Specifica e gestione di errori in contratti e servizi

Le applicazioni Windows Communication Foundation (WCF) gestiscono le situazioni di errore eseguendo il mapping di oggetti eccezione gestiti a oggetti errore SOAP e di oggetti errore SOAP a oggetti eccezione gestiti. Negli argomenti di questa sezione viene illustrato come progettare contratti per esporre condizioni di errore come errori SOAP personalizzati, come restituire tali errori come parte dell'implementazione del servizio e come tali errori vengono rilevati dai client.

Panoramica sulla gestione degli errori

Tutte le applicazioni gestite prevedono che gli errori di elaborazione siano rappresentati dagli oggetti Exception. Nelle applicazioni basate su SOAP, quali le applicazioni WCF, le informazioni sugli errori di elaborazione vengono comunicate dai metodi del servizio tramite messaggi di errore SOAP. Gli errori SOAP sono tipi di messaggio inclusi nei metadati per un'operazione del servizio e pertanto creano un contratto di errore che i client possono utilizzare per rendere il proprio funzionamento più affidabile o interattivo. Inoltre, poiché gli errori SOAP vengono espressi ai client in formato XML, si tratta di un sistema di tipo altamente interoperabile utilizzabile dai client su qualsiasi piattaforma, aumentando la portata dell'applicazione WCF.

Poiché le applicazioni WCF possono essere eseguite con entrambi i tipi di sistemi di gestione degli errori, tutte le informazioni sulle eccezioni gestite inviate al client devono essere convertite da eccezioni in errori SOAP sul servizio, inviate e convertite da errori SOAP in eccezioni di errore nei client WCF. Nel caso di client duplex, i contratti client possono anche restituire errori SOAP a un servizio. In entrambi i casi, è possibile utilizzare i comportamenti predefiniti delle eccezioni di servizio. In alternativa, è possibile stabilire in modo esplicito se convertire le eccezioni in messaggi di errore e, in tal caso, definire le modalità di conversione.

I tipi di errori SOAP che è possibile inviare sono due: dichiarati e non dichiarati. Gli errori SOAP dichiarati sono quelli in cui un'operazione presenta un attributo System.ServiceModel.FaultContractAttribute che specifica un tipo di errore SOAP personalizzato. Gli errori SOAP non dichiarati sono quelli che non vengono specificati nel contratto per un'operazione.

È consigliabile che le operazioni del servizio dichiarino gli errori utilizzando l'attributo FaultContractAttribute per specificare formalmente tutti gli errori SOAP che un client può aspettarsi di ricevere durante il normale funzionamento di un'operazione. Per ridurre al minimo la divulgazione delle informazioni è inoltre consigliabile restituire negli errori SOAP solo le informazioni che il client deve conoscere.

In genere, i servizi (e i client duplex) prevedono i passaggi seguenti per integrare correttamente la gestione degli errori nelle applicazioni:

• Eseguire il mapping delle condizioni di eccezione a errori SOAP personalizzati.

• I client e i servizi inviano e ricevono errori SOAP come eccezioni.

Inoltre, client e servizi WCF possono utilizzare errori SOAP non dichiarati a scopo di debug e possono estendere il comportamento predefinito degli errori. Nelle sezioni seguenti vengono esaminati questi concetti e attività.

Eseguire il mapping delle eccezioni a errori SOAP

Il primo passaggio per creare un'operazione che gestisca condizioni di errore consiste nel decidere a quali condizioni un'applicazione client deve essere informata degli errori. Alcune operazioni hanno condizioni di errore specifiche per la propria funzionalità. Ad esempio, un'operazione PurchaseOrder potrebbe restituire informazioni specifiche a clienti a cui non è più consentito avviare un ordine d'acquisto. In altri casi, quali, ad esempio, un servizio Calculator, un errore SOAP MathFault più generale potrebbe essere in grado di descrivere tutte le condizioni di errore di un intero servizio. Dopo avere identificato tutte le condizioni di errore dei client del servizio, è possibile costruire un errore SOAP personalizzato e contrassegnare l'operazione come restituzione dell'errore SOAP quando si verifica la condizione di errore corrispondente.

Per ulteriori informazioni su su questo passaggio relativo allo sviluppo del servizio o del client, vedere Definizione e specifica degli errori.

Gestione degli errori SOAP come eccezioni da parte di client e servizi

I primi passaggi per una corretta gestione degli errori nelle applicazioni WCF consistono nell'identificare le condizioni di errore delle operazioni, definire errori SOAP personalizzati e contrassegnare le operazioni perché restituiscano gli errori in questione. Il passaggio successivo è invece rappresentato dall'implementazione di invio e ricezione degli errori. In genere, i servizi inviano errori per informare le applicazioni client delle condizioni di errore, ma anche i client duplex possono inviare errori SOAP ai servizi.

Per ulteriori informazioni, vedere Invio e ricezione degli errori.

Errori SOAP non dichiarati e debug

Gli errori SOAP dichiarati sono estremamente utili per la generazione di solide applicazioni distribuite e interoperabili. Tuttavia, in alcuni casi, è utile per un servizio (o un client duplex) inviare un errore SOAP non dichiarato, uno di quegli errori non menzionati nel codice WSDL (Web Services Description Language) dell'operazione. Ad esempio, quando si sviluppa un servizio, possono verificarsi situazioni impreviste in cui è utile, a scopo di debug, reinviare informazioni al client. Inoltre, è possibile impostare la proprietà System.ServiceModel.ServiceBehaviorAttribute.IncludeExceptionDetailInFaults o System.ServiceModel.Description.ServiceDebugBehavior.IncludeExceptionDetailInFaults su true, per consentire ai client WCF di ottenere informazioni sulle eccezioni delle operazioni interne del servizio. Sia l'invio di singoli errori che l'impostazione delle proprietà del comportamento di debug vengono descritti in Invio e ricezione degli errori.

Nota:

Poiché le eccezioni gestite possono esporre informazioni interne dell'applicazione, se si imposta la proprietà System.ServiceModel.ServiceBehaviorAttribute.IncludeExceptionDetailInFaults o la proprietà System.ServiceModel.Description.ServiceDebugBehavior.IncludeExceptionDetailInFaults su true i client WCF possono ottenere informazioni sulle eccezioni delle operazioni interne del servizio, che possono contenere informazioni personali o comunque riservate. Di conseguenza, l'impostazione della proprietà System.ServiceModel.ServiceBehaviorAttribute.IncludeExceptionDetailInFaults o System.ServiceModel.Description.ServiceDebugBehavior.IncludeExceptionDetailInFaults su true è consigliabile solo come modalità temporanea di debug di un'applicazione del servizio. Inoltre, il codice WSDL di un metodo che restituisce in questo modo eccezioni gestite senza tuttavia gestirle non contiene il contratto dell'eccezione FaultException di tipo ExceptionDetail. Per ottenere correttamente le informazioni di debug, i client devono prevedere la possibilità di ricevere un errore SOAP sconosciuto, restituito ai client WCF come oggetti System.ServiceModel.FaultException.

Personalizzazione della gestione degli errori con IErrorHandler

Se si ha l'esigenza di personalizzare il messaggio di risposta al client, quando si verifica un'eccezione a livello di applicazione, o di effettuare alcune operazioni di elaborazione personalizzate dopo la restituzione del messaggio di risposta, implementare l'interfaccia System.ServiceModel.Dispatcher.IErrorHandler.

Problemi di serializzazione

Durante la deserializzazione di un contratto di errore, in WCF viene innanzitutto effettuato il tentativo di far corrispondere il nome del contratto di errore nel messaggio SOAP con il tipo di contratto di errore. Se non si trova una corrispondenza esatta, verrà effettuata una ricerca, in ordine alfabetico, di un tipo compatibile nell'elenco di contratti di errore disponibile. Se due contratti di errore sono tipi compatibili (ad esempio uno è una sottoclasse dell'altro), per deserializzare l'errore potrebbe essere utilizzato il tipo non corretto. Tale situazione si verifica solo se nel contratto di errore non vengono specificati un nome, uno spazio dei nomi e un'azione. Per evitare il verificarsi di tale errore, specificare sempre completamente i contratti di errore indicando il nome, lo spazio dei nomi e gli attributi dell'azione. Inoltre, se è stato definito un numero di contratti di errore correlati derivati da una classe base condivisa, assicurarsi di contrassegnare qualsiasi membro nuovo con [DataMember(IsRequired=true)]. Per ulteriori informazioni su questo attributo IsRequired, vedere DataMemberAttribute. In questo modo si potrà evitare che la classe base sia di tipo compatibile e si consentirà la deserializzazione dell'errore nel tipo derivato corretto.

Vedere anche

Riferimento

FaultException
FaultContractAttribute
FaultException
XmlSerializer
XmlSerializerFormatAttribute
FaultContractAttribute
CommunicationException
Action
Code
Reason
SubCode
IsOneWay

Concetti

Definizione e specifica degli errori