DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> XML學習教程 >> XML詳解
用 Amazon SQS 串接企業應用(上):XML 訊息與跨語言實作入門
編輯:XML詳解     

佇列是一種暫存待處理訊息的資料結構。Amazon Simple Queue Service(Amazon SQS)則是一套以 Web 服務形式提供、具高可用性與高擴充性的訊息佇列服務。它的主要優勢包括:

  • 雲端交付。由 Amazon 託管,企業不必自建基礎設施,也不需要專屬的支援人力。
  • 以 Internet 為基礎。任何能連上網際網路、會發 HTTP 請求的用戶端都能取用,因此天生適合 B2B 整合。
  • 冗餘設計。所有訊息都存放於多台伺服器,提供高可用性與容錯能力。
  • 支援多組並發讀寫。多個程序可同時讀寫同一個佇列,並在處理期間鎖定訊息,避免兩個用戶端同時處理同一筆項目。
  • 鎖定視窗可設定。鎖定視窗由「可見性逾時」(visibility timeout)參數控制,可針對每個佇列個別設定。處理時間長的項目就該給更長的視窗,反之則可縮短。
  • API 友善。為 Java、Microsoft .NET 等常見平台提供包裝過的 API,能快速上手並無縫嵌入既有應用。
  • 成本低。只需為 HTTP 請求所消耗的頻寬付費,沒有其他額外費用。

動工前必須知道的兩個特性

在開始撰寫 SQS 程式之前,先理解它的兩個設計取捨,可以省下不少困惑與挫折。

其一,不保證處理順序。Amazon 不保證佇列項目的處理次序,也就是說 FIFO(先進先出)並不成立——這點與許多傳統訊息佇列實作不同。Amazon 只保證訊息最終都會被送達。

其二,最終一致性(eventual consistency)。大型分散式系統通常在一致性、高可用性與擴充性之間拉扯。Amazon 選擇優先滿足高可用性與擴充性,再在此基礎上提供最終一致性:它把訊息複寫到多台伺服器,保證訊息終將送達,但不保證何時送達。

落到實務上,這意味著:如果你連續送出 3 筆訊息,下一次讀取時不一定能一次收齊。你可能一次就拿到 3 筆,也可能第一次讀到 2 筆、第二次才讀到第 3 筆。但只要持續輪詢,最終一定會全部收到。應用程式的設計必須把這個特性納入考量,而不是事後補救。

準備工作

Amazon 為 Perl、Visual Basic .NET、C#、Java、PHP 等常見語言都提供了 API 函式庫,全部開源且易於使用。動手前先依你的語言取得對應的函式庫即可。

以 Java 使用 Amazon SQS

先看最基礎的三個動作:建立佇列、送出訊息、接收訊息。

建立佇列時,需要一組 Access Key ID(20 位英數)與 Secret Access Key(40 位英數)。前者用於識別身分、讀取佇列項目;後者則是建立與操作佇列項目時的必要憑證。這兩組金鑰在註冊 Amazon 帳號時就會一併取得。

String queueName = "TestQueue";

// 建立 HTTP 用戶端
AmazonSQS service = new AmazonSQSClient(accessKeyId, secretAccessKey);

// 建立請求物件
CreateQueueRequest request = new CreateQueueRequest();
request.setQueueName(queueName);
request.setDefaultVisibilityTimeout(30);

// 送出請求並取得回應
System.out.print("Creating Queue: " + queueName);
CreateQueueResponse response = service.createQueue(request);
if (response.isSetCreateQueueResult()) {
    CreateQueueResult createQueueResult = response.getCreateQueueResult();
    if (createQueueResult.isSetQueueUrl()) {
        System.out.print("Queue Url: " + createQueueResult.getQueueUrl());
    }
}

接著對剛建好的佇列送出一則訊息:

String queueName = "TestQueue";

// 建立 HTTP 用戶端
AmazonSQS service = new AmazonSQSClient(accessKeyId, secretAccessKey);

// 建立送訊請求
SendMessageRequest request = new SendMessageRequest();
request.setQueueName(queueName);
request.setMessageBody("Test SQS Message");

// 送出並取得回應
SendMessageResponse response = service.sendMessage(request);
if (response.isSetSendMessageResult()) {
    SendMessageResult sendMessageResult = response.getSendMessageResult();
    if (sendMessageResult.isSetMessageId()) {
        System.out.print("\tMessageId: " + sendMessageResult.getMessageId());
    }
}

最後是接收。回傳的 Message 物件包裝了佇列中的訊息,並提供三個關鍵方法:

  • getMessageId():回傳訊息的唯一識別碼,可用 isSetMessageId() 判斷是否已設定。
  • getReceiptHandle():回傳訊息的 handle,後續刪除訊息時必須用到;以 isSetReceiptHandle() 判斷。
  • getBody():以字串回傳訊息本文,可以是純文字或 XML;以 isSetBody() 判斷。
String queueName = "TestQueue";

// 建立 HTTP 用戶端
AmazonSQS service = new AmazonSQSClient(accessKeyId, secretAccessKey);

// 建立收訊請求
ReceiveMessageRequest request = new ReceiveMessageRequest();
request.setQueueName(queueName);
// 以下兩個參數為選填
request.setMaxNumberOfMessages(10);  // 单次最多接收的訊息數
request.setVisibilityTimeout(30);     // 鎖定視窗秒數

ReceiveMessageResponse response = service.receiveMessage(request);

if (response.isSetReceiveMessageResult()) {
    ReceiveMessageResult receiveMessageResult = response.getReceiveMessageResult();
    java.util.List<Message> messageList = receiveMessageResult.getMessage();
    for (Message message : messageList) {
        if (message.isSetMessageId()) {
            System.out.print("MessageId: " + message.getMessageId());
        }
        if (message.isSetReceiptHandle()) {
            System.out.print("ReceiptHandle: " + message.getReceiptHandle());
        }
        if (message.isSetBody()) {
            System.out.print("Body: " + message.getBody());
        }
    }
}

以 C# 使用 Amazon SQS

換成 C# 時,示範的題目更有意思一些:把一個物件序列化成 XML,當成訊息送出去,另一端再反序列化回物件。

第一步是定義要序列化的業務物件。C# 的「屬性」(attribute)在概念上近似 Java 的註解,用來宣告某個成員該對應到哪個 XML 元素或屬性。這個 Product 類別另外提供一個 ToXML() 方法,負責把自身序列化為字串。

namespace Stewart.Test
{
    /// <summary>Product</summary>
    [XmlRoot(ElementName = "Product")]
    public class Product
    {
        [XmlElement("ProductName")]
        public string ProductName;

        [XmlElement("ProductPrice")]
        public decimal ProductPrice;

        [XmlElement("InStock")]
        public bool InStock;

        [XmlAttribute(AttributeName = "Id", DataType = "integer")]
        public string Id;

        public Product() { }

        public Product(string productName, decimal productPrice)
        {
            this.ProductName = productName;
            this.ProductPrice = productPrice;
        }

        /// <summary>把物件序列化為 XML 字串</summary>
        public String ToXML()
        {
            StringBuilder output = new StringBuilder();

            // 不要命名空間
            XmlSerializerNamespaces ns = new XmlSerializerNamespaces();
            ns.Add("", "");

            // 省略 XML 宣告行
            XmlWriterSettings settings = new XmlWriterSettings();
            settings.OmitXmlDeclaration = true;

            XmlWriter writer = XmlTextWriter.Create(output, settings);
            XmlSerializer serializer = new XmlSerializer(typeof(Product));
            serializer.Serialize(writer, this, ns);

            return output.ToString();
        }
    }
}

接著送出訊息。Amazon 的 C# API 在功能上與 Java 版幾乎一一對應,只是風格回到 .NET 的屬性寫法:

Product prod = new Product("Widget", 1.5M);
string accessKeyId = ConfigurationSettings.AppSettings["AmazonAccessKeyID"];
string secretAccessKey = ConfigurationSettings.AppSettings["AmazonSecretAccessKey"];

AmazonSQS service = new AmazonSQSClient(accessKeyId, secretAccessKey);
SendMessageRequest request = new SendMessageRequest();
request.MessageBody = prod.ToXML();
request.QueueName = "TestQueue";

SendMessageResponse response = service.SendMessage(request);
if (response.IsSetSendMessageResult())
{
    Console.WriteLine("Send Message Response: ");
    SendMessageResult sendMessageResult = response.SendMessageResult;
    if (sendMessageResult.IsSetMessageId())
    {
        Console.WriteLine(String.Format("MessageId {0}", sendMessageResult.MessageId));
    }
    if (sendMessageResult.IsSetMD5OfMessageBody())
    {
        Console.WriteLine(String.Format("MD5OfMessageBody: {0}",
            sendMessageResult.MD5OfMessageBody));
    }
}

執行結果如下圖。

圖 1. 送出 XML 訊息的輸出

圖片看不清楚?請點擊這裡查看原圖(大圖)。

最後一步是在另一端收訊並反序列化回物件實例:

Product prod = null;

string accessKeyId = ConfigurationSettings.AppSettings["AmazonAccessKeyID"];
string secretAccessKey = ConfigurationSettings.AppSettings["AmazonSecretAccessKey"];

AmazonSQS service = new AmazonSQSClient(accessKeyId, secretAccessKey);

ReceiveMessageRequest request = new ReceiveMessageRequest();
request.QueueName = "TestQueue";
ReceiveMessageResponse response = service.ReceiveMessage(request);

if (response.IsSetReceiveMessageResult())
{
    ReceiveMessageResult receiveMessageResult = response.ReceiveMessageResult;
    List<Message> messageList = receiveMessageResult.Message;
    foreach (Message message in messageList)
    {
        if (message.IsSetMessageId())
        {
            Console.WriteLine(String.Format("MessageId: {0}", message.MessageId));
        }
        if (message.IsSetBody())
        {
            String xml = message.Body;
            StringReader sr = new StringReader(xml);
            XmlSerializer serializer = new XmlSerializer(typeof(Product));
            prod = (Product)serializer.Deserialize(sr);

            Console.WriteLine(String.Format("Id: {0}", prod.Id));
            Console.WriteLine(String.Format("Name: {0}", prod.ProductName));
            Console.WriteLine(String.Format("Price: {0}", prod.ProductPrice));
        }
    }
}

執行結果如下圖。

圖 2. 接收 XML 訊息的輸出

圖片看不清楚?請點擊這裡查看原圖(大圖)。

這些範例看起來簡單,實力卻不容小覷:你能把物件序列化後送給一個不在同一實體網路內的應用程式,不必處理複雜的防火牆規則或安全協商。更關鍵的是,訊息的送方與收方不需要使用同一種語言,甚至不需要同一個平台。

技術架構與設計

接下來要示範的整合情境,牽涉一家分銷商與一家製造商。分銷商向製造商進貨,再銷售給終端客戶。

客戶下單時,分銷商透過 C# WinForm 用戶端提交訂單,訂單明細存入本地 MySQL 資料庫。同一個用戶端也讓使用者能瀏覽庫存、查閱訂單與檢視 SQS 佇列。

一般情況下,分銷商的庫存足以應付客戶需求。一旦庫存不足,分銷商必須即時向製造商發出採購訂單;商品寄出後,製造商回送一份訂單匯總。這兩段對話都透過 SQS 完成。

分銷商的 Order Fulfillment 與 Inventory Management 服務同樣以 C# 打造,負責輪詢進貨與待處理的客戶訂單。當處理某筆訂單時發現庫存數量少於訂購數量,就透過 SQS 向製造商發出採購訂單,佇列項目的訊息本文即為一份採購訂單 XML 文件。

製造商的 Order Processing Service 建於 Java 平台,負責消費採購訂單佇列;商品出貨後,同樣以 SQS 回訊給分銷商,訊息本文為一份訂單匯總 XML 文件。

牽涉到的系統如下圖。

圖 3. 方案架構圖

定義 XML 結構

第一步是為雙方往來的訊息定義 XML schema,共需兩份:採購訂單與訂單匯總。

<?xml version="1.0" encoding="utf-8"?>
<xs:schema xmlns:xs="https://www.w3.org/2001/XMLSchema">
  <xs:element name="PurchaseOrder">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="Id" type="xs:string" minOccurs="0" />
        <xs:element name="OrderDate" type="xs:string" minOccurs="0" />
        <xs:element name="Company" minOccurs="0" maxOccurs="unbounded">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="CompanyName" type="xs:string" minOccurs="0" />
              <xs:element name="StreetAddress" type="xs:string" minOccurs="0" />
              <xs:element name="City" type="xs:string" minOccurs="0" />
              <xs:element name="State" type="xs:string" minOccurs="0" />
              <xs:element name="ZipCode" type="xs:string" minOccurs="0" />
            </xs:sequence>
          </xs:complexType>
        </xs:element>
        <xs:element name="Vendor" minOccurs="0" maxOccurs="unbounded">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="CompanyName" type="xs:string" minOccurs="0" />
              <xs:element name="StreetAddress" type="xs:string" minOccurs="0" />
              <xs:element name="City" type="xs:string" minOccurs="0" />
              <xs:element name="State" type="xs:string" minOccurs="0" />
              <xs:element name="ZipCode" type="xs:string" minOccurs="0" />
            </xs:sequence>
          </xs:complexType>
        </xs:element>
        <xs:element name="Items" minOccurs="0" maxOccurs="unbounded">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="Item" minOccurs="0" maxOccurs="unbounded">
                <xs:complexType>
                  <xs:attribute name="Id" type="xs:string" />
                  <xs:attribute name="Name" type="xs:string" />
                  <xs:attribute name="Quantity" type="xs:string" />
                </xs:complexType>
              </xs:element>
            </xs:sequence>
          </xs:complexType>
        </xs:element>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>

採購訂單 schema 中的關鍵元素:

元素說明
Id採購訂單的唯一識別碼
OrderDate採購訂單日期
Company分銷商的關鍵地址資訊:公司名稱、街道、城市、州、郵遞區號
Vendor製造商的關鍵地址資訊,欄位同上
Items所訂商品的所有資訊:商品 ID、名稱、數量

訂單匯總的 schema 如下:

<?xml version="1.0" encoding="utf-8"?>
<xs:schema xmlns:xs="https://www.w3.org/2001/XMLSchema">
  <xs:element name="OrderSummary">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="OrderId" type="xs:string" minOccurs="0" />
        <xs:element name="ReferenceId" type="xs:string" minOccurs="0" />
        <xs:element name="OrderDate" type="xs:string" minOccurs="0" />
        <xs:element name="CompanyAddress" minOccurs="0" maxOccurs="unbounded">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="CompanyName" type="xs:string" minOccurs="0" />
              <xs:element name="StreetAddress" type="xs:string" minOccurs="0" />
              <xs:element name="City" type="xs:string" minOccurs="0" />
              <xs:element name="State" type="xs:string" minOccurs="0" />
              <xs:element name="ZipCode" type="xs:string" minOccurs="0" />
            </xs:sequence>
          </xs:complexType>
        </xs:element>
        <xs:element name="CustomerAddress" minOccurs="0" maxOccurs="unbounded">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="CompanyName" type="xs:string" minOccurs="0" />
              <xs:element name="StreetAddress" type="xs:string" minOccurs="0" />
              <xs:element name="City" type="xs:string" minOccurs="0" />
              <xs:element name="State" type="xs:string" minOccurs="0" />
              <xs:element name="ZipCode" type="xs:string" minOccurs="0" />
            </xs:sequence>
          </xs:complexType>
        </xs:element>
        <xs:element name="Items" minOccurs="0" maxOccurs="unbounded">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="Item" minOccurs="0" maxOccurs="unbounded">
                <xs:complexType>
                  <xs:attribute name="ItemId" type="xs:string" />
                  <xs:attribute name="ItemName" type="xs:string" />
                  <xs:attribute name="Quantity" type="xs:string" />
                </xs:complexType>
              </xs:element>
            </xs:sequence>
          </xs:complexType>
        </xs:element>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>

訂單匯總 schema 中的關鍵元素:

元素說明
OrderId訂單匯總的唯一識別碼
ReferenceId對應的原始採購訂單 ID
OrderDate訂單匯總日期
CompanyAddress製造商的地址資訊
CustomerAddress分銷商的地址資訊
Items商品 ID、名稱與數量

定義資料實體模型

接著規劃資料庫 schema,實體模型如下圖。

圖 4. 資料庫實體模型

分銷商端的資料實體:

  • Customer:下單客戶的聯絡資訊。
  • CustomerOrder:客戶訂單的內容。
  • CustomerOrderDetail:客戶訂單的商品明細。
  • Inventory:分銷商的庫存。

製造商端的資料實體:

  • VendorOrder:追蹤由 Order Processing Service 處理的採購訂單。

定義訊息佇列

最後一項要定義的元件是訊息佇列。本方案共需兩個佇列,可見性逾時皆設為 30 秒:

佇列名稱可見性逾時用途
POQueue30 秒分銷商送給製造商的採購訂單訊息
OSQueue30 秒製造商送回分銷商的訂單匯總訊息

schema、實體模型與佇列都備齊之後,下一篇就來實作製造商端的 Java 訂單處理服務,並把整條流程跑通驗證。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved