XFire�Q�轻杄��单地开发Web Services[转]

家有��猫's Java Blog — Mon, 25 Sep 2006 06:22:00 GMT

摘要:

XFire是一个免费的开源SOAP框架�Q�它不仅可以极大方便地实现这样一个环境，�q�且可以提供许多Web Services规范中高�U�特征，�q�些特征在多数的商业或者开源工具都没有提供。你要恰当的理解�q�些单词�Q�great ease and simplicity�Q�非常轻村֒��单）。你��会看到使用XFire创徏Web Services是多么的��单�?br />
��你的POJO�Ҏ��发布为Web Services

摘要

问一�?Net的开发者，开发Web Services有多困难�Q�他们会被你的问题逗乐�Q�他们会告诉你所有步骤花费的旉��不会��过一分钟。再问一下Java开发者，�q�气好的话你会碰��C��面的回答�Q�一般情况下�Q�你会得��C��个完全不同的�{�案。从Web Services引入到Java中至今已�l?�q�了�Q�然而它仍然被认为是一门较新的技术，一个主要的原因��是使用Java实现Web Services太困难了。现在，随着��C��代Web Services引擎XFire的发布，�q�种情况��会发生明显的变化。��用XFire�Q�你可以把Java�c�L��法发布�ؓWeb Services而不需要编写额外的代码。在�q�篇文章中，你将会看到XFire使Web Services开发变得多么容易和��单�?br />
Web Services使我们能够在�|�络上徏立分布式�pȝ��Q�应用程序组件可以通过��M��q�_��、�Q何语�a�和�Q何方式访问。无论应用程序如何开发，使用了什么语�a��Q�以及运行在什么操作系�l��^��C��Q�只要它作�ؓWeb Service�Q��ƈ且�ؓ协同解决问题而设计，那么你的应用�E�序�Q�以��M��语言开发或在�Q何��^��C��Q�都可以利用它的服务。这是Web Service的主要概��c�?br />
��Z��实现Web Services的��^台无��x��和实现讉K��独立性，软�g行业需要遵循一些作为标准的技术。其中一些包括：
---XML�Q�在Web Services环境中各层之间进行传递的默认数据格式�?br />-- -SOAP�Q�封装和交换信息的默认协议。第一�ơ被提出�Ӟ��它是只取Simple Object Access Protocol�Q�简单对象访问协议）的首字母。但是现在SOAP更多被认为是一个特定的名词�Q�以它自��p��命名，同样很多��是用词不当：SOAP实际上不是用来访问对象的。另外，它也不再��单�?br />---WSDL�Q�Web Services Description Language�Q�Web Services描述语言�Q�：描述Web Services的语�a�。尽��基于XML�q�且可以被�h理解�Q�WSDL主要是由机器处理�Q�由客户端程序读取和理解�?br />
下面的高�U�层�ơ图表，��Z��WWW协会发布的“Web Services Architecture”（Web Services架构�Q�文��，昄��了这些技术在实际的工作环境中是如何发挥作用：

�q�个��程图显�C�Z��Web Services中的核心技术是如何工作的�?br />
�q�里�Q�Provider是提供服务的应用�E�序�l��g�Q�Requester是��用服务的客户端程序。很多其他技术也会参与到交互中，但是�q�个囑֏�昄��了在Web Services环境中必需的核心技术组件�?br />
XFire 是一个免费的开源SOAP框架�Q�它不仅可以极大方便地实现这样一个环境，�q�且可以提供许多Web Services规范中高�U�特征，�q�些特征在多数的商业或者开源工具都没有提供。你要恰当的理解�q�些单词�Q�great ease and simplicity�Q�非常轻村֒��单）。你��会看到使用XFire创徏Web Services是多么的��单�?br />
假如你的Web应用有一个Java�c�，�q�且你想把它的一个方法发布�ؓWeb Services�Q�当使用XFire�Ӟ��你不需要编写一行额外的Java代码。只需要编辑发布描�q�符�Q�然后你��׃��得到一个Web Services。是的，它相当地��单。我们来看一个例子�?br />
一个简单的Java�c?/span>

我们的例子是一个银行业应用�E�序�Q�服务器是运行在J2SE1.4.2_07下的Apache Tomcat5.5.7。假定你已经了解如何使用Java�~�写Web应用�E�序�Q��ƈ知道应该如何把它部��v到Apache Tomcat服务器上。我们的Web应用�E�序非常��单；它只做一件事——将资金从一个�̎戯��{到另外一个�̎户上。一个普通的Java�c?BankingService包含了一个叫做transferFunds()的方法来为我们完成这��工作。它需要四个输入参敎ͼ�
1、        String fromAccount
2、        String toAccount
3、        double amount
4、        String currency

代码如下�Q?br />

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

}

在这里你看到了什么异常的东西了吗�Q�或许没有，除了默认的构造函敎ͼ��c�d��是public。这是必��ȝ��。否则，XFire不能够初始化�q�个�c�R�?br />
因�ؓ使用接口的设计是一个好的实践，所以我们的Java�c�M��实现了一个称为IBankingService的接口。代码十分简单：

package com.mybank.xfire.example;

public interface IBankingService {

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

}

在实际实��C��Q�这样一个方法可能包括各�U�类型的复杂调用、查询和处理操作。但是我们的�C�Z��代码已经最��化了，以至于我们可以集中精力在主要目标上：把这个方法发布�ؓWeb Services�?br />
你可以看到BankingService是一个普通的Java�c�，没有��M��代码告诉我们它将会在Web Services中��用。好的，�q�里我们不需要增加�Q何东�ѝ��我们所有的工作都在部��v描述�W�里完成�?br />
Web应用的部�|�描�q�符

在Java 中，Web应用�E�序通常需要至��一个部�|�描�q�符�Q�叫做web.xml�Q�对其进行配�|�。XFire本��n是一个基于servlet的应用程序。因此，我们需要增加必要的引用到描�q�符文�g中。然后我们还必须配置��要创徏的Web Services。我们��用一个称为services.xml的新文�g来完成这件事�?br />
web.xml
首先�Q�修改web.xml。我们需要增加下面的XFire servlet相关的条目：

   <servlet>
        <servlet-name>XFireServletservlet-name>
        <display-name>XFire Servletdisplay-name>
        <servlet-class>org.codehaus.xfire.transport.http.XfireConfigurableServlet
         servlet-class>
    servlet>

    <servlet-mapping>
        <servlet-name>XFireServletservlet-name>
        <url-pattern>/servlet/XFireServlet/*url-pattern>
    servlet-mapping>

    <servlet-mapping>
        <servlet-name>XFireServletservlet-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>Bankingname>
    <namespace>mybanknamespace>
    <serviceClass>com.mybank.xfire.example.IBankingServiceserviceClass>
    <implementationClass>com.mybank.xfire.example.BankingServiceimplementationClass>
  service>

beans>

让我们看看这里都包含了什么内宏V��Web Services的定义包含在元素中，它还含有一些子元素。第一个子元素�?lt;name>�Q�它可以是你提供��M��的合法名字。这��会被客��L��E�序和其它需要定位你的服务的�l��g用到。例如，在服务准备好以后�Q�你��在��览器上使用�q�个名字来查看WSDL�?br />
下一个子元素�?lt;namespace>。�Q何合法的XML名字都是可以的�?lt;namespace>用来唯一标识你的服务的各个参数�?br />< serviceClass>元素包含了Java�cȝ��名字�Q�它指定了方法签名。在我们的例子中�Q�它是接口IBankingService。如�?Java�c�L��有实��C�Q何接口，你就需要把�cȝ��名字攑֜��q�里。在你的Java�c�L��者接口中可能有几个方法。只需要一个入口把它们全部发布为Web Services�?br />
保存了实现方法的Java�c�d��。这是一个可选元素。如果上一个元�?lt;serviceClass>包含了一个接口，那么相应的实现类必须在这里指定�?br />
��是�q�样。我们的Web Services配置完成了�?br />
XFire和其它类�?/span>

现在是最后一步了�Q�需要得到所有必需的类库。我们怎样得到它们呢？去XFire�|�站�Q�下载xfire-distribution-1.0.zip�Q�然后解压到一个本地文件夹。复制下面的jar文�g和它的库文�g夹到WEB-INF/lib中：
•        activation-1.0.2.jar
•        commons-codec-1.3.jar
•        commons-httpclient-3.0.jar
•        commons-logging-1.0.4.jar
•        jaxen-1.1-beta-8.jar
•        jdom-1.0.jar
•        log4j-1.2.x.jar
•        mail-1.3.3_01.jar
•        spring-1.2.x.jar
•        stax-api-1.0.jar
•        wsdl4j-1.5.2.jar
•        wstx-asl-2.9.jar
•        xbean-2.1.0.jar
•        xbean-spring-2.2.jar
•        xfire-all-1.0.jar
•        XmlSchema-1.0.jar

一切妥当。我们来部��v和启动应用程序。�ؓ了部�|�示例应用，只需要复制websvc.war到Apache Tomcat的webapps文�g夹中�Q�再�{�待几秒钟。它��会自动启动。这个应用的全部源代码也包含在这个war文�g中。我们的�E�序已经准备作�ؓ一�?Web Service了�?br />
我们如何知道Web Service正在工作呢？

��Z��了解Web Service是否正在工作�Q�我们需要测试。首先，我们��试来看WSDL是否可用。我们在��览器中输入URL。哪个URL�Q�因为我们的应用�E�序的war文�g是websvc.war�Q��ƈ且在services.xml中给出的服务名是Banking�Q�WSDL的URL应该是：http: //localhost:8080/websvc/services/Banking?wsdl�?br />
��h��意：URL的第一部分�Q�例如， http://localhost:8080�Q�可能会�Ҏ��你的应用服务器不同而不同。无论怎样�Q�当你输入URL后，��会看到一个XML文档�Q�它的根元素�?。这个文档叫做服务的WSDL。如果你看到了，�q�就是你的应用作为Web Service已经可用的第一个证明�?br />
但是�q�个��试是不够的。可能会发生�q�种情况�Q�可以看到WSDL�Q�但是从客户端程序可能会讉K��不到服务。因此�ؓ了核实服务是否可以访问了�Q�我们必��M��用一个客��L��q�行服务的实际调用来�q�行一个真正的��试�?br />
开发一个客��L��

你可以��用�Q何的SOAP工具创徏客户端，例如�Q?Net或者Apache Axis�Q�有很多�U�方法：使用从WSDL产生的stubs�Q��用动态代理，�{�等。在例子中，我们使用一个动态代理，以一个简单的Servlet形式�Q�叫�?WsClient.java。�ؓ了保持代码两最��，所有在屏幕昄��的元素都攑֜�了doGet()�Ҏ��中。对Web Service的实际调用由callWebService()�Ҏ��完成�Q�它相当地简单。和下面的类��|��

   /* 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�个代码是如何工作的呢？我来解释一下：首先�Q�我们创��Z��个服务模型，它包含服务的说明——换句话��_��是服务的元数据。我们��用XFire的ObjectServiceFactory从IBankingService.class接口创徏�q�个模型�?br />
接着�Q��ؓXFire获得一个代理工厂对象，它包含了常规的代码，也相当地��单和易懂。这一步中没有��M��特定应用的东�ѝ��从�q�个proxyFactory�Q��用服务模型和服务端点URL�Q�用来获得WSDL�Q�，我们可以得到一个服务的本地代理�?br />
��是它了。这个代理就是实际的客户端。现在，我们可以调用它的transferFunds()�Ҏ��来得到我们需要的Web Service�?br />一旦示例应用发布�ƈ启动�Q�就可以��试servlet URL�Q?br />http://localhost:8080/websvc/ws�?br />
�q�个Servlet使用默认参数来调用Web Service和显�C�接收到的响应。页面的最后两行应该读取：
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�例如：
http://localhost:8080/websvc/ws?from=11-2345&to=77-9876&amt=250.00&cur=EUR�?br />
基本的Web Services开发步骤清�?/span>

�q�个清单�ȝ��了将一个Java�Ҏ��发布为Web Service所必须的步骤：
1、检查Java�cȝ��Ҏ��和默认构造函数确保�ؓ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�它却占据着领导者的位置。下面是它的高��Ҏ��：
-- -本地数据�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的基于树和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和WS-Security�?br />
最重要的是�Q�XFire属于��C��代Web Services引擎。不仅仅是营销用语�Q�“新一代”有一些重要的意义。Apache Axis是第一代Java语言的Web Services引擎�Q�已�l�成��Z��所有后来工��L��参考标准。在�q�去的几�q�里�Q�Axis以及�q�些其它的工具已�l�在很多生��环境中进行了实地��试。从中得出的一个关键的问题��是Web Services�q�不最适合RPC�c�d��的通信。对于性能和效率，面向文��的消息�Ş式是最好的方式。但是Apache Axis和很多其他的Web Services引擎都被设计成了面向RPC的（��管它们支持文��形式�Q�。现在，整个行业正在开发新一代的SOAP引擎�Q�设计�ؓ面向文��的。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�提供了各种�Ҏ��来进一步优化性能。一个方法是使用JVM内置传输�Q�in-JVM transport�Q�。如果你知道Web Services和客��L��q�行在同一个JVM上，你可以选择使用本地传输�Q�它可以大幅提升性能。在�C�Z��中的客户端代码，看以下指定服务端点URL的这行：
String serviceUrl = "http://localhost:8080/websvc/services/Banking";
替换�?br />String serviceUrl = "xfire.local://Banking";

你会看到性能上的明显提高�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人拍手叫好的工具�Q�因为我们有很多其他方式来编写客��L��Q�一个就是文章中演示的方式�?br />---附�g支持�Q�它��会包含在未来发行的版本中�?br />---易于学习的用户向对{��XFire团队在这个方面还有很多工作需要做�?br />
�l�论

Java 当前的趋势是��化技术的使用。因此，我们正看��C��波基于POJO的开发成��。同�Ӟ��面向服务架构�Q�SOA�Q�Services-oriented architecture�Q�和Web Services已经变成了当前行业的热点话题。XFire正是在这�U�情况下产生的。它能够使POJO发布为最��的Web Services�Q�而只需要付出最��化的努力。从而，它��希望使用�q�项技术的初��开发者的学习曲线变得�q�缓。同�Ӟ��׃��它兼�Ҏ��新标准和提供了丰富的 API�Q�XFire为高�U�用��h��供了更多的大好机会�?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��和社会生�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�原来提议�ؓWSDL1.2�Q�现在重新命名了�Q�：�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 发表评论

亚洲精品97久久中文字幕无码,久久久久久亚洲av成人无码国产,亚洲精品A在线观看

XFire�Q�轻杄��单地开发Web Services[转]

摘要:

Axis WSDD Reference

Axis WSDD Reference

Elements

亚洲精品97久久中文字幕无码,久久久久久亚洲av成人无码国产,亚洲精品A在线观看

XFire�Q�轻杄���单地开发Web Services[转]

摘要:

Axis WSDD Reference

Axis WSDD Reference

Elements

XFire�Q�轻杄��单地开发Web Services[转]