转:CXF学习笔记二：如何在Tomcat中创建、发布和访问基于CXF的服务

cxs7225032

　　详细介绍了在tomcat容器中创建、发布和访问CXF服务的步骤和各种方法。
　　一、服务器端
　　1．添加CXF包
　　1）基本包：
　　commons-logging-1.1.1.jar
　　geronimo-activation_1.1_spec-1.0.2.jar
　　geronimo-annotation_1.0_spec-1.1.1.jar
　　geronimo-javamail_1.4_spec-1.6.jar
　　geronimo-jaxws_2.1_spec-1.0.jar
　　geronimo-servlet_2.5_spec-1.2.jar
　　geronimo-stax-api_1.0_spec-1.0.1.jar
　　geronimo-ws-metadata_2.0_spec-1.1.2.jar
　　jaxb-api-2.1.jar
　　jaxb-impl-2.1.12.jar
　　jetty-6.1.21.jar
　　jetty-util-6.1.21.jar
　　neethi-2.0.4.jar
　　saaj-api-1.3.jar
　　saaj-impl-1.3.2.jar
　　wsdl4j-1.6.2.jar
　　wstx-asl-3.2.8.jar
　　xml-resolver-1.2.jar
　　XmlSchema-1.4.5.jar
　　2）jsf和jstl（非必要，用MyEclipse创建Web Project时会自动加入，无须再添加）
　　jsf-api.jar
　　jsf-impl.jar
　　jstl-1.2.jar
　　3）cxf
　　cxf-2.2.4.jar
　　4）Spring jars，为XML Configuration添加Spring支持。
　　aopalliance-1.0.jar
　　spring-core-2.5.5.jar
　　spring-beans-2.5.5.jar
　　spring-context-2.5.5.jar
　　spring-web-2.5.5.jar
　　2．服务接口及实现
　　1）接口类，如HelloWorld.java：

package cxf.test;

import javax.jws.WebService;

@WebService

public interface HelloWorld

{

  // 一个简单的方法,返回一个字符串

String say(String hello);

　　}
　　2）实现类，如HelloWorldImpl.java：

package cxf.test;

import javax.jws.WebService;   

// WebService实现类.  

// 使用@WebService指向Interface定义类即可.  

@WebService(endpointInterface = "cxf.test.HelloWorld")   

public class HelloWorldImpl implements HelloWorld   

{   

    public String say(String hello)   

    {   

        return "hello " + hello;   

    }   

}  

　　3．服务配置
　　1）web.xml

     

        contextConfigLocation

        WEB-INF/beans.xml

   

   

        

            org.springframework.web.context.ContextLoaderListener

        

   

     

         CXFServlet

         

              org.apache.cxf.transport.servlet.CXFServlet

         

     

     

         CXFServlet

         /services/*

     

　　2）beans.xml

     

     

     

     

注：服务无需诸如index.jsp之类的配置，MyEclipse自动加入的可删除，对服务及配置无任何影响。

　　4．服务发布（到Tomcat）
　　方法一：通过MyEclipse发布
　　点击工具栏  图标，或者右键单击项目 → MyEclipse → Add and Remove Project Deployments。
　　方法二：使用Ant。
　　二、客户端
　　创建Web Project，执行下列步骤即可。无须设置web.xml。
　　1．添加CXF包
　　针对不同的方法，需要的包不尽相同。如下面“3．服务调用”的方法三，需要如下包：
　　commons-logging-1.1.1.jar
　　cxf-2.2.4.jar
　　neethi-2.0.4.jar
　　spring-core-2.5.5.jar
　　spring-beans-2.5.5.jar
　　spring-context-2.5.5.jar
　　wsdl4j-1.6.2.jar
　　XmlSchema-1.4.5.jar
　　2．获取服务服务接口类（类似于C/C++中的.h头文件）
　　方法一：直接从原项目中copy
　　这当然是最简单的方法，也是最“难”的方法（如果服务不是自己做的，显然没法获得）。
　　方法二：从wsdl文档中生成。
　　需要先安装cxf程序包。生成步骤如下：
　　1）    安装cxf，设置环境变量，如：D:\Apache\apache-cxf-2.2.4；同时，PATH后加上“;%CXF_HOME%\bin”（可选）。wsdl2java的用法如下：
wsdl2java –p 包名 –d 目录名 wsdl路径
如：wsdl2java –p demo.service.client –d e:\src htt://localhost:8080/helloWorld?wsdl
-p           指定其wsdl的命名空间，也就是要生成代码的包名
-d           指定要产生代码所在目录
-client     生成客户端测试web service的代码
-server    生成服务器启动web service的代码
-impl       生成web service的实现代码
-ant         生成build.xml文件
-compile  生成代码后编译
-quient    静默模式，不输出警告与错误信息
-all          生成所有开始端点代码：types,service proxy,service interface, server mainline, client mainline, implementation object, and an Ant build.xml file.
　　2）    执行wsdl2java批处理程序，如：
wsdl2java -p cxf.test -d d:\src -server http://localhost:8080/CXFTomcat/services/ HelloWorld?wsdl
　　3）    将java接口类导入项目。
上一步生成的java类文件很多，一般的应用中只要将说明接口的那个类文件导入项目即可，如上例生成的HelloWorld.java文件。
　　3．服务调用
　　方法一：使用jws的高层封装，如：

package cxf.test;

　　import javax.xml.namespace.QName;
　　import javax.xml.ws.Service;
　　import javax.xml.ws.soap.SOAPBinding;
　　import cxf.test.HelloWorld;     // necessary

public final class Client {

    private static final QName SERVICE_NAME

        = new QName("http://test.cxf/", "HelloWorld");  // 首参为接口实现类包名的反缀

    private static final QName PORT_NAME

        = new QName("http://test.cxf/", "HelloWorldPort");

    private Client() { }

    public static void main(String args[]) throws Exception {

        Service service = Service.create(SERVICE_NAME);

        // Endpoint Address

        String endpointAddress = "http://localhost:8080/CXFTomcat/services/HelloWorld";

        // Add a port to the Service

        service.addPort(PORT_NAME, SOAPBinding.SOAP11HTTP_BINDING, endpointAddress);

        HelloWorld hw = service.getPort(HelloWorld.class);

        System.out.println(hw.say("World"));

    }

　　}
　　方法二：使用较下层的代码更加精确的控制程序的行为，如：

package cxf.test;

import org.apache.cxf.jaxws.JaxWsProxyFactoryBean;

　　import cxf.test.HelloWorld;     // necessary

public final class Client {

    private Client() { }

    public static void main(String args[]) throws Exception {

      JaxWsProxyFactoryBean factoryBean = new JaxWsProxyFactoryBean();

　　factoryBean.getInInterceptors().add(new LoggingInInterceptor());（可选）
　　factoryBean.getOutInterceptors().add(new LoggingOutInterceptor());（可选）

      factoryBean.setServiceClass(cxf.test.HelloWorld.class);

      factoryBean.setAddress("http://localhost:8080/CXFTomcat/services/HelloWorld");

      HelloWorld client = (HelloWorld)factoryBean.create();

      System.out.println(client.say("God"));

      System.exit(0);

    }

　　}
　　备注：LoggingInInterceptor和LoggingOutInterceptor是日志拦截器，用于输入和输出时显示日志。使用与否并不影响程序的行为。
　　方法三：使用Spring，例如：

package cxf.test;

import org.springframework.context.support.ClassPathXmlApplicationContext;

import cxf.test.HelloWorld; // necessary

public final class Client {

    private Client() { }

    public static void main(String args[]) throws Exception {

        ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext(new String[] {"cxf/test/client-beans.xml"});

        HelloWorld client = (HelloWorld)context.getBean("client");

        String response = client.say("Joe");

        System.out.println("Response: " + response);

        System.exit(0);

    }

　　}
　　注意：要想使用Spring来完成，在cxf.test包中必须有client-beans.xml存在，内容如下：

   

   

      

      

     

　　4．执行
　　Run As Java Application