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

参考:http://blog.csdn.net/neareast/article/details/7717568
文中对应的代码已经上传，与教程（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参数指定我们需要的命名空间：
生成客户端文件1:
wsdl2java -p com.neareast.test.cxf.client.WSDL2Java -frontend jaxws21
http://localhost:9000/helloWorld?wsdl
生成客户端文件2:
wsdl2java  -d /mnt/d/vmware_shared_folder/workspace/webserviceclient/src/main/java -p com.websercices.client -frontend jaxws21 http://localhost:8080/webservice/HelloWorld?wsdl
-d参数：指定文件存放位置．
一些参数说明：
wsdl2java -ant -client -d D:/temp -p com.neareast.test.cxf.client.WSDL2Java -frontend jaxws21 hello_world.wsdl
-ant 指定要生成一个ant的构建说明文档build.xml。
-client 指定要生成一个测试客户端的“起点代码”（starting point code），其中包含了端口中所有方法的测试样例代码。
-d 指定我们想要把生成的文件放到哪个目录下，默认是wsdl2Java命令所在的目录。
-p 指定生成文件的包名；默认是根据WSDL文件中的命名空间相对应。
-frontend 指定前端类型及版本；目前仅支持 JAXWS 前端，用 "jaxws21" 表明要生成JAX-WS 2.1 兼容的代码（Jre6自带的就是这个版本），使用该参数的原因请参考教程(2)。

生成的类如下图所示；其中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"));