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;

@WebService
public 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进行异步调用。