spring和CXF集成来实现webservices

最近在负责一个大系统的实施，经过需求分析之后，将系统分为5个子系统，我们采用SOA架构，分模块开发。项目组中最大的一个争议就是，子系统之间的通讯问题，大家提出了两种方案：一、如果5个子系统最后发布为5个war包，那么相互之间就不能直接调用，而是需要通过webservices等通讯方式，那会增加一些开发工作量；二、如果5个子系统合并在一个大工程中，下面放所有的模块，那子系统间的访问很简单，但是日常的开发管理会存在比较大的风险。

 

 

 

从管理的角度来看，我是比较偏向第一种方案，因为这样结构更清晰更简单，开发人员之间的相互影响也较小，还有一个好处就是，可以将不同的子系统发布在不同的应用服务器上，避免了由于某一个子系统崩溃导致整个系统的崩溃。于是，我对webservices的开发技术进行了研究，发现用spring和CXF集成来发布webservice和调用webservice都非常的简单，也加大了我选择第一种方案的决心。下面就简单介绍一个spring和CXF集成的示例。

 

一、 准备工作。

        1、下载apache-cxf的应用包，地址：http://cxf.apache.org/download.html，我选择的是2.4.1版本。



二、发布webservices

1．新建webproject ,并加入apache-cxf-2.4.1\lib所有包，编写要发布的web service接口和实现.这一步，与前面一样。 

1）创建一个接口类，并加上webservice标记

import javax.jws.WebService;
@WebService 
public interface HelloWorld {  
     public String sayHello(String text);  
}

 

2）创建上面这个接口的实现类

import javax.jws.WebService;  
@WebService(endpointInterface="test.HelloWorld")  
public class HelloWorldImpl implements HelloWorld {  
      public String sayHello(String text) {  
                  return "Hello" + text ;  
    }  
  } 

 

@WebService 注解表示是要发布的web服务，endpointInterface的值是该服务类对应的接口。

2.在spring-cxf.xml配置发布的web service 

<?xmlversion="1.0"encoding="UTF-8"?>
<beansxmlns="http://www.springframework.org/schema/beans"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xmlns:jaxws="http://cxf.apache.org/jaxws"
   xsi:schemaLocation="
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd" >
   <importresource="classpath:META-INF/cxf/cxf.xml"/> 
   <importresource="classpath:META-INF/cxf/cxf-extension-soap.xml"/> 
   <importresource="classpath:META-INF/cxf/cxf-servlet.xml"/> 
 
   <beanid="hello"class="test.HelloWorldImpl"/> 
   <jaxws:endpointid="helloWorld"implementor="#hello" 
       address="/HelloWorld"/> 
  </beans >

 

注意：<jaxws:endpointid="helloWorld"implementor="#hello"   address="/HelloWorld"/> 

id：指在spring配置的bean的ID.

Implementor:指明具体的实现类.

Address:指明这个web service的相对地址，

 

3． 配置web.xml文件：

<?xmlversion="1.0"encoding="UTF-8"?> 
<web-appversion="2.4"xmlns="http://java.sun.com/xml/ns/j2ee" 
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
   xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee   
    http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd" >  
   <context-param >  
       <param-name > contextConfigLocation</param-name >  

                   <!--spring配置文件放在WEB-INF目录下-->
       <param-value > /WEB-INF/spring-cxf.xml</param-value >  
   </context-param >  
   <listener >  
       <listener-class >  
         org.springframework.web.context.ContextLoaderListener 
       </listener-class >  
   </listener >  

         <servlet >  
       <servlet-name > CXFServlet</servlet-name >  
       <servlet-class >  
            org.apache.cxf.transport.servlet.CXFServlet  
       </servlet-class >  
       <load-on-startup > 1</load-on-startup >  
   </servlet >  
   <servlet-mapping >  
       <servlet-name > CXFServlet</servlet-name >  
       <url-pattern > /*</url-pattern >  
   </servlet-mapping >  
</web-app >  

 

4．部署到tomcat服务器,输入:http://localhost:8080/<web-app-name>/HelloWorld?wsdl,将显示这个web service的wsdl.

注意：如果web.xml配置<servlet-name > CXFServlet</servlet-name >  

       <url-pattern > /ws/*</url-pattern >  

则访问地址为：http://localhost:8080/<web-app-name>/ws/HelloWorld?wsdl 

到此webservices就发布成功了。

 

 

三、创建一个客户端来调用webservices

 

1、同样新建java project ,并加入apache-cxf-

2.0.7

\lib所有包，添加到Build Path；

 

2、将webservice的接口类导出成jar包，也添加到Build Path，主要目的是客户端要用到服务端的HelloWorld这个类。如果不想导入这个jar包也可以，只要在客户端创建一个一摸一样的接口类：HelloWorld，特别要注意以下两点：

 

    1）接口前面要添加@Webservice的标记，不然会抛出一个 javax.xml.ws.WebServiceException: Could not find wsdl:binding operation info for web method sayHelloWorld.

 

    2）包路径也要一样，不然会抛出一个ClassCastException: $Proxy29 cannot be cast to...

 

3、配置spring-client.xml

<beansxmlns="http://www.springframework.org/schema/beans"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xmlns:jaxws="http://cxf.apache.org/jaxws"
   xsi:schemaLocation="
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
http://cxf.apache.org/jaxws http://cxf.apache.org/schema/jaxws.xsd" >
      <!-- 这个class的包路径和类名和服务端提供web服务的接口一致-->
   <beanid="client"class="test.HelloWorld"
     factory-bean="clientFactory"factory-method="create"/>
   
   <beanid="clientFactory"class="org.apache.cxf.jaxws.JaxWsProxyFactoryBean" > 

     <!-- 这个class的包路径和类名和服务端提供web服务的接口一致-->
     <propertyname="serviceClass"value="test.HelloWorld"/>

     <!-- 这个address一定要注意，正确的-->
     <propertyname="address"value="http://localhost:8080/<web-app-name>/HelloWorld"/>
    </bean >      
</beans >

 

4．测试：

importorg.springframework.context.ApplicationContext;
importorg.springframework.context.support.ClassPathXmlApplicationContext;
 
importtest.HelloWorld;
 
public class Test {  
     
   public static void main(String[] args) {  
 
        ApplicationContext ctx =newClassPathXmlApplicationContext(  
               "spring-client.xml");  
        HelloWorld client = (HelloWorld) ctx.getBean("client");  
        String result = client.sayHello("Glen!");  
        System.out.println(result);  
    }  
} 

 

结果输出“Hello，Glen!”，测试通过，至此一个webservice的调用也成功了。