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