CXF入门教程（2） -- 简单客户端示例

文中对应的代码已经上传，与教程（1）中的service相对应。为调试方便，将service和client都放在了同一个工程中，不过是在不同的包中；本文对应的两个基本客户端在com.neareast.test.cxf.client.consumer包中，服务端ServiceTest类在com.neareast.test.cxf.server.service包中。
WSDL2Java 生成的客户端
最常见的情境是，你有一个服务的WSDL；无论这个服务是不是受你的管理，你通常可以从这个WSDL文件来生成客户端。这样你可以得到一个强类型的接口，并通过接口来与服务进行交互。一旦生成了客户端，典型的用法如下：

[java]
 HelloWorld server = new HelloWorld();
 IHelloWorld hello = server.getHelloWorldImplPort();

 String result = hello.sayHi("East");
 System.out.println(result);
使用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 命令，即可在命令所在目录下，生成与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参数指定我们需要的命名空间：

[plain]
wsdl2java -p com.neareast.test.cxf.client.WSDL2Java -frontend jaxws21 http://localhost:9000/helloWorld?wsdl
生成的类如下图所示；其中HelloWorld类用来启动对服务的监听，IHelloWorld类就是调用服务的接口。

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

[java]
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;
[java]
Service service = Service.create(WSDL_LOCATION, SERVICE_NAME);

IHelloWorld hw = service.getPort(IHelloWorld.class);
System.out.println(hw.sayHi("World"));
JAX-WS 分发API
JAX-WS 提供了分发机制，使我们可以在没有生成客户端的情况下，很容易地调用服务。使用分发机制，我们可以创建消息（可以是JAXB对象，源对象，或者一个SAAJMessage），并分发到服务器。一个简单的例子可能像下面这样：

import java.net.URL;
import javax.xml.transform.Source;
import javax.xml.ws.Dispatch;
import javax.xml.ws.Service;
...

URL wsdlURL = new URL("http://localhost/hello?wsdl");

Service service = Service.create(wsdlURL, new QName("HelloService"));
Dispatch<Source> disp = service.createDispatch(new QName("HelloPort"), Source.class, Service.Mode.PAYLOAD);

Source request = new StreamSource("<hello/>")
Source response = disp.invoke(request);
注意：即使没有WSDL，我们仍然可以使用分发机制。

如果想得到更多深入的信息，可以查看发行版中的Hello World示例。

Simple frontend客户代理
如果你已经用 simple frontend 开发了一个服务，你就可以用 ClientProxyFactoryBean API 来为你的服务创建一个Java代理客户端。这样你就可以使用服务接口来与服务对话。更多信息请查阅 Simple Frontend 文档。

动态客户端
CXF 包含一个允许你调用操作并为之传递参数的客户端接口，例如：

Client client = ....;
Object[] result = client.invoke("sayHi", "Dan");
在运行时创建客户端有两种途径。第一个选择是使用 ClientFactoryBean 或 JaxWsClientFactoryBean 类。他们将会为service的SEI创建代理对象。这些代理不能处理复杂的对象。

第二种方法是使用 DynamicClientFactory 或它的一个子类。DynamicClientFactory 做的更多，它可以生成并编译WSDL中描述的复杂对象的JAXB POJOs，可以在运行时通过反射使用。

当你将Groovy这样的动态语言与CXF一起使用时，这样做最有意义，但是直接在Java中使用反射也是可以的。

作者：NearEast

补充：Web开发 , 其他 ,