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);
        
}

在实际实çŽîC¸­åQŒè¿™æ ·ä¸€ä¸ªæ–¹æ³•å¯èƒ½åŒ…括各¿Uç±»åž‹çš„复杂调用、查询和处理操作。但是我们的½CÞZ¾‹ä»£ç å·²ç»æœ€ž®åŒ–了，以至于我们可以集中精力在主要目标上：(x¨¬)把这个方法发布äØ“(f¨´)Web Servicesã€?br />
你可以看到BankingService是一个普通的Java¾c»ï¼Œæ²¡æœ‰ä»ÖM½•ä»£ç å‘Šè¯‰æˆ‘们它将ä¼?x¨¬)在Web Services中ä‹É用。好的，˜q™é‡Œæˆ‘们不需要增加ä“Q何东è¥Ñ€‚我们所有的工作都在部çÖv描述½W¦é‡Œå®Œæˆã€?br />
Web应用的部¾|²æ˜q°ç¬¦

在Java 中，W(xu¨¦)eb应用½E‹åºé€šå¸¸éœ€è¦è‡³ž®‘一个部¾|²æ˜q°ç¬¦åQˆå«åšweb.xmlåQ‰å¯¹å…¶è¿›è¡Œé…¾|®ã€‚XFire本èín是一个基于servlet的应用程序。因此，我们需要增加必要的引用到描˜q°ç¬¦æ–‡äšg中。然后我们还必须配置ž®†è¦åˆ›å¾çš„Web Services。我们ä‹É用一个称为services.xmlçš„æ–°æ–‡äšg来完成这件事ã€?br />
web.xml
首先åQŒä¿®æ”¹web.xml。我们需要增加下面的XFire servlet相关的条目：(x¨¬)

   <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æ–‡äšg夹中åQŒå®ƒåœ¨Web应用½E‹åºçš„标准类路径中。这里是services.xml中的基本配置条目åQ?br />

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

˜q™ä¸ªä»£ç æ˜¯å¦‚何工作的呢？我来解释一下：(x¨¬)首先åQŒæˆ‘们创å»ÞZ¸€ä¸ªæœåŠ¡æ¨¡åž‹ï¼Œå®ƒåŒ…含服务的说明——换句话è¯ß_(d¨¢)¼Œž®±æ˜¯æœåŠ¡çš„元数据。我们ä‹É用XFireçš„ObjectServiceFactory从IBankingService.class接口创徏˜q™ä¸ªæ¨¡åž‹ã€?br />
接着åQŒäØ“(f¨´)XFire获得一个代理工厂对象，它包含了常规的代码，也相当地½Ž€å•å’Œæ˜“懂。这一步中没有ä»ÖM½•ç‰¹å®šåº”用的东è¥Ñ€‚从˜q™ä¸ªproxyFactoryåQŒä‹É用服务模型和服务端点URLåQˆç”¨æ¥èŽ·å¾—WSDLåQ‰ï¼Œæˆ‘们可以得到一个服务的本地代理ã€?br />
ž®±æ˜¯å®ƒäº†ã€‚这个代理就是实际的客户端。现在，我们可以调用它的transferFunds()æ–ÒŽ(gu¨©)³•æ¥å¾—到我们需要的Web Serviceã€?br />一旦示例应用发布åƈ启动åQŒå°±å¯ä»¥ž®è¯•servlet URLåQ?br />http://localhost:8080/websvc/wsã€?br />
˜q™ä¸ªServlet使用默认参数来调用Web Service和显½CºæŽ¥æ”¶åˆ°çš„响应。页面的最后两行应该读取：(x¨¬)
Response Received
COMPLETED: CDN$ 500.00 was successfully transferred from A/C# 11111-01234 to A/C# 99999-05678

现在你可以确定Web Service已经发布òq¶ä¸”在运行中了ã€?br />
ä¸ÞZº†ž®è¯•ä¸åŒçš„输入å€û|¼Œä½ å¯ä»¥ä‹É用完整的URLåQŒä¾‹å¦‚：(x¨¬)
http://localhost:8080/websvc/ws?from=11-2345&to=77-9876&amt=250.00&cur=EUR�br />
基本的Web Services开发步骤清�/span>

˜q™ä¸ªæ¸…单æ€È»“了将一个Javaæ–ÒŽ(gu¨©)³•å‘布为Web Service所必须的步骤：(x¨¬)
1、        检查Java¾cȝš„æ–ÒŽ(gu¨©)³•å’Œé»˜è®¤æž„造函数确保äØ“(f¨´)public
2、        增加XFire servlet相关条目到web.xmlä¸?br />3、        创建services.xmlåQŒæŠŠå®ƒæ”¾åˆ°WEB-INF/classes/META-INF/xfire目录ä¸?br />4、        增加XFire和第三方包到你的Web应用的WEB-INF/libæ–‡äšg夹中

˜q™å°±æ˜¯æ‰€æœ‰éœ€è¦çš„步骤åQŒæ˜¯çš„，相当½Ž€å•ã€?br />
XFire的其他高¾U§ç‰¹æ€?/span>

XFireçš„ä‹É用可能比较简单，但是在特性和功能性上åQŒå®ƒå´å æ®ç€é¢†å¯¼è€…的位置。下面是它的高çñ”ç‰ÒŽ(gu¨©)€§ï¼š(x¨¬)
-- -本地数据¾l‘定支持POJOsåQˆplain-old Java objectsåQ‰ã€XMLBeans、JAXBåQˆJava Architecture for XML BindingåQ‰ã€Castor½{‰ç­‰ã€‚数据绑定说明了Web Servicesçš„XMLè¯äh±‚和映ž®„到Java对象的XML响应ã€?br />---使用StAXåQˆStreaming API for XMLåQ‰å¤„理XML文档。同DOM的基于树(w¨¨i)å’ŒSAX的事仉™©±åŠ¨çš„处理方式相比åQŒStAX使用了拉åQˆpullåQ‰æœºåˆÓž¼Œå®ƒä‹É处理更快速，内存效率更高ã€?br />---支持多种传输协议åQŒå¦‚HTTP、JMSåQˆJava Message ServiceåQ‰å’ŒJVM内部传输ã€?br />---嵌入式，˜q™æ˜¯XFire的核心功能之一。你可以把这个SOAP引擎嵌入åˆîC½ çš„应用中åQŒå®Œå…¨éšè—æ‰€æœ‰XFire特定引用åQŒåŒæ äh‰€æœ‰é…¾|®éƒ½æ˜¯ç¨‹åºé©±åŠ¨ã€?br />---丰富的APIåQŒå®ƒä½¿XFire可高度自定义åQŒå…è®¸å¼€å‘者在不同的阶ŒD‰|ˆªèŽ¯‚¯·æ±‚，òq¶ä¸”对他们进行处理ã€?br />-- -兼容最新的标准例如SOAP1.1åQˆæ²¡æœ‰åŠ å¯†è¿œ½E‹å·¥½E‹è°ƒç”¨ï¼Œæˆ–者RPCåQ‰å’Œ1.2、WSDL1.1、the Web Services Interoperability Organization’s Basic Profile 1.0、Web Services Addressingå’ŒW(xu¨¦)S-Securityã€?br />
最重要的是åQŒXFire属于æ–îC¸€ä»£Web Services引擎。不仅仅是营销用语åQŒâ€œæ–°ä¸€ä»£â€æœ‰ä¸€äº›é‡è¦çš„意义。Apache Axis是第一代Java语言的Web Services引擎åQŒå·²¾læˆä¸ÞZº†æ‰€æœ‰åŽæ¥å·¥å…ïL(f¨¥ng)š„参考标准。在˜q‡åŽ»çš„几òq´é‡ŒåQŒAxis以及(qi¨¢ng)˜q™äº›å…¶å®ƒçš„工具已¾låœ¨å¾ˆå¤šç”Ÿäñ”环境中进行了实地‹¹‹è¯•ã€‚从中得出的一个关键的问题ž®±æ˜¯Web Servicesòq¶ä¸æœ€é€‚合RPC¾cÕdž‹çš„通信。对于性能和效率，面向文档的消息åŞ式是最好的方式。但是Apache Axis和很多其他的Web Services引擎都被设计成了面向RPC的（ž®½ç®¡å®ƒä»¬æ”¯æŒæ–‡æ¡£å½¢å¼åQ‰ã€‚现在，整个行业正在开发新一代的SOAP引擎åQŒè®¾è®¡äØ“(f¨´)面向文档的。Apache 已经宣布¾l“束旧版本的Axis引擎开发，现在专注于Axis2åQŒçŽ°åœ¨å®ƒçš„预发布版本æ˜?.95。XFire在今òq´çš„2月䆾发布了它的第一个äñ”品版本（1.0åQ‰ã€‚它的下一个版本（1.1åQ‰ä»…仅在几个星期之后ž®Þp¿›è¡Œäº†å‘布ã€?br />
性能

Web Services需要消耗很多资源，但是性能斚w¢å®ƒä»¬ä¸æ˜¯é‚£ä¹ˆå¼•äh注目。XFire打破了这¿Uè¶‹åŠÑ€‚它消耗更ž®‘的内存åQˆéƒ¨åˆ†å› ä¸?StAXçš„ä‹É用）åQŒä½†æ˜¯è¡¨çŽ°å´æ¯”多数可比较的SOAP引擎å‡ø™‰²ã€‚你可以在资源中提供的链接中看到比较的结果ã€?br />此外åQŒXFire˜q˜æä¾›äº†å„种æ–ÒŽ(gu¨©)³•æ¥è¿›ä¸€æ­¥ä¼˜åŒ–性能。一个方法是使用JVM内置传输åQˆin-JVM transportåQ‰ã€‚如果你知道Web Services和客æˆïL(f¨¥ng)«¯˜qè¡Œåœ¨åŒä¸€ä¸ªJVM上，你可以选择使用本地传输åQŒå®ƒå¯ä»¥å¤§å¹…提升性能。在½CÞZ¾‹ä¸­çš„客户端代码，看以下指定服务端点URL的这行：(x¨¬)
String serviceUrl = "http://localhost:8080/websvc/services/Banking";
替换�br />String serviceUrl = "xfire.local://Banking";

你会(x¨¬)看到性能上的明显提高åQŒå› ä¸ºå®ƒ¾l•è¿‡äº†æ•´ä¸ªç½‘¾lœå±‚ã€?br />
局限�/span>

XFire有些重要的局限性你应该清楚åQ?br />-- -开发Web Services的好的实跉|˜¯ä»ŽWSDL开始。大部分的SOAP引擎提供了从WSDL生成服务stub的工兗÷€‚XFire也提供了˜q™æ ·ä¸€ä¸ªå·¥å…—÷€‚但是它是基于注释（annotations-basedåQ‰çš„åQŒå› æ­¤éœ€è¦J2SE5.0。对于仍坚持使用J2SE1.4.xçš„äh来说åQŒå®ƒä¸æ˜¯ä¸€ä¸ªä×o(h¨´)人拍手叫好的工具åQŒå› ä¸ºæˆ‘们有很多其他方式来编写客æˆïL(f¨¥ng)«¯åQŒä¸€ä¸ªå°±æ˜¯æ–‡ç« ä¸­æ¼”示的方式ã€?br />---附äšg支持åQŒå®ƒ?y¨­u)®†ä¼?x¨¬)包含在未来发行的版本中ã€?br />---易于学习(f¨¤n)的用户向对{€‚XFire团队在这个方面还有很多工作需要做ã€?br />
¾l“论

Java 当前的趋势是½Ž€åŒ–技术的使用。因此，我们正看åˆîC¸€æ³¢åŸºäºŽPOJO的开发成ž®±ã€‚同æ—Óž¼Œé¢å‘服务架构åQˆSOAåQŒServices-oriented architectureåQ‰å’ŒW(xu¨¦)eb Services已经变成了当前行业的热点话题。XFire正是在这¿Uæƒ…况下产生的。它能够使POJO发布为最ž®‘çš„Web ServicesåQŒè€Œåªéœ€è¦ä»˜å‡ºæœ€ž®åŒ–的努力。从而，它ä‹É希望使用˜q™é¡¹æŠ€æœ¯çš„初çñ”开发者的学习(f¨¤n)曲线变得òq³ç¼“。同æ—Óž¼Œç”׃ºŽå®ƒå…¼å®ÒŽ(gu¨©)œ€æ–°æ ‡å‡†å’Œæä¾›äº†ä¸°å¯Œçš„ APIåQŒXFire为高¾U§ç”¨æˆähä¾›äº†æ›´å¤šçš„大好机ä¼?x¨¬)ã€?br />
关于作�/b>
Shahid Ahmed是一个èÊY件架构师åQŒå¦‚今在¾ŸŽå›½ä¸€å®¶ä¸»è¦çš„无线˜qè¡Œå•†ä½œå’¨è¯¢å·¥ä½œã€‚ä»–åœ?2òq´å‰å¼€å§‹å¼€å‘èÊYä»Óž¼Œå½“æ—¶Kaypro、Osborne、Apple IIå’ŒTRS-80s¾lŸæ²»ç€æ•´ä¸ªåœ°çƒã€‚在˜q‡åŽ»çš?òq´é‡ŒåQŒä»–更多的精力集中于Java。他现在的工作包括SOA、Web Services、消息、POJO、Spring、Ajax½{‰ç­‰ã€‚Shahid是一个èÊY件热衯‚€…，每天都在奋斗以求在技术的˜qäh‹å’Œç¤¾ä¼?x¨¬)生‹zȝš„热爱之间å¯ÀL‰¾òqŒ™¡¡ç‚V€?br />
资源åQ?/b>
Matrix Java½C‘ÖŒº:http://www.matrix.org.cn
下蝲本文中的½CÞZ¾‹åº”用åQ?a target="_new">http://www.javaworld.com/javaworld/jw-05-2006/xfire/jw-0501-xfire.zip
Web Services架构:http://www.w3.org/TR/ws-arch/
WSDL2.0åQˆåŽŸæ¥æè®®äØ“(f¨´)WSDL1.2åQŒçŽ°åœ¨é‡æ–°å‘½åäº†åQ‰ï¼š(x¨¬)½W¬ä¸€éƒ¨åˆ†åQšæ ¸å¿ƒè¯­­a€åQˆW3C Candidate Recommendation 27 March 2006åQ?br />
引自:http://www.matrix.org.cn/resource/article/2006-09-24/XFire_6bd1061c-4bc6-11db-978f-43b3336b7e51.html

家有ž®çŒ«'s Java Blog 2006-09-25 14:22 发表评论

]]>