一、获取Minio对象的主要方法

1. 基本获取方法

(1) 获取对象数据流

java
// 获取最新版本
try (InputStream stream = minioClient.getObject(
    GetObjectArgs.builder()
        .bucket("my-bucket")
        .object("path/to/file.txt")
        .build())) {
    // 处理输入流
}

// 获取特定版本
try (InputStream stream = minioClient.getObject(
    GetObjectArgs.builder()
        .bucket("my-bucket")
        .object("path/to/file.txt")
        .versionId("version-id-here")
        .build())) {
    // 处理输入流
}

(2) 下载到本地文件

java
minioClient.downloadObject(
    DownloadObjectArgs.builder()
        .bucket("my-bucket")
        .object("path/to/file.txt")
        .filename("/local/path/save.txt")
        .build());

2. 获取对象信息（不下载内容）

(1) 获取对象元数据

java
StatObjectResponse stat = minioClient.statObject(
    StatObjectArgs.builder()
        .bucket("my-bucket")
        .object("path/to/file.txt")
        .build());

System.out.println("ETag: " + stat.etag());
System.out.println("Size: " + stat.size());
System.out.println("Last Modified: " + stat.lastModified());
System.out.println("Content Type: " + stat.contentType());

(2) 获取用户自定义元数据

java
StatObjectResponse stat = minioClient.statObject(
    StatObjectArgs.builder()
        .bucket("my-bucket")
        .object("path/to/file.txt")
        .build());

Map<String, String> userMetadata = stat.userMetadata();
System.out.println("Custom Metadata: " + userMetadata);

二、基于用户自定义元数据的查询方法

Minio本身不提供直接通过自定义元数据查询对象的API，但可以通过以下方式实现：

1. 方法一：先列出对象再过滤

java
// 1. 列出所有对象
Iterable<Result<Item>> objects = minioClient.listObjects(
    ListObjectsArgs.builder()
        .bucket("my-bucket")
        .prefix("path/") // 限定目录
        .recursive(true)
        .build());

// 2. 过滤包含特定元数据的对象
List<String> matchedObjects = new ArrayList<>();
for (Result<Item> result : objects) {
    Item item = result.get();
    StatObjectResponse stat = minioClient.statObject(
        StatObjectArgs.builder()
            .bucket("my-bucket")
            .object(item.objectName())
            .build());

    if ("expected-value".equals(stat.userMetadata().get("custom-metadata-key"))) {
        matchedObjects.add(item.objectName());
    }
}

2. 方法二：使用外部索引（推荐）

对于大量数据，更高效的做法是维护外部索引（如数据库）：

java
// 1. 上传对象时记录元数据到数据库
public void uploadWithMetadata(String objectPath, InputStream data, Map<String, String> metadata) {
    // 上传到Minio
    minioClient.putObject(
        PutObjectArgs.builder()
            .bucket("my-bucket")
            .object(objectPath)
            .userMetadata(metadata)
            .stream(data, -1, 10485760)
            .build());

    // 同时记录到数据库
    jdbcTemplate.update(
        "INSERT INTO object_metadata (object_path, metadata_key, metadata_value) VALUES (?, ?, ?)",
        objectPath,
        "custom-key",
        metadata.get("custom-key"));
}

// 2. 通过数据库查询获取对象路径
public List<String> findObjectsByMetadata(String key, String value) {
    return jdbcTemplate.queryForList(
        "SELECT object_path FROM object_metadata WHERE metadata_key = ? AND metadata_value = ?",
        String.class,
        key,
        value);
}

3. 方法三：使用Minio通知+外部处理

配置Minio事件通知，当对象创建/更新时将元数据同步到外部系统：

java
// 配置Minio事件通知（通常通过MC命令行或管理界面）
// 然后实现一个服务监听这些事件并建立索引

三、获取对象时的其他有用选项

1. 范围获取（Range GET）

java
// 只获取前1KB数据
GetObjectArgs args = GetObjectArgs.builder()
    .bucket("my-bucket")
    .object("large-file.bin")
    .offset(0L)
    .length(1024L)
    .build();

2. 条件获取

java
// 仅在对象未被修改时获取
GetObjectArgs args = GetObjectArgs.builder()
    .bucket("my-bucket")
    .object("file.txt")
    .matchETag("etag-value")
    .build();

3. 获取对象标签

java
Tags tags = minioClient.getObjectTags(
    GetObjectTagsArgs.builder()
        .bucket("my-bucket")
        .object("file.txt")
        .build());

四、性能优化建议

1. 批量处理：对多个对象的操作使用批量API
2. 并行下载：对大文件使用分段下载
3. 缓存策略：对频繁访问的元数据进行缓存
4. 合理使用prefix：缩小list操作的范围

虽然Minio不直接支持基于自定义元数据的查询，但通过上述方法组合，可以在Java应用中实现高效的元数据查询功能。对于生产环境，建议采用方法二（外部索引）以获得最佳性能。