CXF入门教程（2） -- 第一个客户端

文中对应的代码已经上传，与教程（1）中的service相对应。为调试方便，将service和client都放在了同一个工程中，不过是在不同的包中；本文对应的两个基本客户端在com.neareast.test.cxf.client.consumer包中，服务端ServiceTest类在com.neareast.test.cxf.server.service包中。代码地址如下：

http://download.csdn.net/detail/neareast/4411870

最常见的情境是，我们有一个服务的WSDL；无论这个服务是不是我们自己维护的，我们都可以从这个WSDL文件来生成客户端，包括一个强类型的接口，并通过接口来与服务进行交互。

使用WSDL2Java工具，可以通过WSDL生成JAX-WS客户端。使用WSDL2java有以下三种方法:

• The command line 命令行
• The Maven Plugin Maven插件
• 使用WSDL2Java API

要深入获取更多信息，可以参阅 Developing a JAX-WS consumer 一文或发型包中的示例程序。

Eclipse和Maven的插件最终应该还是调用WSDL2Java命令来实现的。这里我们使用上一篇中发布的服务，直接在控制台使用 wsdl2java http://localhost:9000/helloWorld?wsdl 命令，即可在命令所在目录下（ 如笔者在 apache-cxf-2.6.1包的bin目录下调用wsdl2java 命令，生成的类文件就在这个目录下），生成与WSDL中的targetNamespace相对应的包路径，将相应的类放到该目录下，客户端直接调用这些类即可；比较无奈的是，生成的代码居然是ANSI格式的……

然而，生成的HelloWorld类报错，如HelloWorld方法的super(WSDL_LOCATION, SERVICE, features);这行报错，原因是javax.xml.ws.Service中缺少Service(URL, QName, WebServiceFeature[]) 构造方法。我们引入的geronimo-jaxws_2.2_spec-1.1.jar包里，提供了新版本的Service类，但是需要进行endorse才能够替换掉jre自带的Service类。为尽量较少以后移植的麻烦，我们可以根据注释中的提示指定-frontend参数，使用JAX-WS 2.1兼容模式重新生成所有的类，顺便用-p参数指定我们需要的命名空间：

wsdl2java -p com.neareast.test.cxf.client.WSDL2Java -frontend jaxws21 http://localhost:9000/helloWorld?wsdl

生成的类如下图所示；其中HelloWorld类用来启动对服务的监听，IHelloWorld类就是调用服务的接口。

一旦生成了客户端，典型的用法如下：

public class BasicClient {
	public static void main(String[] args){
		HelloWorld server = new HelloWorld();
		IHelloWorld hello = server.getHelloWorldImplPort();

		String result = hello.sayHi("East");
		System.out.println(result);
		
		User user = new User();
		user.setName("East");
		System.out.println(hello.sayHiToUser(user));
		
		System.out.println("All the users are: ");
		for(IdentifiedUser u:hello.getUsers().getEntry()){
			System.out.println( u.getUser().getName() );
		}
	}
}

至此，一个简单的webService客户端已经完成了。

JAX-WS代理

除了使用使用wsdl2java 直接生成客户端，我们也可以使用 Service.create 来生成服务实例，下面的代码展示了这一过程： 

        URL url = null;
        try {
            url = new URL("http://localhost:9000/helloWorld?wsdl");
        } catch (MalformedURLException e) {
            java.util.logging.Logger.getLogger(HelloWorld.class.getName())
                .log(java.util.logging.Level.INFO, 
                     "Can not initialize the default wsdl from {0}", "http://localhost:9000/helloWorld?wsdl");
        }
        WSDL_LOCATION = url;

        Service service = Service.create(WSDL_LOCATION, SERVICE_NAME);
        
        IHelloWorld hw = service.getPort(IHelloWorld.class);
        System.out.println(hw.sayHi("World"));