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 the Java Client API Reference documentation.
Minimum Requirements
Java 1.8 or above.
Maven usage
<dependency>
<groupId>io.minio</groupId>
<artifactId>minio</artifactId>
<version>8.1.0</version>
</dependency>
Gradle usage
dependencies {
compile 'io.minio:minio:8.1.0'
}
JAR download
The latest JAR can be downloaded from here
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 playground https://play.min.io. Feel free to use this service for test and development.
FileUploader.java
import io.minio.BucketExistsArgs;
import io.minio.MakeBucketArgs;
import io.minio.MinioClient;
import io.minio.UploadObjectArgs;
import io.minio.errors.MinioException;
import java.io.IOException;
import java.security.InvalidKeyException;
import java.security.NoSuchAlgorithmException;
public class FileUploader {
public static void main(String[] args)
throws IOException, NoSuchAlgorithmException, InvalidKeyException {
try {
// Create a minioClient with the MinIO server playground, its access key and secret key.
MinioClient minioClient =
MinioClient.builder()
.endpoint("https://play.min.io")
.credentials("Q3AM3UQ867SPQQA43P2F", "zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG")
.build();
// Make 'asiatrip' bucket if not exist.
boolean found =
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 (MinioException e) {
System.out.println("Error occurred: " + e);
System.out.println("HTTP trace: " + e.httpTrace());
}
}
}
Compile FileUploader
$ javac -cp minio-8.1.0-all.jar FileUploader.java
Run FileUploader
$ java -cp minio-8.1.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
More References
Explore Further
Contribute
Please refer Contributors Guide
![[BUG][FIX] fix NPE when try to stat object named](https://avatars.githubusercontent.com/u/5113926?v=4)
I meet an OOM Exception ,but it's hard to find out . The exception caught outside just says: java.lang.RuntimeException: null
43 Dec 27, 2022
21 Jan 7, 2022
268 Dec 16, 2022
15 Oct 9, 2022
607 Jan 3, 2023
202 Dec 30, 2022
2.8k Jan 2, 2023
31.5k Jan 4, 2023
1.7k Jan 8, 2023
691 Dec 27, 2022
1.3k Jan 8, 2023
46.5k Jan 1, 2023
2.6k Dec 30, 2022
411 Dec 6, 2022
2.5k Jan 9, 2023
4.6k Dec 30, 2022
916 Dec 30, 2022
944 Jan 5, 2023
700 Oct 16, 2022