Apache CXF提供了用于方便地构建和开发WebService的可靠基础架构。它允许创建高性能和可扩展的服务,可以部署在Tomcat和基于Spring的轻量级容器中,也可以部署在更高级的服务器上,例如Jboss、WebSphere或WebLogic。
CXF提供了以下功能:
WebService服务标准支持:
Java API for XML Web Services (JAX-WS) SOAP WebService描述语言(Web Services Description Language ,WSDL) 消息传输优化机制(Message Transmission Optimization Mechanism,MTOM) WS-Basic Profile WS-Addressing WS-Policy WS-ReliableMessaging WS-Security
前端建模:CXF允许使用不同的前端API来创建Service。如CXF允许使用简单的工厂Bean并通过JAX-WS实现来创建WebService,允许创建动态WebService客户端。
工具支持:CXF提供了在Java Bean、WebService和WSDL之间进行转换的工具,提供了对Maven和Ant集成的支持,并无缝地支持Spring集成。
RESTful支持:CXF支持Restful,并支持Java平台的JAX-RS实现。
对不同传输和绑定的支持:CXF支持不同数据类型的传输,除了支持SOAP和HTTP协议绑定外,还支持JAXB和AEGIS绑
定。
对非XML绑定的支持:CXF支持非XML绑定,如JSON、CORBA、JBI和SCA等。
Code First和Xml First:CXF支持使用Code First或者Xml First的方式创建WebService。
下面用CXF创建独立发布的WebService。
服务端
在Eclipse中创建maven项目,配置文件pom.xml中引入CXF,具体配置如下
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.rvho</groupId> <artifactId>cxfstandalone</artifactId> <version>0.0.1-SNAPSHOT</version> <properties> <!-- 文件拷贝编码 --> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <!-- 输出编码 --> <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding> <!-- 编译编码 --> <maven.compiler.encoding>UTF-8</maven.compiler.encoding> <!-- CXF版本 --> <cxf.version>3.1.1</cxf.version> </properties> <dependencies> <!-- CXF --> <dependency> <groupId>org.apache.cxf</groupId> <artifactId>cxf-rt-frontend-jaxws</artifactId> <version>${cxf.version}</version> </dependency> <dependency> <groupId>org.apache.cxf</groupId> <artifactId>cxf-rt-transports-http</artifactId> <version>${cxf.version}</version> </dependency> <dependency> <!-- 如果CXF不集成到Web服务器中,必须添加该引用 --> <groupId>org.apache.cxf</groupId> <artifactId>cxf-rt-transports-http-jetty</artifactId> <version>${cxf.version}</version> </dependency> <!-- End CXF --> </dependencies> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.3</version> <configuration> <!-- 指定source和target的jdk版本是1.8 --> <source>1.8</source> <target>1.8</target> </configuration> </plugin> </plugins> </build></project>
服务接口HelloWS,该接口发布welcome方法。
package com.rvho.cxfstandalone.ws;import javax.jws.WebMethod;import javax.jws. WebParam;import javax.jws.WebService;@WebService( name = "HelloWS", targetNamespace = "http://www.tmp.com/services/hello" )public interface HelloWS { @WebMethod String welcome(@WebParam(name = "name") String name); }
服务接口HelloWS实现类HelloWSImpl。
package com.rvho.cxfstandalone.ws.impl; import javax.jws.WebService; import com.rvho.cxfstandalone.ws.HelloWS; @WebService( endpointInterface = "com.rvho.cxfserver.ws.HelloWS", portName = "HelloWSPort", serviceName = "HelloWSService", targetNamespace = "http://www.tmp.com/services/hello" ) public class HelloWSImpl implements HelloWS { @Override public String welcome(String name) { return "Welcome " + name; } }
发布服务
package com.rvho.cxfstandalone; import org.apache.cxf.jaxws.JaxWsServerFactoryBean; import com.rvho.cxfstandalone.ws.HelloWS; import com.rvho.cxfstandalone.ws.impl.HelloWSImpl; public class CxfServer { public static void main(String[] args) { JaxWsServerFactoryBean factory = new JaxWsServerFactoryBean(); factory.setServiceClass(HelloWS.class); //服务发布的地址 factory.setAddress("http://localhost:8999/services/hello"); factory.setServiceBean(new HelloWSImpl()); factory.create(); } }
在浏览器中输入服务发布地址http://localhost:8999/services/hello?wsdl如果看到如下内容,表示服务发布成功。
客户端
用wsimport或者wsdl2java把服务端发布的服务生成java对象。
wsimport是jdk提供的wsdl转java对象工具,在jdk的bin目录下可以找到。用法是
"D:\Program Files\Java\jdk1.8.0_25\bin\wsimport.exe" -encoding utf-8 -d D:\dev\wsdl\cxfserver\wsimport\compile -s D:\dev\wsdl\cxfserver\wsimport\src -p com. rvho.cxfclient.wsdl.wsimport.hello http://localhost:8999/services/hello?wsdl
wsdl2java是cxf提供的wsdl转java对象工具,在cxf的bin目录下可以找到。用法是
"D:\dev\library\java\cxf\apache-cxf-3.1.0\bin\wsdl2java" -p com. rvho.cxfclient.wsdl.cxf.hello -d D:\dev\wsdl\cxfserver\cxf\src http://localhost:8999/services/hello?wsdl
上面命令的路径是我本机路径,有可能不一样。
客户端可以通过jaxws调用,也可以通过cxf调用。
//jaxws调用 //URL不是必须的,除非服务的地址有改变 URL wsdlUrl = new URL("http://localhost:8999/services/hello?wsdl"); HelloWSService helloWSS = new HelloWSService(wsdlUrl); HelloWS helloWS = helloWSS.getHelloWSPort(); String welcome = helloWS.welcome("accountwcx@qq.com"); System.out.println(welcome); /* cxf调用 首先在客户端添加cxf <dependency> <groupId>org.apache.cxf</groupId> <artifactId>cxf-rt-frontend-jaxws</artifactId> <version>3.1.1</version> </dependency> <dependency> <groupId>org.apache.cxf</groupId> <artifactId>cxf-rt-transports-http</artifactId> <version>3.1.1</version> </dependency> */ JaxWsProxyFactoryBean factory = new JaxWsProxyFactoryBean(); factory.setServiceClass(HelloWS.class); factory.setAddress("http://localhost:8999/services/hello"); HelloWS helloWS = factory.create(HelloWS.class); String welcome = helloWS.welcome("accountwcx@qq.com"); System.out.println(welcome);