Azure.Messaging.ServiceBus Örneği C# (Nasıl Çalışır)

Azure Service Bus'ı Anlamak

Azure Service Bus, bulut, şirket içi veya hibrit ortamlarda çalışan uygulamalar ve hizmetler arasında güvenilir iletişimi kolaylaştıran tamamen yönetilen bir kurumsal entegrasyon mesaj aracı olarak görev yapar.

Farklı sistem bileşenleri arasında kesintisiz iletişimi sağlamak için esnek mesajlaşma özellikleri, kuyruklama ve yayın/abonelik mekanizmaları sunar. Ayrıca, toplam boyut kısıtlamasını aşmadan birden fazla mesajın gönderilmesine izin veren toplu mesajlara olanak tanır.

Azure Service Bus şu faydaları sunar:

1. Uygulamaları Ayırma: Service Bus, uygulamaları ve hizmetleri birbirinden ayırmanıza olanak tanır. Bu ayırma, güvenilirlik ve ölçeklenebilirliği artırır.
2. Yük Dengeleme: O, rekabet eden çalışanlar arasında çalışmayı dengeleyerek, kaynakların verimli kullanımını sağlar.
3. Mesaj Aktarımı: Uygulamalar ve hizmetler arasında veri, mesajlar aracılığıyla aktarılır. Bu mesajların gövde kısmı, JSON, XML veya düz metin gibi çeşitli veri türlerini içerebilir.
4. Mesajlaşma Senaryoları: Sık karşılaşılan senaryolar, iş verilerinin (örn. satış siparişleri) aktarılması, yük dengeleme ve yayıncılar ile aboneler arasında ilişkiler kurmayı içermektedir.
5. İşlemler: Service Bus, çoklu işlemlerde tek bir işlem kapsamı içinde atomik işlemleri destekler. Bir işlemde birden fazla eşzamanlı çağrı bulunurken, bir mesaj kümesi tek bir çağrıda olur.
6. Mesaj Oturumları: Yüksek ölçekli iş akışı koordinasyonunu ve sıralı mesaj aktarımlarını kolaylaştırır.

Anahtar Özellikler ve Yetkinlikler

1. Kuyruklar ve Konular: Azure Service Bus, iletişim kanalları olarak hem kuyruklar hem de konular sunar. Kuyruklar, her mesajın yalnızca bir alıcı tarafından işlendiği nokta-nokta iletişimi sağlarken, iş yükü dağıtımı ve yük dengeleme senaryoları için idealdir. Öte yandan, konular, birçok abonenin ilgili mesajları bağımsız olarak almasını sağlayan yayın/abonelik mesajlaşma kalıplarını destekler ve ölçeklenebilir olay-odaklı mimarilerin oluşturulmasını kolaylaştırır.

2. Güvenilir Mesaj Teslimi: Azure Service Bus ile mesaj teslimi doğal olarak güvenilirdir. Mesaj sürekliliğini sağlar, mesaj ve hata işleyicisini yapılandırabilir, hata toleransı ve en az bir kere teslim semantiklerini içerebilir, böylece veri kaybı veya çoğaltılması riskini minimize eder. Ayrıca, işlemleri destekler, birden fazla mesaj üzerinde atomik işlemlere olanak tanır ve bu da veri bütünlüğünü sağlar.

3. Ölü-Mektup ve Yeniden Deneme Politikaları: Hatalı mesajları etkili bir şekilde ele almak için Azure Service Bus, sorunlu mesajların analiz ve sorun giderme için otomatik olarak ayrı bir kuyruğa taşınmasını sağlayan ölü-mektup özellikleri sunar. Ayrıca, geçici hatalar karşısında uygulamaların dayanıklılığını artıran esnek yeniden deneme politikaları, üstel geri çekilme stratejileriyle otomatik yeniden denemeleri yapılandırma imkanı sunar.

4. Bölme ve Ölçekleme: Azure Service Bus, mesajlaşma varlıklarının iş yükünü birden fazla düğüme dağıtarak yatay ölçeklenebilirlik ve yüksek verim sağlamak için bölmeyi destekler. Bu yetenek, büyük hacimli mesajların işlendiği ve iş yükü dalgalanmalarının performans veya güvenilirlikten ödün vermeden yönetiminde kritiktir.

5. Azure Ekosistemine Entegrasyon: Azure Service Bus, Azure İşlevleri, Logic Apps, Olay Ağı ve Azure Kubernetes Hizmeti (AKS) gibi diğer Azure hizmetleriyle sorunsuz bir şekilde entegre olur ve geliştiricilerin uçtan uca çözümleri kolaylıkla oluşturmasına olanak tanır. Gelen mesajlara yanıt olarak sunucusuz işlevlerin tetiklenmesi veya Logic Apps kullanarak karmaşık iş akışlarının düzenlenmesi olsun, Azure Service Bus, sağlam, olay odaklı mimariler oluşturmanın merkezi bir parçası olarak hizmet eder.

IronPDF'ye Giriş

IronPDF, .NET projelerinizde PDF belgeleri oluşturmanıza, düzenlemenize ve içerik çıkarmanıza olanak tanıyan güçlü bir C# PDF kütüphanesidir. İşte bazı temel özellikler:

1. HTML'den PDF'ye Dönüşüm:

   • HTML, CSS ve JavaScript içeriğini PDF formatına dönüştürün.

   • Piksel mükemmel PDF'ler için Chrome İşleme Motorunu kullanın.

   • URL'ler, HTML dosyaları veya HTML yazı dizilerinden PDF'ler oluşturun.

2. Görüntü ve İçerik Dönüşümü:

   • Görüntüleri PDF'ye ve PDF'den dönüştürün.

   • Mevcut PDF'lerden metin ve görüntüleri çıkarın.

   • Çeşitli görüntü formatları için destek sağlar.

3. Düzenleme ve Manipülasyon:

   • PDF'lerin özelliklerini, güvenliğini ve izinlerini ayarlayın.

   • Dijital imzalar ekleyin.

   • Meta veri ve revizyon geçmişini düzenleyin.

4. Çapraz Platform Desteği:

   • .NET Core (8, 7, 6, 5 ve 3.1+), .NET Standard (2.0+) ve .NET Framework (4.6.2+) ile çalışır.

   • Windows, Linux ve macOS ile uyumludur.

   • Kolay kurulum için NuGet üzerinde mevcuttur.

IronPDF ve Azure.Messaging.ServiceBus Kullanarak Bir PDF Belgesi Oluşturun

Başlamak için, aşağıda gösterildiği gibi Visual Studio kullanarak bir konsol uygulaması oluşturun.

Proje Adı Sağlayın

.NET Sürümü Sağlayın

IronPDF paketini yükleyin.

Azure Portalında Hizmet Veri Yolu Kuyruğu Oluşturma

Hizmet Veri Yolu ad alanınızda bir kuyruk kurmak için şu adımları izleyin:

1. Kuyruklara gidin: Azure portalında Hizmet Veri Yolu Ad Alanı sayfasına gidin. Sol navigasyon menüsünden "Kuyruklar" seçeneğini seçin.
2. Yeni Bir Kuyruk Oluşturun: Kuyruklar sayfasında, araç çubuğundaki "+ Kuyruk" düğmesine tıklayın.

3. Kuyruğu Yapılandırın: Kuyruğunuz için sağlanan alana bir isim girin. Diğer ayarları varsayılan değerlerinde bırakın. Azure Hizmet Veri Yolu kuyruğu oluştururken yapılandırmanız gereken seçenekler:

   1. İsim: Bu, kuyruğunuzun benzersiz tanımlayıcısıdır. Açıklayıcı ve hatırlanması kolay bir isim seçin.

   2. Maksimum Kuyruk Boyutu: Bu, kuyruğun maksimum depolama kapasitesini tanımlar. Bunu 1 GB, 2 GB, 5 GB, 10 GB, 20 GB, 40 GB, 80 GB veya 100 GB olarak ayarlayabilirsiniz. Sizin durumunuzda, 1 GB olarak ayarlanmış.

   3. Maksimum Teslimat Sayısı: Bu, bir mesajın ölü harf kuyruğuna gönderilmeden veya atılmadan önce kaç kez teslim edilebileceğini belirtir. Bu, mesaj işleme hatalarını yönetmeye yardımcı olur.

   4. Mesajın Yaşam Süresi (TTL): Bu, bir mesajın süresi dolmadan önce kuyrukta ne kadar kalacağını belirler. Bunu gün, saat, dakika ve saniye cinsinden ayarlayabilirsiniz. TTL ulaşıldığında, ölü harf mesajları ya atılır ya da ölü harf kuyruğuna taşınır, eğer ölü harf kullanımı etkinleştirilmişse.

   5. Kilit Süresi: Bu, bir mesajın bir alıcı tarafından işlenmesi için kilitli tutulacağı süredir. Bu süre içinde, diğer alıcılar aynı mesajı işleyemez. Bu süreyi gün, saat, dakika ve saniye cinsinden ayarlayabilirsiniz.

   6. Mesaj Süresinin Dolması Üzerine Ölü Harf Kullanımını Etkinleştir: Etkinleştirildiğinde, süresi dolan mesajlar (yani TTL'lerini aşan) atılmak yerine ölü harf kuyruğuna taşınır. Bu, süresi dolan mesajların daha fazla incelenmesini ve yönetilmesini sağlar.

   7. Parçalama Etkinleştir: Bu seçenek, kuyruğun birden fazla mesaj aracısı arasında parçalanmasını sağlar ve bu durum ölçeklenebilirliği ve verimi artırabilir. Parçalama, büyük hacimdeki mesajları yönetmek için yararlıdır.

Bu ayarlar, Azure Hizmet Veri Yolu kuyruğunuzun davranışını ve performansını kontrol etmenize yardımcı olur ve uygulamanızın gereksinimlerini karşılamasını sağlar.

4. Oluşturmayı Tamamla: Kuyruğun oluşturulmasını sonlandırmak için "Oluştur" düğmesine tıklayın. Bu adımlar, Azure portalını kullanarak Hizmet Veri Yolu ad alanınız içinde bir kuyruk oluşturmanızı sağlar.

Azure kuyruğuna bağlantı dizgisini kullanarak bağlanmak için bir Hizmet Veri Yolu istemci kitaplığı olan Azure.Messaging.ServiceBus'ı yükleyin.

Azure.Messaging.ServiceBus kullanarak mesaj gönderip alacak kodu aşağıya ekleyin.

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 Lisanslama

IronPDF paketi çalışmak ve PDF oluşturmak için bir lisans gerektirir. Paket erişilmeden önce, uygulamanın başına aşağıdaki kodu ekleyin.

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

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

Imports IronPdf

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

IronPDF Deneme Lisansı Sayfası üzerinde bir deneme lisansı mevcuttur.

Sonuç

Dijital dönüşüm ve hızlı teknolojik gelişmelerle karakterize edilen bir dönemde, Azure Hizmet Veri Yolu, dünya genelindeki işletmelerin modernizasyon yolculuğunda önemli bir bileşen olarak ortaya çıkıyor. Güvenilir, ölçeklenebilir ve esnek mesajlaşma yetenekleri sağlayarak, geliştiricilere evrimleşen iş gereksinimlerine uyum sağlayabilen dayanıklı ve çevik çözümler oluşturma imkanı tanır.

İster kesintisiz entegrasyonu kolaylaştırıyor, ister olay tabanlı mimarileri etkinleştiriyor veya asenkron iletişimi sağlıyor olsun, Azure Hizmet Veri Yolu, inovasyonu tetikleyici ve dijital girişimleri hızlandırıcı bir rol oynar.

Kuruluşlar, bulut temelli paradigmalara ve dağıtık mimarilere geçmeye devam ettikçe, Azure Hizmet Veri Yolu, Microsoft'un geliştiricileri ve kuruluşları buluta taşıma yolculuklarında güçlendirme taahhüdünün bir kanıtı olarak durmaktadır. IronPDF, PDF oluşturmayı .NET uygulamaları içinde sadeleştirir, profesyonel kalitede belgeleri doğrudan koddan oluşturmak için esneklik ve işlevsellik sunar.