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

详细介绍了在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

<?xml version="1.0" encoding="UTF-8"?>

<web-app version="2.5"

xmlns="http://java.sun.com/xml/ns/javaee"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://java.sun.com/xml/ns/javaee

http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">

<context-param>

<param-name>contextConfigLocation</param-name>

<param-value>WEB-INF/beans.xml</param-value>

</context-param>

<listener-class>

org.springframework.web.context.ContextLoaderListener

</listener-class>

</listener>

<servlet-name>CXFServlet</servlet-name>

<servlet-class>

org.apache.cxf.transport.servlet.CXFServlet

</servlet-class>

</servlet>

<servlet-mapping>

<servlet-name>CXFServlet</servlet-name>

<url-pattern>/services/*</url-pattern>

</servlet-mapping>

</web-app>

2）beans.xml

<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns="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">

<jaxws:endpoint id="webServiceHelloWorld"

address="/HelloWorld"

implementor="cxf.test.HelloWorldImpl"/>

</beans>

注：服务无需诸如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存在，内容如下：

<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns="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/schema/jaxws.xsd">

<bean id="client" class="cxf.test.HelloWorld"

factory-bean="clientFactory" factory-method="create"/>

</bean>

</beans>

4．执行

Run As Java Application

发表于 2011-03-04 11:20 phoebus0501 阅读(5448) 评论(0) 编辑收藏举报