Azure.Messaging.ServiceBus Beispiel C# (Wie es funktioniert)

Verstehen Sie Azure Service Bus

Azure Service Bus ist ein voll verwalteter Unternehmensnachrichtenvermittler, der eine zuverlässige Kommunikation zwischen Anwendungen und Diensten ermöglicht, unabhängig davon, ob sie in der Cloud, lokal oder in hybriden Umgebungen betrieben werden.

Er bietet flexible Messaging-Funktionen, einschließlich Warteschlangen- und Publish/Subscribe-Mechanismen, um eine nahtlose Kommunikation zwischen verschiedenen Komponenten eines verteilten Systems zu ermöglichen. Zusätzlich erlaubt er Batch-Nachrichten, was mehrere Nachrichten ermöglicht, ohne die Gesamtgrößenbeschränkung zu überschreiten.

Azure Service Bus bietet die folgenden Vorteile:

1. Entkoppeln von Anwendungen: Der Service Bus ermöglicht es Ihnen, Anwendungen und Dienste voneinander zu trennen. Diese Entkopplung verbessert die Zuverlässigkeit und Skalierbarkeit.
2. Lastverteilung: Er verteilt die Arbeit auf konkurrierende Arbeiter und sorgt so für eine effiziente Ressourcennutzung.
3. Nachrichtenübertragung: Daten werden mithilfe von Nachrichten zwischen Anwendungen und Diensten übertragen. Der Nachrichtenkörper dieser Nachrichten kann verschiedene Datentypen enthalten, wie JSON, XML oder Klartext.
4. Nachrichtenszenarien: Häufige Szenarien umfassen die Übertragung von Geschäftsdaten (z.B. Verkaufsaufträge), Lastverteilung und die Ermöglichung von Beziehungen zwischen Publishern und Abonnenten mittels Themen und Abonnements.
5. Transaktionen: Der Service Bus unterstützt atomare Transaktionen, die mehrere Operationen innerhalb eines einzelnen Transaktionsbereichs ermöglichen. Eine Transaktion hätte mehrere gleichzeitige Aufrufe, während eine Nachrichtencharge nur einen einzigen Aufruf hat.
6. Nachrichtensitzungen: Er erleichtert die hochskalige Koordination von Workflows und die geordnete Nachrichtenübertragung.

Schlüsselmerkmale und -fähigkeiten

1. Warteschlangen und Themen: Azure Service Bus bietet sowohl Warteschlangen als auch Themen als Kommunikationskanäle. Warteschlangen ermöglichen eine direkte Kommunikation von Punkt zu Punkt und stellen sicher, dass jede Nachricht nur von einem Empfänger verarbeitet wird, was ideal für Arbeitsverteilung und Lastnivellierungsszenarien ist. Andererseits unterstützen Themen Publish/Subscribe-Messaging-Muster, sodass mehrere Abonnenten unabhängig voneinander relevante Nachrichten empfangen können, und erleichtern skalierbare eventgesteuerte Architekturen.

2. Zuverlässige Nachrichtenzustellung: Mit Azure Service Bus ist die Nachrichtenzustellung von Natur aus zuverlässig. Es gewährleistet die Nachrichtenpersistenz, kann den Nachrichten- und Fehlerhandler, Fehlertoleranz und mindestens-einmal-Zustellsemantik konfigurieren, wodurch das Risiko von Datenverlust oder -duplizierung minimiert wird. Zusätzlich unterstützt es Transaktionen, die atomare Operationen über mehrere Nachrichten hinweg ermöglichen und so die Datenintegrität sicherstellen.

3. Dead-Lettering und Wiederholungsrichtlinien: Um fehlerhafte Nachrichten effektiv zu handhaben, bietet Azure Service Bus Dead-Lettering-Funktionen, die es ermöglichen, problematische Nachrichten automatisch in eine separate Warteschlange zur Analyse und Fehlerbehebung zu verschieben. Darüber hinaus bietet es flexible Wiederholungsrichtlinien, mit denen Entwickler automatische Wiederholungen mit exponentiellen Back-off-Strategien konfigurieren können, um die Belastbarkeit von Anwendungen angesichts von vorübergehenden Fehlern zu erhöhen.

4. Partitionierung und Skalierung: Azure Service Bus unterstützt die Partitionierung von Messaging-Entitäten zur Verteilung der Arbeitslast über mehrere Knoten hinweg, was horizontale Skalierbarkeit und hohen Durchsatz sicherstellt. Diese Fähigkeit ist entscheidend für den Umgang mit großen Mengen an Nachrichten und die Bewältigung schwankender Arbeitslasten, ohne die Leistung oder Zuverlässigkeit zu beeinträchtigen.

5. Integration in das Azure-Ökosystem: Azure Service Bus integriert sich nahtlos in andere Azure-Dienste wie Azure Functions, Logic Apps, Event Grid und Azure Kubernetes Service (AKS), sodass Entwickler End-to-End-Lösungen mühelos erstellen können. Ganz gleich, ob es darum geht, serverlose Funktionen als Reaktion auf eingehende Nachrichten auszulösen oder komplexe Workflows mithilfe von Logic Apps zu orchestrieren, Azure Service Bus dient als Kernstück für den Aufbau robuster, ereignisgesteuerter Architekturen.

Einführung in IronPDF

IronPDF ist eine leistungsstarke C# PDF-Bibliothek, die es Ihnen ermöglicht, PDF-Dokumente in .NET-Projekten zu erzeugen, zu bearbeiten und Inhalte daraus zu extrahieren. Hier sind einige wichtige Funktionen:

1. HTML-zu-PDF-Konvertierung:

   • HTML-, CSS- und JavaScript-Inhalte in PDF-Format konvertieren.

   • Verwenden Sie die Chrome-Rendering-Engine für pixelgenaue PDFs.

   • Generieren Sie PDFs von URLs, HTML-Dateien oder HTML-Zeichenfolgen.

2. Bild- und Inhaltskonvertierung:

   • Bilder zu und aus PDF konvertieren.

   • Text und Bilder aus bestehenden PDFs extrahieren.

   • Unterstützung für verschiedene Bildformate.

3. Bearbeitung und Manipulation:

   • Eigenschaften, Sicherheit und Berechtigungen für PDFs festlegen.

   • Hinzufügen digitaler Signaturen.

   • Metadaten und Versionsverlauf bearbeiten.

4. Plattformübergreifende Unterstützung:

   • Funktioniert mit .NET Core (8, 7, 6, 5 und 3.1+), .NET Standard (2.0+) und .NET Framework (4.6.2+).

   • Kompatibel mit Windows, Linux und macOS.

   • Auf NuGet für einfache Installation verfügbar.

Erzeugen eines PDF-Dokuments mit IronPDF und Azure.Messaging.ServiceBus

Um zu beginnen, erstellen Sie eine Konsolenanwendung mit Visual Studio wie unten gezeigt.

Projektname angeben

.NET-Version angeben

Installieren Sie das IronPDF-Paket.

Servicebus-Warteschlangen im Azure-Portal erstellen

Um eine Warteschlange in Ihrem Service Bus-Namensraum einzurichten, führen Sie diese Schritte aus:

1. Navigieren zu Warteschlangen: Gehen Sie zur Service Bus Namespace-Seite im Azure-Portal. Wählen Sie "Warteschlangen" aus dem linken Navigationsmenü.
2. Erstellen einer neuen Warteschlange: Klicken Sie auf der Seite Warteschlangen in der Symbolleiste auf die Schaltfläche '+ Warteschlange'.

3. Warteschlange konfigurieren: Geben Sie einen Namen für Ihre Warteschlange in das bereitgestellte Feld ein. Lassen Sie die anderen Einstellungen mit ihren Standardwerten. Die Optionen, die Sie beim Erstellen einer Azure Service Bus-Warteschlange konfigurieren müssen:

   1. Name: Dies ist die eindeutige Kennung für Ihre Warteschlange. Wählen Sie einen Namen, der beschreibend und leicht zu merken ist.

   2. Maximale Warteschlangengröße: Dies definiert die maximale Speicherkapazität der Warteschlange. Sie können es auf 1 GB, 2 GB, 5 GB, 10 GB, 20 GB, 40 GB, 80 GB oder 100 GB einstellen. Für Ihren Fall ist er auf 1 GB eingestellt.

   3. Maximale Lieferanzahl: Dies gibt an, wie oft eine Nachricht zugestellt werden kann, bevor sie in die Warteschlange für unzustellbare Nachrichten verschoben oder verworfen wird. Dies hilft bei der Behandlung von Nachrichtenverarbeitungsfehlern.

   4. Nachrichtenlebensdauer (TTL): Dies bestimmt, wie lange eine Nachricht in der Warteschlange verbleibt, bevor sie abläuft. Sie können dies in Tagen, Stunden, Minuten und Sekunden einrichten. Sobald die TTL erreicht ist, werden die Dead-Letter-Nachrichten entweder verworfen oder bei aktivierter Dead-Letter-Funktion in die Dead-Letter-Warteschlange verschoben.

   5. Sperrdauer: Dies ist die Zeitspanne, in der eine Nachricht zur Verarbeitung durch einen Empfänger gesperrt ist. Während dieser Zeit können andere Empfänger dieselbe Nachricht nicht verarbeiten. Sie können diese Dauer in Tagen, Stunden, Minuten und Sekunden einstellen.

   6. Unzustellbarkeitsprotokoll bei Nachrichtenauslauf aktivieren: Wenn aktiviert, werden abgelaufene Nachrichten (d.h. die ihre TTL überschreiten) in die Warteschlange für unzustellbare Nachrichten verschoben, anstatt verworfen zu werden. Dies ermöglicht eine weitere Inspektion und Behandlung abgelaufener Nachrichten.

   7. Partitionierung aktivieren: Diese Option ermöglicht die Partitionierung der Warteschlange über mehrere Nachrichtenbroker hinweg, was die Skalierbarkeit und den Durchsatz verbessern kann. Partitionierung ist nützlich, um mit großen Mengen an Nachrichten umzugehen.

Diese Einstellungen helfen Ihnen, das Verhalten und die Leistung Ihrer Azure Service Bus-Warteschlange zu kontrollieren und sicherzustellen, dass sie den Anforderungen Ihrer Anwendung entspricht.

4. Anlage abschließen: Klicken Sie auf die Schaltfläche 'Erstellen', um die Erstellung der Warteschlange abzuschließen. Diese Schritte stellen sicher, dass Sie erfolgreich eine Warteschlange innerhalb Ihres Service Bus-Namensraums mithilfe des Azure-Portals erstellen.

Installieren Sie Azure.Messaging.ServiceBus, eine Service Bus-Client-Bibliothek, um über eine Verbindungszeichenfolge eine Verbindung zur Azure-Warteschlange herzustellen.

Fügen Sie den folgenden Code hinzu, um Nachrichten zu senden und Nachrichten mit Azure.Messaging.ServiceBus zu empfangen.

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 Lizenzierung

Das IronPDF-Paket erfordert eine Lizenz, um zu funktionieren und das PDF zu erzeugen. Fügen Sie den Code unten am Anfang der Anwendung hinzu, bevor das Paket verwendet wird.

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

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

Eine Testlizenz ist auf der IronPDF Testlizenz-Seite verfügbar.

Abschluss

In einer von digitalem Wandel und schnellen technologischen Fortschritten geprägten Ära erweist sich der Azure Service Bus als ein entscheidendes Element in der Modernisierungsreise von Unternehmen weltweit. Durch die Bereitstellung zuverlässiger, skalierbarer und flexibler Messaging-Funktionen ermöglicht er es Entwicklern, widerstandsfähige und agile Lösungen zu entwerfen, die sich an sich ändernde Geschäftsanforderungen anpassen können.

Ob es sich um nahtlose Integration, die Ermöglichung ereignisgesteuerter Architekturen oder die Sicherstellung asynchroner Kommunikation handelt, Azure Service Bus spielt eine transformative Rolle bei der Förderung von Innovation und der Beschleunigung digitaler Initiativen in verschiedenen Branchen.

Während Organisationen weiterhin cloud-native Paradigmen und verteilte Architekturen annehmen, steht der Azure Service Bus als Beweis für das Engagement von Microsoft, Entwicklern und Unternehmen auf ihrem Weg in die Cloud zu unterstützen. IronPDF vereinfacht die PDF-Erzeugung innerhalb von .NET-Anwendungen und bietet Flexibilität und Funktionalität zur Erstellung professioneller Dokumente direkt aus dem Code.