SignalR Nedir ve Neden Kullanılır?
Modern web uygulamalarında kullanıcılar artık sayfayı yenilemeden anlık güncellemeler almayı bekliyor. Bir chat uygulamasında mesajların anında görünmesi, bir dashboard'da verilerin canlı olarak güncellenmesi veya bir e-ticaret sitesinde stok durumunun gerçek zamanlı değişmesi gibi senaryolar günümüzün vazgeçilmez gereksinimleri arasında yer alıyor. İşte tam bu noktada Microsoft'un geliştirdiği SignalR kütüphanesi devreye giriyor.
SignalR, ASP.NET Core ekosisteminin bir parçası olarak sunucu ile istemci arasında gerçek zamanlı, çift yönlü iletişim kurmayı kolaylaştıran açık kaynaklı bir kütüphanedir. SignalR, arka planda en uygun taşıma protokolünü otomatik olarak seçer. Öncelikle WebSocket kullanmayı dener; desteklenmiyorsa Server-Sent Events veya Long Polling gibi alternatif yöntemlere geçiş yapar. Bu sayede geliştiriciler taşıma katmanı detaylarıyla uğraşmak zorunda kalmaz.
SignalR'ın Temel Mimarisi
SignalR'ın mimarisini anlamak, etkili gerçek zamanlı uygulamalar geliştirmenin temel taşıdır. Bu mimari birkaç ana bileşenden oluşur ve her biri belirli bir sorumluluğu üstlenir.
Hub Kavramı
Hub, SignalR'ın merkezinde yer alan ve sunucu ile istemci arasındaki iletişimi yöneten ana bileşendir. Hub sınıfları, istemcilerin çağırabileceği sunucu metotlarını ve sunucunun istemcilere gönderebileceği mesajları tanımlar. Bir Hub sınıfı oluşturmak için Microsoft.AspNetCore.SignalR.Hub sınıfından türetme yapmanız yeterlidir.
Hub içerisinde tanımlanan her public metot, istemciler tarafından doğrudan çağrılabilir. Örneğin bir chat uygulamasında SendMessage metodu tanımladığınızda, JavaScript istemcisi bu metodu invoke ederek sunucuya mesaj gönderebilir. Sunucu da Clients özelliği üzerinden bağlı istemcilere mesaj iletebilir.
Taşıma Protokolleri
SignalR üç farklı taşıma protokolünü destekler ve bağlantı kurulurken en uygun olanını otomatik olarak seçer:
- WebSocket: En performanslı seçenektir. Tam çift yönlü iletişim sağlar ve tek bir TCP bağlantısı üzerinden çalışır. Modern tarayıcıların büyük çoğunluğu WebSocket'i destekler.
- Server-Sent Events (SSE): Sunucudan istemciye tek yönlü veri akışı sağlar. WebSocket desteklenmediğinde ikinci tercih olarak kullanılır.
- Long Polling: En eski ve en az verimli yöntemdir. İstemci sürekli olarak sunucuya istek gönderir ve sunucu yeni veri olduğunda yanıt döner. Diğer yöntemler kullanılamadığında son çare olarak devreye girer.
Bağlantı Yönetimi
SignalR her istemci bağlantısını benzersiz bir ConnectionId ile tanımlar. Bu kimlik sayesinde belirli bir istemciye özel mesaj göndermek mümkün olur. Ayrıca bağlantı yaşam döngüsü olayları olan OnConnectedAsync ve OnDisconnectedAsync metotları sayesinde kullanıcı bağlantı ve kopma durumlarını yönetebilirsiniz.
SignalR Projesini Yapılandırma
Bir SignalR projesi kurmak oldukça basittir. ASP.NET Core projenizde birkaç adımda gerçek zamanlı iletişim altyapısını hazırlayabilirsiniz. İlk olarak Program.cs dosyasında SignalR servislerini kaydetmeniz ve hub endpoint'ini tanımlamanız gerekir.
Servis kaydı için builder.Services.AddSignalR() çağrısını yapmanız yeterlidir. Ardından app.MapHub yöntemiyle hub'ınızı belirli bir URL yoluna bağlarsınız. Örneğin /chatHub gibi bir yol tanımlayarak istemcilerin bu adrese bağlanmasını sağlayabilirsiniz.
İstemci tarafında ise @microsoft/signalr npm paketini yükleyerek veya CDN üzerinden SignalR JavaScript kütüphanesini ekleyerek bağlantı kurabilirsiniz. HubConnectionBuilder sınıfı ile bağlantı nesnesi oluşturulur ve start metodu ile bağlantı başlatılır.
Grup Yönetimi ve Hedefli Mesajlaşma
SignalR'ın en güçlü özelliklerinden biri grup yönetimi mekanizmasıdır. Gruplar sayesinde bağlı istemcileri mantıksal birimlere ayırabilir ve belirli gruplara özel mesajlar gönderebilirsiniz. Bu özellik özellikle chat odaları, proje bazlı bildirimler veya departman bazlı güncellemeler gibi senaryolarda kritik öneme sahiptir.
Bir istemciyi gruba eklemek için Groups.AddToGroupAsync metodunu, gruptan çıkarmak için Groups.RemoveFromGroupAsync metodunu kullanırsınız. Gruba mesaj göndermek için ise Clients.Group("grupAdı") ifadesini kullanarak hedefli iletişim kurabilirsiniz.
Mesaj Gönderim Yöntemleri
SignalR farklı hedeflere mesaj göndermenizi sağlayan çeşitli yöntemler sunar:
- Clients.All: Bağlı tüm istemcilere mesaj gönderir.
- Clients.Caller: Yalnızca metodu çağıran istemciye mesaj gönderir.
- Clients.Others: Çağıran istemci hariç diğer tüm istemcilere mesaj gönderir.
- Clients.Client(connectionId): Belirli bir bağlantı kimliğine sahip istemciye mesaj gönderir.
- Clients.Group(groupName): Belirli bir gruptaki tüm istemcilere mesaj gönderir.
- Clients.User(userId): Belirli bir kullanıcı kimliğine sahip tüm bağlantılara mesaj gönderir.
Gerçek Zamanlı Chat Uygulaması Geliştirme
SignalR'ın en yaygın kullanım alanlarından biri gerçek zamanlı chat uygulamalarıdır. Bir chat hub'ı oluşturarak kullanıcıların anlık mesajlaşmasını, odalara katılmasını ve çevrimiçi durumlarını takip etmesini sağlayabilirsiniz.
Chat hub'ında genellikle SendMessage, JoinRoom ve LeaveRoom gibi temel metotlar bulunur. SendMessage metodu gelen mesajı ilgili gruba veya tüm kullanıcılara iletir. JoinRoom metodu kullanıcıyı belirtilen odaya ekler ve diğer kullanıcılara katılım bildirimini gönderir. LeaveRoom ise bunun tersini gerçekleştirir.
İstemci tarafında mesaj dinlemek için connection.on metodu kullanılır. Sunucudan gelen ReceiveMessage olayını dinleyerek mesajları arayüzde görüntüleyebilirsiniz. Mesaj göndermek için ise connection.invoke ile sunucudaki SendMessage metodunu çağırırsınız.
Canlı Bildirim Sistemi Oluşturma
Gerçek zamanlı bildirimler modern web uygulamalarının vazgeçilmez bir parçasıdır. SignalR ile kullanıcılara anlık bildirimler göndermek oldukça kolaydır. Bir NotificationHub oluşturarak sistem genelinde veya kullanıcıya özel bildirimleri gerçek zamanlı olarak iletebilirsiniz.
Bildirim sistemi genellikle sunucu tarafında bir servis aracılığıyla çalışır. IHubContext arayüzü sayesinde hub dışından, yani controller'lardan veya background servislerden de istemcilere mesaj gönderebilirsiniz. Bu yaklaşım özellikle bir sipariş oluşturulduğunda, bir görev tamamlandığında veya bir sistem uyarısı tetiklendiğinde bildirim göndermek için idealdir.
Bildirim Türleri ve Yönetimi
Etkili bir bildirim sistemi farklı bildirim türlerini desteklemelidir:
- Bilgi bildirimleri: Kullanıcıyı bir durum hakkında bilgilendiren genel mesajlar.
- Uyarı bildirimleri: Dikkat edilmesi gereken durumları belirten mesajlar.
- Başarı bildirimleri: Bir işlemin başarıyla tamamlandığını bildiren mesajlar.
- Hata bildirimleri: Bir sorun oluştuğunda kullanıcıyı uyaran mesajlar.
Her bildirim türü için farklı bir görsel sunum ve ses efekti kullanarak kullanıcı deneyimini zenginleştirebilirsiniz.
Ölçeklendirme ve Performans Optimizasyonu
Üretim ortamında SignalR uygulamalarını ölçeklendirmek önemli bir konudur. Tek sunucu senaryosunda SignalR sorunsuz çalışır ancak birden fazla sunucu kullanıldığında bir backplane mekanizmasına ihtiyaç duyulur. Redis, Azure SignalR Service veya SQL Server backplane seçenekleri arasında en yaygın kullanılanıdır.
Redis Backplane
Redis backplane, birden fazla SignalR sunucusu arasında mesaj senkronizasyonu sağlar. Bir sunucuya gönderilen mesaj Redis üzerinden diğer sunuculara da iletilir ve böylece tüm bağlı istemciler mesajı alır. Bu yapılandırma için Microsoft.AspNetCore.SignalR.StackExchangeRedis paketini yüklemeniz ve AddStackExchangeRedis çağrısıyla Redis bağlantı dizesini belirtmeniz yeterlidir.
Azure SignalR Service
Azure SignalR Service, SignalR uygulamalarını bulut ortamında yönetmenin en kolay yoludur. Bağlantı yönetimi, ölçeklendirme ve yük dengeleme gibi karmaşık konuları Azure'a devrederek uygulamanızın iş mantığına odaklanabilirsiniz. Bu servis binlerce eş zamanlı bağlantıyı destekler ve otomatik ölçeklendirme sağlar.
Performans İpuçları
SignalR uygulamalarında performansı artırmak için dikkat edilmesi gereken noktalar şunlardır:
- MessagePack protokolünü kullanarak mesaj boyutunu küçültün ve serileştirme hızını artırın.
- Gereksiz yere Clients.All kullanmak yerine hedefli mesajlaşma tercih edin.
- Büyük veri setleri için streaming hub metotlarını kullanın.
- Bağlantı havuzu boyutunu uygulamanızın ihtiyaçlarına göre yapılandırın.
- İstemci tarafında otomatik yeniden bağlanma stratejisi uygulayın.
Güvenlik ve Kimlik Doğrulama
SignalR uygulamalarında güvenlik kritik bir konudur. Hub metotlarına Authorize attribute'u ekleyerek yalnızca kimliği doğrulanmış kullanıcıların erişimini sağlayabilirsiniz. JWT token tabanlı kimlik doğrulama, SignalR ile en yaygın kullanılan yöntemdir.
WebSocket bağlantılarında token, genellikle sorgu dizesi parametresi olarak gönderilir çünkü WebSocket protokolü özel başlık eklemeyi desteklemez. Bu nedenle sunucu tarafında token'ı sorgu dizesinden alacak şekilde yapılandırma yapmanız gerekir.
SignalR uygulamalarında güvenlik katmanını asla göz ardı etmeyin. CORS politikalarını doğru yapılandırın, hub metotlarına yetkilendirme kuralları ekleyin ve hassas verileri şifreli kanallar üzerinden gönderin.
Hata Yönetimi ve Dayanıklılık
Gerçek zamanlı uygulamalarda bağlantı kopmaları kaçınılmazdır. Ağ sorunları, sunucu yeniden başlatmaları veya istemci tarafındaki hatalar bağlantının kopmasına neden olabilir. SignalR bu durumlar için otomatik yeniden bağlanma mekanizması sunar.
withAutomaticReconnect metodu ile istemci bağlantısının kopması durumunda belirli aralıklarla yeniden bağlanma denemeleri yapılmasını sağlayabilirsiniz. Varsayılan olarak 0, 2, 10 ve 30 saniyelik aralıklarla dört deneme yapılır ancak bu değerleri özelleştirebilirsiniz.
Sunucu tarafında ise bağlantı durumu değişikliklerini OnConnectedAsync ve OnDisconnectedAsync metotlarıyla takip edebilir, gerekli temizlik işlemlerini gerçekleştirebilirsiniz. Kullanıcı çevrimdışı olduğunda bekleyen mesajları veritabanına kaydetmek ve kullanıcı tekrar bağlandığında iletmek iyi bir uygulama örneğidir.
Sonuç ve En İyi Uygulamalar
SignalR, .NET ekosisteminde gerçek zamanlı uygulama geliştirmenin en etkili ve kapsamlı yoludur. Hub tabanlı mimarisi sayesinde sunucu ve istemci arasındaki iletişimi basit metot çağrılarına indirger. Chat uygulamalarından canlı dashboard'lara, bildirim sistemlerinden oyun sunucularına kadar geniş bir yelpazede kullanılabilir.
Başarılı bir SignalR uygulaması geliştirmek için hub metotlarını küçük ve odaklı tutun, grup yapısını iyi planlayın, güvenlik katmanını ihmal etmeyin ve üretim ortamı için ölçeklendirme stratejinizi önceden belirleyin. Bu temel prensipleri takip ederek yüksek performanslı ve güvenilir gerçek zamanlı uygulamalar oluşturabilirsiniz.
