Il motore Pub/Sub che alimenta Redis ServerEvents e Redis MQ è stato estratto e incapsulato in una classe riutilizzabile che può essere utilizzata indipendentemente per la gestione dei messaggi pubblicati su specifici canali Redis Pub/Sub.
RedisPubSubServer
elabora i messaggi in un thread in background gestito che si riconnette automaticamente quando la connessione al server redis non riesce e funziona come un servizio in background indipendente che può essere interrotto e avviato a comando.
L'API pubblica viene acquisita nell'interfaccia IRedisPubSubServer:
public interface IRedisPubSubServer : IDisposable
{
IRedisClientsManager ClientsManager { get; }
// What Channels it's subscribed to
string[] Channels { get; }
// Run once on initial StartUp
Action OnInit { get; set; }
// Called each time a new Connection is Started
Action OnStart { get; set; }
// Invoked when Connection is broken or Stopped
Action OnStop { get; set; }
// Invoked after Dispose()
Action OnDispose { get; set; }
// Fired when each message is received
Action<string, string> OnMessage { get; set; }
// Fired after successfully subscribing to the specified channels
Action<string> OnUnSubscribe { get; set; }
// Called when an exception occurs
Action<Exception> OnError { get; set; }
// Called before attempting to Failover to a new redis master
Action<IRedisPubSubServer> OnFailover { get; set; }
int? KeepAliveRetryAfterMs { get; set; }
// The Current Time for RedisServer
DateTime CurrentServerTime { get; }
// Current Status: Starting, Started, Stopping, Stopped, Disposed
string GetStatus();
// Different life-cycle stats
string GetStatsDescription();
// Subscribe to specified Channels and listening for new messages
IRedisPubSubServer Start();
// Close active Connection and stop running background thread
void Stop();
// Stop than Start
void Restart();
}
Utilizzo #
Per utilizzare RedisPubSubServer
, inizializzalo con i canali a cui vuoi iscriverti e assegna gestori per ciascuno degli eventi che vuoi gestire. Come minimo vorrai gestire OnMessage
:
var clientsManager = new PooledRedisClientManager();
var redisPubSub = new RedisPubSubServer(clientsManager, "channel-1", "channel-2") {
OnMessage = (channel, msg) => "Received '{0}' from '{1}'".Print(msg, channel)
}.Start();
Chiamando Start()
dopo l'inizializzazione, inizierà ad ascoltare ed elaborare tutti i messaggi pubblicati sui canali a cui si è iscritti.