webservice使用教程

Web Service实践之——开始XFire

一、Axis与XFire的比较
XFire是与Axis2 并列的新一代WebService平台。之所以并称为新一代，因为它：
1、支持一系列Web Service的新标准--JSR181、WSDL2.0 、JAXB2、WS-Security等；
2、使用Stax解释XML,性能有了质的提高。XFire采用Woodstox 作Stax实现；

<?xml version="1.0" encoding="GB2312">  
<!DOCTYPE web-app   
  PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"   
  "http://java.sun.com/dtd/web-app_2_3.dtd">  
   
<web-app>  
 
 <servlet>  
 <servlet-name>XFireServlet</servlet-name>  
   <display-name>XFire Servlet</display-name>  
   <servlet-class>org.codehaus.xfire.transport.http.XFireConfigurableServlet</servlet-class>  
 </servlet>  
 <servlet-mapping>  
  <servlet-name>XFireServlet</servlet-name>  
 <url-pattern>/servlet/XFireServlet/*</url-pattern>  
 </servlet-mapping>  
 
<servlet-mapping>  
 <servlet-name>XFireServlet</servlet-name>  
<url-pattern>/services/*</url-pattern>  
</servlet-mapping>  
 
</web-app>  

其中主要就是引入了XFireServlet，用以处理Web Service请求，并且负责提供Web Service的WSDL，如果你发布了一个名为BookService的WebService，则可以通过网址：
http://<服务器>[:端口]/<webapp名>/services/BookService
来访问这个WebService，并且通过地址：
http://<服务器>[:端口]/<webapp名>/services/BookService?WSDL  来得到这个WebService的WSDL信息。

2、开发最简单的WebService
在WEB-INF目录下新建src文件夹，然后再建一个package:
cn.com.pansky.webservice.xfire.study
，在这个包下面新建一个接口：

Java代码

package cn.com.pansky.webservice.xfire.study;   
 
public interface SayHiService{   
 public String sayHi(String name);   
}  
package cn.com.pansky.webservice.xfire.study;

public interface SayHiService{
  public String sayHi(String name);
}

这个接口是告诉服务器你的WebService哪些方法可以被用户调用的。下面我们再来写一个SayHiService的实现类，以完成业务逻辑：

Java代码

package cn.com.pansky.webservice.xfire.study;   
  
public class SayHiServiceImpl implements SayHiService{   
  public String sayHi(String name){   
    if(name==null){   
      return "连名字也不肯告诉我吗？";   
    }   
    return name+", 你吃了吗？没吃回家吃去吧。";   
  }   

  
  public String 不告诉你(){   
   return "我的名字不告诉你！";   
 }   
}  

这个类实现了sayHi方法，该方法是可以通过WebService调用访问到的。另外还实现了一个方法“不告诉你”，该方法因为没有在接口SayHiService中定义，所以不能被WebService调用到。
   这个例子足够简单吧，就跟我们刚学Java时写的"Hello world"没什么两样。
到这里为止，我们做的跟平时的Java开发没啥区别，该如何来发布WebService呢？

3、把JAVA类发布为WebService：
在WEB-INF/classes目录下新建文件夹：META-INF/xfire，然后在该文件夹下新建一个XML文件：services.xml，文件内容如下：

Xml代码 

 这个文件

<beans xmlns="http://xfire.codehaus.org/config/1.0">  
  <service>  
    <name>SayHiService</name>  
    <namespace>http://cn.com.pansky/SayHiService</namespace>  
    <serviceClass>cn.com.pansky.webservice.xfire.study.SayHiService</serviceClass>  
    <implementationClass>cn.com.pansky.webservice.xfire.study.SayHiServiceImpl</implementationClass>  
  </service>  
</beans>  
<beans xmlns="http://xfire.codehaus.org/config/1.0">
  <service>
    <name>SayHiService</name>
    <namespace>http://cn.com.pansky/SayHiService</namespace>
    <serviceClass>cn.com.pansky.webservice.xfire.study.SayHiService</serviceClass>
    <implementationClass>cn.com.pansky.webservice.xfire.study.SayHiServiceImpl</implementationClass>
  </service>
</beans>

定义一个WebService: SayHiService，并同时定义了接口和实现类。
好了，该建的文件基本建完了，现在想办法把src下的java文件编译成class，并复制到WEB-INF/classes目录下

4、启动Tomcat，测试WebService
如果Tomcat还没配置好，抽两分钟再配一下。再把Tomcat启动起来。
再打开浏览器，输入：
http://localhost/stove/services
，服务器返回的结果如下：
Available Services:
    * SayHiService [wsdl]
     Generated by XFire ( http://xfire.codehaus.org/ )
我们看到我们的WebService已经布署成功了，我们再看看它的WSDL信息：

Xml代码

<?xml version="1.0" encoding="UTF-8"?>  
<wsdl:definitions targetNamespace="http://cn.com.pansky/SayHiService" xmlns:tns="http://cn.com.pansky/SayHiService" xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenc11="http://schemas.xmlsoap.org/soap/encoding/" xmlns:soapenc12="http://www.w3.org/2003/05/soap-encoding" xmlns:soap11="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">  
  <wsdl:types>  
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="http://cn.com.pansky/SayHiService">  
<xsd:element name="sayHi">  
<xsd:complexType>  
<xsd:sequence>  
<xsd:element maxOccurs="1" minOccurs="1" name="in0" nillable="true" type="xsd:string"/>  
</xsd:sequence>  
</xsd:complexType>  
</xsd:element>  
<xsd:element name="sayHiResponse">  
<xsd:complexType>  
<xsd:sequence>  
<xsd:element maxOccurs="1" minOccurs="1" name="out" nillable="true" type="xsd:string"/>  
</xsd:sequence>  
</xsd:complexType>  
</xsd:element>  
</xsd:schema>  
  </wsdl:types>  
  <wsdl:message name="sayHiRequest">  

    <wsdl:part name="parameters" element="tns:sayHi">  
    </wsdl:part>  
  </wsdl:message>  
  <wsdl:message name="sayHiResponse">  
    <wsdl:part name="parameters" element="tns:sayHiResponse">  
    </wsdl:part>  
  </wsdl:message>  
  <wsdl:portType name="SayHiServicePortType">  
    <wsdl:operation name="sayHi">  
      <wsdl:input name="sayHiRequest" message="tns:sayHiRequest">  
    </wsdl:input>  
      <wsdl:output name="sayHiResponse" message="tns:sayHiResponse">  
    </wsdl:output>  
    </wsdl:operation>  
  </wsdl:portType>  
  <wsdl:binding name="SayHiServiceHttpBinding" type="tns:SayHiServicePortType">  
    <wsdlsoap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>  
    <wsdl:operation name="sayHi">  
      <wsdlsoap:operation soapAction=""/>  
      <wsdl:input name="sayHiRequest">  
        <wsdlsoap:body use="literal"/>  
      </wsdl:input>  
      <wsdl:output name="sayHiResponse">  
        <wsdlsoap:body use="literal"/>  
      </wsdl:output>  
    </wsdl:operation>  
  </wsdl:binding>  
  <wsdl:service name="SayHiService">  
    <wsdl:port name="SayHiServiceHttpPort" binding="tns:SayHiServiceHttpBinding">  
      <wsdlsoap:address location="http://localhost/stove/services/SayHiService"/>  
    </wsdl:port>  
  </wsdl:service>  
</wsdl:definitions> 

这个文件跟我们用Axis生成的基本是一样的。

5、享受美味的时刻
WebService这道大餐算是烹制好了，现在是享用美餐的时候了。
我们写一个客户端吃掉这道大餐：

Java代码

package cn.com.pansky.webservice.xfire.study;   
  
import java.net.MalformedURLException;   
import java.util.Map;   
  
import org.codehaus.xfire.client.Client;   
import org.codehaus.xfire.client.XFireProxyFactory;   
import org.codehaus.xfire.service.Service;   
import org.codehaus.xfire.service.binding.ObjectServiceFactory;   
import org.codehaus.xfire.transport.http.CommonsHttpMessageSender;   
  
public class SayHiClient{   
  public static void main(String args[]) {   
    String serviceURL = "http://localhost/stove/services/SayHiService";   
    Service serviceModel = new ObjectServiceFactory().create(SayHiService.class,null,"http://cn.com.pansky/SayHiService",null);   
  
    XFireProxyFactory serviceFactory = new XFireProxyFactory();   
  
    try{   
      SayHiService service = (SayHiService) serviceFactory.create(serviceModel, serviceURL);   
      Client client = Client.getInstance(service);   
      //client.addOutHandler(new OutHeaderHandler());   
  
      // disable timeout   
      client.setProperty(CommonsHttpMessageSender.HTTP_TIMEOUT, "1");   
  
      String hello = service.sayHi("张山疯");   
      System.out.println("服务器对[张山疯] 的回答是：" + hello );   
  

      hello = service.sayHi(null);   
      System.out.println("服务器胡言乱语说：" + hello );   
  
    } catch (MalformedURLException e) {   
      e.printStackTrace();   
    }   
  }   
}  

编译这个类，再执行一下，服务器服务的结果是：

2008-5-22 17:39:17 org.apache.commons.httpclient.HttpMethodBase writeRequest
信息: 100 (continue) read timeout. Resume sending the request
2008-5-22 17:39:17 org.apache.commons.httpclient.HttpMethodBase readResponse
信息: Discarding unexpected response: HTTP/1.1 100 Continue
服务器对[张山疯] 的回答是：张山疯, 你吃了吗？没吃回家吃去吧。
2008-5-22 17:39:20 org.apache.commons.httpclient.HttpMethodBase writeRequest
信息: 100 (continue) read timeout. Resume sending the request
2008-5-22 17:39:20 org.apache.commons.httpclient.HttpMethodBase readResponse
信息: Discarding unexpected response: HTTP/1.1 100 Continue
服务器胡言乱语说：连名字也不肯告诉我吗？

好了，WebService布署成功。

下课！