基于 WebService 的远程调用协议,基于 Apache CXF 的 frontend-simple
和 transports-http
实现。2.3.0
以上版本支持。
CXF 是 Apache 开源的一个 RPC 框架,由 Xfire 和 Celtix 合并而来。
可以和原生 WebService 服务互操作,即:
Serializable
接口发布一个服务(对内/对外),不考虑客户端类型,不考虑性能,建议使用webservice。服务端已经确定使用webservice,客户端不能选择,必须使用webservice。
从 Dubbo 3 开始,Webservice 协议已经不再内嵌在 Dubbo 中,需要单独引入独立的模块。
<dependency>
<groupId>org.apache.dubbo.extensions</groupId>
<artifactId>dubbo-rpc-webservice</artifactId>
<version>3.3.0</version>
</dependency>
<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>
<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" />
http://10.20.153.10:8080/com.foo.HelloWorld?wsdl
<dubbo:protocol ... server="jetty" />
<dubbo:protocol ... server="servlet" />
<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 应用的上下文路径相同。