webservice 协议
webservice:// 协议参考手册
此文档已经不再维护。您当前查看的是快照版本。如果想要查看最新版本的文档，请参阅最新版本。
基于 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 合并而来 ↩︎
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.
