如何为Quarkus Qute的MessageBundle加载外部msg.properties？

方法1：通过Quarkus配置指定消息文件路径 #

Qute支持通过配置项指定消息文件的加载路径，你可以在application.properties（内置或外部的都可以）中添加以下配置：

quarkus.qute.messages.paths=messages/msg.properties,file:./config/messages/msg.properties

这个配置会让Qute同时加载classpath内的内置消息文件，以及外部config/messages/目录下的文件，且外部文件的属性优先级更高，会覆盖内置的同名属性。

如果是原生应用，只要你在$PWD目录下启动，file:./config/messages/msg.properties就能正确指向你放置的外部文件。

方法2：自定义配置源加载消息文件 #

如果需要更灵活的加载逻辑，可以自定义配置源，将外部msg.properties作为独立配置源注入：

1. 创建自定义配置源类（原生应用必须添加@RegisterForReflection注解，避免编译时被优化掉）：

import io.quarkus.runtime.annotations.RegisterForReflection;
import org.eclipse.microprofile.config.spi.ConfigSource;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.HashMap;
import java.util.Map;
import java.util.Properties;

@RegisterForReflection
public class ExternalMessagesConfigSource implements ConfigSource {

    private final Map<String, String> properties = new HashMap<>();

    public ExternalMessagesConfigSource() {
        loadExternalProperties();
    }

    private void loadExternalProperties() {
        try (InputStream is = new FileInputStream("./config/messages/msg.properties")) {
            Properties props = new Properties();
            props.load(is);
            props.forEach((k, v) -> properties.put(k.toString(), v.toString()));
        } catch (IOException e) {
            // 可添加日志记录加载失败的情况
        }
    }

    @Override
    public Map<String, String> getProperties() {
        return properties;
    }

    @Override
    public String getValue(String key) {
        return properties.get(key);
    }

    @Override
    public String getName() {
        return "ExternalMessagesConfigSource";
    }

    @Override
    public int getOrdinal() {
        return 200; // 优先级高于默认classpath配置源（100），确保外部属性优先生效
    }
}

2. 在项目的META-INF/services/org.eclipse.microprofile.config.spi.ConfigSource文件中，添加该类的全限定名，让Quarkus识别这个自定义配置源：

com.yourpackage.ExternalMessagesConfigSource

完成后，Qute模板即可直接使用外部文件中的属性键。

方法3：通过启动参数指定外部配置路径 #

Quarkus允许通过启动参数直接添加外部配置文件，你可以在启动原生应用时传递以下参数：

./your-native-app -Dquarkus.config.locations=file:./config/messages/msg.properties

这个参数会让Quarkus将外部的msg.properties作为配置源加载，Qute可以直接读取其中的属性。如果需要同时保留内置配置，也可以指定多个路径：

./your-native-app -Dquarkus.config.locations=classpath:application.properties,file:./config/messages/msg.properties

注意事项 #

• 原生应用运行时，要确保外部文件路径正确，且应用具备文件读取权限。
• 若需调试加载情况，可开启日志调试：quarkus.log.category."io.quarkus.qute".level=DEBUG，查看Qute的消息文件加载日志。

内容的提问来源于stack exchange，提问作者kingkong