佇列是一種暫存待處理訊息的資料結構。Amazon Simple Queue Service(Amazon SQS)則是一套以 Web 服務形式提供、具高可用性與高擴充性的訊息佇列服務。它的主要優勢包括:
在開始撰寫 SQS 程式之前,先理解它的兩個設計取捨,可以省下不少困惑與挫折。
其一,不保證處理順序。Amazon 不保證佇列項目的處理次序,也就是說 FIFO(先進先出)並不成立——這點與許多傳統訊息佇列實作不同。Amazon 只保證訊息最終都會被送達。
其二,最終一致性(eventual consistency)。大型分散式系統通常在一致性、高可用性與擴充性之間拉扯。Amazon 選擇優先滿足高可用性與擴充性,再在此基礎上提供最終一致性:它把訊息複寫到多台伺服器,保證訊息終將送達,但不保證何時送達。
落到實務上,這意味著:如果你連續送出 3 筆訊息,下一次讀取時不一定能一次收齊。你可能一次就拿到 3 筆,也可能第一次讀到 2 筆、第二次才讀到第 3 筆。但只要持續輪詢,最終一定會全部收到。應用程式的設計必須把這個特性納入考量,而不是事後補救。
Amazon 為 Perl、Visual Basic .NET、C#、Java、PHP 等常見語言都提供了 API 函式庫,全部開源且易於使用。動手前先依你的語言取得對應的函式庫即可。
先看最基礎的三個動作:建立佇列、送出訊息、接收訊息。
建立佇列時,需要一組 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# 時,示範的題目更有意思一些:把一個物件序列化成 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 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. 資料庫實體模型

分銷商端的資料實體:
製造商端的資料實體:
最後一項要定義的元件是訊息佇列。本方案共需兩個佇列,可見性逾時皆設為 30 秒:
| 佇列名稱 | 可見性逾時 | 用途 |
|---|---|---|
| POQueue | 30 秒 | 分銷商送給製造商的採購訂單訊息 |
| OSQueue | 30 秒 | 製造商送回分銷商的訂單匯總訊息 |
schema、實體模型與佇列都備齊之後,下一篇就來實作製造商端的 Java 訂單處理服務,並把整條流程跑通驗證。