依賴的jar

理論上Dubbo可以只依賴JDK，不依賴於任何三方庫執行，只需配置使用JDK相關實現策略。

預設依賴（系統預設）

通過mvn dependency:tree > dep.log命令（Eclipse或Linux命令列）分析，Dubbo預設依賴以下三方庫：

INFO] +- com.alibaba:dubbo:jar:2.1.2:compile
[INFO] |  +- log4j:log4j:jar:1.2.16:compile 
[INFO] |  +- org.javassist:javassist:jar:3.15.0-GA:compile
[INFO] |  +- org.springframework:spring:jar:2.5.6.SEC03:compile
[INFO] |  +- commons-logging:commons-logging:jar:1.1.1:compile
[INFO] |  \- org.jboss.netty:netty:jar:3.2.5.Final:compile
 

這裡所有依賴都是換照Dubbo預設配置選的，這些預設值是基於穩定性和效能考慮的。 
log4j.jar和commons-logging.jar日誌輸出包： 
可以直接去掉，dubbo本身的日誌會自動切換為JDK的java.util.logging輸出。但如果其它三方庫比如spring.jar間接依賴commons-logging，則不能去掉。 
javassist.jar 位元組碼生成： 
如果或，以及，則不需要。 
spring.jar 配置解析： 
如果用ServiceConfig和ReferenceConfig的API呼叫，則不需要。 
netty.jar 網路傳輸： 
如果或，則換成mina.jar或grizzly.jar。如果，則不需要。

Dubbo配置說明

xml配置

所有配置項分為三大類，如下： 
服務發現：表示該配置項用於服務的註冊與發現，目的是讓消費方找到提供方。 
服務治理：表示該配置項用於治理服務間的關係，或為開發測試提供便利條件。 
效能調優：表示該配置項用於調優效能，不同的選項對效能會產生影響。 
所有配置最終都將轉換為URL表示，並由服務提供方生成，經註冊中心傳遞給消費方，各屬性對應URL的引數，URL格式如下： 
protocol://username:[email protected]:port/path?key=value&key=value

服務提供方<dubbo:service />

服務發現類 
1、interface 
dubbo服務暴露的介面全路徑，例如：<dubbo:service interface="com.dubbo.service.UserService" /> 
2、ref 
dubbo服務暴露的介面的實現類例如：

<bean id="userService" class="com.dubbo.service.impl.UserServiceImpl" />
<dubbo:service interface="com.dubbo.service.UserService" ref="userServie" />

3、version 
服務版本號，服務提供方和服務消費方的version務必保持一致 
4、group 
服務分組，當一個介面有多個實現，可以用分組區分配置類：com.alibaba.dubbo.config.ServiceConfig 
服務治理類 
1、stub 
設為true，表示使用預設代理類名，即：介面名 + Local字尾，服務介面客戶端本地代理類名，用於在客戶端執行本地邏輯，如本地快取等，該本地代理類的建構函式必須允許傳入遠端代理物件，建構函式如：public XxxServiceLocal(XxxService xxxService) 
2、mock 
設為true，表示使用預設Mock類名，即：介面名 + Mock字尾，服務介面呼叫失敗Mock實現類，該Mock類必須有一個無參建構函式，與Local的區別在於，Local總是被執行，而Mock只在出現非業務異常(比如超時，網路異常等)時執行，Local在遠端呼叫之前執行，Mock在遠端呼叫後執行。 
3、token 
令牌驗證，為空表示不開啟，如果為true，表示隨機生成動態令牌，否則使用靜態令牌，令牌的作用是防止消費者繞過註冊中心直接訪問，保證註冊中心的授權功能有效，如果使用點對點呼叫，需關閉令牌功能 
4、registry 
向指定註冊中心註冊，在多個註冊中心時使用，值為<dubbo:registry>的id屬性，多個註冊中心ID用逗號分隔，如果不想將該服務註冊到任何registry，可將值設為N/A 
5、provider 
指定provider，值為<dubbo:provider>的id屬性 
6、deprecate 
服務是否過時，如果設為true，消費方引用時將列印服務過時警告error日誌 
7、dynamic 
服務是否動態註冊，如果設為false，註冊後將顯示後disable狀態，需人工啟用，並且服務提供者停止時，也不會自動取消冊，需人工禁用。 
8、accesslog 
設為true，將向logger中輸出訪問日誌，也可填寫訪問日誌檔案路徑，直接把訪問日誌輸出到指定檔案 
9、owner 
服務負責人，用於服務治理，請填寫公司郵箱字首 
10、protocol 
使用指定的協議暴露服務，在多協議時使用，值為<dubbo:protocol>的id屬性，多個協議ID用逗號分隔，可以有dubbo/hessian/rmi/thrift/redis等，後面會詳細介紹每種協議 
11、register 
該協議的服務是否註冊到註冊中心 
服務調優類 
1、delay 
延遲註冊服務時間(毫秒) ，設為-1時，表示延遲到Spring容器初始化完成時暴露服務 
2、timeout 
遠端呼叫服務超時時間，如果客戶端服務端都配置了以客戶端為準，客戶端沒配以服務端為準，單位毫秒預設1000 
3、retries 
遠端服務呼叫重試次數，不包括第一次呼叫，不需要重試請設為0，預設2 
4、connections 
對每個提供者的最大連線數，rmi、http、hessian等短連線協議表示限制連線數，dubbo等長連線協表示建立的長連線個數，預設100 
5、loadbalance 
負載均衡策略，random,roundrobin,leastactive，分別表示：隨機，輪循，最少活躍呼叫 
6、async 
是否預設非同步執行，不可靠非同步，只是忽略返回值，不阻塞執行執行緒 
7、weigth 
服務權重，結合負載均衡策略使用 
8、executes 
服務提供者每服務每方法最大可並行執行請求數 
9、actives 
每服務消費者每服務每方法最大併發呼叫數 
10、proxy 
生成動態代理方式，可選：jdk/javassist 
11、cluster 
叢集方式，可選： 
【failover】 
失敗自動切換，當出現失敗，重試其他伺服器（預設），通常用於讀操作，但重試會帶來更長的延時，可通過retries=“2”來設定重試次數（不含第一次）

<dubbo:service retries="2"> 

或者

<dubbo:reference retries="2"> 

或者

<dubbo:reference> 
   <dubbo:method name="findFoo" retries=2> 
<dubbo:reference/> 

【failfast】 
快速失效，只發起一次呼叫，失敗立即報錯。通常用於非冪等性寫操作，比如說新增記錄

<dubbo:service cluster="failfast"> 

或者

<dubbo:reference cluster="failfast"

【failsafe】 
失敗安全，出現異常時，直接忽略，通常用於寫入審計日誌等操作

<dubbo:service cluster="failsafe"> 

或者

<dubbo:reference cluster="failsafe">

【failback】 
失敗自動恢復，後臺記錄失敗請求，定時重發，通常用於訊息通知操作

<dubbo:service cluster="failback"> 

或者

<dubbo:reference cluster="failback">

【forking】 
並行呼叫多個伺服器，只要一個成功即返回。通常用於實時性要求較高的讀操作，但需要浪費更多的伺服器資源。可通過forks=“2”來設定最大並行數。

<dubbo:service cluster="forking"> 

或者

<dubbo:reference cluster="forking">

12、filter 
服務提供方遠端呼叫過程攔截器名稱，多個名稱用逗號分隔，Spring攔截器可以攔截Web介面，無法攔截dubbo介面，但是dubbo提供了Filter擴充套件 
13、listener 
服務提供方匯出服務監聽器名稱，多個名稱用逗號分隔

服務消費方<dubbo:reference />

配置類：com.alibaba.dubbo.config.ReferenceConfig 
服務發現類 
1、id 
服務引用Bean的id，例如

<dubbo:reference id=“xxxService” interface=“com.xxx.XxxService” /> <!-- 增加引用遠端服務配置 -->
<bean id=“xxxAction” class=“com.xxx.XxxAction”> <!-- 和本地服務一樣使用遠端服務 -->
    <property name=“xxxService” ref=“xxxService” />
</bean>

2、interface 
服務介面全路徑，例子同上 
3、version 
版本號，與服務提供者保持一致 
4、group 
服務分組，當一個介面有多個實現，可以用分組區分，必需和服務提供方一致 
5、registry 
從指定註冊中心註冊獲取服務列表，在多個註冊中心時使用，值為<dubbo:registry>的id屬性，多個註冊中心ID用逗號分隔

服務治理類 
1、generic 
是否預設泛化介面，如果為泛化介面，將返回GenericService 
2、check 
啟動時檢查提供者是否存在，true報錯，false忽略 
3、url 
點對點直連服務提供者地址，將繞過註冊中心 
4、stub 
服務介面客戶端本地代理類名，用於在客戶端執行本地邏輯，如本地快取等，該本地代理類的建構函式必須允許傳入遠端代理物件，建構函式如：public XxxServiceLocal(XxxService xxxService) 
5、mock 
服務介面呼叫失敗Mock實現類名，該Mock類必須有一個無參建構函式，與Local的區別在於，Local總是被執行，而Mock只在出現非業務異常(比如超時，網路異常等)時執行，Local在遠端呼叫之前執行，Mock在遠端呼叫後執行 
6、cache 
以呼叫引數為key，快取返回結果，可選：lru, threadlocal, jcache等 
7、validation 
是否啟用JSR303標準註解驗證，如果啟用，將對方法引數上的註解進行校驗 
8、layer 
layer服務呼叫者所在的分層。如：biz、dao、intl:web、china:acton 
9、protocol 
只調用指定協議的服務提供方，其它協議忽略

服務調優類 
1、timeout 
服務呼叫超時時間，如果客戶端配置以客戶端為準 
2、retries 
遠端服務呼叫重試次數，不包括第一次呼叫，不需要重試請設為0 
3、connections 
對每個提供者的最大連線數，rmi、http、hessian等短連線協議表示限制連線數，dubbo等長連線協表示建立的長連線個數 
4、loadbalance 
負載均衡策略，可選值：random,roundrobin,leastactive，分別表示：隨機，輪循，最少活躍呼叫 
5、async 
是否非同步執行，不可靠非同步，只是忽略返回值，不阻塞執行執行緒 
6、proxy 
選擇動態代理實現策略，可選：javassist, jdk 
7、client 
客戶端傳輸型別設定，如Dubbo協議的netty或mina 
8、actives 
每服務消費者每服務每方法最大併發呼叫數 
9、cluster 
叢集方式，可選： 
【failover】 
失敗自動切換，當出現失敗，重試其他伺服器（預設），通常用於讀操作，但重試會帶來更長的延時，可通過retries=“2”來設定重試次數（不含第一次）

<dubbo:service retries="2"> 

或者

<dubbo:reference retries="2"> 

 或者

<dubbo:reference> 
   <dubbo:method name="findFoo" retries=2> 
<dubbo:reference/> 

 【failfast】 
快速失效，只發起一次呼叫，失敗立即報錯。通常用於非冪等性寫操作，比如說新增記錄

<dubbo:service cluster="failfast"> 

或者

<dubbo:reference cluster="failfast"

【failsafe】 
失敗安全，出現異常時，直接忽略，通常用於寫入審計日誌等操作

<dubbo:service cluster="failsafe"> 

或者

<dubbo:reference cluster="failsafe">

 【failback】

失敗自動恢復，後臺記錄失敗請求，定時重發，通常用於訊息通知操作

<dubbo:service cluster="failback"> 

或者

<dubbo:reference cluster="failback">

【forking】 
並行呼叫多個伺服器，只要一個成功即返回。通常用於實時性要求較高的讀操作，但需要浪費更多的伺服器資源。可通過forks=“2”來設定最大並行數。

<dubbo:service cluster="forking"> 

或者

<dubbo:reference cluster="forking">

10、filter 
服務消費方遠端呼叫過程攔截器名稱，多個名稱用逗號分隔 
11、listener 
服務消費方引用服務監聽器名稱，多個名稱用逗號分隔 
12、init 
是否在afterPropertiesSet()時飢餓初始化引用，否則等到有人注入或引用該例項時再初始化。

服務提供方<dubbo:protocol/>

配置類：com.alibaba.dubbo.config.ProtocolConfig 
說明：如果需要支援多協議，可以宣告多個<dubbo:protocol>標籤，並在<dubbo:service>中通過protocol屬性指定使用的協議。 
服務發現類 

1、id 
協議BeanId，可以在<dubbo:service protocol="">中引用此ID，如果ID不填，預設和name屬性值一樣，重複則在name後加序號 
2、port 
dubbo協議預設埠為20880，rmi協議預設埠為1099，http和hessian協議預設埠為80 如果配置為-1 或者 沒有配置port，則會分配一個沒有被佔用的埠。Dubbo 2.4.0+，分配的埠在協議預設埠的基礎上增長，確保埠段可控； 
3、host 
預設查詢本機IP，服務主機名，多網絡卡選擇或指定VIP及域名時使用，為空則自動查詢本機IP，-建議不要配置，讓Dubbo自動獲取本機IP 
4、path 
提供者上下文路徑，為服務path的字首

服務治理類 
1、accesslog 
設為true，將向logger中輸出訪問日誌，也可填寫訪問日誌檔案路徑，直接把訪問日誌輸出到指定檔案 
2、telnet 
所支援的telnet命令，多個命令用逗號分隔 
3、register 
該協議的服務是否註冊到註冊中心服務調優類 
1、name 
協議名稱,支援常見的傳輸協議：RMI、Dubbo、Hessain、WebService、Http等 
2、threadpool 
預設fixed,執行緒池型別，可選：fixed/cached 
3、threads 
服務執行緒池大小(固定大小) 
4、iothreads 
io執行緒池大小(固定大小) 
5、accepts 
服務提供方最大可接受連線數 
6、payload 
請求及響應資料包大小限制，單位：位元組，預設值88388608(=8M) 
7、codec 
協議編碼方式 
8、serialization 
dubbo協議預設為hessian2，rmi協議預設為java，http協議預設為json；協議序列化方式，當協議支援多種序列化方式時使用，比如：dubbo協議的dubbo,hessian2,java,compactedjava，以及http協議的json等 
9、transporter 
協議的服務端和客戶端實現型別，比如：dubbo協議的mina,netty等，可以分拆為server和client配置 
10、server 
協議的伺服器端實現型別，比如：dubbo協議的mina,netty等，http協議的jetty,servlet等 
11、client 
協議的客戶端實現型別，比如：dubbo協議的mina,netty等 
12、dispather** 
協議的訊息派發方式，用於指定執行緒模型，比如：dubbo協議的all, direct, message, execution, connection等 
13、queues 
執行緒池佇列大小，當執行緒池滿時，排隊等待執行的佇列大小，建議不要設定，當執行緒程池時應立即失敗，重試其它服務提供機器，而不是排隊，除非有特殊需求。 
14、charset 
序列化編碼 
15、buffer 
網路緩衝區大小 
16、heartbeat 
心跳間隔，對於長連線，當物理層斷開時，比如拔網線，TCP的FIN訊息來不及傳送，對方收不到斷開事件，此時需要心跳來幫助檢查連線是否已斷開

註冊中心配置<dubbo:registry/>

配置類：com.alibaba.dubbo.config.RegistryConfig 
說明：如果有多個不同的註冊中心，可以宣告多個<dubbo:registry>標籤，並在<dubbo:service>或<dubbo:reference>的registry屬性指定使用的註冊中心 
服務發現類 

1、id 
註冊中心引用BeanId，可以在<dubbo:service registry="">或<dubbo:reference registry="">中引用此ID 1.0.16以上版本 
2、address 
註冊中心伺服器地址，如果地址沒有埠預設為9090，同一叢集內的多個地址用逗號分隔，如：ip:port,ip:port，不同叢集的註冊中心，請配置多個 
3、protocol 
注同中心地址協議，支援dubbo, http, local三種協議，分別表示，dubbo地址，http地址，本地註冊中心 
4、port 
註冊中心預設埠，當address沒有帶埠時使用此埠做為預設值

服務治理類 
1、username 
登入註冊中心使用者名稱，如果註冊中心不需要驗證可不填 
2、password 
登入註冊中心密碼，如果註冊中心不需要驗證可不填 
3、file 
使用檔案快取註冊中心地址列表及服務提供者列表，應用重啟時將基於此檔案恢復，注意：兩個註冊中心不能使用同一檔案儲存 
4、check 
註冊中心不存在時，是否報錯 
5、 register 
是否向此註冊中心註冊服務，如果設為false，將只訂閱，不註冊 
6、subscribe 
是否向此註冊中心訂閱服務，如果設為false，將只註冊，不訂閱 
7、dynamic 
服務是否動態註冊，如果設為false，註冊後將顯示後disable狀態，需人工啟用，並且服務提供者停止時，也不會自動取消冊，需人工禁用。

服務調優類 
1、transport 
網路傳輸方式，可選mina,netty 
2、timeout 
註冊中心請求超時時間(毫秒) 
3、session 
註冊中心會話超時時間(毫秒)，用於檢測提供者非正常斷線後的髒資料，比如用心跳檢測的實現，此時間就是心跳間隔，不同註冊中心實現不一樣 
4、wait 
停止時等待通知完成時間(毫秒)

監控中心配置<dubbo:monitor/>

服務治理類 
1、protocol 
監控中心協議，如果為protocol=”registry”，表示從註冊中心發現監控中心地址，否則直連監控中心 
2、address 
直連監控中心伺服器地址，address=”10.20.130.230:12080”

服務提供者預設值配置<dubbo:provider/>

配置類：com.alibaba.dubbo.config.ProviderConfig 
說明：該標籤為<dubbo:service>和<dubbo:protocol>標籤的預設值設定。具體配置可以參考<dubbo:service>和<dubbo:protocol>配置

方法級配置<dubbo:method/>

配置類：com.alibaba.dubbo.config.MethodConfig 
說明：該標籤為<dubbo:service>或<dubbo:reference>的子標籤，用於控制到方法級， 
服務發現類 
1、name 
方法名 
服務治理類 
1.deprecated 
服務方法是否過時，此屬性只在<dubbo:method>作為<dubbo:service>子標籤時有效 
2、sticky 
該介面上的所有方法使用同一個provider.如果需要更復雜的規則，請使用用路由 
3、cache 
以呼叫引數為key，快取返回結果，可選：lru, threadlocal, jcache等 
4、validation 
是否啟用JSR303標準註解驗證，如果啟用，將對方法引數上的註解 
服務調優類 
1、timeout 
方法呼叫超時時間(毫秒) 
2、retries 
預設為<dubbo:reference>的retries，遠端服務呼叫重試次數，不包括第一次呼叫，不需要重試請設為0 
3、loadbalance 
負載均衡策略，可選值：random,roundrobin,leastactive，分別表示：隨機，輪循，最少活躍呼叫 
4、async 
是否非同步執行，不可靠非同步，只是忽略返回值，不阻塞執行執行緒 
5、sent 
非同步呼叫時，標記sent=true時，表示網路已發出資料 
6、actives 
每服務消費者最大併發呼叫限制 
7、executes 
每服務每方法最大使用執行緒數限制- -，此屬性只在<dubbo:method>作為<dubbo:service>子標籤時有效 
8、return 
方法呼叫是否需要返回值,async設定為true時才生效，如果設定為true，則返回future，或回撥onreturn等方法，如果設定為false，則請求傳送成功後直接返回Null 
9、oninvoke 
方法執行前攔截 
10、onreturn 
方法執行返回後攔截 
11、onthrow 
方法執行有異常攔截 
例如

<dubbo:reference interface="com.xxx.XxxService">
    <dubbo:method name="findXxx" timeout="3000" retries="2" />
</dubbo:reference>

方法引數配置<dubbo:argument/>

配置類：com.alibaba.dubbo.config.ArgumentConfig 
說明：該標籤為<dubbo:method>的子標籤，用於方法引數的特徵描述，比如：

<dubbo:method name="findXxx" timeout="3000" retries="2">
    <dubbo:argument index="0" callback="true" />
<dubbo:method>

1、index 
方法名 
2、type 
通過引數型別查詢引數的index 
3、callback 
引數是否為callback介面，如果為callback，服務提供方將生成反向代理，可以從服務提供方反向呼叫消費方，通常用於事件推送

選項引數配置<dubbo:parameter/>

配置類：java.util.Map 
說明：該標籤為<dubbo:protocol>或<dubbo:service>或<dubbo:provider>或<dubbo:reference>或<dubbo:consumer>的子標籤，用於配置自定義引數，該配置項將作為擴充套件點設定自定義引數使用。 
1、key 
路由引數鍵 
2、value 
路由引數值 
例如：

<dubbo:protocol name="napoli">
    <dubbo:parameter key="http://10.20.160.198/wiki/display/dubbo/napoli.queue.name" value="xxx" />
</dubbo:protocol>
<!-- 或者 -->
<dubbo:protocol name="jms" p:queue="xxx" />

<dubbo:protocol name="napoli">
    <dubbo:parameter key="http://10.20.160.198/wiki/display/dubbo/napoli.queue.name" value="xxx" />
</dubbo:protocol>
<!-- 或者 -->
<dubbo:protocol name="jms" p:queue="xxx" />