一、概述
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
2.1、在开发环境中引入CXF的jar包
我使用的是maven环境,CXF包坐标如下:
<properties>
<cxf.version>3.0.7</cxf.version>
<junit.version>4.11</junit.version>
</properties>
<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>
<!-- 部署至tomcat底下不会报错,jetty环境需要加入该包,否则项目启动报错 -->
<dependency>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-rt-transports-http-jetty</artifactId>
<version>${cxf.version}</version>
</dependency>2.2.服务接口如下所示:
/**
* @author Ickes
*/
@WebService
public interface UserService {
/**
* 测试返回list
* @return
*/
public List<Users> geAlltUsers();
/**
* 测试返回实体,以及传人普通参数
* @param id
* @return
*/
public Users getUser(String id);
/***
* 测试传入对象
* @param user
*/
public void save(Users user);
/**
* 测试传人集合
* @param users
*/
public void saves(List<Users> users);
}
2.3、实现类如下所示:
import java.util.List;
import javax.jws.WebService;
import com.gosun.jws.daomain.Users;
import com.gosun.jws.daomain.UsersFactory;
@WebService(serviceName = "cxfService",
endpointInterface = "com.gosun.jws.cxf.UserService"
)
public class UserServiceImpl implements UserService {
@Override
public List<Users> geAlltUsers() {
return UsersFactory.getUsers();
}
@Override
public Users getUser(String id) {
System.out.println(id);
return UsersFactory.getUser();
}
@Override
public void save(Users user) {
System.out.println(user.toJson());
}
@Override
public void saves(List<Users> users) {
for (Users u : users) {
System.out.println(u.toJson());
}
}
}测试用到的:UsersFactory工具类和Users实体类在:http://eksliang.iteye.com/blog/2265021篇文章的3.1和3.2代码中
2.4、使用CXF发布WebService
使用CXF发布WebService代码如下:
import org.apache.cxf.jaxws.JaxWsServerFactoryBean;
import com.gosun.jws.cxf.UserService;
import com.gosun.jws.cxf.UserServiceImpl;
public class ServiceDemo {
/**
* 使用CXF的JaxWsServerFactoryBean发布服务
* @param Ickes
*/
public static void main(String[] args) {
JaxWsServerFactoryBean factory = new JaxWsServerFactoryBean();
factory.setServiceClass(UserService.class);
//服务发布地址
factory.setAddress("http://localhost:8080/userService");
factory.setServiceBean(new UserServiceImpl());
factory.create();
System.out.println("publish success");
}
}
执行后在浏览器中输入http://localhost:8080/userService?wsdl,出现如下界面说明发布成功。
温馨提示:如果使用JAX-WEB进行发布,可以直接输入http://localhost:8080/userService便可以看到服务的详情,但是导入了CXF的包后,必须要加上?wsdl,否则报错
三、使用CXF在客户端调用WebService
使用CXF在客户端调用WebService代码如下:
import java.util.List;
import org.apache.cxf.jaxws.JaxWsProxyFactoryBean;
import com.gosun.jws.cxf.UserService;
import com.gosun.jws.daomain.Users;
public class ClientDemo {
public static void main(String[] args) {
JaxWsProxyFactoryBean jwpfb = new JaxWsProxyFactoryBean();
jwpfb.setServiceClass(UserService.class);
jwpfb.setAddress("http://localhost:8080/userService");
UserService us = (UserService) jwpfb.create();
System.out.println(us.getUser("a001"));
System.out.println("----------------------------------------");
List<Users> users = us.geAlltUsers();
for (Users u : users) {
System.out.println(u.toJson());
}
}
}UserService接口和Users,可以先使用jdk1.6以上只带的wsimport命令进行生成例如:
wsimport -p com.ickes.cxf.client -keep http://localhost:8080/userService?wsdl
