CXF实战(一)
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。同意创建动态WebServiceclient。
- 工具支持: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假设看到例如以下内容,表示服务公布成功。
client
用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
上面命令的路径是我本机路径,有可能不一样。
client能够通过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调用
首先在client加入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);