Progettazione e implementazione di servizi
In questa sezione viene illustrato come definire e implementare contratti WCF. Un contratto di servizio specifica quale endpoint comunica con il mondo esterno. A un livello più concreto, è un'istruzione su un set di messaggi specifici organizzati in modelli di scambio di messaggi di base (MEP, Message Exchange Pattern) quali, ad esempio, request/reply, unidirezionale e duplex. Se un contratto di servizio è un set logicamente correlato di scambi di messaggi, un'operazione di servizio è un singolo scambio di messaggi. Un'operazione Hello deve, ad esempio, accettare un messaggio (quindi il chiamante può annunciare il saluto) e può o non può restituire un messaggio (a seconda del livello di cortesia dell'operazione).
Per ulteriori informazioni su contratti e altri concetti Windows Communication Foundation (WCF) di base, vedere Concetti fondamentali di Windows Communication Foundation. Questo argomento si incentra sulla comprensione dei contratti di servizio. Per ulteriori informazioni su come creare client che utilizzano contratti di servizio per connettersi ai servizi, vedere Panoramica dei client WCF.
Panoramica
In questo argomento viene fornito un orientamento concettuale di alto livello alla progettazione e all'implementazione di servizi WCF. Negli argomenti correlati vengono fornite informazioni più dettagliate sulle specifiche di progettazione e implementazione. Prima di progettare e implementare l'applicazione WCF, è consigliabile:
Comprendere cosa siano i contratti di servizio, come funzionino e come sia possibile crearne uno.
Comprendere che i contratti prevedono requisiti minimi che la configurazione di runtime o l'ambiente host potrebbe non supportare.
Contratti di servizio
In un contratto di servizio viene specificato quanto segue:
Le operazioni esposte nel contratto.
La firma delle operazioni in termini di messaggi scambiati.
Tipi di dati di questi messaggi.
Posizione delle operazioni.
Protocolli e formati di serializzazione specifici utilizzati per supportare la corretta comunicazione con il servizio.
Un contratto di ordine di acquisto può, ad esempio, includere un'operazione CreateOrder che accetta un input di tipi di informazioni sull'ordine e restituisce informazioni sull'esito positivo o negativo, incluso un identificatore di ordine. Può inoltre includere un'operazione GetOrderStatus che accetta un identificatore di ordine e restituisce informazioni sullo stato dell'ordine. Un contratto di servizio di questo tipo specificherebbe:
Che il contratto di ordine di acquisto è costituito da operazioni
CreateOrdereGetOrderStatus.Che le operazioni hanno specificato messaggi di input e di output.
I dati che questi messaggi possono contenere.
Istruzioni categoriali sull'infrastruttura di comunicazione necessaria per elaborare correttamente i messaggi. Questi dettagli includono, ad esempio, indicazioni sulla necessità della protezione, e sui tipi di sicurezza eventualmente necessari, per stabilire una corretta comunicazione.
Per comunicare questo tipo di informazioni ad altre applicazioni su numerose piattaforme (incluse piattaforme non Microsoft), i contratti di servizio XML vengono pubblicamente espressi in formati XML standard tra cui, ad esempio, il Web Services Description Language (WSDL) e lo XML Schema (XSD). Gli sviluppatori operanti su molte piattaforme possono utilizzare queste informazioni pubbliche sui contratti per creare applicazioni che possano comunicare con il servizio, perché comprendono il linguaggio della specifica e perché tali linguaggi sono progettati per consentire l'interoperabilità descrivendo i tipi, i formati e i protocolli pubblici supportati dal servizio. Per ulteriori informazioni su come WCF gestisce questo tipo di informazioni, vedere Metadata.
I contratti possono essere espressi in molti modi e, sebbene WSDL e XSD siano eccellenti per descrivere i servizi in modo accessibile, sono linguaggi difficili da utilizzare direttamente e costituiscono semplici descrizioni di un servizio, non implementazioni del contratto di servizio. Pertanto, le applicazioni WCF utilizzano interfacce, classi e attributi gestiti sia per definire la struttura di un servizio sia per implementarlo.
Il contratto risultante definito nei tipi gestiti può essere esportato come metadata, WSDL e XSD, quando richiesto da client o altri implementatori del servizio. Il risultato è un modello di programmazione semplice, che può essere descritto (utilizzando metadati pubblici) per qualsiasi applicazione client. I dettagli dei messaggi SOAP sottostanti, le informazioni sul trasporto e sulla sicurezza e così via possono essere gestiti da WCF, che esegue automaticamente le conversioni necessarie tra il sistema dei tipi di contratto di servizio e il sistema dei tipi XML.
Per ulteriori informazioni sulla progettazione di contratti, vedere Progettazione dei contratti di servizio. Per ulteriori informazioni sull'implementazione di contratti, vedere Implementazione dei contratti di servizio.
Orientamento ai messaggi
L'utilizzo di interfacce, classi e metodi gestiti per modellare le operazioni di servizio è piuttosto semplice se si utilizzano abitualmente firme dei metodi in stile RPC (Remote Procedure Call), in cui il passaggio di parametri in un metodo e la restituzione di valori costituiscono la forma standard per richiedere la funzionalità di un oggetto o di un altro tipo di codice. I programmatori che, ad esempio, utilizzano linguaggi gestiti come Visual Basic e C++ COM possono applicare le proprie conoscenze sull'approccio in stile RPC (utilizzando oggetti o interfacce) alla creazione di contratti di servizio WCF senza incorrere in problemi inerenti ai sistemi con oggetti distribuiti in stile RPC. L'orientamento ai servizi offre il vantaggio di una programmazione orientata ai messaggi, ad accoppiamento debole, mantenendo comunque la semplicità della programmazione RPC.
Molti programmatori preferiscono utilizzare interfacce di programmazione di applicazioni orientate ai messaggi, ad esempio le code di messaggi come Microsoft MSMQ, gli spazi dei nomi System.Messaging di .NET Framework o l'invio di XML non strutturato nelle richieste HTTP, solo per citarne alcune. Per ulteriori informazioni sulla programmazione a livello di messaggi, vedere Utilizzo dei contratti di messaggio, Programmazione client a livello di canale e Interoperabilità con applicazioni POX.
Informazioni sulla gerarchia di requisiti
Un contratto di servizio raggruppa le operazioni, specifica il modello di scambio dei messaggi, i tipi di messaggio e i tipi di dati contenuti nei messaggi e indica le categorie di comportamento runtime che un'implementazione deve avere per supportare il contratto (se, ad esempio, è necessario che i messaggi siano crittografati e firmati). Il contratto di servizio stesso non specifica con precisione in che modo vengono soddisfatti questi requisiti, ma solo che devono essere soddisfatti. Il tipo di crittografia e la modalità di firma di un messaggio dipendono dall'implementazione e dalla configurazione di un servizio conforme.
Si noti il modo in cui il contratto richiede certe caratteristiche dell'implementazione del contratto di servizio e della configurazione di runtime per l'aggiunta di un comportamento. Il set dei requisiti che devono essere soddisfatti per esporre un servizio affinché possa essere utilizzato si basa sul set di requisiti precedente. Se un contratto prevede requisiti per l'implementazione, un'implementazione può richiedere ancora più caratteristiche di configurazione e associazioni che consentono l'esecuzione del servizio. Infine, anche l'applicazione host deve supportare tutti i requisiti aggiunti dalla configurazione e dalle associazioni del servizio.
Questo processo relativo ai requisiti aggiuntivi è importante da tener presente quando si progetta, implementa, configura e ospita un'applicazione del servizio Windows Communication Foundation (WCF). Il contratto può, ad esempio, specificare che deve essere supportata una sessione. In questo caso sarà quindi necessario configurare le associazioni per supportare il requisito contrattuale o l'implementazione del servizio non funzionerà. Se il servizio richiede invece l'autenticazione integrata di Windows ed è ospitato in Internet Information Services (IIS), nell'applicazione Web in cui risiede il servizio deve essere attivata l'autenticazione integrata di Windows e disattivato il supporto di utenti anonimi. Per ulteriori informazioni sulle funzionalità e l'impatto dei diversi tipi di applicazioni host dei srevizi, vedere Servizi host.
Vedere anche
Concetti
Progettazione dei contratti di servizio
Implementazione dei contratti di servizio