基于 WebService 的远程调用协议,基于 Apache CXF 1 的 frontend-simple 和 transports-http 实现。
提示:2.3.0 以上版本支持
可以和原生 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>org.apache.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 派发请求:
- 协议的端口
<dubbo:protocol port="8080" />
必须与 servlet 容器的端口相同, - 协议的上下文路径
<dubbo:protocol contextpath="foo" />
必须与 servlet 应用的上下文路径相同。
- CXF 是 Apache 开源的一个 RPC 框架,由 Xfire 和 Celtix 合并而来
下一节:Triple 协议是 Dubbo3 的主力协议,完整兼容 gRPC over HTTP/2,并在协议层面扩展了负载均衡和流量控制相关机制。本文档旨在指导用户正确的使用 Triple 协议。
在开始前,需要决定服务使用的序列化方式,如果为新服务,推荐使用 protobuf 作为默认序列化,在性能和跨语言上的效果都会更好。如果是原有服务想进行协议升级,Triple 协议也已经支持其他序列化方式,如 Hessian / JSON 等