Leggere in inglese

Condividi tramite


Estensione dell'hosting tramite ServiceHostFactory

L'API ServiceHost standard per i servizi di hosting in Windows Communication Foundation (WCF) è un punto di estendibilità nell'architettura WCF. Gli utenti possono derivare proprie classi host da ServiceHost, in genere per eseguire l'override di OnOpening, per utilizzare ServiceDescription al fine di aggiungere endpoint predefiniti in modo imperativo o modificare comportamenti, prima di aprire il servizio.

Nell'ambiente di self-hosting, non è necessario creare una classe ServiceHost personalizzata, perché si scrive il codice che crea un'istanza dell'host e quindi si chiama Open sull'host dopo averne creato l'istanza. Tra questi due passaggi è possibile eseguire tutte le operazioni che si desidera. È ad esempio possibile aggiungere una nuova classe IServiceBehavior:

public static void Main()
{
   ServiceHost host = new ServiceHost( typeof( MyService ) );
   host.Description.Add( new MyServiceBehavior() );
   host.Open();
   
   ...
}

Questo approccio non è riutilizzabile. Il codice che modifica la descrizione è inserito nel programma host, in questo caso, la funzione Main(), ed è quindi difficile riutilizzare la logica in questione in altri contesti. Esistono altri modi di aggiungere una classe IServiceBehavior che non richiedono codice imperativo. È possibile derivare un attributo da ServiceBehaviorAttribute e inserirlo sul tipo di implementazione del servizio o è possibile rendere configurabile un comportamento personalizzato e comporlo dinamicamente utilizzando la configurazione.

Tuttavia, per risolvere il problema, è possibile utilizzare anche una leggera variazione dell'esempio. Un approccio consiste nello spostare il codice che aggiunge ServiceBehavior fuori da Main() e inserirlo nel metodo OnOpening di un derivato personalizzato di ServiceHost:

public class DerivedHost : ServiceHost
{
   public DerivedHost( Type t, params Uri baseAddresses ) :
      base( t, baseAddresses ) {}
      
   public override void OnOpening()
   {
  this.Description.Add( new MyServiceBehavior() );
   }
}

All'interno di Main() è quindi possibile utilizzare:

public static void Main()
{
   ServiceHost host = new DerivedHost( typeof( MyService ) );
   host.Open();
   
   ...
}

Ora è stata incapsulata la logica personalizzata in un'astrazione pulita, facilmente riutilizzabile su molti eseguibili host diversi.

Non è immediatamente ovvio come utilizzare questa classe ServiceHost personalizzata da Internet Information Services (IIS) o dal servizio di attivazione dei processi di Windows (WAS). Questi ambienti sono diversi dall'ambiente di self-hosting, perché l'ambiente host è quello che crea l'istanza di ServiceHost per conto dell'applicazione. L'infrastruttura di hosting di IIS e WAS non conosce assolutamente il derivato ServiceHost personalizzato.

La classe ServiceHostFactory è stata progettata per risolvere questo problema di accesso alla classe ServiceHost personalizzata da IIS o WAS. Poiché un host personalizzato derivato da ServiceHost viene configurato dinamicamente ed è potenzialmente di vario tipo, l'ambiente host non ne crea mai un'istanza in modo diretto. Invece, WCF utilizza un modello di factory per fornire un livello di riferimento indiretto tra l'ambiente host e il tipo concreto del servizio. Se non diversamente detto, utilizza un'implementazione predefinita di ServiceHostFactory che restituisce un'istanza di ServiceHost. È però possibile fornire anche una propria factory che restituisca l'host derivato specificando il nome del tipo CLR dell'implementazione della factory nella direttiva @ServiceHost.

Nei casi di base, l'implementazione di una propria factory dovrebbe essere un esercizio semplice. Di seguito è ad esempio riportata una classe ServiceHostFactory personalizzata che restituisce una classe ServiceHost derivata:

public class DerivedFactory : ServiceHostFactory
{
   public override ServiceHost CreateServiceHost( Type t, Uri[] baseAddresses )
   {
      return new DerivedHost( t, baseAddresses )
   }
}

Per utilizzare questa factory al posto di quella predefinita, fornire il nome del tipo nella direttiva @ServiceHost, come illustrato di seguito:

<% @ServiceHost Factory=”DerivedFactory” Service=”MyService” %>

Sebbene non ci siano limiti tecnici a ciò che è possibile fare alla classe ServiceHost restituita da CreateServiceHost, è consigliabile mantenere l'implementazione della factory quanto più semplice è possibile. Se si utilizza un'elevata quantità di logica personalizzata, è preferibile inserire tale logica all'interno dell'host invece che all'interno della factory, in modo che possa essere riutilizzata.

Esiste un ulteriore livello dell'API di hosting che dovrebbe essere qui citato. WCF dispone anche di ServiceHostBase e ServiceHostFactoryBase, da cui derivano rispettivamente ServiceHost e ServiceHostFactory. Queste classi sono destinate a scenari più avanzati, in cui è necessario scambiare ampie parti del sistema dei metadati con proprie creazioni personalizzate.