一、概述
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