Eclipse下使用Xfire创建WebService入门示例（下）

有了在 《Eclipse下使用Xfire创建WebService入门示例（上）》中所描述的构建基础，接下来我们要写一个服务端java类。模拟应用是一个银行转账应用，从账户A转账到账户B并需要给出金额和货币种类。我们先来实现一个接口IBankingService.java代码全文如下：

java 代码

package com.mybank.xfire.example;

public interface IBankingService {

  public String transferFunds(
          String fromAccount, String toAccount, double amount, String currency);

}

然后编写一个普通的Java类BankingService包含了一个叫做transferFunds()的方法来为我们完成这项工作。它需要四个输入参数:

• 　　1、 String fromAccount
• 　　2、 String toAccount
• 　　3、 double amount
• 　　4、 String currency

　　代码如下:

java 代码

package com.mybank.xfire.example;

import java.text.NumberFormat;
import java.text.DecimalFormat;

public class BankingService implements IBankingService {

 //Default constructor.
    public BankingService(){
    }

    /** Transfers fund from one account to another.
    */
    public String transferFunds(
        String fromAccount, String toAccount, double amount, String currency){

        String statusMessage = "";

        //调用业务逻辑执行操作.
        //建立并返回状态信息.
        try {
            NumberFormat formatter = new DecimalFormat("###,###,###,###.00");
            statusMessage = "COMPLETED: " + currency + " " + formatter.format(amount)+
            " was successfully transferred from A/C# " + fromAccount + " to A/C# " + toAccount;
        } catch (Exception e){
            statusMessage = "BankingService.transferFunds(): EXCEPTION: " + e.toString();
        }
        return statusMessage;
    }

｝

你可以看到BankingService是一个普通的Java类，没有任何代码告诉我们它将会在Web Services中使用。只是要有默认的构造函数，类型是public。这是必须的。否则，XFire不能够初始化这个类。好的，这里我们不需要增加任何东西。我们所有的工作都在部署描述符里完成。

Web应用的部署描述符

　　在Java中，Web应用程序通常需要至少一个部署描述符(叫做web.xml)对其进行配置。XFire本身是一个基于servlet的应用程序。因此，我们需要增加必要的引用到描述符文件中。然后我们还必须配置将要创建的Web Services。我们使用一个称为services.xml的新文件来完成这件事。在使用Eclipse工具构建工程的时候我们已经完成了这项配置（参见（上）文）。

services.xml

　　现在我们不得不说一下我们的Web Services的由什么组成的了。这由一个叫做services.xml的文件完成，当这个项目在tomcat发布后，它存放在WEB-INF/classes/META-INF/xfire目录下，它在Web应用程序的标准类路径中。而在Eclipse环境中我们可以清除的看到Eclipse已经为我们把它清楚的列在项目路径中。这里是services.xml中的基本配置条目:

xml 代码

<beans xmlns="http://xfire.codehaus.org/config/1.0">

  <service>
    <name>Banking</name>
    <namespace>mybank</namespace>
    <serviceClass>com.mybank.xfire.example.IBankingService</serviceClass>
    <implementationClass>com.mybank.xfire.example.BankingService</implementationClass>
  </service>

</beans>

Web Services的定义包含在元素中，它还含有一些子元素。

第一个子元素是Banking，它可以是你提供任何的合法名字。这将会被客户端程序和其它需要定位你的服务的组件用到。例如，在服务准备好以后，你将在浏览器上使用这个名字来查看WSDL。

下一个子元素是。任何合法的XML名字都是可以的。用来唯一标识你的服务的各个参数。（注释@）

注释@：Namespace派什么用？namespace的作用是要避免命名冲突。如果我建立一项Web
Service，其中的WSDL文件包含一个名为"foo"的元素，而你想要使用我的服务与另一项服务连接作为补充，这样的话另一项服务的WSDL文件就不能包含名为"foo"的元素。两个服务器程序只有在它们在两个事例中表示完全相同的东西时，才可以取相同的名字。如果有了表示区别的namespace，我的网络服务里的"foo"就可以表示完全不同于另一个网络服务里"foo"的含义。在你的客户端里，你只要加以限制就可以引用我的"foo"。

元素包含了Java类的名字，它指定了方法签名。在我们的例子中，它是接口IBankingService。如果Java类没有实现任何接口，你就需要把类的名字放在这里。在你的Java类或者接口中可能有几个方法。只需要一个入口把它们全部发布为Web Services。

　　保存了实现方法的Java类名。这是一个可选元素。如果上一个元素包含了一个接口，那么相应的实现类必须在这里指定。

　　就是这样。我们的Web Services配置完成了。

我们如何知道Web Service正在工作呢?

　　为了了解Web Service是否正在工作，我们需要测试。首先，我们测试来看WSDL是否可用。我们在浏览器中输入URL。哪个URL?因为我们的应用程序的war文件是aa.war，并且在services.xml中给出的服务名是Banking，WSDL的URL应该是:http://localhost:8080/aa/services/Banking?wsdl。

　　请注意:URL的第一部分，例如，http://localhost:8080，可能会根据你的应用服务器不同而不同。无论怎样，当你输入URL后，将会看到一个XML文档，这个文档叫做服务的WSDL。如果你看到了，这就是你的应用作为Web Service已经可用的第一个证明。

正确的执行情况：

在这个WSDL中我们可以看到<xsd:element name="transferFunds">的服务方法明以及他的四个参数描述等信息。但是这个测试是不够的。可能会发生这种情况，可以看到WSDL，但是从客户端程序可能会访问不到服务。因此为了核实服务是否可以访问了，我们必须使用一个客户端进行服务的实际调用来进行一个真正的测试。

开发一个客户端

编写BankClient.java

java 代码

package com.mybank.xfire.client;

import java.net.MalformedURLException;
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;

import com.mybank.xfire.example.IBankingService;
/**
 * @author AdminiDD
 *
 */
public class BankClient {

 /**
  * @param args
  */
 public static void main(String[] args) {
  // TODO Auto-generated method stub

 }
 /* Call the Web service
    *
    */
    public String callWebService(
        String fromAccount, String toAccount, double amount, String currency)
        throws MalformedURLException, Exception {

        //Create a metadata of the service  创建一个service的元数据
        Service serviceModel = new ObjectServiceFactory().create(IBankingService.class);
        System.out.println("callSoapServiceLocal(): got service model." );

        //Create a proxy for the deployed service 为XFire获得一个代理工厂对象
        XFire xfire = XFireFactory.newInstance().getXFire();
        XFireProxyFactory factory = new XFireProxyFactory(xfire);
        //得到一个服务的本地代理
        String serviceUrl = "http://127.0.0.1:8080/wstest/services/Banking";

        IBankingService client = null;
        try {
            client = (IBankingService) factory.create(serviceModel, serviceUrl);
        } catch (MalformedURLException e) {
         System.out.println("WsClient.callWebService(): EXCEPTION: " + e.toString());
        }

        //Invoke the service 调用服务 返回状态结果信息
        String serviceResponse = "";
        try {
            serviceResponse = client.transferFunds(fromAccount, toAccount, amount, currency);
       } catch (Exception e){
        System.out.println("WsClient.callWebService(): EXCEPTION: " + e.toString());
            serviceResponse = e.toString();
        }
       System.out.println("WsClient.callWebService(): status=" + serviceResponse);

        //Return the response
        return serviceResponse;
    }

}

编写两个JSP页来模拟请求和响应

index.jsp；发送请求

<!----><!---->

java 代码

<!---->
<!---->

<!---->"-//W3C//DTD HTML 4.01 Transitional//EN">


    "<!---->">


 "pragma" content="no-cache">
 "cache-control" content="no-cache">
 "expires" content="0">
 "keywords" content="keyword1,keyword2,keyword3">
 "description" content="This is my page">
 <!---->



    

Welcomle to WebService!

    Bank test : give my money to you!
     "form1" action="say.jsp" method="POST">
      your account ID："toAcc" type="text"/>
      How much do you want："amount" type="text" />
      "center">"submit" value="提交">



  
say.jsp，接收请求并返回响应结果 
java 代码
<!---->

<!---->

<!---->"-//W3C//DTD HTML 4.01 Transitional//EN">


    "<!---->">



 "pragma" content="no-cache">
 "cache-control" content="no-cache">
 "expires" content="0">
 "keywords" content="keyword1,keyword2,keyword3">
 "description" content="This is my page">
 <!---->




     
Welcomle to WebService!

    Message from WebService:<!---->



 
项目aa编译完毕并发布到Tomcat上，启动Tomcat测试开始！访问http://127.0.0.1:8080/aa/index.jsp
执行效果：

添上你的账户，想要多少钱就写多少钱，嘿嘿 提交！请求转发到say.jsp如果你看到下面的情况：

恭喜你！成功啦～ 可以看到有 RMB$ 1,000.00 从affman（a fit foolish man～）的账户转到了liudan的账户上！
总结：
基本的Web Services开发步骤清单 
　　这个清单总结了将一个Java方法发布为Web Service所必须的步骤:


　　1、 检查Java类的方法和默认构造函数确保为public 
　　2、 增加XFire servlet相关条目到web.xml中 
　　3、 创建services.xml，把它放到WEB-INF/classes/META-INF/xfire目录下 
　　4、 增加XFire和第三方包到你的Web应用的WEB-INF/lib文件夹中 

嗯～确实不复杂！
以上步骤均经过亲自测试执行，如有勘误请至mail to： [e-mail] 欢迎指教和共同探讨
以下相关讨论（转自原文http://www.360doc.com/showweb/0/0/516946.aspx）
XFire的其他高级特性 
　　XFire的使用可能比较简单，但是在特性和功能性上，它却占据着领导者的位置。下面是它的高级特性:


　　---本地数据绑定支持POJOs(plain-old Java objects)、XMLBeans、JAXB(Java Architecture for XML Binding)、Castor等等。数据绑定说明了Web Services的XML请求和映射到Java对象的XML响应。 
　　---使用StAX(Streaming API for XML)处理XML文档。同DOM的基于树和SAX的事件驱动的处理方式相比，StAX使用了拉(pull)机制，它使处理更快速，内存效率更高。 
　　---支持多种传输协议，如HTTP、JMS(Java Message Service)和JVM内部传输。 
　　---嵌入式，这是XFire的核心功能之一。你可以把这个SOAP引擎嵌入到你的应用中，完全隐藏所有XFire特定引用，同样所有配置都是程序驱动。 
　　---丰富的API，它使XFire可高度自定义，允许开发者在不同的阶段截获请求，并且对他们进行处理。 
　　---兼容最新的标准例如SOAP1.1(没有加密远程工程调用，或者RPC)和1.2、WSDL1.1、the Web Services Interoperability Organization’s Basic Profile 1.0、Web Services Addressing和WS-Security。 

　　最重要的是，XFire属于新一代Web Services引擎。不仅仅是营销用语，“新一代”有一些重要的意义。Apache Axis是第一代Java语言的Web Services引擎，已经成为了所有后来工具的参考标准。在过去的几年里，Axis以及这些其它的工具已经在很多生产环境中进行了实地测试。从中得出的一个关键的问题就是Web Services并不最适合RPC类型的通信。对于性能和效率，面向文档的消息形式是最好的方式。但是Apache Axis和很多其他的Web Services引擎都被设计成了面向RPC的(尽管它们支持文档形式)。现在，整个行业正在开发新一代的SOAP引擎，设计为面向文档的。Apache已经宣布结束旧版本的Axis引擎开发，现在专注于Axis2，现在它的预发布版本是0.95。XFire在今年的2月份发布了它的第一个产品版本(1.0)。它的下一个版本(1.1)仅仅在几个星期之后就进行了发布。
　　局限性 
　　XFire有些重要的局限性你应该清楚:


　　---开发Web Services的好的实践是从WSDL开始。大部分的SOAP引擎提供了从WSDL生成服务stub的工具。XFire也提供了这样一个工具。但是它是基于注释(annotations-based)的，因此需要J2SE5.0。对于仍坚持使用J2SE1.4.x的人来说，它不是一个令人拍手叫好的工具，因为我们有很多其他方式来编写客户端，一个就是文章中演示的方式。 
　　---附件支持，它将会包含在未来发行的版本中。 
　　---易于学习的用户向导。XFire团队在这个方面还有很多工作需要做。 

　　结论
　　Java当前的趋势是简化技术的使用。因此，我们正看到一波基于POJO的开发成就。同时，面向服务架构(SOA，Services-oriented architecture)和Web Services已经变成了当前行业的热点话题。XFire正是在这种情况下产生的。它能够使POJO发布为最少的Web Services，而只需要付出最小化的努力。从而，它使希望使用这项技术的初级开发者的学习曲线变得平缓。同时，由于它兼容最新标准和提供了丰富的API，XFire为高级用户提供了更多的大好机会。
版权声明：
    本文内容为作者经过查阅资料，编码实践，编辑实属原创，仅限学习与个人收藏，为避免制造网络垃圾请误用于商业性的原文转载。如有勘误请至mail to： [e-mail]  期待共同探讨！
参考资料：
通过WebService实现Java与.Net互联 作者：itlove 
    图文并茂的阐述了WebService相关概念。
轻松简单地开发Web Services 作者:Shahid Ahmed ;mydeman
    文章语言组织简练明确，是众多资料中表述最确切全面的，很多语言也被我原文转述了，原因是说的很好无须再由本人重新组织语言。可惜也是被转载的。
利用xfire开发webservice专题[四] 作者：MSN:[e-mail]
    借鉴了测试客户端的jsp形式实现。