CXF+Spring开发Webservices

WebService 是一套标准&＃xff0c;而不是一种具体的技术。不同的平台&＃xff0c;不同的语言&＃xff0c;大都提供了对 WebService 的开发实现。

在 JAVA 领域里&＃xff0c;WebService 的框架有不少&＃xff0c;常用的就有 AXIS&＃xff0c;XFire , CXF 等 .

Apache CXF 是一个开源的 Services 框架 , 它 的前身是 Apache CeltiXfire , 继承自 Celtix 和 XFire 两大开源项目 ,
 
CXF 实现了 JAX-WS &＃xff08;Java API  For XML-WebService&＃xff09; API&＃xff0c;对 JAX-WS 提供了全面的支持 , 而且可以和 Spring 进行无缝集成。

CXF 支持多种标准 : 

    支持 JAX-WS 、 JAX-WSA 、JSR-181 和 SAAJ&＃xff1b;

    支持 SOAP 1.1 、1.2 、WS-I BasicProfile 、WS-Security 、WS-Addressing 、WS-RM 和 WS-Policy&＃xff1b;

    支持 WSDL ( Web Services Description Language ) 1.1 、2.0&＃xff1b;

    支持 MTOM&＃xff1b;

为帮助理解&＃xff0c;下面引用一段摘自网络的文字内容 : 

"  什么是 WebServices

    从表面上看&＃xff0c;Webservice 就是一个应用程序&＃xff0c;它向外界暴露出一个能够通过 Web 进行调用的 API 。也就是说&＃xff0c;可以利用编程的方法通过 Web 来调用这个应用程序。

    对 Webservice 更精确的解释 : Webservice 是建立可互操作的分布式应用程序的新平台。Webservice 平台是一套标准&＃xff0c;它定义了应用程序如何在 Web 上实现互操作性。

    你可以用任何你喜欢的语言&＃xff0c;在任何你喜欢的平台上写 Webservice &＃xff0c;只要我们可以通过 Webservice 标准对这些服务进行查询和访问。

    不管你的 Webservice 是用什么工具&＃xff0c;什么语言写出来的&＃xff0c;只要你用 SOAP 协议通过 HTTP 来调用它&＃xff0c;总体结构都一致。通常&＃xff0c;你用你自己喜欢的语言(如VB 6或者VB.NET)

    来构建你的 Webservice&＃xff0c;然后用 SOAP Toolkit 或者 .NET 的内建支持来把它暴露给 Web 客户。于是&＃xff0c;任何语言&＃xff0c;任何平台上的客户都可以阅读其WSDL文档&＃xff0c;

    以调用这个 Webservice。客户根据 WSDL 描述文档&＃xff0c;会生成一个 SOAP 请求消息。Webservice 都是放在 Web 服务器 (如IIS) 后面的&＃xff0c;客户生成的 SOAP 请求

    会被嵌入在一个 HTTP POST 请求中&＃xff0c;发送到 Web 服务器来。Web 服务器再把这些请求转发给 Webservice 请求处理器。请求处理器的作用在于&＃xff0c;解析收到的 SOAP 请求&＃xff0c;

    调用 Webservice&＃xff0c;然后再生成相应的 SOAP 应答。Web 服务器得到 SOAP 应答后&＃xff0c;会再通过 HTTP 应答的方式把它送回到客户端。   "

环境 : 


编写 HelloWorld :

下载 Apache CXF :   http://cxf.apache.org/download.html

导入 CXF 所需的 jar 包 : 
    commons-logging-1.1.1.jar
    cxf-2.5.3.jar
    geronimo-activation_1.1_spec-1.1.jar
    geronimo-annotation_1.0_spec-1.1.1.jar
    geronimo-javamail_1.4_spec-1.7.1.jar
    geronimo-jaxws_2.2_spec-1.1.jar
    geronimo-jms_1.1_spec-1.1.1.jar
    geronimo-servlet_2.5_spec-1.1.2.jar
    geronimo-stax-api_1.0_spec-1.0.1.jar
    geronimo-ws-metadata_2.0_spec-1.1.3.jar
    jaxb-api-2.2.3.jar
    jaxb-impl-2.2.4-1.jar
    neethi-3.0.2.jar
    saaj-api-1.3.4.jar
    saaj-impl-1.3.12.jar
    wsdl4j-1.6.2.jar
    wss4j-1.6.5.jar
    xml-resolver-1.2.jar
    xmlschema-core-2.0.2.jar

也可以将 CXF lib 下的 jar 包全部导入&＃xff0c;以及导入 spring 所需 jar 包 .

服务器端 ( web project&＃xff0c;项目名 : ws ) ---

1 . 编写 HelloWorld 接口&＃xff0c;并将其标注成 WebService 的标准 java 接口


 
2 . 编写 HelloWorld 的实现类



applicationContext.xml 配置


以上配置中的 cxf.xml&＃xff0c;cxf-extension-soap.xml&＃xff0c;cxf-servlet.xml 实际上是放在 cxf-2.5.3.jar 里面的 META-INF 文件夹的 cxf 目录下&＃xff0c;由于我们已经导入了这个 jar 包&＃xff0c;

所以在这里&＃xff0c;我们只需要这样配置就行&＃xff0c;其他的就可以不用管了&＃xff0c;至于更多的详细信息&＃xff0c;请参考帮助文档 :  http://cxf.apache.org/docs/jax-rs-and-jax-ws.html


web.xml 配置



OK&＃xff0c;到此服务器端已经开发完成&＃xff0c;部署运行&＃xff0c;打开你最熟悉的浏览器&＃xff0c;访问 :   http://localhost:8080/ws/webservice/helloworld?wsdl

如果能查看到 WSDL 文件的内容信息如下&＃xff0c;说明服务器端已经没问题了 : 



客户端 ( web project&＃xff0c;项目名 : ws_client ) ---

如果你对 CXF 或 Axis 比较熟悉的话&＃xff0c;可以使用 wsdl2java 命令来根据 wsdl 文件直接生成客户端的 java 代码&＃xff0c;其中&＃xff0c;CXF 的 WSDL to Java 的命令参数

请自行参考官网文档  :   https://cwiki.apache.org/CXF20DOC/wsdl-to-java.html      顺便说一下&＃xff0c;使用 CXF 的 wsdl2java 命令需要配置一下环境变量&＃xff0c;

下面采用手工方式编写客户端测试代码 : 

1 . 首先需要创建一个与服务器端相同的 HelloWorld 接口&＃xff0c;这是服务端给我们暴露的服务&＃xff0c;客户端的这个 HelloWorld 接口代码的编写需与服务端的一致 .



2 . applicationContext.xml 配置


Tips : 这里配置的 &＃xff0c;其中 address 的属性值 value 要与服务器端
            applicationContext.xml 配置中的  的 address 对应起来。

3 . Junit 测试

package junit.test;

import org.junit.AfterClass;
import org.junit.BeforeClass;
import org.junit.Test;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;
import com.fancy.service.client.HelloWorld;
/**
 * -----------------------------------------
 * &＃64;描述  客户端测试
 * &＃64;作者  fancy
 * &＃64;邮箱  fancydeepin&＃64;yeah.net
 * &＃64;日期  2012-10-4 

 * -----------------------------------------
 */
public class ClientTestApp {

    private static ApplicationContext context &＃61; null;
    
    &＃64;BeforeClass
    public static void setUpBeforeClass() throws Exception {
        
        context &＃61; new ClassPathXmlApplicationContext("applicationContext.xml");

    }

    &＃64;AfterClass
    public static void tearDownAfterClass() throws Exception {
        
        context &＃61; null;

    }
    
    &＃64;Test
    public void clientTest(){
        
        HelloWorld helloworld &＃61; (HelloWorld)context.getBean("wsclient");
        String message &＃61; helloworld.sayHi("fancy");
        System.out.println(message);
        
    }

}
 

测试的时候&＃xff0c;必须保证服务器是开着的&＃xff0c;后台打印输出结果 : 

Hi fancy !

以上是我使用最新版cxf集成spring时用到的jar包&＃xff08;webcenter工程&＃xff09;


后来修改成旧版时用到的包cxf&＃43;spring:

   [ 随笔均原创&＃xff0c;转载请注明出处&＃xff1a;http://www.blogjava.net/fancydeepin ]