編輯時間2018.10.12 20.20

最新的文件檢視< wiki - Java客戶端使用指南 >   

一.客戶端使用步驟:

步驟1.新增配置

1.1必須配置

app.id=spring-boot-logger  
apollo.meta=http://139.199.193.xxx:8761 

說明:
app.id應用Id
apollo.meta為apollo元服務地址.因為edp的元服務分離到獨立的eureka地址上面去.故此次寫eureka地址即可

1.2非必須配置

在bootstrap階段注入非預設application namespace或多個namespace.使用方式很簡單，只需要在application.properties/bootstrap.properties中按照如下樣例配置即可。

<!-- 多個namespace-->
apollo.bootstrap.enabled = true  
apollo.bootstrap.namespaces = application,FX.apollo

說明:
FX.apollo指fx部門編碼.
apollo為部門下的專案配置.此處僅為舉例說明.實際請以具體配置為準

步驟2. 新增Maven Dependency

Apollo的客戶端jar包已經上傳到中央倉庫，應用在實際使用時只需要按照如下方式引入即可。如:

<!-- apollo -->
      <dependency>
        <groupId>com.ctrip.framework.apollo</groupId>
        <artifactId>apollo-client</artifactId>
        <version>${apollo.version}</version>
      </dependency>
 

步驟3.啟動專案驗證.

二.功能說明:

1.是否具體快取:具備

Apollo客戶端會把從服務端獲取到的配置在本地檔案系統快取一份，用於在遇到服務不可用，或網路不通的時候，依然能從本地恢復配置，不影響應用正常執行。(這時候配置是讀本地的配置)

本地快取路徑預設位於以下路徑，所以請確保/opt/data或C:\opt\data\目錄存在，且應用有讀寫許可權。

Mac/Linux: /opt/data/{appId}/config-cache
Windows: C:\opt\data\{appId}\config-cache

本地配置檔案會以下面的檔名格式放置於本地快取路徑下：

{appId}+{cluster}+{namespace}.properties

appId就是應用自己的appId，如100004458
cluster就是應用使用的叢集，一般在本地模式下沒有做過配置的話，就是default
namespace就是應用使用的配置namespace，一般是application
參考 官方文件 1.2.3 本地快取路徑
參考 官方文件 1.2.3.1 自定義快取路徑

2.是否具備恢復:不具備

apollo不具備自動恢復功能.但可以通過人為的去快取獲取配置.在貼上到apollo
參考 官方文件 3.2.4 已有配置遷移

3.是否覆蓋:會覆蓋

如果本地application.yml有一個key(keyName=local),apollo也有一個key(keyName=apollo),那麼獲取值時:keyName=apollo

參考 官方文件:https://github.com/ctripcorp/apollo/wiki/Java客戶端使用指南