配置管理

引入依赖

修改应用根目录下的pom.xml，为 polaris-java 添加 dependencyManagement：

  1. <dependencyManagement>
  2.     <dependencies>
  3.         <dependency>
  4.             <groupId>com.tencent.polaris</groupId>
  5.             <artifactId>polaris-dependencies</artifactId>
  6.             <version>${version}</version>
  7.             <type>pom</type>
  8.             <scope>import</scope>
  9.         </dependency>
  10.     </dependencies>
  11. </dependencyManagement>

然后只需要在 标签中在添加 polaris-all 即可

  1. <dependencies>
  2.     <dependency>
  3.         <groupId>com.tencent.polaris</groupId>
  4.         <artifactId>polaris-all</artifactId>
  5.     </dependency>
  6. </dependencies>

初始化 polaris.yaml

你需要在项目的 main/resources 下创建一个 polaris.yaml 文件用于初始化 polaris-java SDK。polaris.yaml配置详细

SDK实例构建

当初始化好 polaris.yaml 文件之后，你可以直接 import com.tencent.polaris.configuration.factory, 使用 ConfigFileServiceFactory 中的方法进行构造一个 ConfigFileService SDK 实例

  1. import com.tencent.polaris.configuration.factory.ConfigFileServiceFactory;
  3. public static void main(String[] args) throws Exception {
  4.     ConfigFileService configFileService = ConfigFileServiceFactory.createConfigFileService();
  5. }

获取配置文件

  1. // 获取特定远程的配置文件
  2. ConfigFile getConfigFile(String namespace, String fileGroup, String fileName);
  4. // 获取特定远程的配置文件
  5. ConfigFile getConfigFile(ConfigFileMetadata configFileMetadata);

对配置文件发起监听

  1. //获取配置文件
  2. ConfigFile configFile = configFileService.getConfigFile(namespace, fileGroup, fileName);
  3. //添加变更监听器
  4. configFile.addChangeListener(new ConfigFileChangeListener() {
  5.     @Override
  6.     public void onChange(ConfigFileChangeEvent event) {
  7.     }
  8. });

SDK配置发布实例构建

使用 ConfigFileServicePublishFactory 中的方法进行构造一个 ConfigFilePublishService SDK 实例

  1. import com.tencent.polaris.configuration.factory.ConfigFileServicePublishFactory;
  3. public static void main(String[] args) throws Exception {
  4.     ConfigFilePublishService configFilePublishService = ConfigFileServicePublishFactory.createConfigFilePublishService();
  5. }

操作配置文件

  1. // 创建配置文件
  2. void createConfigFile(String namespace, String fileGroup, String fileName, String content);
  4. // 创建配置文件
  5. void createConfigFile(ConfigFileMetadata configFileMetadata, String content);
  7. // 修改配置文件
  8. void updateConfigFile(String namespace, String fileGroup, String fileName, String content);
  10. // 修改配置文件
  11. void updateConfigFile(ConfigFileMetadata configFileMetadata, String content);
  13. // 发布配置文件
  14. void releaseConfigFile(String namespace, String fileGroup, String fileName);
  16. // 发布配置文件
  17. void releaseConfigFile(ConfigFileMetadata configFileMetadata);

如何基于 polaris-java 客户端完成一个配置拉取和操作的程序