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. Trennung von Anwendungen: Der Service Bus ermöglicht es Ihnen, Anwendungen und Dienste voneinander zu trennen. Diese Entkopplung verbessert die Zuverlässigkeit und Skalierbarkeit.
2. Lastenausgleich: Er gleicht die Arbeit zwischen konkurrierenden Arbeitsprozessen aus und sorgt so für eine effiziente Ressourcennutzung.
3. Nachrichtentransfer: Daten werden zwischen Anwendungen und Diensten mithilfe von Nachrichten übertragen. Der Nachrichtenkörper dieser Nachrichten kann verschiedene Datentypen enthalten, wie JSON, XML oder Klartext.
4. Nachrichtenszenarien: Häufige Szenarien sind das Übertragen von Geschäftsdaten (z. B. Verkaufsaufträgen), Lastenausgleich und die Ermöglichung von Beziehungen zwischen Publishern und Abonnenten mithilfe von Themen und Abonnements.
5. Transaktionen: Der Service Bus unterstützt atomare Transaktionen, die mehrere Operationen innerhalb eines einzigen Transaktionsbereichs ermöglichen. Eine Transaktion hätte mehrere gleichzeitige Aufrufe, während eine Nachrichtencharge nur einen einzigen Aufruf hat.
6. Nachrichtensitzungen: Sie erleichtern die groß angelegte Koordination von Workflows und geordneten Nachrichtentransfers.

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

3. Warteschlange konfigurieren: Geben Sie im 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 der eindeutige Bezeichner 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: Diese Option gibt an, wie oft eine Nachricht zugestellt werden kann, bevor sie auf die Dead-Letter-Warteschlange gesendet oder verworfen wird. Dies hilft bei der Behandlung von Nachrichtenverarbeitungsfehlern.

   4. Nachrichtenlebensdauer (TTL): Diese Option bestimmt, wie lange eine Nachricht in der Warteschlange bleibt, 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. Schlossdauer: Dies ist die Zeitspanne, die 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. Aktivieren Sie die Dead-Lettering bei Nachrichtenablauf: Wenn aktiviert, werden Nachrichten, die ablaufen (d.h. ihre TTL überschreiten), in die Dead-Letter-Warteschlange verschoben anstatt sie zu verwerfen. Dies ermöglicht eine weitere Inspektion und Behandlung abgelaufener Nachrichten.

   7. Partitionierung aktivieren: Diese Option ermöglicht die Partitionierung der Warteschlange über mehrere Nachrichtenbrokers, was die Skalierbarkeit und den Durchsatz erhöhen 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. Abschließende Erstellung: 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");
        }
    }
}

Imports Azure.Messaging.ServiceBus
Namespace CodeSample
	Public Module AzureServiceBusDemo
		Public Async Function Execute() As Task
			Dim connectionString As String = "Endpoint=sb://iron-articles.servicebus.windows.net/;SharedAccessKeyName=all;SharedAccessKey=uqQIzpuc2HxbnAb9keqTINvzfTcFbkkU0+ASbJZ/tow=;EntityPath=ironpdf"
			Dim queName As String = "ironpdf"
			Console.WriteLine("Demo IronPDF with Azure.Messaging.ServiceBus")
			Installation.EnableWebSecurity = True

			' Instantiate Renderer
			Dim renderer = New ChromePdfRenderer()
			Dim content = "<h1>Demo IronPDF with Azure.Messaging.ServiceBus</h1>"
			content &= "<h2>Send Message to Azure.Messaging.ServiceBus Queue: ironpdf</h2>"

			Await var client = New ServiceBusClient(connectionString)
			Dim msgText = "IronPDF is Awesome Package"
			content &= $"<p>Message: {msgText}</p>"

			Dim 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;

			Dim rx = client.CreateReceiver(queName)
			Dim 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}")

			Dim pdf = renderer.RenderHtmlAsPdf(content)
			' Export to a file or Stream
			pdf.SaveAs("AwesomeAzureServiceBusQueueAndIronPdf.pdf")
		End Function
	End Module
End Namespace

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";

IRON VB CONVERTER ERROR developers@ironsoftware.com

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.