Modelli di progettazione: pubblicazione-sottoscrizione basata su elenchi
L'esempio ListBasedPublishSubscribe illustra il modello Publish-Subscribe basato su elenchi implementato come programma Windows Communication Foundation (WCF).
Nota
La procedura di installazione e le istruzioni di compilazione per questo esempio si trovano alla fine di questo argomento.
Il modello di progettazione per pubblicazione-sottoscrizione basato su elenchi viene descritto nella pubblicazione relativa ai modelli e alle procedure Microsoft nella pagina dei modelli di integrazione. Il modello di pubblicazione-sottoscrizione passa le informazioni a una raccolta di destinatari che hanno sottoscritto un argomento di informazioni. La pubblicazione-sottoscrizione basata su elenchi gestisce un elenco di sottoscrittori. Quando esistono informazioni da condividere, una copia viene inviata a ogni sottoscrittore presente nell'elenco. In questo esempio viene illustrato un modello di pubblicazione-sottoscrizione basato su elenchi dinamici, in cui i client possono effettuare la sottoscrizione o annullare la sottoscrizione ogni volta che lo desiderano.
L'esempio di pubblicazione-sottoscrizione basata su elenchi consiste in un client, un servizio e un programma dell'origine dati. È consentita l'esecuzione di più client e più programmi delle origini dati. I client sottoscrivono il servizio, ricevono le notifiche e annullano la sottoscrizione. I programmi delle origini dati inviano informazioni al servizio da condividere con tutti i sottoscrittori correnti.
In questo esempio il client e l'origine dati sono programmi della console (file con estensione exe) e il servizio è una libreria (con estensione dll) ospitata in Internet Information Services (IIS). Le attività del client e dell'origine dati sono visibili sul desktop.
Il servizio usa la comunicazione duplex. Il contratto di servizio ISampleContract è accoppiato a un contratto di callback ISampleClientCallback. Il servizio implementa operazioni del servizio di sottoscrizione e annullamento della sottoscrizione che consentono ai client di essere aggiunti o rimossi dall'elenco dei sottoscrittori. Il servizio implementa inoltre l'operazione del servizio PublishPriceChange chiamata dal programma dell'origine dati per fornire nuove informazioni al servizio. Il programma client implementa l'operazione del servizio PriceChange chiamata dal servizio per notificare a tutti i sottoscrittori la modifica di un prezzo.
// Create a service contract and define the service operations.
// NOTE: The service operations must be declared explicitly.
[ServiceContract(SessionMode=SessionMode.Required,
CallbackContract=typeof(ISampleClientContract))]
public interface ISampleContract
{
[OperationContract(IsOneWay = false, IsInitiating=true)]
void Subscribe();
[OperationContract(IsOneWay = false, IsTerminating=true)]
void Unsubscribe();
[OperationContract(IsOneWay = true)]
void PublishPriceChange(string item, double price,
double change);
}
public interface ISampleClientContract
{
[OperationContract(IsOneWay = true)]
void PriceChange(string item, double price, double change);
}
Il servizio usa un evento .NET Framework come meccanismo per informare tutti i sottoscrittori dell'esistenza di nuove informazioni. L'aggiunta di un client al servizio tramite una chiamata a Subscribe determina la disponibilità di un gestore eventi. La rimozione di un client dal servizio determina l'annullamento della sottoscrizione del relativo gestore eventi. Quando un'origine dati chiama il servizio per segnalare la modifica di un prezzo, il servizio genera l'evento, che a sua volta chiama ogni istanza del servizio, una per ogni client che ha effettuato la sottoscrizione, e causa l'esecuzione dei relativi gestori eventi. Ogni gestore eventi passa le informazioni al client corrispondente tramite la relativa funzione di callback.
public class PriceChangeEventArgs : EventArgs
{
public string Item;
public double Price;
public double Change;
}
// The Service implementation implements your service contract.
[ServiceBehavior(InstanceContextMode=InstanceContextMode.PerSession)]
public class SampleService : ISampleContract
{
public static event PriceChangeEventHandler PriceChangeEvent;
public delegate void PriceChangeEventHandler(object sender, PriceChangeEventArgs e);
ISampleClientContract callback = null;
PriceChangeEventHandler priceChangeHandler = null;
//Clients call this service operation to subscribe.
//A price change event handler is registered for this client instance.
public void Subscribe()
{
callback = OperationContext.Current.GetCallbackChannel<ISampleClientContract>();
priceChangeHandler = new PriceChangeEventHandler(PriceChangeHandler);
PriceChangeEvent += priceChangeHandler;
}
//Clients call this service operation to unsubscribe.
//The previous price change event handler is unregistered.
public void Unsubscribe()
{
PriceChangeEvent -= priceChangeHandler;
}
//Information source clients call this service operation to report a price change.
//A price change event is raised. The price change event handlers for each subscriber will execute.
public void PublishPriceChange(string item, double price, double change)
{
PriceChangeEventArgs e = new PriceChangeEventArgs();
e.Item = item;
e.Price = price;
e.Change = change;
PriceChangeEvent(this, e);
}
//This event handler runs when a PriceChange event is raised.
//The client's PriceChange service operation is invoked to provide notification about the price change.
public void PriceChangeHandler(object sender, PriceChangeEventArgs e)
{
callback.PriceChange(e.Item, e.Price, e.Change);
}
}
Eseguire l'esempio avviando più client. I client sottoscrivono il servizio. Eseguire quindi il programma dell'origine dati che invia informazioni al servizio. Il servizio passa le informazioni a tutti i sottoscrittori. In ogni console client sono visibili le attività, a conferma dell'avvenuta ricezione delle informazioni. Premere INVIO nella finestra del client per arrestare il client.
Per impostare e compilare l'esempio
Assicurarsi di aver eseguito la Procedura di installazione singola per gli esempi di Windows Communication Foundation.
Per compilare l'edizione in C# o Visual Basic .NET della soluzione, seguire le istruzioni in Building the Windows Communication Foundation Samples.
Per eseguire l'esempio sullo stesso computer
Verificare che sia possibile accedere al servizio usando un browser immettendo l'indirizzo seguente:
http://localhost/servicemodelsamples/service.svc. In risposta, viene visualizzata un pagina di conferma.Eseguire Client.exe da \client\bin\, nella cartella specifica della lingua. L'attività del client viene visualizzata nella finestra della console client. Avviare più client.
Eseguire Datasource.exe da \datasource\bin\ nella cartella specifica del linguaggio. L'attività dell'origine dati viene visualizzata nella finestra della console. Dopo l'invio delle informazioni al servizio da parte dell'origine dati, è necessario che tali informazioni vengano inviate a ogni client.
Se il client, l’origine dati e i programmi del servizio non possono comunicare, vedere Suggerimenti per la risoluzione dei problemi per esempi WCF.
Per eseguire l'esempio tra più computer
Configurare il computer del servizio:
Sul computer del servizio, creare una directory virtuale denominata ServiceModelSamples. Il file batch Setupvroot.bat della procedura di installazione singola per gli esempi di Windows Communication Foundation può essere usato per creare la directory del disco e la directory virtuale.
Copiare i file del programma del servizio da %SystemDrive%\Inetpub\wwwroot\servicemodelsamples alla directory virtuale di ServiceModelSamples sul computer del servizio. Verificare di includere i file nella directory \bin.
Verificare che sia possibile accedere al servizio dal computer client usando un browser.
Configurare i computer client:
Copiare i file del programma client dalla cartella \client\bin\, nella cartella specifica del linguaggio, all'interno dei computer client.
In ogni file di configurazione del client modificare il valore dell'indirizzo della definizione dell'endpoint affinché corrisponda al nuovo indirizzo del servizio. Nell'indirizzo sostituire qualsiasi riferimento a "localhost" con un nome di dominio completo.
Configurare il computer dell'origine dati:
Copiare i file del programma dell'origine dati dalla cartella \datasource\bin\, nella cartella specifica del linguaggio, all'interno del computer dell'origine dati.
Nel file di configurazione dell'origine dati modificare il valore dell'indirizzo della definizione dell'endpoint affinché corrisponda al nuovo indirizzo del servizio. Nell'indirizzo sostituire qualsiasi riferimento a "localhost" con un nome di dominio completo.
Nei computer client avviare Client.exe da un prompt dei comandi.
Nel computer dell'origine dati avviare Datasource.exe da un prompt dei comandi.