{"id":27900574,"url":"https://github.com/qiniu/java-sdk","last_synced_at":"2025-05-14T03:06:22.303Z","repository":{"id":2795447,"uuid":"3795725","full_name":"qiniu/java-sdk","owner":"qiniu","description":"Qiniu Resource (Cloud) Storage SDK for Java","archived":false,"fork":false,"pushed_at":"2025-02-13T06:40:34.000Z","size":8375,"stargazers_count":555,"open_issues_count":34,"forks_count":476,"subscribers_count":50,"default_branch":"master","last_synced_at":"2025-05-05T20:17:47.526Z","etag":null,"topics":["java","rtc-sdk","storage-sdk"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/qiniu.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2012-03-22T08:25:59.000Z","updated_at":"2025-05-02T11:15:38.000Z","dependencies_parsed_at":"2023-12-27T07:23:53.983Z","dependency_job_id":"fe94fc39-ba73-49cb-88b0-ccca06927592","html_url":"https://github.com/qiniu/java-sdk","commit_stats":{"total_commits":1244,"total_committers":60,"mean_commits":"20.733333333333334","dds":0.8456591639871383,"last_synced_commit":"38ecfe89bafd0a782eab69dfa09da74c852d483b"},"previous_names":[],"tags_count":94,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qiniu%2Fjava-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qiniu%2Fjava-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qiniu%2Fjava-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qiniu%2Fjava-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/qiniu","download_url":"https://codeload.github.com/qiniu/java-sdk/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254050948,"owners_count":22006387,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","rtc-sdk","storage-sdk"],"created_at":"2025-05-05T20:17:34.140Z","updated_at":"2025-05-14T03:06:22.268Z","avatar_url":"https://github.com/qiniu.png","language":"Java","readme":"# Qiniu Resource Storage SDK for Java\n\n[![@qiniu on weibo](http://img.shields.io/badge/weibo-%40qiniutek-blue.svg)](http://weibo.com/qiniutek)\n[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg)](LICENSE)\n[![Build Status](https://travis-ci.org/qiniu/java-sdk.svg)](https://travis-ci.org/qiniu/java-sdk)\n[![GitHub release](https://img.shields.io/github/v/tag/qiniu/java-sdk.svg?label=release)](https://github.com/qiniu/java-sdk/releases)\n[![Docs](https://img.shields.io/github/v/tag/qiniu/java-sdk.svg?label=docs\u0026color=yellow)](https://qiniu.github.io/java-sdk/)\n[![Coverage Status](https://codecov.io/gh/qiniu/java-sdk/branch/master/graph/badge.svg)](https://codecov.io/gh/qiniu/java-sdk)\n[![Latest Stable Version](https://img.shields.io/maven-central/v/com.qiniu/qiniu-java-sdk.svg)](http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.qiniu%22%20AND%20a%3A%22qiniu-java-sdk%22)\n\n## 安装\n\n下载 [the latest JAR][1] 或者 通过 Maven:\n\n```xml\n\u003cdependency\u003e\n  \u003cgroupId\u003ecom.qiniu\u003c/groupId\u003e\n  \u003cartifactId\u003eqiniu-java-sdk\u003c/artifactId\u003e\n  \u003cversion\u003e[7.18.0, 7.18.99]\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n或者 Gradle:\n\n```groovy\nimplementation 'com.qiniu:qiniu-java-sdk:7.18.+'\n```\n\n## 运行环境\n\nJDK 7 及以上\n\n## 使用方法\n\n### 上传\n\n```Java\n// 分片上传 v1\nimport com.qiniu.storage.UploadManager;\nimport com.qiniu.util.Auth;\nimport com.qiniu.storage.Configuration;\nimport com.qiniu.http.Response;\n\nString accessKey = \"Your AccessKey\";\nString secretKey = \"Your SecretKey\";\nString bucketName = \"upload to bucket\";\nConfiguration cfg = new Configuration();\nUploadManager uploadManager = new UploadManager(cfg);\nAuth auth = Auth.create(accessKey, secretKey);\nString token = auth.uploadToken(bucketName);\nString key = \"file save key\";\nResponse r = uploadManager.put(\"hello world\".getBytes(), key, token);\n\n// 分片上传 v2\nimport com.qiniu.storage.UploadManager;\nimport com.qiniu.util.Auth;\nimport com.qiniu.storage.Configuration;\nimport com.qiniu.http.Response;\n\nString accessKey = \"Your AccessKey\";\nString secretKey = \"Your SecretKey\";\nString bucketName = \"upload to bucket\";\nConfiguration cfg = new Configuration();\ncfg.resumableUploadAPIVersion = Configuration.ResumableUploadAPIVersion.V2;\nUploadManager uploadManager = new UploadManager(cfg);\nAuth auth = Auth.create(accessKey, secretKey);\nString token = auth.uploadToken(bucketName);\nString key = \"file save key\";\nResponse r = uploadManager.put(\"hello world\".getBytes(), key, token);\n```\n\n其他使用请参考[开发指南]https://developer.qiniu.com/kodo/1239/java\n详细的示例请参考[Examples]https://github.com/qiniu/java-sdk/tree/master/examples\n\n## 测试\n\n``` bash\n$ ./gradlew build\n```\n\n## 生成Eclipse工程文件\n\n``` bash\n$ ./gradlew gen_eclipse\n```\n\n## 常见问题\n\n- QiniuExeption保留了请求响应的信息，失败情况下会抛出此异常，可以提交给我们排查问题。\n- API 的使用 demo 可以参考 [单元测试](https://github.com/qiniu/java-sdk/blob/master/src/test)。\n\n## 代码贡献\n\n详情参考[代码提交指南](https://github.com/qiniu/java-sdk/blob/master/CONTRIBUTING.md)。\n\n## 贡献记录\n\n- [所有贡献者](https://github.com/qiniu/java-sdk/contributors)\n\n## 联系我们\n\n- 如果需要帮助，请提交工单（在portal右侧点击咨询和建议提交工单，或者直接向 support@qiniu.com 发送邮件）\n- 如果有什么问题，可以到问答社区提问，[问答社区](http://qiniu.segmentfault.com/)\n- 更详细的文档，见[官方文档站](http://developer.qiniu.com/)\n- 如果发现了bug， 欢迎提交 [issue](https://github.com/qiniu/java-sdk/issues)\n- 如果有功能需求，欢迎提交 [issue](https://github.com/qiniu/java-sdk/issues)\n- 如果要提交代码，欢迎提交 pull request\n- 欢迎关注我们的[微信](http://www.qiniu.com/#weixin) [微博](http://weibo.com/qiniutek)，及时获取动态信息。\n\n## 代码许可\n\nThe MIT License (MIT).详情见 [License文件](https://github.com/qiniu/java-sdk/blob/master/LICENSE).\n\n[1]: https://search.maven.org/remote_content?g=com.qiniu\u0026a=qiniu-java-sdk\u0026v=LATEST\n\n[2]: https://github.com/Nextpeer/okhttp\n\n[3]: https://raw.githubusercontent.com/qiniu/java-sdk/master/libs/okhttp-2.3.0-SNAPSHOT.jar\n\n[4]: https://raw.githubusercontent.com/qiniu/java-sdk/master/libs/okio-1.3.0-SNAPSHOT.jar\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqiniu%2Fjava-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqiniu%2Fjava-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqiniu%2Fjava-sdk/lists"}