Dubbo支持的协议

最新推荐文章于 2025-03-20 07:12:02 发布

原创最新推荐文章于 2025-03-20 07:12:02 发布 · 393 阅读

3 ·

CC 4.0 BY-SA版权

☆ 框架专栏收录该内容

4 篇文章

订阅专栏

本文介绍了Dubbo支持的各种协议，包括dubbo、rmi、hessian、http、webservice、thrift、redis等，详细阐述了各协议的特点及适用场景。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Dubbo支持dubbo、rmi、hessian、http、webservice、thrift、redis等多种协议，Dubbo官网推荐我们使用的是Dubbo协议，下面介绍各种协议的特点及适用场景。

dubbo://

Dubbo缺省协议采用单一长连接和NIO异步通讯，适合于小数据量大并发的服务调用，以及服务消费者机器数远大于服务提供者机器数的情况。

反之，Dubbo缺省协议不适合传送大数量的服务，比如传文件、传视频等，除非请求量很低。

特性

缺省协议，使用基于mina1.1.7 和hessian3.2.1的tbremoting交互。

连接个数：单连接
连接方式：长连接
传输协议：TCP
传输方式：NIO异步传输
序列化：Hession二进制序列化
适用范围：传入传出参数数据包较小（建议小于100k）,消费者比提供者个数多，单一消费者无法压满提供者，尽量不要用dubbo协议传输大文件或超大字符串。
适用场景：常规远程服务方法调用

配置

//配置协议
<dubbo:protocol name="dubbo" port="20880" />
//设置默认协议
<dubbo:provider protocol="dubbo" />
//设置服务协议
<dubbo:service protocol="dubbo" />
//多端口
<dubbo:protocol id="dubbo1" name="dubbo" port="20880" />
<dubbo:protocol id="dubbo2" name="dubbo" port="20881" />
//配置协议选项
<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” />
//多连接配置，Dubbo协议缺省每服务提供者每消费者适用单一长连接，如果数量较大，可以使用多个连接
<dubbo:service connections="1"/>
<dubbo:reference connections="1"/>
//表示该服务使用 JVM 共享长连接。缺省
<dubbo:service connections="0"> 或 <dubbo:reference connections="0"> 
//表示该服务使用独立长连接。
<dubbo:service connections="1"> 或 <dubbo:reference connections="1"> 
//表示该服务使用独立两条长连接。
<dubbo:service connections="2"> 或<dubbo:reference connections="2">

常见问题

为什么要消费者比提供者个数多?

因 dubbo 协议采用单一长连接，假设网络为千兆网卡 [3]，根据测试经验数据每条连接最多只能压满 7MByte(不同的环境可能不一样，供参考)，理论上 1 个服务提供者需要 20 个服务消费者才能压满网卡。

为什么不能传大包?

因 dubbo 协议采用单一长连接，如果每次请求的数据包大小为 500KByte，假设网络为千兆网卡 [3:1]，每条连接最大 7MByte(不同的环境可能不一样，供参考)，单个服务提供者的 TPS(每秒处理事务数)最大为：128MByte / 500KByte = 262。单个消费者调用单个服务提供者的 TPS(每秒处理事务数)最大为：7MByte / 500KByte = 14。如果能接受，可以考虑使用，否则网络将成为瓶颈。

为什么采用异步单一长连接?

因为服务的现状大都是服务提供者少，通常只有几台机器，而服务的消费者多，可能整个网站都在访问该服务，比如 Morgan 的提供者只有 6 台提供者，却有上百台消费者，每天有 1.5 亿次调用，如果采用常规的 hessian 服务，服务提供者很容易就被压跨，通过单一连接，保证单一消费者不会压死提供者，长连接，减少连接握手验证等，并使用异步 IO，复用线程池，防止 C10K 问题。

rmi://

RMI协议采用JDK标准的java.rmi.*实现，采用阻塞式短连接和JDK标准序列化方式。

特性

连接个数：多连接
连接方式：短连接
传输协议:TCP
传输方式：同步传输
序列化：java标准二进制序列化
适用访问：传入传出参数数据包大小混合，消费者与提供者个数差不多，可传文件

dubbo.properties配置

 dubbo.service.protocol=rmi

RMI配置

//定义RMI协议
<dubbo:protocol name="rmi" port="1099" />
//定义默认协议
<dubbo:provider protocol="rmi" />
//设置服务协议：
<dubbo:service protocol="rmi" />
//多端口
<dubbo:protocol id="rmi1" name="rmi" port="1099" />
<dubbo:protocol id="rmi2" name="rmi" port="2099" />
<dubbo:service protocol="rmi1" />
//Spring兼容性
<dubbo:protocol name="rmi" codec="spring" />

hessian://

Hessian协议用于继承Hessian的服务，Hessian底层采用Http通讯，采用Servlet暴露服务，Dubbo缺省内嵌Jetty作为服务器实现。

特性

连接个数：多连接
连接方式：短连接
传输协议：Http
输方式：同步传输
序列化：Hessian二进制序列化
适用范围：传入传出参数数据包较大，提供者比消费者个数多，提供者压力较大，可传文件。
适用场景：页面传输，文件传输，或与原生hessian服务互操作

依赖

<dependency><groupId>com.caucho</groupId>
<artifactId>hessian</artifactId>
<version>4.0.7</version></dependency>

配置

//定义 hessian 协议
<dubbo:protocol name="hessian" port="8080" server="jetty" />
//设置默认协议
<dubbo:provider protocol="hessian" />
//设置 service 协议：
<dubbo:service protocol="hessian" />
//多端口：
<dubbo:protocol id="hessian1" name="hessian" port="8080" />
<dubbo:protocol id="hessian2" name="hessian" port="8081" />
//直连：
<dubbo:reference id="helloService" interface="HelloWorld" url="hessian://10.20.153.10:8080/helloWorld" />

http://

基于 HTTP 表单的远程调用协议，采用 Spring 的 HttpInvoker 实现

特性

连接个数：多连接
连接方式：短连接
传输协议：HTTP
传输方式：同步传输
序列化：表单序列化
适用场景：需同时给应用程序和浏览器 JS 使用的服务

配置

//配置协议
<dubbo:protocol name="http" port="8080" />
//配置Jetty Serve(默认)：
<dubbo:protocol ... server="jetty" />
//配置 Servlet Bridge Server (推荐使用)：
<dubbo:protocol ... server="servlet" />
//配置DispatcherServlet
<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 派发请求：
//1. 协议的端口 <dubbo:protocol port="8080" /> 必须与 servlet 容器的端口相同
//2.协议的上下文路径 <dubbo:protocol contextpath="foo" /> 必须与 servlet 应用的上下文路径相同

webservice://

基于 WebService 的远程调用协议，基于 Apache CXF 的 frontend-simple 和 transports-http 实现。

可以和原生 WebService 服务互操作，即：

提供者用 Dubbo 的 WebService 协议暴露服务，消费者直接用标准 WebService 接口调用
或者提供方用标准 WebService 暴露服务，消费方用 Dubbo 的 WebService 协议调用

依赖

<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>

特性

连接个数：多连接
连接方式：短连接
传输协议：HTTP
传输方式：同步传输
序列化：SOAP 文本序列化
适用场景：系统集成，跨语言调用

约束

参数及返回值需实现 Serializable 接口
参数尽量使用基本类型和 POJO

配置

//配置协议
<dubbo:protocol name="webservice" port="8080" server="jetty" />
//配置默认协议：
<dubbo:provider protocol="webservice" />
//配置服务协议：
<dubbo:service protocol="webservice" />
//多端口：
<dubbo:protocol id="webservice1" name="webservice" port="8080" />
<dubbo:protocol id="webservice2" name="webservice" port="8081" />
//直连：
<dubbo:reference id="helloService" interface="HelloWorld" url="webservice://10.20.153.10:8080/com.foo.HelloWorld" />
//WSDL:
http://10.20.153.10:8080/com.foo.HelloWorld?wsdl
//Jetty Server (默认)：
<dubbo:protocol ... server="jetty" />
//Servlet Bridge Server (推荐)：
<dubbo:protocol ... server="servlet" />
//配置 DispatcherServlet：
<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 派发请求：
//1. 协议的端口 <dubbo:protocol port="8080" /> 必须与 servlet 容器的端口相同
//2.协议的上下文路径 <dubbo:protocol contextpath="foo" /> 必须与 servlet 应用的上下文路径相同

thrift://

当前 dubbo 支持的 thrift 协议是对 thrift 原生协议的扩展，在原生协议的基础上添加了一些额外的头信息，比如 service name，magic number 等。

使用 dubbo thrift 协议同样需要使用 thrift 的 idl compiler 编译生成相应的 java 代码，后续版本中会在这方面做一些增强。

依赖

<dependency>
    <groupId>org.apache.thrift</groupId>
    <artifactId>libthrift</artifactId>
    <version>0.8.0</version>
</dependency>

配置

//所有服务公用一个端口
<dubbo:protocol name="thrift" port="3030" />

常见问题

Thrift 不支持 null 值，即：不能在协议中传递 null 值

memcached://

基于 memcached 实现的 RPC 协议。

注册memcached服务的地址

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"));

在客户端引用

//在客户端使用
<dubbo:reference id="cache" interface="java.util.Map" group="member" />
//或者，点对点直连：
<dubbo:reference id="cache" interface="java.util.Map" url="memcached://10.20.153.10:11211" />
//也可以使用自定义接口：
<dubbo:reference id="cache" interface="com.foo.CacheService" url="memcached://10.20.153.10:11211" />
//方法名建议和 memcached 的标准方法名相同，即：get(key), set(key, value), delete(key),如果方法名和 memcached 的标准方法名不相同，则需要配置映射关系
<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://

基于 Redis 实现的 RPC 协议。

注册redis服务的地址

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"));

在客户端引用

//客户端使用
<dubbo:reference id="store" interface="java.util.Map" group="member" />
//点对点直连：
<dubbo:reference id="store" interface="java.util.Map" url="redis://10.20.153.10:6379" />
//也可以使用自定义接口：
<dubbo:reference id="store" interface="com.foo.StoreService" url="redis://10.20.153.10:6379" />
//方法名建议和 redis 的标准方法名相同，即：get(key), set(key, value), delet(key),如果方法名和 redis 的标准方法名不相同，则需要配置映射关系 
<dubbo:reference id="cache" interface="com.foo.CacheService" url="redis://10.20.153.10:6379" p:set="putFoo" p:get="getFoo" p:delete="removeFoo" />