XFire 是 codeHaus 组织提供的一个开源框架,它构建了 POJO 和 SOA 之间的桥梁,主要特性就是支持将 POJO 通过非常简单的方式发布成 Web 服务,这种处理方式不仅充分发挥了 POJO 的作用,简化了 Java 应用转化为 Web 服务的步骤和过程,也直接降低了 SOA 的实现难度,为企业转向 SOA 架构提供了一种简单可行的方式。
MyEclipse 6已经集成了XFire框架,可以直接使用MyEclipse 6和XFire开发Web Service应用。下面以一个HelloWorld最简单的应用学习Web Service。
首先,建立一个Web Service Project,输入功能名HelloWorld,然后下一步创建XFire Servlet和services.xml,如图所示:
默认情况下,会选中Servlet class为org.codehaus.xfire.transport.http.XFireConfigurableServlet,在创建Web Service Project向导完成之后,该XFire Servlet会自动在web.xml中配置好的。
接下来,添加XFire的库文件,如下所示:
单击完整Web Service Project的创建。
这时候,可以看到工程中多了一个WebServices目录,该目录下面生成的就是services.xml文件,内容如下所示:
应用的部署描述符文件web.xml文件内容如下所示:
其实,就是配置了一个名称为XFireServlet的Servlet及其映射。
创建Web Service文件,如图所示:
单击下一步,如图所示:
需要选中Create new Java bean,然后创建Java Web Service,如图所示:
上面,HelloWorldService就是我们创建的服务的名称,可以通过这个字符串来调用相应的服务。
此时,services.xml文件中就会自动配置刚才定义的服务了,如下所示:
|
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://xfire.codehaus.org/config/1.0">
<service>
<name>HelloWorldService</name>
<serviceClass>
tk.shirdrn.webservice.IHelloWorldService
</serviceClass>
<implementationClass>
tk.shirdrn.webservice.HelloWorldServiceImpl
</implementationClass>
<style>wrapped</style>
<use>literal</use>
<scope>application</scope>
</service></beans>
|
下面实现定义的服务,首先在接口类IHelloWorldService.java文件中修改并且添加所需要定义的服务:
|
package tk.shirdrn.webservice;
public interface IHelloWorldService {
public String showGreetings(String name);
public String getServerTime();
}
|
接着就要实现该接口,HelloWorldServiceImpl.java实现如下:
|
package tk.shirdrn.webservice;
public class HelloWorldServiceImpl implements IHelloWorldService {
public String getServerTime() {
String date = new java.util.Date().toLocaleString();
return date;
}
public String showGreetings(String name) {
String greetings = "Hello," + name + "!";
return greetings;
}
}
|
将该Web Service发布到Tomcat服务器上,并启动Tomcat WEB服务器。
可以在MyEclipse工具栏中看到快捷方式,如图所示:
打开Web Service Explorer,你会看到如图所示的Web Service Explorer界面:
如果不是第一次使用的话,可以直接在Actions框架页面中选择Browse来查找可用的URL;否则,你需要在Actions框架内填写正确的WSDL URL。例如这里使用的是:
http://localhost:8080/HelloWorld/services/HelloWorldService?WSDL
如果失败的话,在Status中会提示错误信息;如果成功的话,显示如下所示的界面:
现在可以调用Web Service了。
选中左侧导航栏服务中具体服务,就可以在右侧进行调用获得服务,如图所示:
上面,是直接使用MyEclipse内置的Web Service Explorer进行测试。另外,还可以直接在外部的浏览器中进行测试,例如,在IE浏览器地址栏中键入链接:
http://localhost:8080/HelloWorld/services/HelloWorldService?WSDL
可以在页面上看到如下所示的WSDL文件:
|
<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions targetNamespace="http://webservice.shirdrn.tk" xmlns:tns="http://webservice.shirdrn.tk" 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://webservice.shirdrn.tk">
<xsd:element name="getServerTime">
<xsd:complexType/>
</xsd:element>
<xsd:element name="getServerTimeResponse">
<xsd:complexType>
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="out" nillable="true" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="showGreetings">
<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="showGreetingsResponse">
<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="showGreetingsResponse">
<wsdl:part name="parameters" element="tns:showGreetingsResponse">
</wsdl:part>
</wsdl:message>
<wsdl:message name="showGreetingsRequest">
<wsdl:part name="parameters" element="tns:showGreetings">
</wsdl:part>
</wsdl:message>
<wsdl:message name="getServerTimeResponse">
<wsdl:part name="parameters" element="tns:getServerTimeResponse">
</wsdl:part>
</wsdl:message>
<wsdl:message name="getServerTimeRequest">
<wsdl:part name="parameters" element="tns:getServerTime">
</wsdl:part>
</wsdl:message>
<wsdl:portType name="HelloWorldServicePortType">
<wsdl:operation name="getServerTime">
<wsdl:input name="getServerTimeRequest" message="tns:getServerTimeRequest">
</wsdl:input>
<wsdl:output name="getServerTimeResponse" message="tns:getServerTimeResponse">
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="showGreetings">
<wsdl:input name="showGreetingsRequest" message="tns:showGreetingsRequest">
</wsdl:input>
<wsdl:output name="showGreetingsResponse" message="tns:showGreetingsResponse">
</wsdl:output>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="HelloWorldServiceHttpBinding" type="tns:HelloWorldServicePortType">
<wsdlsoap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="getServerTime">
<wsdlsoap:operation soapAction=""/>
<wsdl:input name="getServerTimeRequest">
<wsdlsoap:body use="literal"/>
</wsdl:input>
<wsdl:output name="getServerTimeResponse">
<wsdlsoap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="showGreetings">
<wsdlsoap:operation soapAction=""/>
<wsdl:input name="showGreetingsRequest">
<wsdlsoap:body use="literal"/>
</wsdl:input>
<wsdl:output name="showGreetingsResponse">
<wsdlsoap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="HelloWorldService">
<wsdl:port name="HelloWorldServiceHttpPort" binding="tns:HelloWorldServiceHttpBinding">
<wsdlsoap:address location="http://localhost:8080/HelloWorld/services/HelloWorldService"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
|
这也说明我们开发的Web Service发布成功。关于上面的文件会在后面学习介绍。