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. Entkopplung von Anwendungen: Mit Service Bus können Sie Anwendungen und Dienste voneinander trennen. Diese Entkopplung verbessert die Zuverlässigkeit und Skalierbarkeit.
2. Lastverteilung: Sie verteilt die Arbeit auf mehrere konkurrierende Mitarbeiter und gewährleistet so eine effiziente Ressourcennutzung.
3. Nachrichtenübertragung: Daten werden zwischen Anwendungen und Diensten mittels Nachrichten übertragen. Der Nachrichtenkörper dieser Nachrichten kann verschiedene Datentypen enthalten, wie JSON, XML oder Klartext.
4. Messaging-Szenarien: Gängige Szenarien sind die Übertragung von Geschäftsdaten (z. B. Verkaufsaufträge), der Lastausgleich und die Ermöglichung von Beziehungen zwischen Herausgebern und Abonnenten mithilfe von Themen und Abonnements.
5. Transaktionen: Der Service Bus unterstützt atomare Transaktionen, wodurch mehrere Operationen innerhalb eines einzigen Transaktionsbereichs möglich sind. Eine Transaktion hätte mehrere gleichzeitige Aufrufe, während eine Nachrichtencharge nur einen einzigen Aufruf hat.
6. Nachrichtensitzungen: Es ermöglicht die umfassende Koordination von Arbeitsabläufen und die geordnete Übermittlung von Nachrichten.

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 Sie zu Warteschlangen: Gehen Sie im Azure-Portal zur Seite "Service Bus-Namespace". Wählen Sie "Warteschlangen" aus dem linken Navigationsmenü.
2. Neue Warteschlange erstellen: Klicken Sie auf der Seite "Warteschlangen" auf die Schaltfläche "+ Warteschlange" in der Symbolleiste.

3. Warteschlange konfigurieren: Geben Sie im dafür vorgesehenen Feld einen Namen für Ihre Warteschlange 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 Ihrer Warteschlange. Wählen Sie einen Namen, der beschreibend und leicht zu merken ist.

   2. Maximale Warteschlangengröße: Hiermit wird die maximale Speicherkapazität der Warteschlange definiert. 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 Zustellungsanzahl: Hiermit wird die maximale Anzahl der Zustellungen einer Nachricht festgelegt, bevor sie in die Dead-Letter-Warteschlange verschoben oder verworfen wird. Dies hilft bei der Behandlung von Nachrichtenverarbeitungsfehlern.

   4. Message Time to Live (TTL): Diese Einstellung 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. Dead Lettering bei Nachrichtenablauf aktivieren: Wenn diese Option aktiviert ist, werden Nachrichten, die ablaufen (d. h. ihre TTL überschreiten), in die Dead-Letter-Warteschlange 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 auf mehrere Message Broker, 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. Erstellung 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.