原文地址：http://dubbo.io/User+Guide-zh.htm#UserGuide-zh-協(xié)議參考手冊
協(xié)議參考手冊
(
+) (
#)
推薦使用Dubbo協(xié)議
性能測試報告
各協(xié)議的性能情況，請參見：
性能測試報告 (
+)
dubbo://
(
+) (
#)
Dubbo缺省協(xié)議采用單一長連接和NIO異步通訊，適合于小數(shù)據(jù)量大并發(fā)的服務調用，以及服務消費者機器數(shù)遠大于服務提供者機器數(shù)的情況。
Dubbo缺省協(xié)議不適合傳送大數(shù)據(jù)量的服務，比如傳文件，傳視頻等，除非請求量很低。
[html]
<dubbo:protocol name="dubbo" port="20880"/>
Set default protocol:
[html]
<dubbo:provider protocol="dubbo"/>
Set service protocol:
[html]
<dubbo:service protocol="dubbo"/>
Multi port:
[html]
<dubbo:protocol id="dubbo1" name="dubbo" port="20880"/>
<dubbo:protocol id="dubbo2" name="dubbo" port="20881"/>
Dubbo protocol options:
[html]
<dubbo:protocol name=“dubbo” port=“9090” server=“netty” client=“netty” codec=“dubbo” serialization=“hessian2” charset=“UTF-8” threadpool=“fixed” threads=“100” queues=“0” iothreads=“9” buffer=“8192” accepts=“1000” payload=“8388608” />
Transportermina, netty, grizzy
Serializationdubbo, hessian2, java, json
Dispatcherall, direct, message, execution, connection
ThreadPoolfixed, cached
Dubbo協(xié)議缺省每服務每提供者每消費者使用單一長連接，如果數(shù)據(jù)量較大，可以使用多個連接。
[html]
<dubbo:protocol name="dubbo"connections="2"/>
<dubbo:service connections=”0”>或<dubbo:reference connections=”0”>表示該服務使用JVM共享長連接。(缺省)
<dubbo:service connections=”1”>或<dubbo:reference connections=”1”>表示該服務使用獨立長連接。
<dubbo:service connections=”2”>或<dubbo:reference connections=”2”>表示該服務使用獨立兩條長連接。
為防止被大量連接撐掛，可在服務提供方限制大接收連接數(shù)，以實現(xiàn)服務提供方自我保護。
[html]
<dubbo:protocol name="dubbo" accepts="1000"/>
缺省協(xié)議，使用基于mina1.1.7+hessian3.2.1的tbremoting交互。
連接個數(shù)：單連接
連接方式：長連接
傳輸協(xié)議：TCP
傳輸方式：NIO異步傳輸
序列化：Hessian二進制序列化
適用范圍：傳入傳出參數(shù)數(shù)據(jù)包較?。ńㄗh小于100K），消費者比提供者個數(shù)多，單一消費者無法壓滿提供者，盡量不要用dubbo協(xié)議傳輸大文件或超大字符串。
適用場景：常規(guī)遠程服務方法調用
為什么要消費者比提供者個數(shù)多：
因dubbo協(xié)議采用單一長連接，
假設網絡為千兆網卡(1024Mbit=128MByte)，
根據(jù)測試經驗數(shù)據(jù)每條連接最多只能壓滿7MByte(不同的環(huán)境可能不一樣，供參考)，
理論上1個服務提供者需要20個服務消費者才能壓滿網卡。
為什么不能傳大包：
因dubbo協(xié)議采用單一長連接，
如果每次請求的數(shù)據(jù)包大小為500KByte，假設網絡為千兆網卡(1024Mbit=128MByte)，每條連接最大7MByte(不同的環(huán)境可能不一樣，供參考)，
單個服務提供者的TPS(每秒處理事務數(shù))最大為：128MByte / 500KByte = 262。
單個消費者調用單個服務提供者的TPS(每秒處理事務數(shù))最大為：7MByte / 500KByte = 14。
如果能接受，可以考慮使用，否則網絡將成為瓶頸。
為什么采用異步單一長連接：
因為服務的現(xiàn)狀大都是服務提供者少，通常只有幾臺機器，
而服務的消費者多，可能整個網站都在訪問該服務，
比如Morgan的提供者只有6臺提供者，卻有上百臺消費者，每天有1.5億次調用，
如果采用常規(guī)的hessian服務，服務提供者很容易就被壓跨，
通過單一連接，保證單一消費者不會壓死提供者，
長連接，減少連接握手驗證等，
并使用異步IO，復用線程池，防止C10K問題。
(1) 約束：
參數(shù)及返回值需實現(xiàn)Serializable接口
參數(shù)及返回值不能自定義實現(xiàn)List, Map, Number, Date, Calendar等接口，只能用JDK自帶的實現(xiàn)，因為hessian會做特殊處理，自定義實現(xiàn)類中的屬性值都會丟失。()
Hessian序列化，只傳成員屬性值和值的類型，不傳方法或靜態(tài)變量，兼容情況：(由吳亞軍提供)數(shù)據(jù)通訊 情況 結果
A->B 類A多一種 屬性（或者說類B少一種 屬性） 不拋異常，A多的那 個屬性的值，B沒有， 其他正常
A->B 枚舉A多一種 枚舉（或者說B少一種 枚舉），A使用多 出來的枚舉進行傳輸 拋異常
A->B 枚舉A多一種 枚舉（或者說B少一種 枚舉），A不使用 多出來的枚舉進行傳輸 不拋異常，B正常接 收數(shù)據(jù)
A->B A和B的屬性 名相同，但類型不相同 拋異常
A->B serialId 不相同 正常傳輸
總結：會拋異常的情況：枚 舉值一邊多一種，一邊少一種，正好使用了差別的那種，或者屬性名相同，類型不同
接口增加方法，對客戶端無影響，如果該方法不是客戶端需要的，客戶端不需要重新部署；
輸入參數(shù)和結果集中增加屬性，對客戶端無影響，如果客戶端并不需要新屬性，不用重新部署；
輸入參數(shù)和結果集屬性名變化，對客戶端序列化無影響，但是如果客戶端不重新部署，不管輸入還是輸出，屬性名變化的屬性值是獲取不到的。
總結：服務器端和客戶端對領域對象并不需要完全一致，而是按照最大匹配原則。
(2) 配置：
dubbo.properties：
[html]
dubbo.service.protocol=dubbo
rmi://
(
+) (
#)
RMI協(xié)議采用JDK標準的java.rmi.*實現(xiàn)，采用阻塞式短連接和JDK標準序列化方式。
如果正在使用RMI提供服務給外部訪問（公司內網環(huán)境應該不會有攻擊風險），同時應用里依賴了老的common-collections包（dubbo不會依賴這個包，請排查自己的應用有沒有使用）的情況下，存在反序列化安全風險。
請檢查應用：
將commons-collections3 請升級到3.2.2版本：https://commons.apache.org/proper/commons-collections/release_3_2_2.html
將commons-collections4 請升級到4.1版本：https://commons.apache.org/proper/commons-collections/release_4_1.html
新版本的commons-collections解決了該問題
如果服務接口繼承了java.rmi.Remote接口，可以和原生RMI互操作，即：提供者用Dubbo的RMI協(xié)議暴露服務，消費者直接用標準RMI接口調用，
或者提供方用標準RMI暴露服務，消費方用Dubbo的RMI協(xié)議調用。
如果服務接口沒有繼承java.rmi.Remote接口，缺省Dubbo將自動生成一個com.xxx.XxxService$Remote的接口，并繼承java.rmi.Remote接口，并以此接口暴露服務，
但如果設置了<dubbo:protocol name="rmi" codec="spring" />，將不生成$Remote接口，而使用Spring的RmiInvocationHandler接口暴露服務，和Spring兼容。
Define rmi protocol:
[html]
<dubbo:protocol name="rmi"port="1099"/>
Set default protocol:
[html]
<dubbo:provider protocol="rmi"/>
Set service protocol:
[html]
<dubbo:service protocol="rmi"/>
Multi port:
[html]
<dubbo:protocol id="rmi1" name="rmi" port="1099"/>
<dubbo:protocol id="rmi2" name="rmi" port="2099"/>
<dubbo:service protocol="rmi1"/>
Spring compatible:
[html]
<dubbo:protocol name="rmi" codec="spring"/>
Java標準的遠程調用協(xié)議。
連接個數(shù)：多連接
連接方式：短連接
傳輸協(xié)議：TCP
傳輸方式：同步傳輸
序列化：Java標準二進制序列化
適用范圍：傳入傳出參數(shù)數(shù)據(jù)包大小混合，消費者與提供者個數(shù)差不多，可傳文件。
適用場景：常規(guī)遠程服務方法調用，與原生RMI服務互操作
(1) 約束：
參數(shù)及返回值需實現(xiàn)Serializable接口
dubbo配置中的超時時間對rmi無效，需使用java啟動參數(shù)設置：-Dsun.rmi.transport.tcp.responseTimeout=3000，參見下面的RMI配置。
(2) 配置：
dubbo.properties：
[html]
dubbo.service.protocol=rmi
(3) RMI配置：
[html]
java -Dsun.rmi.transport.tcp.responseTimeout=3000
更多RMI優(yōu)化參數(shù)請查看：
hessian://
(
+) (
#)
Hessian協(xié)議用于集成Hessian的服務，Hessian底層采用Http通訊，采用Servlet暴露服務，Dubbo缺省內嵌Jetty作為服務器實現(xiàn)。
Hessian是Caucho開源的一個RPC框架：，其通訊效率高于WebService和Java自帶的序列化。
依賴：
[html]
<dependency>
<groupId>com.caucho</groupId>
<artifactId>hessian</artifactId>
<version>4.0.7</version>
</dependency>
可以和原生Hessian服務互操作，即：
提供者用Dubbo的Hessian協(xié)議暴露服務，消費者直接用標準Hessian接口調用，
或者提供方用標準Hessian暴露服務，消費方用Dubbo的Hessian協(xié)議調用。
基于Hessian的遠程調用協(xié)議。
連接個數(shù)：多連接
連接方式：短連接
傳輸協(xié)議：HTTP
傳輸方式：同步傳輸
序列化：Hessian二進制序列化
適用范圍：傳入傳出參數(shù)數(shù)據(jù)包較大，提供者比消費者個數(shù)多，提供者壓力較大，可傳文件。
適用場景：頁面?zhèn)鬏?，文件傳輸，或與原生hessian服務互操作
(1) 約束：
參數(shù)及返回值需實現(xiàn)Serializable接口
參數(shù)及返回值不能自定義實現(xiàn)List, Map, Number, Date, Calendar等接口，只能用JDK自帶的實現(xiàn)，因為hessian會做特殊處理，自定義實現(xiàn)類中的屬性值都會丟失。
(2) 配置：
Define hessian protocol:
[html]
<dubbo:protocol name="hessian" port="8080" server="jetty"/>
Set default protocol:
[html]
<dubbo:provider protocol="hessian"/>
Set service protocol:
[html]
<dubbo:service protocol="hessian"/>
Multi port:
[html]
<dubbo:protocol id="hessian1" name="hessian" port="8080"/>
<dubbo:protocol id="hessian2" name="hessian" port="8081"/>
Directly provider:
[html]
<dubbo:reference id="helloService" interface="HelloWorld" url="hessian://10.20.153.10:8080/helloWorld"/>
h4. Jetty Server: (default)
[html]
<dubbo:protocol... server="jetty"/>
h4. Servlet Bridge Server: (recommend)
[html]
<dubbo:protocol... server="servlet"/>
web.xml：
[html]
<servlet>
<servlet-name>dubbo</servlet-name>
<servlet-class>com.alibaba.dubbo.remoting.http.servlet.DispatcherServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>dubbo</servlet-name>
<url-pattern>/*</url-pattern>
</servlet-mapping>
注意，如果使用servlet派發(fā)請求：
協(xié)議的端口<dubbo:protocol port="8080" />必須與servlet容器的端口相同，
協(xié)議的上下文路徑<dubbo:protocol contextpath="foo" />必須與servlet應用的上下文路徑相同。
http://
(
+) (
#)
采用Spring的HttpInvoker實現(xiàn)
2.3.0以上版本支持
基于http表單的遠程調用協(xié)議。參見：[HTTP協(xié)議使用說明]
連接個數(shù)：多連接
連接方式：短連接
傳輸協(xié)議：HTTP
傳輸方式：同步傳輸
序列化：表單序列化
適用范圍：傳入傳出參數(shù)數(shù)據(jù)包大小混合，提供者比消費者個數(shù)多，可用瀏覽器查看，可用表單或URL傳入參數(shù)，暫不支持傳文件。
適用場景：需同時給應用程序和瀏覽器JS使用的服務。
(1) 約束：
參數(shù)及返回值需符合Bean規(guī)范
(2) 配置：
dubbo.xml：
[html]
<dubbo:protocol name="http" port="8080"/>
h4. Jetty Server: (default)
[html]
<dubbo:protocol... server="jetty"/>
h4. Servlet Bridge Server: (recommend)
[html]
<dubbo:protocol... server="servlet"/>
web.xml：
[html]
<servlet>
<servlet-name>dubbo</servlet-name>
<servlet-class>com.alibaba.dubbo.remoting.http.servlet.DispatcherServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>dubbo</servlet-name>
<url-pattern>/*</url-pattern>
</servlet-mapping>
注意，如果使用servlet派發(fā)請求：
協(xié)議的端口<dubbo:protocol port="8080" />必須與servlet容器的端口相同，
協(xié)議的上下文路徑<dubbo:protocol contextpath="foo" />必須與servlet應用的上下文路徑相同。
webservice://
(
+) (
#)
2.3.0以上版本支持。
基于CXF的和實現(xiàn)。
CXF是Apache開源的一個RPC框架：，由Xfire和Celtix合并而來 。
依賴：
[html]
<dependency>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-rt-frontend-simple</artifactId>
<version>2.6.1</version>
</dependency>
<dependency>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-rt-transports-http</artifactId>
<version>2.6.1</version>
</dependency>
可以和原生WebService服務互操作，即：
提供者用Dubbo的WebService協(xié)議暴露服務，消費者直接用標準WebService接口調用，
或者提供方用標準WebService暴露服務，消費方用Dubbo的WebService協(xié)議調用。
基于WebService的遠程調用協(xié)議。
連接個數(shù)：多連接
連接方式：短連接
傳輸協(xié)議：HTTP
傳輸方式：同步傳輸
序列化：SOAP文本序列化
適用場景：系統(tǒng)集成，跨語言調用。
(1) 約束：
參數(shù)及返回值需實現(xiàn)Serializable接口
參數(shù)盡量使用基本類型和POJO。
(2) 配置：
Define hessian protocol:
[html]
<dubbo:protocol name="webservice"port="8080"server="jetty"/>
Set default protocol:
[html]
<dubbo:provider protocol="webservice"/>
Set service protocol:
[html]
<dubbo:service protocol="webservice"/>
Multi port:
[html]
<dubbo:protocol id="webservice1" name="webservice"port="8080"/>
<dubbo:protocol id="webservice2" name="webservice"port="8081"/>
Directly provider:
[html]
<dubbo:reference id="helloService" interface="HelloWorld" url="webservice://10.20.153.10:8080/com.foo.HelloWorld"/>
WSDL:
[html]
http://10.20.153.10:8080/com.foo.HelloWorld?wsdl
h4. Jetty Server: (default)
[html]
<dubbo:protocol... server="jetty"/>
h4. Servlet Bridge Server: (recommend)
[html]
dubbo:protocol... server="servlet"/>
web.xml：
[html]
<servlet>
<servlet-name>dubbo</servlet-name>
<servlet-class>com.alibaba.dubbo.remoting.http.servlet.DispatcherServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>dubbo</servlet-name>
<url-pattern>/*</url-pattern>
</servlet-mapping>
注意，如果使用servlet派發(fā)請求：
協(xié)議的端口<dubbo:protocol port="8080" />必須與servlet容器的端口相同，
協(xié)議的上下文路徑<dubbo:protocol contextpath="foo" />必須與servlet應用的上下文路徑相同。
thrift://
(
+) (
#)
2.3.0以上版本支持。
Thrift說明
Thrift是Facebook捐給Apache的一個RPC框架，參見：
dubbo thrift協(xié)議
當前 dubbo 支持的 thrift 協(xié)議是對 thrift 原生協(xié)議的擴展，在原生協(xié)議的基礎上添加了一些額外的頭信息，比如service name，magic number等。使用dubbo thrift協(xié)議同樣需要使用thrift的idl compiler編譯生成相應的java代碼，后續(xù)版本中會在這方面做一些增強。
示例：
依賴：
[html]
<dependency>
<groupId>org.apache.thrift</groupId>
<artifactId>libthrift</artifactId>
<version>0.8.0</version>
</dependency
所有服務共用一個端口：(與原生Thrift不兼容)
[html]
<dubbo:protocol name="thrift"port="3030"/>
Thrift不支持數(shù)據(jù)類型：
null值 (不能在協(xié)議中傳遞null值)
memcached://
(
+) (
#)
2.3.0以上版本支持。
Memcached說明
Memcached是一個高效的KV緩存服務器，參見：
可以通過腳本或監(jiān)控中心手工填寫表單注冊memcached服務的地址：
[java]
RegistryFactory registryFactory = ExtensionLoader.getExtensionLoader(RegistryFactory.class).getAdaptiveExtension();
Registry registry = registryFactory.getRegistry(URL.valueOf("zookeeper://10.20.153.10:2181"));
registry.register(URL.valueOf("memcached://10.20.153.11/com.foo.BarService?category=providers&dynamic=false&application=foo&group=member&loadbalance=consistenthash"));
然后在客戶端使用時，不需要感知Memcached的地址：
[html]
<dubbo:reference id="cache" interface="http://10.20.160.198/wiki/display/dubbo/java.util.Map" group="member" />
或者，點對點直連：
[html]
<dubbo:reference id="cache" interface="http://10.20.160.198/wiki/display/dubbo/java.util.Map" url="memcached://10.20.153.10:11211" />
也可以使用自定義接口：
[html]
<dubbo:reference id="cache" interface="com.foo.CacheService" url="memcached://10.20.153.10:11211"/>
方法名建議和memcached的標準方法名相同，即：get(key), set(key, value), delete(key)。
如果方法名和memcached的標準方法名不相同，則需要配置映射關系：(其中"p:xxx"為spring的標準p標簽)
[html]
<dubbo:reference id="cache" interface="com.foo.CacheService" url="memcached://10.20.153.10:11211" p:set="putFoo" p:get="getFoo" p:delete="removeFoo"/>
redis://
(
+) (
#)
2.3.0以上版本支持。
Redis說明
Redis是一個高效的KV存儲服務器，參見：
可以通過腳本或監(jiān)控中心手工填寫表單注冊redis服務的地址：
[java]
RegistryFactory registryFactory = ExtensionLoader.getExtensionLoader(RegistryFactory.class).getAdaptiveExtension();
Registry registry = registryFactory.getRegistry(URL.valueOf("zookeeper://10.20.153.10:2181"));
registry.register(URL.valueOf("redis://10.20.153.11/com.foo.BarService?category=providers&dynamic=false&application=foo&group=member&loadbalance=consistenthash"));
然后在客戶端使用時，不需要感知Redis的地址：
[html]
<dubbo:reference id="store" interface="http://10.20.160.198/wiki/display/dubbo/java.util.Map" group="member" />
或者，點對點直連：
[html]
<dubbo:reference id="store" interface="http://10.20.160.198/wiki/display/dubbo/java.util.Map" url="redis://10.20.153.10:6379" />
也可以使用自定義接口：
[html]
<dubbo:reference id="store" interface="com.foo.StoreService" url="redis://10.20.153.10:6379"/>
方法名建議和redis的標準方法名相同，即：get(key), set(key, value), delete(key)。
如果方法名和redis的標準方法名不相同，則需要配置映射關系：(其中"p:xxx"為spring的標準p標簽)
[html]
<dubbo:reference id="cache" interface="com.foo.CacheService" url="memcached://10.20.153.10:11211" p:set="putFoo" p:get="getFoo" p:delete="removeFoo"/>
