在Spring中使用XFire构建Web Service应用

各种客户端调用方式

XFire为访问服务端Web Service提供了各种方便的方式：在可以获取服务端窄接口类的情况下，可以根据服务地址和窄接口类创建客户调用程序。

如果不能获得服务窄接口类，XFire允许你通过WSDL文件生成客户端调用程序，通过指定服务接口的方式调用服务。鉴于这种调用方式不够面向对象，XFire提供了一个根据WSDL生成客户端存根代码的工具，这样你就可以方便以面向对象的方式编写客户端程序了。

使用服务端的窄接口类

如果客户端可以获取服务端的Web Service的窄接口类，这时可以使用XFire的ObjectServiceFactory将对应地址的Web Service转换为窄接口实例进行调用，如代码清单4所示：

代码清单4使用窄接口调用Web Service应用

package com.baobaotao.xfire.client;

import org.codehaus.xfire.client.XFireProxyFactory;

import org.codehaus.xfire.service.Service;

import org.codehaus.xfire.service.binding.ObjectServiceFactory;

import com.baobaotao.xfire.server.BbtForumService;

public class WithClassClient {

public int getRefinedTopicCount() {

①根据窄接口创建Service模型

Service serviceModel = new ObjectServiceFactory().create(BbtForumService.class);

②服务对应URL地址

String serviceURL = "http://localhost:8080/baobaotao/service/BbtForumService";

BbtForumService service = null;

try {

③将Web Service转换为窄接口实例

service = (BbtForumService) new XFireProxyFactory().

create(serviceModel, serviceURL);

} catch (Exception e) {

throw new RuntimeException(e);

}

return service.getRefinedTopicCount(20);④调用Web Service方法

}

public static void main(String[] args) {

WithClassClient client = new WithClassClient();

System.out.println("topic count is:"+client.getRefinedTopicCount());

}

}

XFire根据Service模型对象及Web Service的URL地址就可以构造出Web Service的调用实例。在服务端Tomcat启动的情况下，运行以上的客户端代码，将可以获得正确的输出。

使用WSDL文件构造客户端程序

并不是任何时候都可以获得Web Service服务端的窄接口类，但我们必然可以获取Web Service对应的WSDL文档。XFire允许我们仅通过Web Service对应的WSDL文件构造客户端访问程序。

这无疑给创建客户端程序带来了极大的便利性，你可以直接通过URL指定WSDL，也可以将WSDL保存在本地系统中，通过InputStream的方式获取WSDL内容。下面，我们使用InputStream的方式提供WSDL：

代码清单5通过WSDL创建客户端程序

package com.baobaotao.xfire.client;

import java.net.URL;

import org.codehaus.xfire.client.Client;

public class OnlyWsdlClient {

public int getRefinedTopicCount() {

try {

String wsdl = "com/baobaotao/xfire/client/BbtForumService.wsdl";①对应的WSDL文件

Resource resource = new ClassPathResource(wsdl);

Client client = new Client(resource.getInputStream(), null);②根据WSDL创建客户实例

③调用特定的Web Service方法

Object[] results = client.invoke("getRefinedTopicCount",new Object[]{20});

return (Integer) results[0];

} catch (Exception e) {

throw new RuntimeException(e);

}

}

public static void main(String[] args) {

OnlyWsdlClient client = new OnlyWsdlClient();

System.out.println("topic count is:" + client.getRefinedTopicCount());

}

}

你可以通过http://localhost:8080/baobaotao/service/BbtForumService?wsdl地址获取BbtForumService对应的WSDL，并将其保存在工程项目的src对应的类包目录：com/baobaotao/xfire/client/BbtForumService.wsdl。

我们通过Spring的ClassPathResource读取BbtForumService.wsdl，XFire从Resource中获取WSDL的输入流并生成一个客户端实例。接着，我们就可以通过这个客户端实例，指定Service服务名和输入参数调用Web Service的服务方法了，如③所示。

可能会有读者认为这种完全根据WSDL创建客户端程序的方式会带来低劣的运行性能，笔者通过测试发现，确实会造成一定的性能降低，但也不象想象中那样低效。

使用基于窄接口的客户端程序和使用基于WSDL的客户端程序访问一次BbtForumService的时间依次是1300 ms和1450 ms。如果WSDL文档很复杂，由于需要解析整个WSDL文档，这种客户端程序的性能会受到更多的挑战。不过，如果只要在程序中缓存Client实例，由于创建Client的代价是一次性的，性能问题就可以忽略了。

根据WSDL生成客户端代码

XFire允许通过运行Ant任务，根据WSDL文件生成访问Web Service的客户端代码存根，同时XFire还提供了一个Eclipse插件完成相同的任务。本节里，我们将学习通过XFire Eclipse插件生成BbtForumService客户端存根代码的知识。

安装Eclipse XFire 插件

1．Help->Software Updates->Find and Install...

2．选择“Search for new features to install”，并点击Next；

3．选择“New Remote Site...”，创建一个Name为XFire，URL为

http://dist.codehaus.org/xfire/update/的网站；

4．点击Finish安装XFire插件。