WebServices和Xfire学习总结

你会怎样向别人介绍你的Web service有什么功能，以及每个函数调用时的参数呢？你可能会自己写一套文档，你甚至可能会口头上告诉需要使用你的Web service的人。这些非正式的方法至少都有一个严重的问题：当程序员坐到电脑前，想要使用你的Web service的时候，他们的工具(如Visual Studio)无法给他们提供任何帮助，因为这些工具根本就不了解你的Web service。解决方法是：用机器能阅读的方式提供一个正式的描述文档。Web service描述语言(WSDL)就是这样一个基于XML的语言，用于描述Web service及其函数、参数和返回值。因为是基于XML的，所以WSDL既是机器可阅读的，又是人可阅读的，这将是一个很大的好处。一些最新的开发工具既能根据你的Web service生成WSDL文档，又能导入WSDL文档，生成调用相应Web service的代码。

XFire

XFire是一个开源的SOAP框架，用它可以快速开发WS。

它在Eclipse下的配置也是相当简单，甚至你可能都不需要做什么配置。

在Eclipse下新建一个Web Service Project工程，这个工程与传统的Web Project工程不同的不过是通过向导添加XFire以及services.xml。

关于services.xml各元素信息，请参阅官方文档http://xfire.codehaus.org/services.xml+Reference。

现在我们的Web服务已经配置好了，我们可以在地址栏中输入http://localhost:8080/SimpleWSExam/services,可以看到

单击wsdl连接，可以看到关于这个WS的WSDL。在XFire下配置WS就是这么简单！

现在我们来写客户端，

HelloWorldClient.java

public class HelloWorldClient {
?public static void main(String args[]){
??String serviceURL = "http://localhost:8080/SimpleWSExam/services/HelloWorldService";
??????? Service serviceModel = new ObjectServiceFactory().create(HelloWorldService.class,null,"http://localhost:8080/SimpleWSExam/services/HelloWorldService",null);
???????
??????? XFireProxyFactory serviceFactory = new XFireProxyFactory();
??????? try {
???HelloWorldService hello=(HelloWorldService)serviceFactory.create(serviceModel,serviceURL);
??????? System.out.println(hello.sayHello("Jackal Wood"));
???} catch (MalformedURLException e) {
???// TODO Auto-generated catch block
???e.printStackTrace();
??}
??
?}
}

一个众人皆知的道理是，WS是只读的，也就是说，WS不能有setxxx()。

如果取的值是List或者是Map，则需要在与源文件相同的目录下创建名为xxxx.aegis.xml的文件，其中xxxx是服务的类名，比如我们在接口中添加public List getList();并实现之，如果客户端想调用这个函数，需要写HelloWorldService.aegis.xml：

?Aegis 是 XFire 的缺省的绑定方式,可以将 XML 映射成 POJO。，在官方例子中，aegis文件中对类的描述基本是全部的，不像我这里只是写上必须的描述。关于aegis，请见其它更详细的资料。当然XFire不仅仅可以绑定aegis，它还支持JAXB2、XMLBeans、Castor、Jibx。

身份验证

XFire提供了四种身份验证的方式，分别是http验证，JSR181,Handler验证，WS-Security。

这里我们只谈Handler验证。

SOAP的原理告诉我们一个WS交互的流程是客户端发送请求－>服务器接收请求－>服务器发送数据->客户端接收数据，handler可以让我们在这四个操作中之前进行编码，所以，我们的验证进行在客户端发送请求和服务器接收请求的时候，因此，我们要写两个handler，然后把它们装配上就可以了。

服务器接收请求：

AuthentificationHandler.java:

package org.vivianj.xfire.handlers;

import org.codehaus.xfire.MessageContext;
import org.codehaus.xfire.handler.AbstractHandler;
import org.jdom.Element;
import org.jdom.Namespace;

public class AuthentificationHandler extends AbstractHandler {

?public void invoke(MessageContext cfx) throws Exception {
??// TODO Auto-generated method stub
??
????? if(cfx.getInMessage().getHeader() == null)
????? {
??? ?? throw new org.codehaus.xfire.fault.XFireFault("请求必须包含验证信息",org.codehaus.xfire.fault.XFireFault.SENDER);
????? }
????? Element token=cfx.getInMessage().getHeader().getChild("AuthenticationToken");

????? if (token == null)

????? {

????????? throw new org.codehaus.xfire.fault.XFireFault("请求必须包含身份验证信息",

??????? ??? org.codehaus.xfire.fault.XFireFault.SENDER);

????? }

????? String username = token.getChild("Username").getValue();

????? String password = token.getChild("Password").getValue();

????? try

????? {

????????? //进行身份验证

???????? if(username.equals("jackal") && password.equals("talent"))
??????? ? //这语句不显示
??????? ? System.out.println("身份验证通过");
???????? else throw new Exception();
????????????????? // 身份验证通过

???????? // cfx.setProperty(User_KEY,user);

????? }

????? catch (Exception e)

????? {

????????? throw new?? org.codehaus.xfire.fault.XFireFault("非法的用户名和密码",?? org.codehaus.xfire.fault.XFireFault.SENDER);

????? }

? }

}

客户端发送请求：

ClientAuthenticationHandler.java

package org.vivianj.xfire.handlers;

import org.codehaus.xfire.MessageContext;
import org.codehaus.xfire.handler.AbstractHandler;
import org.jdom.Element;
import org.jdom.Namespace;