如何在Quarkus 2.16扩展中定义非固定键的自定义应用属性以支持多MyClient实例

嗨，这个需求其实Quarkus已经提供了现成的方案来实现，和你提到的RestClient多实例配置思路完全一致，我来一步步给你讲清楚怎么搞：

核心思路：利用@EachProperty处理命名配置实例 #

Quarkus的@EachProperty注解专门用来处理这种「前缀固定、后面跟着自定义名称」的多实例配置，它会自动把每个自定义名称对应的配置项转换成独立的配置Bean，我们只需要基于这些配置Bean生成对应的MyClient实例就行。

第一步：定义每个客户端的配置类 #

先创建一个配置接口，用@EachProperty指定配置的公共前缀，接口里定义你需要的配置属性（比如name）：

import io.quarkus.arc.config.EachProperty;

// 这里指定公共前缀，后面的自定义名称（比如CLIENTNAME-1）就是每个实例的标识
@EachProperty("quarkus.myextension.myclient")
public interface MyClientConfig {
    // 对应配置项中的`.name`属性
    String name();

    // 如果还有其他配置属性，比如url、timeout，直接在这里添加对应的方法就行
    // String url();
    // int timeout();
}

第二步：编写生产者类，将配置转换为MyClient实例 #

接下来写一个CDI生产者类，注入所有的MyClientConfig实例（key就是配置里的自定义名称），然后把每个配置转换成MyClient对象：

import jakarta.enterprise.context.ApplicationScoped;
import jakarta.enterprise.inject.Produces;
import java.util.Map;
import java.util.stream.Collectors;

@ApplicationScoped
public class MyClientProducer {

    // 注入所有配置实例，key是配置里的自定义名称（比如CLIENTNAME-1）
    @Produces
    public Map<String, MyClient> produceMyClients(Map<String, MyClientConfig> configMap) {
        // 遍历配置，生成对应的MyClient实例
        return configMap.entrySet().stream()
                .collect(Collectors.toMap(
                        Map.Entry::getKey,
                        entry -> {
                            MyClient client = new MyClient();
                            client.setName(entry.getValue().name());
                            // 如果有其他属性，在这里继续设置
                            // client.setUrl(entry.getValue().url());
                            return client;
                        }
                ));
    }

    // 额外选项：如果你想让每个MyClient以命名Bean的形式单独注入
    // 可以添加这个生产者方法，这样就能用@Named("CLIENTNAME-1") MyClient client1来注入单个实例
    /*
    @Produces
    public MyClient produceSingleMyClient(@Named String configName, MyClientConfig config) {
        MyClient client = new MyClient();
        client.setName(config.name());
        return client;
    }
    */
}

第三步：在扩展处理器中注册必要的Bean #

为了让Quarkus识别你的生产者类，需要在扩展的部署处理器里把它注册为额外Bean：

import io.quarkus.arc.deployment.AdditionalBeanBuildItem;
import io.quarkus.deployment.annotations.BuildStep;
import io.quarkus.deployment.builditem.FeatureBuildItem;

class MyExtensionProcessor {

    private static final String FEATURE = "myextension";

    // 声明扩展的feature名称
    @BuildStep
    FeatureBuildItem feature() {
        return new FeatureBuildItem(FEATURE);
    }

    // 注册MyClientProducer为不可移除的Bean
    @BuildStep
    AdditionalBeanBuildItem registerProducer() {
        return AdditionalBeanBuildItem.unremovableOf(MyClientProducer.class);
    }
}

第四步：用户使用时的配置方式 #

现在你的扩展用户就可以在application.properties里按照需求配置多个MyClient实例了：

# 配置第一个客户端
quarkus.myextension.myclient.CLIENTNAME-1.name=Bob

# 配置第二个客户端
quarkus.myextension.myclient.CLIENTNAME-2.name=John

# 更多实例依此类推
quarkus.myextension.myclient.CLIENTNAME-3.name=Paul

额外说明 #

• 这个实现思路和Quarkus RestClient的多实例配置逻辑完全一致，都是借助@EachProperty来自动解析命名配置实例。
• 如果用户需要单独注入某个特定的MyClient实例，只需要用@Named("CLIENTNAME-1") MyClient client1即可；如果需要获取所有实例，直接注入Map<String, MyClient>就行。
• 确保你的扩展依赖了quarkus-arc和smallrye-config这两个核心库，Quarkus 2.16版本默认已经包含这些依赖，但如果是独立扩展项目，需要在pom.xml中明确引入。

备注：内容来源于stack exchange，提问作者EnricoNiccoli