快速上手使用CXF

?

快速上手使用CXF

一.? 简介

Apache CXF 是一个Service框架，他简化了Service的创建， CXF实现了JAX-WS2.0规范，并通过了JAX-WS2.0 TCK； CXF和Spring无缝集成；CXF支持多种传输协议（HTTP， JMS， Corba等）， 支持多种Binding数据格式（SOAP，XML，JSON等）， 支持多种DataBinding数据类型（JAXB， Aegis) 。CXF基于Interceptor的架构，使得整个框架非常易于扩展。

二.? 如何发布并调用简单的web service实例

2.1．下载：apache-cxf- 2.1.1 ? http://cxf.apache.org/download.html

2.2． 新建java project,并加入apache-cxf- 2.0.7 /lib所有包，编写要发布的web service 接口和实现

import javax.jws.WebService;

@WebService?

public interface HelloWorld {??

???? public String sayHello(String text);??

}

import javax.jws.WebService;??

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

public class HelloWorldImpl implements HelloWorld {??

????? public String sayHello(String text) {??

????????????????? return "Hello" + text ;??

??? }??

? }?

@WebService?注解表示是要发布的web 服务

name：用于Interface，属映射到wsdl:portType element的name属性。
targetNamespace：用于Interface和implement，如果不指定，缺省会使用包名倒序做为wsdl名空间。

serviceName：用于implement，表示wsdl服务名。

portName：用于implement，表示wsdl:port 的name属性。

endpointInterface：用于implement，指定Interface全名，包括包名。

2.3.发布web service

public class Server {

??? protected Server() throws Exception {

??? ??? ?System.out.println("Starting Server");

???????? HelloWorldImpl implementor = new HelloWorldImpl();

???????? String address = "http://localhost:9000/helloWorld";

???????? Endpoint.publish(address,implementor);

??? }

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

??????? new Server();

??????? System.out.println("Server ready...");

??????? Thread.sleep(5 * 60 * 1000);

??????? System.out.println("Server exiting");

??????? System.exit(0);

??? }

}

运行后，在浏览器中输入http://localhost:9000/helloWorld?wsdl将显示这个web service的wsdl.说明web service发布成功。

2.4.下面就开始创建一个客户端程序，访问这个web service, 同样新建java project,并加入apache-cxf- 2.0.7 /lib所有包，由于CXF已经提供wsdl转化成java 的命令工具，所以创建一个build.xml，用来生成客户端程序。Bulid.xml内容如下：

<?xml version="1.0"?>

<project name="cxf wsdl2java" basedir=".">??

?? <property name="cxf.home" location ="${basedir}/WebRoot/WEB-INF/"/>

?? <path id="cxf.classpath">

????? <fileset dir="${cxf.home}/lib">

???????? <include name="*.jar"/>

????? </fileset>

?? </path>?????

?? <target name="cxfWSDLToJava">

????? <java classname="org.apache.cxf.tools.wsdlto.WSDLToJava" fork="true">

???????? <arg value="-client"/>

???????? <arg value="-d"/>

???????? <arg value="src"/>

????? ???<arg value="http://localhost:9000/helloWorld?wsdl"/>

???????? <classpath>

??????????? <path refid="cxf.classpath"/>

???????? </classpath>

????? </java>

?? </target>

</project>

或者：配置环境变量%CXF_HOME%=E:/WebService/CXF/apache-cxf- 2.1.1 /apache-cxf-2.1.1（以我的目录为例）,并在PATH后加上;%CXF_HOME%/bin

在cmd命令行中输入wsdl2java如果显示其用法表示配置好了。

输入：wsdl2java -d src - client http://localhost:9000/helloWorld?wsdl

其作用上面的build.xml作用一样。

附加：wsdl2java用法：

wsdl2java -p com -d src -all? aa.wsdl

-p? 指定其wsdl的命名空间，也就是要生成代码的包名:

-d? 指定要产生代码所在目录

-client 生成客户端测试web service的代码

-server 生成服务器启动web? service的代码

-impl 生成web service的实现代码

-ant? 生成build.xml文件

-all 生成所有开始端点代码：types,service proxy,service interface,server mainline,client mainline,implementation object,and an Ant build.xml file.

详细用法见：http://cwiki.apache.org/CXF20DOC/wsdl-to-java.html

2.5.调用web service

public class MyClient {

??? ? public static void main(String[] argv) {

??? ??? HelloWorld? hello = new HelloWorldImplService().getHelloWorldImplPort();

??? ??? System.out.println(hello.sayHello("Tom") );?

??? ? }

??? }

注意：运行时，要一定先要发布web sevice.

三.? 参考资料

1.CXF 主页: http://cxf.apache.org/

2. CXF中文讨论组: http://groups.google.com/group/cxf-zh?

3. Web service: http://www.w3school.com.cn/webservices/index.asp
4. WSDL: http://www.w3school.com.cn/wsdl/index.asp
5. SOAP:http://www.w3school.com.cn/soap/index.asp