MinIO - 32. 아마존 S3 호환 클라우드 스토리지용 MinIO Java SDK

목록

MinIO Java SDK for Amazon S3 Compatible Cloud Storage

아마존 S3 호환 클라우드 스토리지용 MinIO Java SDK

The MinIO Java Client SDK provides simple APIs to access any Amazon S3 compatible object storage server.

MinIO Java 클라이언트 SDK는 Amazon S3 호환 객체 스토리지 서버에 액세스할 수 있는 간단한 API를 제공합니다.

This quickstart guide will show you how to install the client SDK and execute an example java program.

이 빠른 시작 가이드에서는 클라이언트 SDK를 설치하고 예제 Java 프로그램을 실행하는 방법을 보여줍니다.

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

API 및 예제의 전체 목록을 보려면 Java 클라이언트 API 참조 문서를 살펴보세요.

Minimum Requirements

최소 요구 사항들

Java 1.8 or above, with one of the following environments:

Java 1.8 이상, 다음 환경 중 하나:

OracleJDK 8.0

오라클JDK 8.0

OpenJDK8.0

오픈JDK8.0

Download from maven

Maven에서 다운로드

io.minio minio 6.0.11

Download from gradle

gradle에서 다운로드

dependencies { compile 'io.minio:minio:6.0.11' }

Download from JAR

JAR에서 다운로드

You can download the latest JAR directly from maven.

Maven에서 직접 최신 JAR을 다운로드할 수 있습니다.

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.

객체 스토리지 서버에 연결하려면 세 가지 항목이 필요합니다.

Params

매개변수

Description

설명

Endpoint

Endpoint

URL to object storage service.

객체 스토리지 서비스에 대한 URL입니다.

Access Key

Access Key

Access key is like user ID that uniquely identifies your account.

액세스 키는 계정을 고유하게 식별하는 사용자 ID와 같습니다.

Secret Key

Secret Key

Secret key is the password to your account.

비밀 키는 계정의 패스워드입니다.

For the following example, we will use a freely hosted MinIO server running at https://play.min.io.

다음 예에서는 https://play.min.io에서 실행되는 무료 호스팅 MinIO 서버를 사용합니다.

Feel free to use this service for test and development. Access credentials shown in this example are open to the public.

테스트 및 개발을 위해 이 서비스를 자유롭게 사용해 보세요. 이 예에 표시된 액세스 자격 증명은 대중에게 공개됩니다.

FileUploader.java

FileUploader.java

import java.io.IOException; import java.security.NoSuchAlgorithmException; import java.security.InvalidKeyException; import org.xmlpull.v1.XmlPullParserException; import io.minio.MinioClient; import io.minio.errors.MinioException; public class FileUploader { public static void main(String[] args) throws NoSuchAlgorithmException, IOException, InvalidKeyException, XmlPullParserException { try {

// Create a minioClient with the MinIO Server name, Port, Access key and Secret key.

// MinIO 서버 이름, 포트, 액세스 키 및 비밀 키를 사용하여 minioClient를 생성합니다.

MinioClient minioClient = new MinioClient("https://play.min.io", "Q3AM3UQ867SPQQA43P2F", "zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG");

// Check if the bucket already exists.

// 버킷이 이미 존재하는지 확인합니다.

boolean isExist = minioClient.bucketExists("asiatrip"); if(isExist) {

System.out.println("Bucket already exists.");

System.out.println("버킷이 이미 존재합니다.");

} else {

// Make a new bucket called asiatrip to hold a zip file of photos.

// 사진의 zip 파일을 보관할 asiatrip이라는 새 버킷을 만듭니다.

minioClient.makeBucket("asiatrip"); }

// Upload the zip file to the bucket with putObject

// putObject를 사용하여 zip 파일을 버킷에 업로드합니다

minioClient.putObject("asiatrip","asiaphotos.zip", "/home/user/Photos/asiaphotos.zip"); System.out.println("/home/user/Photos/asiaphotos.zip is successfully uploaded as asiaphotos.zip to `asiatrip` bucket."); } catch(MinioException e) { System.out.println("Error occurred: " + e); } } }

Compile FileUploader

FileUploader 컴파일

javac -cp "minio-6.0.11-all.jar" FileUploader.java

Run FileUploader

FileUploader 실행

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

API Reference

API 참조

The full API Reference is available here.

전체 API 참조는 여기에서 확인할 수 있습니다.

Complete API Reference

완전한 API 참조

API Reference: Bucket Operations

API 참조: 버킷 작업

makeBucket listBuckets bucketExists removeBucket listObjects listIncompleteUploads

API Reference: Object Operations

API 참조: 객체 작업

getObject putObject copyObject statObject removeObject removeIncompleteUpload

API Reference: Presigned Operations

API 참조: 사전 서명된 작업

presignedGetObject presignedPutObject presignedPostPolicy

API Reference: Bucket Policy Operations

API 참조: 버킷 정책 작업

getBucketPolicy setBucketPolicy

Full Examples

전체 예

Full Examples: Bucket Operations

전체 예: 버킷 작업

ListBuckets.java ListObjects.java BucketExists.java MakeBucket.java RemoveBucket.java ListIncompleteUploads.java

Full Examples: Object Operations

전체 예: 객체 작업

PutObject.java PutObjectEncrypted.java GetObject.Java GetObjectEncrypted.Java GetPartialObject.java RemoveObject.java RemoveObjects.java StatObject.java

Full Examples: Presigned Operations

전체 예: 사전 서명된 작업

PresignedGetObject.java PresignedPutObject.java PresignedPostPolicy.java

Full Examples: Bucket Policy Operations

전체 예: 버킷 정책 작업

SetBucketPolicy.java GetBucketPolicy.Java

Full Examples: Server Side Encryption

전체 예: 서버측 암호화

CopyObjectEncrypted.java CopyObjectEncryptedKms.java CopyObjectEncryptedS3.java PutGetObjectEncrypted.java PutObjectEncryptedKms.java PutObjectEncryptedS3.java

Explore Further

더 자세히 살펴보세요

Complete Documentation

완전한 문서

MinIO Java Client SDK API Reference

MinIO Java 클라이언트 SDK API 참조

Build your own Photo API Service - Full Application Example

여러분만의 Photo API 서비스 구축 - 전체 애플리케이션 예시

Contribute

기여

Contributors Guide

기여자 가이드