无需类中介，在WSO2 MI Server启动时加载属性文件并在API中访问

推荐实现方案 #

1. 自定义属性文件 + 内置属性提供者（适配get-property('file','propertyName')需求） #

这是最贴合你需求的方案，属性会在服务器启动时一次性加载，且支持指定命名空间的XPath访问：

• 第一步：在MI的conf目录下创建自定义属性文件，比如my-config.properties，写入配置内容：

  api.base.url=https://prod.example.com/v1
  db.connection.timeout=30000
  

• 第二步：在deployment.toml中配置属性提供者，将该文件关联到file命名空间，启动时自动加载：

  [file.properties]
  file = "${carbon.home}/conf/my-config.properties"
  # 可选：设置为0表示仅启动时加载一次，不自动重载
  reload_interval = 0
  

• 访问方式：
  • 在API序列中直接用get-property('file','api.base.url')获取
  • XPath表达式中直接使用get-property('file','db.connection.timeout')

2. 直接配置在Deployment.toml（简化版） #

如果属性数量不多，可直接将配置写入deployment.toml，MI启动时会自动加载为系统属性：

• 配置示例：

  [custom.properties]
  api.endpoint = "https://dev.example.com/api"
  redis.host = "localhost"
  

• 访问方式：用get-property('api.endpoint')直接获取，无需指定命名空间

3. 本地注册表存储（适合动态管理场景） #

若属性需要后续在管理控制台修改，可存入MI本地注册表：

• 登录MI管理控制台，进入注册表 -> /_system/config，新建属性节点（比如custom_configs/api_url）并设置对应值
• 访问方式：get-property('registry','/_system/config/custom_configs/api_url')

最佳实践 #

• 敏感属性加密：密码、密钥等敏感配置，用MI加密工具加密后写入属性文件，在deployment.toml中配置加密密钥，避免明文泄露
• 环境隔离：不同环境（开发/测试/生产）的属性分开存储，通过环境变量动态替换，比如api.base.url="${ENV_API_BASE_URL}"
• 避免重复加载：禁用属性文件自动重载（reload_interval=0），确保启动时仅加载一次，减少性能损耗
• 统一管理：把所有业务配置集中到单个或少数属性文件，避免分散配置增加维护成本

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