package com.mybank.xfire.example;

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

/** *//** XFire WebServices sample implementation class. 
*/
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 = "";
                      
        //Call business objects and other components to get the job done.
        //Then create a status message and return.
        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;
    }
    
}

package com.mybank.xfire.example;

public interface IBankingService {  

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

在实际实现中，这样一个方法可能包括各种类型的复杂调用、查询和处理操作。但是我们的示例代码已经最小化了，以至于我们可以集中精力在主要目标上：把这个方法发布为Web Services。

你可以看到BankingService是一个普通的Java类，没有任何代码告诉我们它将会在Web Services中使用。好的，这里我们不需要增加任何东西。我们所有的工作都在部署描述符里完成。

Web应用的部署描述符

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

web.xml
首先，修改web.xml。我们需要增加下面的XFire servlet相关的条目：

   <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>

services.xml
现在我们不得不说一下我们的Web Services的由什么组成的了。这由一个叫做services.xml的文件完成，它存放在META-INF/xfire目录下，而这整个目录放在 WEB-INF/classes文件夹中，它在Web应用程序的标准类路径中。这里是services.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>

   /**//* 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 serviceModel = new ObjectServiceFactory().create(IBankingService.class);        
        log.debug("callSoapServiceLocal(): got service model." );
   
        //Create a proxy for the deployed service
        XFire xfire = XFireFactory.newInstance().getXFire();
        XFireProxyFactory factory = new XFireProxyFactory(xfire);      
    
        String serviceUrl = "http://localhost:8080/websvc/services/Banking";
        
        IBankingService client = null;
        try {
            client = (IBankingService) factory.create(serviceModel, serviceUrl);
        } catch (MalformedURLException e) {
            log.error("WsClient.callWebService(): EXCEPTION: " + e.toString());
        }    
               
        //Invoke the service
        String serviceResponse = "";
        try { 
            serviceResponse = client.transferFunds(fromAccount, toAccount, amount, currency);
       } catch (Exception e){
            log.error("WsClient.callWebService(): EXCEPTION: " + e.toString());                 
            serviceResponse = e.toString();
        }        
        log.debug("WsClient.callWebService(): status=" + serviceResponse);              

        //Return the response
        return serviceResponse;
    }  

这个代码是如何工作的呢？我来解释一下：首先，我们创建一个服务模型，它包含服务的说明——换句话说，就是服务的元数据。我们使用XFire的ObjectServiceFactory从IBankingService.class接口创建这个模型。

接着，为XFire获得一个代理工厂对象，它包含了常规的代码，也相当地简单和易懂。这一步中没有任何特定应用的东西。从这个proxyFactory，使用服务模型和服务端点URL（用来获得WSDL），我们可以得到一个服务的本地代理。

就是它了。这个代理就是实际的客户端。现在，我们可以调用它的transferFunds()方法来得到我们需要的Web Service。
一旦示例应用发布并启动，就可以尝试servlet URL：
http://localhost:8080/websvc/ws。

这个Servlet使用默认参数来调用Web Service和显示接收到的响应。页面的最后两行应该读取：
Response Received
COMPLETED: CDN$ 500.00 was successfully transferred from A/C# 11111-01234 to A/C# 99999-05678

现在你可以确定Web Service已经发布并且在运行中了。

为了尝试不同的输入值，你可以使用完整的URL，例如：
http://localhost:8080/websvc/ws?from=11-2345&to=77-9876&amt=250.00&cur=EUR。

基本的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文件夹中

这就是所有需要的步骤，是的，相当简单。

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）仅仅在几个星期之后就进行了发布。

性能

Web Services需要消耗很多资源，但是性能方面它们不是那么引人注目。XFire打破了这种趋势。它消耗更少的内存（部分因为 StAX的使用），但是表现却比多数可比较的SOAP引擎出色。你可以在资源中提供的链接中看到比较的结果。
此外，XFire还提供了各种方法来进一步优化性能。一个方法是使用JVM内置传输（in-JVM transport）。如果你知道Web Services和客户端运行在同一个JVM上，你可以选择使用本地传输，它可以大幅提升性能。在示例中的客户端代码，看以下指定服务端点URL的这行：
String serviceUrl = "http://localhost:8080/websvc/services/Banking";
替换为
String serviceUrl = "xfire.local://Banking";

你会看到性能上的明显提高，因为它绕过了整个网络层。

局限性

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为高级用户提供了更多的大好机会。

关于作者
Shahid Ahmed是一个软件架构师，如今在美国一家主要的无线运行商作咨询工作。他在22年前开始开发软件，当时Kaypro、Osborne、Apple II和TRS-80s统治着整个地球。在过去的7年里，他更多的精力集中于Java。他现在的工作包括SOA、Web Services、消息、POJO、Spring、Ajax等等。Shahid是一个软件热衷者，每天都在奋斗以求在技术的迷恋和社会生活的热爱之间寻找平衡点。

资源：
Matrix Java社区:http://www.matrix.org.cn
下载本文中的示例应用：http://www.javaworld.com/javaworld/jw-05-2006/xfire/jw-0501-xfire.zip
Web Services架构:http://www.w3.org/TR/ws-arch/
WSDL2.0（原来提议为WSDL1.2，现在重新命名了）：第一部分：核心语言（W3C Candidate Recommendation 27 March 2006）

引自:http://www.matrix.org.cn/resource/article/2006-09-24/XFire_6bd1061c-4bc6-11db-978f-43b3336b7e51.html

The SOAP tool Apache Axis offers a lot of features which require the use of a deployment descriptor. This reference describes all the elements and attributes which can be used in a WSDD deployment descriptor.

Elements

All Elements belong to the http://xml.apache.org/axis/wsdd/ namespace.

• beanMapping
• chain
• deployment
• documentation
• endpointURL
• fault
• globalConfiguration
• handler
• handlerInfo
• handlerInfoChain
• header
• namespace
• operation
• parameter (configuration parameter)
• parameter (operation parameter)
• requestFlow
• responseFlow
• role
• service
• transport
• typeMapping
• undeployment
• wsdlFile