首頁新隨筆新文章聯系聚合

posts - 495,comments - 227,trackbacks - 0

2006年12月

>

日

一

二

三

四

五

六

26

27

28

29

30

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

30

1

2

3

4

5

6

常用鏈接

留言簿(46)

隨筆分類(476)

隨筆檔案(495)

搜索

積分與排名

積分 - 1395433
排名 - 16

閱讀排行榜

級別: 中級

Nicholas Chase (ibmquestions@nicholaschase.com), 自由作者, Backstop Media, LLC

2006 年 5 月 25 日

使用 Apache Geronimo 和 Axis2 構建復雜 Web 服務應用程序是一項錯綜復雜的任務，本系列將深入研究相關內容。本系列教程由 3 個部分構成，引領您構建一個示例在線銀行 Web 服務，文中介紹了整個流程的每個步驟，因此新用戶可快速掌握概念并構建一個完整的 Web 服務和可與 Web 服務連接并通信的 Web 界面客戶機。在第一期中，將為您介紹示例 Web 服務和使用 WSDL 的 Web 服務，構建并編譯 WSDL 文件，然后在 Geronimo 上測試及部署它。

開始之前

本系列教程分 3 部分，面向對使用 Apache Geronimo 和 Apache Axis2 開發大型 Web 服務有興趣的讀者。了解如何構建 WSDL 文件及與在線銀行系統相關的一些操作。然后使用 Axis2 將 WSDL 文件編譯為 Web 服務，并在 Geronimo 上進行部署和測試。

關于本系列

本系列中將創建一個在線銀行 Web 服務示例。使用 WSDL 和 Axis2 創建的 Web 服務將包含一個 Apache Derby 數據庫，用于保存交易數據、賬戶數據和賬單支付數據。您會將 Axis2 作為 Apache Geronimo 上的 Web 應用程序部署，新 Web 服務將是在 Axis2 中部署的 Axis 歸檔。您在示例中可能會用到在線銀行中的多個命令，包括查看賬戶、搜索交易、劃撥資金和支付賬單。您還會創建一個客戶機 Web 應用程序來連接到 Web 服務，以查詢信息及執行交易 —— 主要是為了調用在 Web 服務中實現的操作。

在本系列的第 1 部分中，將在 WSDL 中構建在線銀行 Web 服務的基礎設施。在第 2 部分中，將通過在 Apache Derby 數據庫中存儲賬戶和交易信息來構建 Web 服務的功能。在最后的第 3 部分中，將為 Web 服務創建功能完整、基于 Web 的客戶機用戶界面（UI），用戶可在其中登錄、進行在線銀行活動及注銷。

回頁首

關于本教程

本教程首先介紹示例 Web 服務，并展示使用 WSDL 的多種 Web 服務。您將使用 Axis2 將 WSDL 文件轉換為 Java? 代碼，其中將實現一些簡單的功能，以測試客戶機與 Web 服務之間的通信。測試環境包括作為 Geronimo 上的模塊部署的 Axis2、作為 Axis2 內的歸檔部署的 Web 服務，以及與 Web 服務通信的一個簡單 Java 客戶機。

回頁首

前提條件

要學習本教程，需要具備以下工具：

Apache Geronimo —— 下載 Apache Geronimo V1.0，您將在 Geronimo 上部署 Axis2 Web 服務。
Apache Axis2 —— 下載 V0.94 Axis2 WAR 及二進制發行版，用于從 WSDL 構建 Web 服務。
Apache Ant —— 下載 Apache Ant，由于 Axis2 的 WSDL2Java 工具為構建 Web 服務創建了一個便捷的 Ant build.xml 文件，因此您需要用到此工具，這將使 Web 服務源代碼的構建更容易。
Java 代碼 —— 下載最新版的 Java 1.4，Java 1.4.10，Geronimo、Axis2 和 Ant 都需要用到它。

本教程假設您具備 Java 語法和編寫代碼的基本知識，但不必了解 Axis2 或特定 Geronimo 的相關知識。

回頁首

在線銀行 Web 服務概述

下面簡要介紹本系列教程的最終成果 —— 在線銀行 Web 服務示例。該 Web 服務涵蓋了在線銀行體驗的幾種特性，包括查看賬戶和交易、劃撥資金、申請貸款和在線支付賬單。

賬戶

登錄到 Web 服務之后，您會看到您所擁有的賬戶及其余額。出于安全性方面的考慮，登錄過程包括發送用戶名和密碼，以及接收保證安全性的二進制令牌。因此，在您登錄之后，僅需發送該令牌即可使 Web 服務識別您的身份。之后您就可以單擊查看賬戶中的交易，見下節。

交易

您在銀行中做的每一件事都涉及交易，各交易的歷史 —— 可在各賬戶中查看其歷史 —— 記錄在您的賬戶中。Web 服務還使您根據支票編號、金額或日期搜索交易。這使您可在納稅時更輕松地回溯和查找賬戶中的交易。您可將資金從一個賬戶劃撥到另外一個賬戶中，這也作為賬戶的一項交易記入日志。

申請貸款

本特性允許您通過在線銀行 Web 服務申請貸款。您可輸入貸款類型、欲貸金額、償還時間。成功提交貸款申請表后，您可查看每筆貸款的狀態。

支付賬單

在線賬單支付服務現已非常普及。這種服務使您能夠通過銀行賬戶支付賬單。但在支付賬單之前，必須首先添加作為支付對象的人或公司，我們稱之為收款方（payee）。Web 服務允許您查看、添加和編輯賬戶中的收款方。在賬戶中設置好收款方后，您就可以向其償還債務或劃撥資金了。所支持的支付類型有兩種：一次性支付 和 定期支付。您可通過 Web 服務執行各類支付。每次支付都有一個與其相關的日期，在支付發生之前（待定支付），允許您編輯其內容。

在下一節中，我們將開始構建在線銀行 Web 服務的 WSDL。

回頁首

數據結構

您在 Web 服務中支持的消息及操作需要一些數據結構用于來回傳遞數據，在 WSDL 中也稱為復型。這些數據結構是通過簡單對象訪問協議（SOAP）傳送的，并且是使用 WSDL 定義的。Web 服務的操作需要 6 個數據結構，我們將從最常用的一種開始，即交易。

交易

在您的在線銀行 Web 服務上下文中，兩個賬戶（或一個賬戶和銀行）是所涉兩方。就我們的在線銀行應用程序而言，一個交易可能有 5 項屬性。下面看看這些屬性，參見清單 1。現在創建一個 WSDL 文件 —— OnlineBanking.wsdl，將 Transaction complexType 放置在其中。

Transaction complexType 中的 5 個元素在清單 1 中顯示為黑體。所有必需元素均以 minOccurs="1" maxOccurs="1" 表示。這表示該元素號應至少出現一次，且最多出現一次，也就是恰好一次。注意 checknumber 非必需，因為 minOccurs="0"，這表示在一個 Transaction 中，該元素可被忽略，也可以恰好出現一次。另外，查看數據類型。注意，號碼定義為 int、checknumber 和 int、date 和 date、header 和 string，以及 amount 和 float。

清單 1. 交易


												      <xsd:complexType name="Transaction">
        <xsd:sequence>
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="number" type="xsd: int" />
          <xsd:element minOccurs="0" maxOccurs="1"
                       name="checknumber" type="xsd: int" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="date" type="xsd: date" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="header" type="xsd: string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="amount" type="xsd: float" />
        </xsd:sequence>
      </xsd:complexType>

接下來將介紹收款方復型。

回頁首

收款方

收款方接受您通過在線銀行支付的賬單。因此，需要幾個字段來獲得地址和賬單金額信息。為您的 WSDL 文件添加收款方復型，參見清單 2。

清單 2. 收款方


												      <xsd:complexType name="Payee">
        <xsd:sequence>
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="name" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="address1" type="xsd:string" />
          <xsd:element minOccurs="0" maxOccurs="1"
                       name="address2" type="xsd:string" />
          <xsd:element minOccurs="0" maxOccurs="1"
                       name="address3" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="city" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="state" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="zip" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="phoneAreaCode" type="xsd:int" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="phonePrefix" type="xsd:int" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="phoneSuffix" type="xsd:int" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="accountToPay" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="nameOnBill" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="alias" type="xsd:string" />
        </xsd:sequence>
      </xsd:complexType>

對于郵匯，您可以想到，需要的所有必需數據，在清單 2 中以黑體顯示。注意 address2 和 address3，補充的額外地址行非必需。接下來定義貸款申請表復型。

回頁首

貸款申請表

如果銀行不發放貸款，我們要如何生存？這里定義的數據結構包括貸款申請表信息和貸款狀態信息。我們首先定義貸款申請表復型，參見清單 3。

清單 3. 貸款申請表


												      <xsd:complexType name="LoanApplication">
        <xsd:sequence>
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="loanType" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="amount" type="xsd:float" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="termMonths" type="xsd:int" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="joint" type="xsd:boolean" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="percentFinanced" type="xsd:int" />
        </xsd:sequence>
      </xsd:complexType>

各字段都包括貸款申請表中的典型數據。接下來將貸款狀態添加到您的 WSDL 中，如清單 4 所示。

清單 4. 貸款申請表狀態


												      <xsd:complexType name="LoanApplicationStatus">
        <xsd:sequence>
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="loanNumber" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="approved" type="xsd:boolean" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="denied" type="xsd:boolean" />
        </xsd:sequence>
      </xsd:complexType>

每筆貸款都獲得一個號碼以及一個與其相關的批準或拒絕狀態。如果它既未得到批準，也未被拒絕，則該貸款尚未處理。接下來介紹與賬單支付相關的結構。

回頁首

賬單支付

支付賬單要求您輸入信息，如支付金額、支付對象，以及是否為定期支付等。接下來的兩個清單展示了兩種結構，供您參考。向您的 WSDL 文件中添加賬單支付復型，參見清單 5。

清單 5. 賬單支付


												      <xsd:complexType name="BillPayment">
        <xsd:sequence>
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="payeeName" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="account" type="xsd:int" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="amount" type="xsd:float" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="date" type="xsd:date" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="notes" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="recurring" type="xsd:boolean" />
          <xsd:element minOccurs="0" maxOccurs="1"
                       name="recurringData"
                       type="xsd1:RecurringBillPayment" />
        </xsd:sequence>
      </xsd:complexType>

這里顯示的金額即為您所支付的金額。如果是定期支付，則此金額為您每次支付的金額，所以日期將為起始日期。另外，注意這里 recurring 指定支付是否為定期支付，如果是，則定義 recurringData（注意其 minOccurs 定義為 0）。recurringData 元素引用 RecurringBillPayment 復型，如清單 6 所示。將其添加到您的 WSDL 中。

清單 6. 追加定期賬單支付數據


												      <xsd:complexType name="RecurringBillPayment">
        <xsd:sequence>
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="finalPayment" type="xsd:float" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="frequency" type="xsd:string" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="totalNumberOfPayments" type="xsd:int" />
          <xsd:element minOccurs="1" maxOccurs="1"
                       name="recurringType" type="xsd:string" />
        </xsd:sequence>
      </xsd:complexType>

清單 6 中的數據直接填充清單 5 所示復型。在這里，您的最后支付為 finalPayment 字段的值，frequency 則為支付賬單的周期。recurringType 字段表示賬單金額是否為固定數量，也就是說表示您是否可在下一次提交之前更改金額。接下來為您介紹需要通過 WSDL 公開的幾種不同操作。

回頁首

posted on 2006-12-29 19:38 SIMONE 閱讀(1830) 評論(1) 編輯收藏所屬分類: AXIS 、JAVA

FeedBack:

# re: 用 Apache Geronimo 和 Axis2 實現在線銀行，第 1 部分: 服務：布設框架（1）

2008-07-02 16:31 | 路過

這個例子在IBM網站上貌似得有會員才能看。博主很有奉獻精神！超贊！！！回復更多評論

新用戶注冊刷新評論列表


只有注冊用戶登錄后才能發表評論。




網站導航: 博客園 IT新聞 Chat2DB C++博客博問管理
相關文章: java通過axis訪問.net webService 簡單例子用 Apache Geronimo 和 Axis2 實現在線銀行，第 1 部分: 服務：布設框架（3）用 Apache Geronimo 和 Axis2 實現在線銀行，第 1 部分: 服務：布設框架（2）用 Apache Geronimo 和 Axis2 實現在線銀行，第 1 部分: 服務：布設框架（1）了解 Web 服務規范: 第 3 部分：統一描述、發現和集成 (UDDI)（4）了解 Web 服務規范: 第 3 部分：統一描述、發現和集成 (UDDI) （3）了解 Web 服務規范: 第 3 部分：統一描述、發現和集成 (UDDI) （2）了解 Web 服務規范: 第 3 部分：統一描述、發現和集成 (UDDI) （1）了解 Web 服務規范: 第 2 部分：Web 服務描述語言 (WSDL) （4）了解 Web 服務規范: 第 2 部分：Web 服務描述語言 (WSDL) （3）

常用鏈接

留言簿(46)

隨筆分類(476)

隨筆檔案(495)

最新隨筆

搜索

積分與排名

最新評論

閱讀排行榜

評論排行榜