Specifica di un indirizzo endpoint

Tutta la comunicazione con un servizio Windows Communication Foundation (WCF) si verifica tramite i relativi endpoint. Ogni ServiceEndpoint contiene una proprietà Address, una proprietà Binding e una proprietà Contract. Il contratto specifica quali operazioni sono disponibili. L'associazione specifica come comunicare con il servizio e l'indirizzo specifica dove trovare il servizio. Ogni endpoint deve avere un indirizzo univoco. L'indirizzo dell'endpoint è rappresentato dalla classe EndpointAddress, che contiene un URI (Uniform Resource Identifier), che rappresenta l'indirizzo del servizio, una proprietà Identity, che rappresenta l'identità di protezione del servizio, e un insieme di proprietà Headers facoltative. Le intestazioni facoltative forniscono informazioni di indirizzamento più dettagliate, per identificare o interagire con l'endpoint. Ad esempio, le intestazioni possono indicare come elaborare un messaggio in ingresso, dove l'endpoint deve inviare un messaggio di risposta o quale istanza di un servizio utilizzare per elaborare un messaggio in ingresso di un particolare utente, quando sono disponibili più istanze.

Definizione di un indirizzo endpoint

In WCF, una classe EndpointAddress modella un riferimento endpoint (EPR), come definito nello standard WS-Addressing.

L'indirizzo URI per la maggior parte dei trasporti è costituito da quattro parti. Ad esempio, l'URI "http://www.fabrikam.com:322/mathservice.svc/secureEndpoint" è costituito dalle quattro parti seguenti:

• Schema: http:
• Computer: www.fabrikam.com
• (facoltativo) Porta: 322
• Percorso: /mathservice.svc/secureEndpoint

Il modello di riferimento endpoint prevede che ogni riferimento possa includere alcuni parametri di riferimento che aggiungono ulteriori informazioni di identificazione. In WCF, questi parametri di riferimento vengono modellati come istanze della classe AddressHeader.

L'indirizzo endpoint per un servizio può essere specificato in modo imperativo mediante l'utilizzo di codice oppure in modo dichiarativo mediante la configurazione. In genere definire endpoint nel codice non è pratico in quanto le associazioni e gli indirizzi di un servizio distribuito sono solitamente diversi da quelli utilizzati durante lo sviluppo del servizio. In genere è più pratico definire endpoint di servizio mediante la configurazione piuttosto che mediante codice. Se le informazioni sull'associazione e sull'indirizzo non vengono incluse nel codice, tali dati possono essere modificati senza dover compilare e distribuire nuovamente l'applicazione.

Esistono due modo per specificare gli indirizzi degli endpoint per un servizio in WCF. È possibile specificare un indirizzo assoluto per ogni endpoint associato al servizio o fornire un indirizzo di base per la classe ServiceHost di un servizio e quindi specificare un indirizzo per ogni endpoint associato a questo servizio, che viene definito come relativo all'indirizzo di base. È possibile utilizzare entrambe le procedure per specificare gli indirizzi degli endpoint per un servizio nella configurazione o nel codice. Se non si specifica un indirizzo relativo, il servizio utilizza l'indirizzo di base. È inoltre possibile avere più indirizzi di base per un servizio, ma per ogni servizio è consentito un solo indirizzo di base per ogni trasporto. Se sono presenti più endpoint, ognuno dei quali è configurato con un'associazione diversa, i relativi indirizzi devono essere univoci. Gli endpoint che utilizzano la stessa associazione ma contratti diversi possono utilizzare lo stesso indirizzo.

Quando si ospita il servizio in IIS, non si gestisce l'istanza di ServiceHost. Nel caso di un servizio ospitato in IIS, l'indirizzo di base è sempre l'indirizzo specificato nel file con estensione svc. Per gli endpoint del servizio ospitato in IIS è quindi necessario utilizzare sempre indirizzi relativi. Fornire un indirizzo endpoint completo può provocare errori nella fase di distribuzione del servizio. Per ulteriori informazioni, vedere Distribuzione di un servizio WCF ospitato in Internet Information Services (IIS).

Definizione degli indirizzi endpoint nella configurazione

Per definire un endpoint in un file di configurazione, utilizzare l'elemento <endpoint>.

Quando viene chiamato il metodo Open, quando cioè l'applicazione host tenta di avviare il servizio, il sistema ricerca un elemento <service> con un attributo name che specifica "UE.Samples.HelloWorld". Se l'elemento <service> viene trovato, il sistema carica la classe specificata e crea gli endpoint utilizzando le definizioni degli endpoint presenti nel file di configurazione. Questo meccanismo consente di caricare e avviare un servizio con due righe di codice, mentre tiene le informazioni sull'associazione e l'indirizzamento fuori dal codice. Il vantaggio di tale approccio è che queste modifiche possono essere apportate senza dover ricompilare o ridistribuire l'applicazione.

Le intestazioni facoltative vengono dichiarate in un <headers> element. Di seguito è riportato un esempio degli elementi utilizzati per specificare gli endpoint di un servizio in un file di configurazione in cui vengono distinte due intestazioni: client "Gold" all'indirizzo http://tempuri1.org/ e client "Standard" all'indirizzo http://tempuri2.org/. Il client che chiama questo servizio deve l'<headers> element appropriato nel file di configurazione.

Le intestazioni possono essere impostate anche su singoli messaggi anziché su tutti i messaggi su un endpoint (come illustrato in precedenza). A tale scopo, utilizzare OperationContextScope per creare un nuovo contesto in un'applicazione client, per aggiungere un'intestazione personalizzata al messaggio in uscita, come illustrato nell'esempio seguente.

Indirizzo endpoint nei metadati

Un indirizzo endpoint viene rappresentato in WSDL (Web Services Description Language) come elemento EndpointReference (EPR) WS-Addressing all'interno dell'elemento wsdl:port dell'endpoint corrispondente. L'EPR contiene l'indirizzo dell'endpoint e qualsiasi proprietà dell'indirizzo. Si noti che l'EPR in wsdl:port sostituisce soap:Address, come illustrato nell'esempio seguente.

Definizione degli indirizzi endpoint nel codice

È possibile creare un indirizzo endpoint nel codice con la classe EndpointAddress. L'URI specificato per l'indirizzo endpoint può essere un percorso completo o un percorso relativo all'indirizzo di base del servizio. Nel codice seguente viene illustrato come creare un'istanza della classe EndpointAddress e aggiungerla all'istanza di ServiceHost che ospita il servizio.

Nell'esempio seguente viene illustrato come specificare l'indirizzo endpoint completo nel codice.

Nell'esempio seguente viene illustrato come aggiungere un indirizzo relativo ("MyService") all'indirizzo di base dell'host del servizio.

Vedere anche

Riferimenti

EndpointAddress

Concetti

Identità del servizio e autenticazione
Cenni preliminari sulla creazione di endpoint

Altre risorse

Hosting