用XFire发布WebService

WebService的概念就不多说了，直接进入主题：如何用XFire发布WebService。比较流行的发布WebService的框架有XFire、CXF、AXIS等等。到目前为止接触过的有XFire和CXF，所以想写个例子，以备以后不时之需。

要使用XFire，首先需要去下载XFire的Jar包，然后新建一个Web工程，将XFire的jar包放在lib目录中，全部引入。在web.xml文件中加入XFire的Servlet，代码如下：

<?xml version="1.0" encoding="UTF-8"?>

<web-app version="2.5"
 xmlns="http://java.sun.com/xml/ns/javaee"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
 http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
  <welcome-file-list>
    <welcome-file>index.jsp</welcome-file>
  </welcome-file-list>
 
  <servlet>
   <servlet-name>XFireServlet</servlet-name>
   <servlet-class>org.codehaus.xfire.transport.http.XFireConfigurableServlet</servlet-class>
  </servlet>

  <servlet-mapping>
   <servlet-name>XFireServlet</servlet-name>
   <url-pattern>/services</url-pattern>

</servlet-mapping>
public interface IXFireService {
 public String sayHello(String name);
}

接口很简单，就是一个返回字符串的方法。在WebService的方法中，建议输入参数和返回参数都设为String类型，设置为对象类型的话还得做转换，比较麻烦。在我所做过的项目的WebService中，不管是我提供服务还是我去调用别人的服务，输入参数和返回参数都是String类型的。

接下来提供一个接口的实现类，代码如下：

package cn.com.huixin.webservice.impl;

import cn.com.huixin.webservice.IXFireService;

public class XFireServiceImpl implements IXFireService {

 
 public String sayHello(String name) {
  return name + " say: Hello!";
 }

}

代码比较简单，就不再赘述了。接口和实现类准备好后，就该XFire的配置文件了，在这个文件中将上述的接口和实现类加入配置之后，才能将其作为WebService发布出去。按照XFire的约定，要在工程的classes目录中建一个名为META-INF的文件夹，在这个文件夹中建一个xfire的文件夹，在该文件夹中建一个名为services.xml的配置文件。所以在工程的src\META-INF\xfire路径下建这样一个文件，Eclipse编译之后，就会在classes\META-INF\xfire目录中出现services.xml文件。services.xml文件的代码如下：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://xfire.codehaus.org/config/1.0">
 <service>
  <name>xfireService</name>
  <namespace>
   http://www.huixin.com.cn/webservice/helloworld
  </namespace>
  <serviceClass>cn.com.huixin.webservice.IXFireService</serviceClass>
  <implementationClass>
   cn.com.huixin.webservice.impl.XFireServiceImpl
  </implementationClass>
 </service>
</beans>

其中，name节点指明了WebService的地址，namespace指明了WebService的命名空间，命名空间可以随便取，我查了一下，网上也没说明白命名空间的具体作用。serviceClass节点指明了WebService的接口，包括这个接口的包名。implementationClass节点是WebService接口的实现类的完整路径名。这个文件配置好之后，WebService的地址也就确定了，地址为:

http:// 主机地址:端口号/ 工程名/ 在web.xml文件中配置的XFire的Servlet的mapping的模式/ 在services.xml文件中配置的name节点值。

以我这个例子来说，主机就是localhost，端口号是tomcat的默认端口号8080，工程名是webservice，在web.xml文件中配置的XFireConfigurableServlet的mapping模式是services，在services.xml文件中配置的name节点的值是xfireService，所以我的这个WebService的地址就是： http://localhost:8080/webservice/services/xfireService。

将工程启动起来，在IE浏览器中访问 http://localhost:8080/webservice/services/xfireService?wsdl这个WebService的wsdl地址，如果出现类似下边的xml文件格式的画面，就说明WebService发布成功了：

WebService发布成功之后，就可以写客户端来访问这个Web服务了。下来介绍如何使用XFire来编写客户端访问这个WebService。

新建一个java工程，将XFire的Jar包引入。我们使用的这种方式有一个缺点，就是在客户端必须知道WebService的接口，所以现将WebService的接口IXFireService复制过来，然后新建一个java类，名字为XFireClient，代码如下：

package cn.com.huixin.webservice;

import org.codehaus.xfire.XFire;
import org.codehaus.xfire.XFireFactory;
import org.codehaus.xfire.client.XFireProxyFactory;
import org.codehaus.xfire.service.Service;
import org.codehaus.xfire.service.binding.ObjectServiceFactory;

public class XFireClient {
 
 public static void main(String[] args) {
  Service serviceModel = new ObjectServiceFactory().create(IXFireService.class);

  XFire xfire = XFireFactory.newInstance().getXFire();
  XFireProxyFactory factory = new XFireProxyFactory(xfire);
  String serviceUrl = "http://localhost:8080/webservice/services/xfireService";
  IXFireService client = null;
  try {
   client = (IXFireService) factory.create(serviceModel, serviceUrl);
  } catch (Exception e) {
   System.out.println("Client call webservice has exception: "
     + e.toString());
  }

  String retvalue = client.sayHello("andrew Lau");

  System.out.println(retvalue);
 }

}

其中的serviceUrl就是我们发布的WebService的地址，注意此处后边不需要“?wsdl”，IXFireService就是WebService的接口。

在此后的博文中我会介绍不需要引入WebService接口来调用WebService的方法。