使用 MinIO 和 SpringBoot 开发壁纸 API

前言

你是否曾经想为博客文章设计一个能随机展示壁纸的封面？在这篇指南中，我们将结合 MinIO 和 SpringBoot 开发一个壁纸 API，每次调用都会返回一张随机的壁纸图片。

项目依赖

要开始我们的项目，首先需要添加以下 Maven 依赖：

<dependency>
  <groupId>io.minio</groupId>
  <artifactId>minio</artifactId>
  <version>8.0.3</version>
</dependency>
<dependency>
  <groupId>commons-io</groupId>
  <artifactId>commons-io</artifactId>
  <version>2.11.0</version>
</dependency>

Service 层设计

首先，我们定义了 MinioService 接口及其实现类 MinioServiceImpl。此服务提供了列出指定 MinIO 存储桶中的所有对象和获取随机图片URL的功能。

接口定义：

package com.techhut.wallpaper.service;

import io.minio.messages.Item;

import java.io.IOException;
import java.io.InputStream;
import java.util.List;

public interface MinioService {

    List<Item> listObjects(String bucketName) throws IOException;

    String randomImageUrl() throws Exception;
}

实现类内容：

package com.techhut.wallpaper.service.impl;

import com.techhut.wallpaper.service.MinioService;
import io.minio.GetPresignedObjectUrlArgs;
import io.minio.ListObjectsArgs;
import io.minio.MinioClient;
import io.minio.Result;
import io.minio.http.Method;
import io.minio.messages.Item;
import org.springframework.stereotype.Service;

import java.io.IOException;
import java.util.ArrayList;
import java.util.List;
import java.util.Random;

/**
 * @author
 **/
@Service
public class MinioServiceImpl implements MinioService {

    private final MinioClient minioClient;

    public MinioServiceImpl() {
        // 初始化MinIO客户端
 				MinioClient minioClient = MinioClient.builder()
                    .endpoint("your-minio-endpoint")
                    .credentials("access-key", "secret-key")
                    .build();	
    }


    @Override
    public List<Item> listObjects(String bucketName) throws IOException {
        try {
            List<Item> items = new ArrayList<>();
            // 列出指定存储桶中的所有对象
            Iterable<Result<Item>> results = minioClient.listObjects(ListObjectsArgs.builder().bucket(bucketName).build());
            for (Result<Item> result : results) {
                Item item = result.get();
                items.add(item);
            }
            return items;
        } catch (Exception e) {
            e.printStackTrace();
            throw new IOException("Error occurred while listing objects in MinIO", e);
        }
    }


    @Override
    public String randomImageUrl() throws Exception {
        // 列出指定存储桶中的所有对象
        List<Item> objects = listObjects(bucketName);
        // 从对象列表中随机选择一个对象
        Random random = new Random();
        Item randomItem = objects.get(random.nextInt(objects.size()));
        GetPresignedObjectUrlArgs wallpaper = GetPresignedObjectUrlArgs.builder().method(Method.GET).bucket(bucketName).object(randomItem.objectName()).build();
        String presignedObjectUrl = minioClient.getPresignedObjectUrl(wallpaper);
        return presignedObjectUrl;
    }
}

在 MinioServiceImpl 中，我们首先初始化 MinIO 客户端，并定义了两个重要的方法：listObjects 和 randomImageUrl。

Controller 设计

Controller 层包含了处理请求的逻辑。在 WallpaperController 类中，我们定义了一个 GET 请求映射，当请求到达时，它会调用 randomImageUrl 方法并重定向到返回的图片URL。

package com.techhut.wallpaper.controller;

import com.techhut.wallpaper.service.MinioService;
import org.springframework.web.bind.annotation.CrossOrigin;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.servlet.view.RedirectView;

import javax.annotation.Resource;

/**
 * @author
 **/
@CrossOrigin
@RestController
@RequestMapping("/wallpaper")
public class WallpaperController {


    @Resource
    MinioService minioService;

    @GetMapping()
    RedirectView getWallpaper() throws Exception {
        String targetUrl = minioService.randomImageUrl();
      	//重定向到图片路径
        return new RedirectView(targetUrl);
    }


}

通过上述指南，你应该能够轻松地在 SpringBoot 中集成 MinIO，开发一个随机壁纸 API。如果你有任何疑问或建议，欢迎在评论区留言讨论。