Procedure consigliate per un modello di progettazione observer
In .NET, il modello di progettazione osservatore è implementato come un insieme di interfacce. L'interfaccia System.IObservable<T> rappresenta il provider di dati, che è anche responsabile di fornire un'implementazione di IDisposable che consenta agli osservatori di annullare la sottoscrizione di notifiche. L'interfaccia System.IObserver<T> rappresenta l'osservatore. In questo argomento vengono descritte le procedure consigliate che gli sviluppatori devono seguire per implementare il modello di progettazione osservatore usando queste interfacce.
Threading
In genere, un provider implementa il metodo IObservable<T>.Subscribe aggiungendo un osservatore specifico a un elenco di server di sottoscrizione, che è rappresentato da un oggetto di raccolta, e implementa il metodo IDisposable.Dispose rimuovendo un osservatore specifico dall'elenco dei server di sottoscrizione. Un osservatore può chiamare questi metodi in qualsiasi momento. Inoltre, perché il contratto provider/osservatore non specifica chi è responsabile dell'annullamento della sottoscrizione dopo il metodo di callback IObserver<T>.OnCompleted, il provider e l'osservatore possono provare a rimuovere lo stesso membro dall'elenco. Grazie a questa possibilità, entrambi i metodi Subscribe e Dispose dovrebbero essere thread-safe. In genere, ciò comporta l'uso di una raccolta simultanea o di un blocco. Le implementazioni che non sono thread-safe devono documentare esplicitamente che non lo sono.
Tutte le garanzie aggiuntive devono essere specificate in un livello all'inizio del contratto provider/osservatore. Gli implementatori devono indicare chiaramente quando impongono requisiti aggiuntivi per evitare confusione sul contratto di osservatore.
Gestione delle eccezioni
A causa dell'accoppiamento debole tra un provider di dati e un osservatore, le eccezioni nel modello di progettazione osservatore sono esclusivamente informative. Ciò influisce sul modo in cui provider e osservatori gestiscono le eccezioni nel modello di progettazione osservatore.
Provider: Chiamata al metodo OnError
Il metodo OnError è concepito come un messaggio informativo agli osservatori, in modo analogo al metodo IObserver<T>.OnNext. Tuttavia, il metodo OnNext è progettato al fine di fornire a un osservare dati correnti o aggiornati, laddove il metodo OnError è progettato per indicare che il provider non può fornire dati validi.
Il provider dovrebbe seguire queste procedure consigliate durante la gestione delle eccezioni e la chiamata del metodo OnError:
Il provider deve gestire le proprie eccezioni in caso di requisiti specifici.
Il provider non dovrebbe aspettarsi o richiedere che gli osservatori gestiscano le eccezioni in alcun modo particolare.
Il provider dovrà chiamare il metodo OnError quando gestisce un'eccezione che compromette la sua capacità di fornire aggiornamenti. Le informazioni su tali eccezioni possono essere passate all'osservatore. In altri casi, non è necessario notificare un'eccezione agli osservatori.
Quando il provider chiama il metodo OnError o IObserver<T>.OnCompleted, non vi saranno altre notifiche e il provider potrà annullare la sottoscrizione dei relativi osservatori. Questi ultimi, tuttavia, potranno a loro volta annullare una sottoscrizione in qualsiasi momento, sia prima sia dopo aver ricevuto una notifica OnError o IObserver<T>.OnCompleted. Il modello di progettazione dell'osservatore non indica se il provider o l'osservatore è responsabile dell'annullamento della sottoscrizione. Quindi, è possibile che entrambi provino ad annullare la sottoscrizione. In genere, quando gli osservatori annullano l'iscrizione, vengono rimossi da una raccolta di sottoscrittori. In un'applicazione a thread singolo, l'implementazione di IDisposable.Dispose dovrà garantire che un riferimento all'oggetto sia valido e che l'oggetto sia un membro della raccolta di sottoscrittori prima di provare a rimuoverlo. In un'applicazione multithreading, è necessario usare un oggetto di raccolta thread-safe, come ad esempio un oggetto System.Collections.Concurrent.BlockingCollection<T>.
Osservatore: implementazione del metodo OnError
Quando un osservatore riceve una notifica di errore da un provider, l'osservatore deve considerare l'eccezione come informativa e non deve eseguire alcuna operazione particolare.
L'osservatore dovrebbe seguire queste procedure consigliate durante la risposta a gestione delle eccezioni e la chiamata al metodo OnError da un provider:
L'osservatore non deve generare eccezioni dalle implementazioni dell'interfaccia, come ad esempio OnNext o OnError. Tuttavia, se l'osservatore genera eccezioni, deve aspettarsi che queste eccezioni rimangano non gestite.
Per preservare lo stack di chiamate, un osservatore che intenda generare un oggetto Exception che è stato passato al relativo metodo OnError dovrà eseguire il wrapping dell'eccezione prima di generarla. A questo scopo è necessario usare un oggetto eccezione standard.
Procedure consigliate aggiuntive
Un tentativo di annullamento della registrazione nel metodo IObservable<T>.Subscribe può produrre un riferimento null. È quindi consigliabile evitare questa operazione.
Nonostante sia possibile associare un osservatore a più provider, il modello consigliato consiste nell'associare un'istanza di IObserver<T> a una sola istanza di IObservable<T>.
