CXF简单示例（一）

本来没打算写这个的，网上资料已经很多了，不想做这重复的工作。但是今天项目中需要使用CXF异步通信，要先做个测试，先是看了网上的例子，但是并不明白每一步是怎么回事，结果卡了好久，看了网上各种资源，Apache官网也看了，都不是很清楚，因此我想写一篇博客，记录下来。
（题外话：纸上得来终觉浅，绝知此事要躬行；看万卷书，行万里路，理论与实践结合，才能产生真知）
1. 下载需要的Jar
没有比官网更权威的了
2. 新建Java工程（这里先将如何简单的搭建一个服务器，后面再写与Spring整合）
运行环境： win7+ eclipse+ apache-cxf-3.1.2+ JDK1.7+Junit4

client:存放客户端代码
server:存放服务端代码
service:存放服务端接口
test:测试
lib目录:存放CXF所需的jar文件（在下载文件的lib目录下）
3. 编写需要暴露给外部的接口以及它的实现（存放在service下）
这里只是简单的写了个HelloWorldService，麻雀虽小五脏俱全

package com.smart.service;import javax.jws.WebService;@WebServicepublic interface HelloWorldService {    public String sayHello();}

注意：在接口上加了WebService注解。
它的实现类：

package com.smart.service.impl;import javax.jws.WebService;import com.smart.service.HelloWorldService;@WebService(endpointInterface = "com.smart.service.HelloWorldService", targetNamespace = "helloWorld", name = "HelloWorld", portName = "HelloWorldPort", serviceName = "helloWorldService")public class HelloWorldServiceImpl implements HelloWorldService {    @Override    public String sayHello() {        System.out.println("Hello Kitty");        return "Server response";    }}

HelloWorldServiceImpl 上面也是加了WebService注解，并且配置的更加详细了。下面介绍下它的每个属性的意思。
endpointInterface ：定义服务端接口的完整路径；
targetNamespace ：定义导出的服务接口的名域(namespace)，默认是倒置的服务接口Java包名；portName：对应WSDL文档中的wsdl:port元素。默认是Java类名加Port ；
serviceName：定义服务名，与名域一起唯一标识一个服务。默认是其Java类名；
name：定义导出的服务接口的名字，对应于WSDL文档中wsdl:portType。默认是服务接口的Java类名加PortType

服务端写好后，就该启动服务了，然后等待客户端调用

package com.smart.server;import javax.xml.ws.Endpoint;import com.smart.service.impl.HelloWorldServiceImpl;public class Server {    public static void main(String[] args) {        System.out.println("web service start");        // 创建实例接口        HelloWorldServiceImpl implementor = new HelloWorldServiceImpl();        // 设置服务访问地址        String address = "http://localhost:8080/helloWorld";        Endpoint.publish(address, implementor);        System.out.println("web service started");    }}

启动之后，在浏览器中输入“http://localhost:8080/helloWorld”，可以看到如下信息

其中，Service Name，Port Name，Address，WSDL都是客户端访问服务所需要的信息。点击WSDL后面的链接（http://localhost:8080/helloWorld?wsdl）即可查看服务的详细信息。

OK，下面客户端调用服务

package com.smart.client;import java.net.MalformedURLException;import java.net.URL;import javax.xml.namespace.QName;import javax.xml.ws.Service;import com.smart.service.HelloWorldService;public class Client {    // 与WebService.serviceName对应    private static final String SERVICE_NAME = "helloWorldService";    // 与WebService.portName对应    private static final String PORT_NAME = "HelloWorldPort";    // 与WebService.targetNamespace对应    private static final String TARGET_NAMESPACE = "helloWorld";    // wsdl路径，该路径下描述了服务的详细信息    private static final String WSDL_URL = "http://localhost:8080/helloWorld?wsdl";    public static void main(String[] args) throws MalformedURLException {        //创建服务        Service service = Service.create(new URL(WSDL_URL), new QName(                TARGET_NAMESPACE, SERVICE_NAME));        //调用服务，生成HelloWorldService实例        HelloWorldService helloWorld = service.getPort(new QName(                TARGET_NAMESPACE, PORT_NAME), HelloWorldService.class);        //调用方法        String result = helloWorld.sayHello();        System.out.println(result);    }}

Ok，运行即可。
源码地址：https://github.com/Zhang-Jin-Hua/CXFTest
下一篇博客将介绍如何使用CXF进行异步调用。