大家好，今天開始為大家帶來我們通用產品團隊的產品 —— diamond的專題，本次為大家介紹diamond的概況和快速使用。

一、概況

diamond是淘寶內部使用的一個管理持久配置的系統，它的特點是簡單、可靠、易用，目前淘寶內部絕大多數系統的配置，由diamond來進行統一管理。

diamond為應用系統提供了獲取配置的服務，應用不僅可以在啟動時從diamond獲取相關的配置，而且可以在執行中對配置資料的變化進行感知並獲取變化後的配置資料。

持久配置是指配置資料會持久化到磁碟和資料庫中。

diamond的特點是簡單、可靠、易用：

簡單：整體結構非常簡單，從而減少了出錯的可能性。

可靠：應用方在任何情況下都可以啟動，在承載淘寶核心系統並正常執行一年多以來，沒有出現過任何重大故障。

易用：客戶端使用只需要兩行程式碼，暴露的介面都非常簡單，易於理解。

二、快速使用

1、原始碼檢出

從以下svn地址檢出diamond的原始碼：

2、server的搭建

（1）mysql

安裝mysql-server的步驟請參考mysql官方文件，安裝完畢後，以root使用者登入，建立使用者並賦予許可權，建立資料庫，然後建表，語句分別如下：

create database diamond;

grant all on diamond.* to [email protected]

use diamond

create table config_info (

'id' bigint(64) unsigned NOT NULL auto_increment,

'data_id' varchar(255) NOT NULL default ' ',

'group_id' varchar(128) NOT NULL default ' ',

'content' longtext NOT NULL,

'md5' varchar(32) NOT NULL default ' ',

'gmt_create' datetime NOT NULL default '2010-05-05 00:00:00',

'gmt_modified' datetime NOT NULL default '2010-05-05 00:00:00',

PRIMARY KEY  ('id'),

UNIQUE KEY 'uk_config_datagroup' ('data_id','group_id')

);

完成後，請將資料庫的配置資訊（IP，使用者名稱，密碼）新增到diamond-server工程的src/resources/jdbc.properties檔案中的db.url，db.user，db.password屬性上面，這裡建立的庫名，使用者名稱和密碼，必須和jdbc.properties中對應的屬性相同。

（2）tomcat

tomcat是diamond server的執行容器。

tomcat的安裝請參考tomcat官方文件，建議使用tomcat7

不需要對tomcat進行任何改動。

（3）diamond server

在diamond-server原始碼根目錄下，執行mvn clean package -Dmaven.test.skip，成功後會在diamond-server/target目錄下生成diamond-server.war（如果沒有安裝maven，請參考maven官方文件進行安裝）。

打包完成後，將diamond-server.war放在tomcat的webapps目錄下。

啟動tomcat，即啟動了diamond-server

（4）http server

http server用來存放diamond server等地址列表，可以選用任何http server，這裡以tomcat為例。

一般來講，http server和diamond server是部署在不同機器上的，這裡簡單起見，將二者部署在同一個機器下的同一個tomcat的同一個應用中，注意，如果部署在不同的tomcat中，埠號一定是8080，不能修改（所以必須部署在不同的機器上）。

在（3）的tomcat的webapps中的diamond-server中建立檔案diamond，檔案內容是diamond-server的地址列表，一行一個地址，地址為IP，例如：

127.0.0.1

完成以上4步後，server端的搭建就完成了。

2、釋出資料

diamond釋出資料通過手工的方式進行。

在瀏覽器中輸入http://ip:8080/diamond-server/，ip為server搭建的第（2）步中的地址，以user為使用者名稱，123為密碼，登入後進入後臺管理介面，然後點選“配置資訊管理”—— “新增配置資訊”，在輸入框中輸入dataId、group、內容，最後點選“提交”即可。

成功後，可以在“配置資訊管理”中查詢到釋出的資料。

3、訂閱資料

diamond客戶端API主要提供了訂閱資料的功能.

（1）客戶端獲取服務端地址

獲取服務端地址對客戶端是透明的，客戶端僅僅需要在本地進行如下域名繫結即可：

ip    a.b.c

ip為前面搭建的http-server的ip

（2）建立訂閱者

DiamondManager manager = new DefaultDiamondManager(group, dataId, new ManagerListener() {

public Executor getExecutor() {

return null;

}

public void receiveConfigInfo(String configInfo) {

// 客戶端處理資料的邏輯

}

});

引數的說明：

group和dataId為String型別，二者結合為diamond-server端儲存資料的惟一key

ManagerListener 是客戶端註冊的資料監聽器， 它的作用是在執行中接受變化的配置資料，然後回撥receiveConfigInfo()方法，執行客戶端處理資料的邏輯。如果要在執行中對變化的配置資料進行處理，就一定要註冊ManagerListener

（3）獲取配置資料

String configInfo = manager.getAvailableConfigureInfomation(timeout);

diamond-server端儲存的配置全都為文字型別，返回給客戶端的配置資料為java.lang.String型別，timeout為從網路獲取配置資料的超時時間。客戶端呼叫每次呼叫該方法，都能夠保證獲取一份最新的可用的配置資料。