Spring Boot 연결

dependencies 추가

# minio
implementation 'io.minio:minio:8.5.9'

MinioConfig.java 생성

package com.subject1.images.config;

import io.minio.MinioClient;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class MinioConfig {
    @Value("${minio.url}")
    private String url;

    @Value("${minio.access.name}")
    private String accessKey;

    @Value("${minio.access.secret}")
    private String secretKey;

    @Bean
    public MinioClient minioClient() {
        return MinioClient.builder()
            .endpoint(url)
            .credentials(accessKey, secretKey)
            .build();
    }
}

application.yaml 설정

minio:
  url: ${MINIO_URL} # minio API 포트 주소
  path: ${MINIO_PATH} # Minio 서버 자체의 웹 경로를 의미 Ex. localhost:9001/minio -> minio으로 설정
  dir:
    image: ${MINIO_IMAGE_DIR} # 버킷 내 이미지 저장할 폴더명(버킷 내 폴더 설정할 때 사용)
  bucket:
    name: ${MINIO_BUCKET}  # 버킷 이름
  access:
    name: ${MINIO_ACCESS_KEY}   # access key
    secret: ${MINIO_SECRET_KEY} # secretKey key

MinioService.java

package com.subject1.images.service;

import io.minio.*;
import io.minio.errors.*;
import io.minio.http.Method;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import org.springframework.web.multipart.MultipartFile;

import java.io.IOException;
import java.io.InputStream;
import java.security.InvalidKeyException;
import java.security.NoSuchAlgorithmException;
import java.util.concurrent.TimeUnit;

@Service
@Slf4j
public class MinioService {
    private final MinioClient minioClient;

    public MinioService(MinioClient minioClient) {
        this.minioClient = minioClient;
    }

    @Value("${minio.bucket.image.name}")
    private String IMAGE_BUCKET_NAME;

    @Value("${minio.bucket.thumbnail.name}")
    private String THUMBNAIL_BUCKET_NAME;

    @Transactional
    public String saveImgFile(String storedFileName, MultipartFile multipartFile)
        throws IOException,
        ServerException,
        InsufficientDataException,
        ErrorResponseException,
        NoSuchAlgorithmException,
        InvalidKeyException,
        InvalidResponseException,
        XmlParserException,
        InternalException {
        // 환경변수로 설정한 버킷이 존재한지 확인한다.
        boolean isExist = minioClient.bucketExists(
            BucketExistsArgs.builder()
                .bucket(IMAGE_BUCKET_NAME)
                .build());
        // 존재하지 않다면, 새로 생성한다.
        if (!isExist) {
            minioClient.makeBucket(MakeBucketArgs.builder()
                .bucket(IMAGE_BUCKET_NAME)
                .build());
        }
        // MinIO에 저장한다.
        minioClient.putObject(PutObjectArgs.builder()
                .bucket(IMAGE_BUCKET_NAME)
                .object(storedFileName)
                .stream(multipartFile.getInputStream(), multipartFile.getSize(), -1)
                .contentType(multipartFile.getContentType())
                .build());
        // MinIO의 저장된 경로를 반환한다.
        return "/" + storedFileName;
    }

    public String saveThumbnailFile(String storedFileName, InputStream inputStream, long size)
        throws IOException,
        ServerException,
        InsufficientDataException,
        ErrorResponseException,
        NoSuchAlgorithmException,
        InvalidKeyException,
        InvalidResponseException,
        XmlParserException,
        InternalException {
        // 환경변수로 설정한 버킷이 존재한지 확인한다.
        boolean isExist = minioClient.bucketExists(
            BucketExistsArgs.builder()
                .bucket(THUMBNAIL_BUCKET_NAME)
                .build());
        // 존재하지 않다면, 새로 생성한다.
        if (!isExist) {
            minioClient.makeBucket(MakeBucketArgs.builder()
                .bucket(THUMBNAIL_BUCKET_NAME)
                .build());
        }
        // MinIO에 저장한다.
        minioClient.putObject(PutObjectArgs.builder()
            .bucket(THUMBNAIL_BUCKET_NAME)
            .object(storedFileName)
            .stream(inputStream, size, -1)
            .contentType("image/jpeg")
            .build());

        // MinIO의 저장된 경로를 반환한다.
        return "/" + storedFileName;
    }

    // MinIO에서 저장된 파일을 InputStream으로 반환한다.
    public InputStream getFileInputStream(String storedFileName)
        throws ServerException,
            InsufficientDataException,
            ErrorResponseException,
            IOException,
            NoSuchAlgorithmException,
            InvalidKeyException,
            InvalidResponseException,
            XmlParserException,
            InternalException {
        return minioClient.getObject(
            GetObjectArgs.builder()
                .bucket(IMAGE_BUCKET_NAME)
                .object(storedFileName)
                .build()
        );
    }

    // 저장된 파일을 완전한 URL로 반환한다.
    public String getPresignedUrl(String storedFileName)
        throws ServerException,
        InsufficientDataException,
        ErrorResponseException,
        IOException,
        NoSuchAlgorithmException,
        InvalidKeyException,
        InvalidResponseException,
        XmlParserException,
        InternalException {
        return minioClient.getPresignedObjectUrl(
            GetPresignedObjectUrlArgs.builder()
                .method(Method.GET) // GET 메서드로 접근 허용
                .bucket(IMAGE_BUCKET_NAME)
                .object(storedFileName)
                .expiry(3600, TimeUnit.SECONDS) // 유효기간 설정
                .build());
    }
}

<aside> 📌

출처. 뤼튼

</aside>

MinIo Spring Boot에서 사용하기