將應(yīng)用程序的功能封裝成為Web Services

下面的代碼段說明了如何在WSDL中定義我們的Web服務(wù)。

TelephoneDirectory-service.wsdl
<?xml version="1.0" encoding="UTF-8"?>
<definitions name="TelephoneDirectoryService"
    targetNamespace="http://localhost:8080/TelephoneDirectoryWeb/wsdl/TelephoneDirectory-service.wsdl"
    xmlns="http://schemas.xmlsoap.org/wsdl/"
    xmlns:binding="http://www.telephonedirectory.com/definitions/TelephoneDirectoryRemoteInterface"
    xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
    xmlns:tns="http://localhost:8080/TelephoneDirectoryWeb/wsdl/TelephoneDirectory-service.wsdl">

    <import
        location="http://localhost:8080/TelephoneDirectoryWeb/wsdl/TelephoneDirectory-binding.wsdl"
        namespace="http://www.telephonedirectory.com/definitions/TelephoneDirectoryRemoteInterface"/>

    <service name="TelephoneDirectoryService">
        <port binding="binding:TelephoneDirectoryBinding" name="TelephoneDirectoryPort">
            <soap:address location="http://localhost:8080/TelephoneDirectoryWeb/servlet/rpcrouter"/>
        </port>
    </service>

</definitions>

 TelephoneDirectory-service.wsdl文件包括了一些定義Web服務(wù)的信息，比如說Web服務(wù)的名字，Web服務(wù)的端口綁定等等。從例子中可以看出，我們將通過SOAP rpcrouter 這個(gè) servlet來訪問Web服務(wù)，而 port binding則描述了在哪可以找到如何訪問服務(wù)的詳細(xì)信息。

TelephoneDirectory-binding.wsdl
<?xml version="1.0" encoding="UTF-8"?>
<definitions name="TelephoneDirectoryRemoteInterface"
    targetNamespace="http://www.telephonedirectory.com/definitions/TelephoneDirectoryRemoteInterface"
    xmlns="http://schemas.xmlsoap.org/wsdl/"
    xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
    xmlns:tns="http://www.telephonedirectory.com/definitions/TelephoneDirectoryRemoteInterface"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsd1="http://www.telephonedirectory.com/schemas/TelephoneDirectoryRemoteInterface">

    <import
        location="http://localhost:8080/TelephoneDirectoryWeb/wsdl/TelephoneDirectory-schema.xsd"
        namespace="http://www.telephonedirectory.com/schemas/TelephoneDirectoryRemoteInterface"/>

    <message name="findEmployeeByIDRequest">
        <part name="id" type="xsd:int"/>
    </message>

    <message name="findEmployeeByIDResponse">
        <part name="result" type="xsd1:com.acme.Employee"/>
    </message>

    <portType name="TelephoneDirectory">
        <operation name="findEmployeeByID" parameterOrder="id">
            <input message="tns:findEmployeeByIDRequest" name="findEmployeeByIDRequest"/>
            <output message="tns:findEmployeeByIDResponse" name="findEmployeeByIDResponse"/>
        </operation>
    </portType>

    <binding name="TelephoneDirectoryBinding" type="tns:TelephoneDirectory">
        <soap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/>

        <operation name="findEmployeeByID">
            <soap:operation soapAction="" style="rpc"/>

            <input name="findEmployeeByIDRequest">
                <soap:body
                    encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
                    namespace="http://tempuri.org/com.acme.TelephoneDirectory" use="encoded"/>
            </input>

            <output name="findEmployeeByIDResponse">
                <soap:body
                    encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
                    namespace="http://tempuri.org/com.acme.TelephoneDirectory" use="encoded"/>
            </output>

        </operation>

    </binding>

</definitions>

TelephoneDirectory-binding.wsdl文件中包含了定義Web服務(wù)接口的信息。在我們的例子中，接口的名字為TelephoneDirectoryRemoteInterface，它有一個(gè)名為TelephoneDirectory的portType，這個(gè)端口關(guān)聯(lián)了一個(gè)名為findEmployeebyID的操作。

TelephoneDirectory-schema.xsd
<?xml version="1.0" encoding="UTF-8"?>
<schema attributeFormDefault="qualified" elementFormDefault="qualified"
    targetNamespace="http://www.telephonedirectory.com/schemas/TelephoneDirectoryRemoteInterface"
    xmlns="http://www.w3.org/2001/XMLSchema"
    xmlns:xsd1="http://www.telephonedirectory.com/schemas/TelephoneDirectoryRemoteInterface">

    <complexType name="com.acme.Employee">
        <all>
            <element name="phone" type="string"/>
            <element name="lastName" type="string"/>
            <element name="firstName" type="string"/>
            <element name="id" type="int"/>
        </all>
    </complexType>

</schema>

 TelephoneDirectory-schema.xsd文件中包含了在Web服務(wù)中從Java到XML的映射信息，在例子中，名為com.acme.Employee的Java類將被映射為一個(gè)完整的XML文檔，XML中的每一個(gè)元素都對(duì)應(yīng)于類中一個(gè)簡(jiǎn)單的Java類型。這些信息將在TelephoneDirectory-binding.wsdl文件中定義消息類型和格式時(shí)被用到。

測(cè)試Web服務(wù)

WSAD中的Web服務(wù)生成向?qū)且粋€(gè)強(qiáng)大，有效的工具，它不但可以引導(dǎo)您一步一步的創(chuàng)建和定義一個(gè)Web服務(wù)，還可以幫助您部署和測(cè)試生成的Web服務(wù)。您可以不需要知道部署和配置Web服務(wù)的詳細(xì)信息，因?yàn)橄驅(qū)?huì)自動(dòng)將新創(chuàng)建的Web服務(wù)部署到WSAD自帶的WebSphere應(yīng)用服務(wù)器測(cè)試環(huán)境中，同時(shí)幫您生成用來測(cè)試的Web客戶端應(yīng)用程序并運(yùn)行它。圖4顯示了向?qū)傻挠脕頊y(cè)試的客戶端例子程序。

圖4：WSAD中生成的用來測(cè)試的客戶端例子程序

從圖4中，我們看到客戶端例子程序的用戶界面由三個(gè)HTML部分構(gòu)成。在左邊區(qū)域的上部列出了所有可以作為Web服務(wù)調(diào)用的方法。當(dāng)選中其中任一方法時(shí)，右邊區(qū)域的上部會(huì)顯示出一個(gè)表格，表格里包含要調(diào)用該方法所需的所有參數(shù)。用戶輸入?yún)?shù)值，并點(diǎn)擊提交按鈕后，相應(yīng)的Web服務(wù)將被調(diào)用，結(jié)果會(huì)顯示在底部區(qū)域。

將Web服務(wù)發(fā)布到UDDI注冊(cè)中心

在利用WSAD自帶的測(cè)試環(huán)境驗(yàn)證我們創(chuàng)建的Web服務(wù)成功后，我們準(zhǔn)備讓其它的應(yīng)用程序來使用該服務(wù)。我們用WSAD中的UDDI explorer將Web服務(wù)發(fā)布到IBM Test Registry(要使用IBM的Test Registry, 你需要先到以下網(wǎng)址www-3.ibm.com/services/uddi/testregistry/protect/home.jsp注冊(cè)）。首先，我們?cè)贗BM的Test Registry中創(chuàng)建一個(gè)名為ACME Business的商業(yè)實(shí)體，接下來，就可以將我們的電話號(hào)碼簿的Web服務(wù)發(fā)布到其中了。圖5顯示了怎樣使用UDDI explorer 來發(fā)布我們的Web服務(wù)。

圖5: 用UDDI Explorer發(fā)布Web服務(wù)

使用員工信息查詢的Web服務(wù)

當(dāng)我們想通過編程的方式從電話號(hào)碼簿的應(yīng)用中來檢索員工信息，我們需要首先查找到這個(gè)Web服務(wù)的定義然后調(diào)用它們。也就是說，我們將成為這個(gè)Web服務(wù)的服務(wù)請(qǐng)求者。

通過UDDI Registry發(fā)現(xiàn)Web服務(wù)

我們使用WSAD中的UDDI explorer來查找電話號(hào)碼簿這個(gè)Web服務(wù)。一旦我們?cè)赨DDI Registry中找到它，我們將使用導(dǎo)入功能將搜索到的WSDL文檔導(dǎo)入到WSAD的工作臺(tái)中。 圖5說明了如何發(fā)現(xiàn)、導(dǎo)入Web服務(wù)定義文檔的過程。

圖6：發(fā)現(xiàn)、導(dǎo)入U(xiǎn)DDI Registry中的WSDL文檔

通過SOAP來訪問Web服務(wù)

通過SOAP來訪問Web服務(wù)的最常見的方法是使用事先生成的Java 代理對(duì)象（Java Proxy Object）。通過使用WSAD中的Web服務(wù)客戶端向?qū)?，我們可以為電話?hào)碼簿這個(gè)Web服務(wù)生成一個(gè)Java代理，它使我們可以通過簡(jiǎn)單的Java調(diào)用來訪問Web服務(wù)。圖7顯示了如何使用客戶端向?qū)砩蒍ava代理對(duì)象并通過生成的例子代碼來訪問Web服務(wù)。

圖7：生成一個(gè)Java代理并訪問Web服務(wù)

總結(jié)

Web服務(wù)是構(gòu)建在諸如XML、SOAP、WSDL和UDDI等等這些開放的，技術(shù)實(shí)現(xiàn)中立的標(biāo)準(zhǔn)之上的。Web服務(wù)被看作是下一代Web應(yīng)用的奠基石，通過Web服務(wù)，電子商務(wù)應(yīng)用可以高效的，自動(dòng)化的整合他們的應(yīng)用，降低開發(fā)費(fèi)用，獲取更多的商機(jī)。到此為止，我們已經(jīng)描述了如何將已有的應(yīng)用程序的功能封裝為Web服務(wù)的過程，展示了在一個(gè)B2B的例子應(yīng)用中，如何使用IBM的WebSphere Studio Application Developer來非常輕松的定義、發(fā)布、定位、訪問Web服務(wù)。

資源：

1．請(qǐng)下載最新版本的WSAD試用版。

2．下載directory.war文件，該文件包含了本文的例子代碼。要運(yùn)行該例子程序，需要將該文件導(dǎo)入IBM的WebSphere Studio Application Developer工作區(qū)，然后您就可以通過Web服務(wù)向?qū)伤璧拇a來測(cè)試這個(gè)應(yīng)用和Web服務(wù)了。

3. 大家對(duì)于本文有任何建議以及想到的其他可能的問題，都?xì)g迎到討論論壇來提出意見或給出評(píng)論。

關(guān)于作者

黎獻(xiàn)勇, 電腦軟件業(yè)余愛好者,擅長(zhǎng)基于XML和Web服務(wù)的WebSphere應(yīng)用設(shè)計(jì). 可以通過 lxylxylxylxy@hotmail.com與他聯(lián)系。

李勁, IBM軟件解決方案多倫多實(shí)驗(yàn)室應(yīng)用開發(fā)技術(shù)中心的部門負(fù)責(zé)人，他負(fù)責(zé)從收集用戶要求到軟件實(shí)現(xiàn)及測(cè)試的全部設(shè)計(jì)周期，即收集、分析用戶的要求，并在軟件以及WebSphere應(yīng)用開發(fā)工具和面向Web應(yīng)用的交互式設(shè)計(jì)技術(shù)，實(shí)現(xiàn)用戶的要求和使用方案。 Jin目前的主要工作是Web服務(wù)和B2B應(yīng)用集成，他具有十多年的軟件業(yè)從業(yè)經(jīng)驗(yàn)，曾多次使用VisualAge實(shí)現(xiàn)了IBM的Java和WebSphere應(yīng)用服務(wù)器的客戶承諾. 可以通過 jinli@ca.ibm.com與他聯(lián)系。