用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的方法。

你可能感兴趣的:(webservice)