Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 1,354 Commits
.github/workflows		.github/workflows
adminapi/src		adminapi/src
api/src		api/src
docs		docs
examples		examples
functional		functional
gradle/wrapper		gradle/wrapper
.gitattributes		.gitattributes
.gitignore		.gitignore
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
MAINTAINERS.md		MAINTAINERS.md
README.md		README.md
README_zh_CN.md		README_zh_CN.md
build.gradle		build.gradle
gradlew		gradlew
gradlew.bat		gradlew.bat
settings.gradle		settings.gradle
spotbugs-filter.xml		spotbugs-filter.xml

Repository files navigation

MinIO Java SDK for Amazon S3 Compatible Cloud Storage

MinIO Java SDK is Simple Storage Service (aka S3) client to perform bucket and object operations to any Amazon S3 compatible object storage service.

For a complete list of APIs and examples, please take a look at theJava Client API Reference documentation.

Minimum Requirements

Java 1.8 or above.

Maven usage

<dependency>    <groupId>io.minio</groupId>    <artifactId>minio</artifactId>    <version>8.6.0</version></dependency>

Gradle usage

dependencies {    implementation("io.minio:minio:8.6.0")}

JAR download

The latest JAR can be downloaded fromhere

Quick Start Example - File Uploader

This example program connects to an object storage server, makes a bucket on the server and then uploads a file to the bucket.

You need three items in order to connect to an object storage server.

Parameters	Description
Endpoint	URL to S3 service.
Access Key	Access key (aka user ID) of an account in the S3 service.
Secret Key	Secret key (aka password) of an account in the S3 service.

This example uses MinIO server playgroundhttps://play.min.io. Feel free to use this service for test and development.

FileUploader.java

importio.minio.BucketExistsArgs;importio.minio.MakeBucketArgs;importio.minio.MinioClient;importio.minio.UploadObjectArgs;importio.minio.errors.MinioException;importjava.io.IOException;importjava.security.InvalidKeyException;importjava.security.NoSuchAlgorithmException;publicclassFileUploader {publicstaticvoidmain(String[]args)throwsIOException,NoSuchAlgorithmException,InvalidKeyException {try {// Create a minioClient with the MinIO server playground, its access key and secret key.MinioClientminioClient =MinioClient.builder()              .endpoint("https://play.min.io")              .credentials("Q3AM3UQ867SPQQA43P2F","zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG")              .build();// Make 'asiatrip' bucket if not exist.booleanfound =minioClient.bucketExists(BucketExistsArgs.builder().bucket("asiatrip").build());if (!found) {// Make a new bucket called 'asiatrip'.minioClient.makeBucket(MakeBucketArgs.builder().bucket("asiatrip").build());      }else {System.out.println("Bucket 'asiatrip' already exists.");      }// Upload '/home/user/Photos/asiaphotos.zip' as object name 'asiaphotos-2015.zip' to bucket// 'asiatrip'.minioClient.uploadObject(UploadObjectArgs.builder()              .bucket("asiatrip")              .object("asiaphotos-2015.zip")              .filename("/home/user/Photos/asiaphotos.zip")              .build());System.out.println("'/home/user/Photos/asiaphotos.zip' is successfully uploaded as "              +"object 'asiaphotos-2015.zip' to bucket 'asiatrip'.");    }catch (MinioExceptione) {System.out.println("Error occurred: " +e);System.out.println("HTTP trace: " +e.httpTrace());    }  }}

Compile FileUploader

$ javac -cp minio-8.6.0-all.jar FileUploader.java

Run FileUploader

$ java -cp minio-8.6.0-all.jar:. FileUploader'/home/user/Photos/asiaphotos.zip' is successfully uploaded as object'asiaphotos-2015.zip' to bucket'asiatrip'.$ mc ls play/asiatrip/[2016-06-02 18:10:29 PDT]  82KiB asiaphotos-2015.zip