{"id":15036519,"url":"https://github.com/minio/minio-java","last_synced_at":"2025-05-13T20:15:58.955Z","repository":{"id":31402938,"uuid":"34966186","full_name":"minio/minio-java","owner":"minio","description":"MinIO Client SDK for Java","archived":false,"fork":false,"pushed_at":"2025-04-08T15:27:22.000Z","size":12334,"stargazers_count":1181,"open_issues_count":11,"forks_count":494,"subscribers_count":39,"default_branch":"master","last_synced_at":"2025-04-28T11:52:23.635Z","etag":null,"topics":["aws-s3","client-sdk","libraries","minio-java","s3-bucket","sdk"],"latest_commit_sha":null,"homepage":"https://docs.min.io/docs/java-client-quickstart-guide.html","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/minio.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2015-05-02T23:01:03.000Z","updated_at":"2025-04-27T11:20:38.000Z","dependencies_parsed_at":"2023-02-17T03:31:20.880Z","dependency_job_id":"b4a2ab05-0d6d-4c91-adfb-17d356356fa4","html_url":"https://github.com/minio/minio-java","commit_stats":null,"previous_names":[],"tags_count":101,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/minio%2Fminio-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/minio%2Fminio-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/minio%2Fminio-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/minio%2Fminio-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/minio","download_url":"https://codeload.github.com/minio/minio-java/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254020641,"owners_count":22000756,"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":["aws-s3","client-sdk","libraries","minio-java","s3-bucket","sdk"],"created_at":"2024-09-24T20:31:25.732Z","updated_at":"2025-05-13T20:15:58.935Z","avatar_url":"https://github.com/minio.png","language":"Java","readme":"# MinIO Java SDK for Amazon S3 Compatible Cloud Storage [![Slack](https://slack.min.io/slack?type=svg)](https://slack.min.io)\n\nMinIO Java SDK is Simple Storage Service (aka S3) client to perform bucket and object operations to any Amazon S3 compatible object storage service.\n\nFor a complete list of APIs and examples, please take a look at the [Java Client API Reference](https://min.io/docs/minio/linux/developers/java/API.html) documentation.\n\n## Minimum Requirements\nJava 1.8 or above.\n\n## Maven usage\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003eio.minio\u003c/groupId\u003e\n    \u003cartifactId\u003eminio\u003c/artifactId\u003e\n    \u003cversion\u003e8.5.17\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n## Gradle usage\n```\ndependencies {\n    implementation(\"io.minio:minio:8.5.17\")\n}\n```\n\n## JAR download\nThe latest JAR can be downloaded from [here](https://repo1.maven.org/maven2/io/minio/minio/8.5.17/)\n\n## Quick Start Example - File Uploader\nThis example program connects to an object storage server, makes a bucket on the server and then uploads a file to the bucket.\n\nYou need three items in order to connect to an object storage server.\n\n| Parameters | Description                                                |\n|------------|------------------------------------------------------------|\n| Endpoint   | URL to S3 service.                                         |\n| Access Key | Access key (aka user ID) of an account in the S3 service.  |\n| Secret Key | Secret key (aka password) of an account in the S3 service. |\n\nThis example uses MinIO server playground [https://play.min.io](https://play.min.io). Feel free to use this service for test and development.\n\n### FileUploader.java\n```java\nimport io.minio.BucketExistsArgs;\nimport io.minio.MakeBucketArgs;\nimport io.minio.MinioClient;\nimport io.minio.UploadObjectArgs;\nimport io.minio.errors.MinioException;\nimport java.io.IOException;\nimport java.security.InvalidKeyException;\nimport java.security.NoSuchAlgorithmException;\n\npublic class FileUploader {\n  public static void main(String[] args)\n      throws IOException, NoSuchAlgorithmException, InvalidKeyException {\n    try {\n      // Create a minioClient with the MinIO server playground, its access key and secret key.\n      MinioClient minioClient =\n          MinioClient.builder()\n              .endpoint(\"https://play.min.io\")\n              .credentials(\"Q3AM3UQ867SPQQA43P2F\", \"zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG\")\n              .build();\n\n      // Make 'asiatrip' bucket if not exist.\n      boolean found =\n          minioClient.bucketExists(BucketExistsArgs.builder().bucket(\"asiatrip\").build());\n      if (!found) {\n        // Make a new bucket called 'asiatrip'.\n        minioClient.makeBucket(MakeBucketArgs.builder().bucket(\"asiatrip\").build());\n      } else {\n        System.out.println(\"Bucket 'asiatrip' already exists.\");\n      }\n\n      // Upload '/home/user/Photos/asiaphotos.zip' as object name 'asiaphotos-2015.zip' to bucket\n      // 'asiatrip'.\n      minioClient.uploadObject(\n          UploadObjectArgs.builder()\n              .bucket(\"asiatrip\")\n              .object(\"asiaphotos-2015.zip\")\n              .filename(\"/home/user/Photos/asiaphotos.zip\")\n              .build());\n      System.out.println(\n          \"'/home/user/Photos/asiaphotos.zip' is successfully uploaded as \"\n              + \"object 'asiaphotos-2015.zip' to bucket 'asiatrip'.\");\n    } catch (MinioException e) {\n      System.out.println(\"Error occurred: \" + e);\n      System.out.println(\"HTTP trace: \" + e.httpTrace());\n    }\n  }\n}\n```\n\n#### Compile FileUploader\n```sh\n$ javac -cp minio-8.5.17-all.jar FileUploader.java\n```\n\n#### Run FileUploader\n```sh\n$ java -cp minio-8.5.17-all.jar:. FileUploader\n'/home/user/Photos/asiaphotos.zip' is successfully uploaded as object 'asiaphotos-2015.zip' to bucket 'asiatrip'.\n\n$ mc ls play/asiatrip/\n[2016-06-02 18:10:29 PDT]  82KiB asiaphotos-2015.zip\n```\n\n## More References\n* [Java Client API Reference](https://min.io/docs/minio/linux/developers/java/API.html)\n* [Javadoc](https://minio-java.min.io/)\n* [Examples](https://github.com/minio/minio-java/tree/release/examples)\n\n## Explore Further\n* [Complete Documentation](https://min.io/docs/minio/kubernetes/upstream/index.html)\n* [Build your own Photo API Service - Full Application Example ](https://github.com/minio/minio-java-rest-example)\n\n## Contribute\nPlease refer [Contributors Guide](https://github.com/minio/minio-java/blob/release/CONTRIBUTING.md)\n","funding_links":[],"categories":["Projects","项目"],"sub_categories":["Utility","实用程序"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fminio%2Fminio-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fminio%2Fminio-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fminio%2Fminio-java/lists"}