Azure.Messaging.ServiceBus範例C#（工作原理）

了解 Azure Service Bus

Azure Service Bus 是一個完全託管的企業整合消息代理，能夠促進應用程式和服務之間的可靠通信，無論它們是在雲上、本地還是混合環境中運行。

它提供靈活的訊息功能，包括排隊和發布/訂閱機制，以實現分佈式系統中不同組件之間的無縫通信。 此外，它允許批量消息，這使得多則消息可以在不超過總大小限制的情況下發送。

Azure Service Bus 提供以下優勢：

1. 解耦應用程式：Service Bus 允許您將應用程式和服務彼此分開。 這種解耦增強了可靠性和可擴展性。
2. 負載均衡：它平衡競爭工人之間的工作，確保資源的高效利用。
3. 消息傳遞：數據是通過消息在應用程式和服務之間傳輸的。 這些消息的消息體可以包含各種類型的數據，如 JSON、XML 或純文本。
4. 消息場景：常見場景包括傳輸業務數據（例如銷售訂單）、負載均衡以及使用主題和訂閱啟動發布者和訂閱者之間的關係。
5. 交易：Service Bus 支援原子交易，允許多個操作在單個交易範圍內。 一個交易會有多次並發呼叫，而消息批次只有一次呼叫。
6. 消息會話：它促進了工作流的高規模協調和有序消息傳輸。

關鍵功能和能力

1. 隊列和主題：Azure Service Bus 提供隊列和主題作為通信通道。 隊列支持點對點通信，確保每個消息僅由一個接收端處理，這使得它非常適合工作量分配和負載均衡場景。 另一方面，主題支持發布/訂閱消息模式，允許多個訂閱者獨立接收相關消息，促進可擴展的事件驅動架構。

2. 可靠的消息傳遞：有了 Azure Service Bus，消息傳遞本質上是可靠的。 它確保消息持久性，可以配置消息和錯誤處理程序，容錯和至少一次交付語義，從而最大限度地降低數據丟失或重複的風險。 此外，它支持交易，允許多個消息的原子操作，從而確保數據完整性。

3. 死信和重試策略：為了有效處理錯誤的消息，Azure Service Bus 提供死信功能，允許問題消息自動移至單獨的隊列進行分析和排除。 此外，它提供靈活的重試策略，使開發人員可以配置自動重試和指數退避策略，提高應用程序面臨暫時失敗的韌性。

4. 分區和擴展：Azure Service Bus 支持消息實體的分區，將工作負載分佈在多個節點上，確保水平可擴展性和高吞吐量。 這一能力對於處理大量消息和適應波動的工作負載而不損害性能或可靠性至關重要。

5. 與 Azure 生態系統的整合：Azure Service Bus 無縫整合到其他 Azure 服務中，如 Azure Functions、Logic Apps、Event Grid 和 Azure Kubernetes Service (AKS)，使開發人員能夠輕鬆構建端到端解決方案。 無論是響應傳入消息啟動無服務器函數，還是使用 Logic Apps 編排復雜工作流程，Azure Service Bus 作為構建強大事件驅動架構的關鍵。

介紹 IronPDF

IronPDF 是一個強大的 C# PDF 程式庫，允許您在 .NET 專案中生成、編輯和從 PDF 文件中提取內容。 以下是一些關鍵特性：

1. HTML 轉 PDF：

• 將 HTML，CSS 和 JavaScript 內容轉換為 PDF 格式。

• 使用 Chrome 渲染引擎生成像素完美的 PDF。

• 從網址，HTML 文件或 HTML 字符串生成 PDF。

2. 影像和內容轉換：

• 將影像轉換為 PDF 或從 PDF 中轉換。

• 從現有 PDF 中提取文本和圖像。

• 支持各種圖像格式。

3. 編輯和操作：

• 設置 PDF 的屬性、安全性和權限。

• 添加數位簽名。

• 編輯元數據及修訂歷史。

4. 跨平台支援：

• 支援 .NET Core (8, 7, 6, 5, 3.1+)、.NET Standard (2.0+) 和 .NET Framework (4.6.2+)。

• 與 Windows，Linux 和 macOS 兼容。

• 可在 NuGet 上直接安裝。

使用 IronPDF 和 Azure.Messaging.ServiceBus 生成 PDF 文件

首先，使用 Visual Studio 創建一個控制台應用程式，如下所示。

提供專案名稱

提供 .NET 版本

安裝 IronPDF 套件。

在 Azure 入口網站中創建 Service Bus 隊列

要在您的 Service Bus 命名空間中設置隊列，請按照以下步驟操作：

1. 導航到隊列：進入 Azure 入口網站上的 Service Bus 命名空間頁。 從左側導航菜單中選擇"Queues"。
2. 創建新隊列：在 Queues 頁面上，點擊工具欄上的"+ Queue"按鈕。

3. 配置隊列：在指定的字段中輸入您的隊列名稱。 將其他設置保持其預設值。 創建 Azure Service Bus 隊列時需要配置的選項：

4. 名稱：這是您隊列的唯一識別符。 選擇一個描述性且易記的名稱。

5. 最大隊列大小：這定義了隊列的最大存儲容量。 您可以將其設置為 1 GB，2 GB，5 GB，10 GB，20 GB，40 GB，80 GB 或 100 GB。 在您的情況下，設置為 1 GB。

6. 最大投遞次數：這指定了消息在被發送到死信隊列或丟棄之前的最大投遞次數。 這有助於處理消息處理失敗。

7. 消息生命週期（TTL）：這決定了消息在隊列中存在的時間，直到到期。 您可以按天、時、分、秒設置過期時間。 一旦達到 TTL，死信消息將被丟棄或移至死信隊列（如果啟用了死信）。

8. 鎖定時長：這是消息被接收者鎖定以進行處理的時間長度。 在此期間，其他接收者無法處理同一消息。 您可以按天、時、分、秒設置時長。

9. 在消息過期時啟用死信：啟用後，過期的消息（即超過其 TTL）將被移至死信隊列，而不是被丟棄。 這允許進一步檢查和處理過期的消息。

10. 啟用分區：此選項允許隊列跨多個消息代理分區，以提高可擴展性和吞吐量。 分區對於處理大量消息非常有用。

這些設置幫助您控制 Azure Service Bus 隊列的行為和性能，確保滿足應用程序的需求。

4. 完成創建：點擊"創建"按鈕來最終創建隊列。 這些步驟確保您通過 Azure 入口網站成功創建了 Service Bus 命名空間中的隊列。

安裝 Azure.Messaging.ServiceBus，這是一個 Service Bus 客戶端程式庫，用於使用連接字符串連接到 Azure 隊列。

添加以下代碼以使用 Azure.Messaging.ServiceBus 發送和接收消息。

using Azure.Messaging.ServiceBus;
namespace CodeSample
{
    public static class AzureServiceBusDemo
    {
        public static async Task Execute()
        {
            string connectionString = "Endpoint=sb://iron-articles.servicebus.windows.net/;SharedAccessKeyName=all;SharedAccessKey=uqQIzpuc2HxbnAb9keqTINvzfTcFbkkU0+ASbJZ/tow=;EntityPath=ironpdf";
            string queName = "ironpdf";
            Console.WriteLine("Demo IronPDF with Azure.Messaging.ServiceBus");
            Installation.EnableWebSecurity = true;

            // Instantiate Renderer
            var renderer = new ChromePdfRenderer();
            var content = "<h1>Demo IronPDF with Azure.Messaging.ServiceBus</h1>";
            content += "<h2>Send Message to Azure.Messaging.ServiceBus Queue: ironpdf</h2>";

            await using var client = new ServiceBusClient(connectionString);
            var msgText = "IronPDF is Awesome Package";
            content += $"<p>Message: {msgText}</p>";

            var tx = client.CreateSender(queName);
            await tx.SendMessageAsync(new ServiceBusMessage(msgText)); // Send message to the queue
            Console.WriteLine($"Sent Below message at: {DateTime.Now}");
            content += $"<p>Sent Below message at: {DateTime.Now}</p>";

            Console.ReadLine(); // wait for user input to read the message;

            var rx = client.CreateReceiver(queName);
            var msg = await rx.ReceiveMessageAsync(); // receive messages
            content += "<h2>Receive Message from Azure.Messaging.ServiceBus Queue: ironpdf</h2>";
            content += $"<p>Recieved Below message at: {DateTime.Now}</p>";
            Console.WriteLine($"Recieved Below message at: {DateTime.Now}");

            content += $"<p>MessageID={msg.MessageId}</p>";
            Console.WriteLine($"MessageID={msg.MessageId}");

            content += $"<p>Message Received: {msg.Body}</p>";
            Console.WriteLine($"Message Received: {msg.Body}");

            var pdf = renderer.RenderHtmlAsPdf(content);
            // Export to a file or Stream
            pdf.SaveAs("AwesomeAzureServiceBusQueueAndIronPdf.pdf");
        }
    }
}

using Azure.Messaging.ServiceBus;
namespace CodeSample
{
    public static class AzureServiceBusDemo
    {
        public static async Task Execute()
        {
            string connectionString = "Endpoint=sb://iron-articles.servicebus.windows.net/;SharedAccessKeyName=all;SharedAccessKey=uqQIzpuc2HxbnAb9keqTINvzfTcFbkkU0+ASbJZ/tow=;EntityPath=ironpdf";
            string queName = "ironpdf";
            Console.WriteLine("Demo IronPDF with Azure.Messaging.ServiceBus");
            Installation.EnableWebSecurity = true;

            // Instantiate Renderer
            var renderer = new ChromePdfRenderer();
            var content = "<h1>Demo IronPDF with Azure.Messaging.ServiceBus</h1>";
            content += "<h2>Send Message to Azure.Messaging.ServiceBus Queue: ironpdf</h2>";

            await using var client = new ServiceBusClient(connectionString);
            var msgText = "IronPDF is Awesome Package";
            content += $"<p>Message: {msgText}</p>";

            var tx = client.CreateSender(queName);
            await tx.SendMessageAsync(new ServiceBusMessage(msgText)); // Send message to the queue
            Console.WriteLine($"Sent Below message at: {DateTime.Now}");
            content += $"<p>Sent Below message at: {DateTime.Now}</p>";

            Console.ReadLine(); // wait for user input to read the message;

            var rx = client.CreateReceiver(queName);
            var msg = await rx.ReceiveMessageAsync(); // receive messages
            content += "<h2>Receive Message from Azure.Messaging.ServiceBus Queue: ironpdf</h2>";
            content += $"<p>Recieved Below message at: {DateTime.Now}</p>";
            Console.WriteLine($"Recieved Below message at: {DateTime.Now}");

            content += $"<p>MessageID={msg.MessageId}</p>";
            Console.WriteLine($"MessageID={msg.MessageId}");

            content += $"<p>Message Received: {msg.Body}</p>";
            Console.WriteLine($"Message Received: {msg.Body}");

            var pdf = renderer.RenderHtmlAsPdf(content);
            // Export to a file or Stream
            pdf.SaveAs("AwesomeAzureServiceBusQueueAndIronPdf.pdf");
        }
    }
}

IronPDF 授權

IronPDF 套件需要授權才能運行並生成 PDF。 在訪問套件前，請在應用程式的開頭添加以下代碼。

IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY";

IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY";

在IronPDF 試用許可頁面上提供試用許可。

結論

在數位轉型和快速技術進步的時代，Azure Service Bus 以其可靠、可擴展和靈活的消息能力，成為全球業務現代化旅程中的關鍵組成部分，使開發人員能夠設計出能夠適應不斷變化的業務需求的強大而敏捷的解決方案。

無論是促進無縫整合、支持事件驅動架構還是確保非同步通信，Azure Service Bus 在推動創新和加速跨行業的數位化進程中發揮了變革性作用。

隨著組織繼續採納基於雲端的範式和分佈式架構，Azure Service Bus 作為 Microsoft 致力於支持開發人員和企業雲端之旅的表現。 IronPDF 簡化了 .NET 應用程式中的 PDF 生成，提供靈活性和功能，直接從代碼創建專業級文檔。