在上一篇文章Disconf實踐指南：安裝篇介紹瞭如何在本地搭建Disconf環境，下面我們介紹如何在專案中使用Disconf。由於某些功能特性對原始碼做了修改，所以在官方文件並沒有提及。

環境基於macOS Sirerra。Windows建議安裝Linux虛擬機器

首先開啟disconf控制檯：http://localhost:8091，第一步：建立應用，awesome-project（自定）；第二步：建立配置檔案。建立後應用和配置檔案資訊如下：

以一個簡單的例子演示如何使用Disconf：

假如應用有一個redis.properties配置檔案，內容如下：

redis.host=128.0.0.1
redis.port=6379
  

   
1
   
2
  

在disconf控制檯選中剛才你建立的應用，再選擇新建->新建配置檔案:

建立後就可以在主介面看到剛才建立的redis.properties檔案了。啟動要接入disconf的應用有四部曲：

1、新增Maven依賴:

<dependency>
    <groupId>com.baidu.disconf</groupId>
    <artifactId>disconf-client</artifactId>
 

    <version>2.6.35</version>
</dependency>
  

   
1
   
2
   
3
   
4
   
5
  

2、建立disconf.properties

# 是否使用遠端配置檔案
# true(預設)會從遠端獲取配置 false則直接獲取本地配置
disconf.enable.remote.conf=true

# 配置伺服器的 HOST,用逗號分隔  127.0.0.1:8000,127.0.0.1:8000
disconf.conf_server_host=127.0.0.1:8091

# 版本, 請採用 X_X_X_X 格式
disconf.version
 
=1_0_0_0

# APP 請採用 產品線_服務名 格式
disconf.app=springboot-learning-example

# 環境
disconf.env=rd

# debug
disconf.debug=true

# 忽略哪些分散式配置，用逗號分隔
disconf.ignore=

# 獲取遠端配置 重試次數，預設是3次
disconf.conf_server_url_retry_times=1

# 獲取遠端配置 重試時休眠時間，預設是5秒
disconf.conf_server_url_retry_sleep_seconds=1

# 應用本身的配置檔案
disconf.app_conf_files_name=app.properties

# 開關配置
disconf.app_commom_files_name=common.properties
  

   
1
   
2
   
3
   
4
   
5
   
6
   
7
   
8
   
9
   
10
   
11
   
12
   
13
   
14
   
15
   
16
   
17
   
18
   
19
   
20
   
21
   
22
   
23
   
24
   
25
   
26
   
27
   
28
   
29
   
30
   
31
   
32
   
33
  

3、建立disconf.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:aop="http://www.springframework.org/schema/aop"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop.xsd">

    <!-- 使用disconf必須新增以下配置 -->
    <bean id="disconfMgrBean" class="com.baidu.disconf.client.DisconfMgrBean"
          destroy-method="destroy">
        <!-- 專案要被disconf掃描的包路徑，多個路徑逗號隔開 -->
        <property name="scanPackage" value="com.rhwayfun.springboot"/>
    </bean>
    <bean id="disconfMgrBean2" class="com.baidu.disconf.client.DisconfMgrBeanSecond"
          init-method="init" destroy-method="destroy">
    </bean>

    <!-- 使用託管方式的disconf配置(無程式碼侵入, 配置更改會自動reload)-->
    <bean id="configproperties_disconf"
          class="com.baidu.disconf.client.addons.properties.ReloadablePropertiesFactoryBean">
        <property name="locations">
            <list>
                <value>classpath*:app.properties</value>
            </list>
        </property>
    </bean>

    <bean id="propertyConfigurer"
          class="com.baidu.disconf.client.addons.properties.ReloadingPropertyPlaceholderConfigurer">
        <property name="ignoreResourceNotFound" value="true"/>
        <property name="ignoreUnresolvablePlaceholders" value="true"/>
        <property name="propertiesArray">
            <list>
                <ref bean="configproperties_disconf"/>
            </list>
        </property>
    </bean>

    <aop:aspectj-autoproxy proxy-target-class="true"/>

</beans>

  

   
1
   
2
   
3
   
4
   
5
   
6
   
7
   
8
   
9
   
10
   
11
   
12
   
13
   
14
   
15
   
16
   
17
   
18
   
19
   
20
   
21
   
22
   
23
   
24
   
25
   
26
   
27
   
28
   
29
   
30
   
31
   
32
   
33
   
34
   
35
   
36
   
37
   
38
   
39
   
40
  

4、redis.properties配置監聽

package com.rhwayfun.springboot.disconf;

import com.baidu.disconf.client.common.annotations.DisconfFile;
import com.baidu.disconf.client.common.annotations.DisconfFileItem;
import com.baidu.disconf.client.common.annotations.DisconfUpdateService;
import com.baidu.disconf.client.common.update.IDisconfUpdate;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.context.annotation.Scope;
import org.springframework.stereotype.Service;

/**
 * Created by rhwayfun on 2017/6/18.
 */
@Service
@Scope("singleton")
@DisconfFile(filename = "redis.properties")
@DisconfUpdateService(classes = {JedisConfig.class})
public class JedisConfig implements IDisconfUpdate {

    /** Logger */
    private static Logger log = LoggerFactory.getLogger(JedisConfig.class);

    // 代表連線地址
    private String host;

    // 代表連線port
    private int port;

    /**
     * 地址, 分散式檔案配置
     *
     * @return
     */
    @DisconfFileItem(name = "redis.host", associateField = "host")
    public String getHost() {
        return host;
    }

    public void setHost(String host) {
        this.host = host;
    }

    /**
     * 埠, 分散式檔案配置
     *
     * @return
     */
    @DisconfFileItem(name = "redis.port", associateField = "port")
    public int getPort() {
        return port;
    }

    public void setPort(int port) {
        this.port = port;
    }

    /**
     * 每次更新分散式配置都會調reload方法
     *
     * @throws Exception
     */
    @Override
    public void reload() throws Exception {
        log.info(">>>>>>>>>host: " + host);
    }

}

  

   
1
   
2
   
3
   
4
   
5
   
6
   
7
   
8
   
9
   
10
   
11
   
12
   
13
   
14
   
15
   
16
   
17
   
18
   
19
   
20
   
21
   
22
   
23
   
24
   
25
   
26
   
27
   
28
   
29
   
30
   
31
   
32
   
33
   
34
   
35
   
36
   
37
   
38
   
39
   
40
   
41
   
42
   
43
   
44
   
45
   
46
   
47
   
48
   
49
   
50
   
51
   
52
   
53
   
54
   
55
   
56
   
57
   
58
   
59
   
60
   
61
   
62
   
63
   
64
   
65
   
66
   
67
   
68
   
69
  

這裡有幾個關鍵點：

介面IDisconfUpdate：需要監聽的服務都要實現該介面
註解@DisconfFile：指定分散式配置檔案，就是剛才控制檯建立的redis.properties
註解@DisconfUpdateService：標識配置更新時需要進行更新的服務，需要指定它影響的配置資料，可以是配置檔案或者是配置項，比如這裡JedisConfig
註解@DisconfFileItem：分散式的配置檔案中的key，比如redis.host

啟動專案，成功後重新整理disconf控制檯，在例項列表就會出現你本地的機器了。disconf會自動幫程式獲取控制檯的配置了。

下面修改disconf控制檯的redis.properties，將host改為127.0.0.1，觀察IDEA控制檯日誌輸出：

發現配置確實變更了，而且是實時重新整理。至此在專案中使用disconf就接入完成了，接下來要做的是移除所有專案配置（properties檔案），統一由disconf管理，並且讓disconf支援公共配置。

在上一篇文章Disconf實踐指南：安裝篇介紹瞭如何在本地搭建Disconf環境，下面我們介紹如何在專案中使用Disconf。由於某些功能特性對原始碼做了修改，所以在官方文件並沒有提及。