Novità in Windows Communication Foundation 4.5
In questo argomento, vengono descritte le nuove funzionalità di Windows Communication Foundation (WCF) versione 4.5.
gRPC come alternativa a WCF
gRPC è un framework RPC moderno che rappresenta un'alternativa comune a WCF. gRPC è basato su HTTP/2, che offre numerosi vantaggi rispetto a WCF, tra cui:
- Prestazioni: gRPC è molto più efficiente di WCF, soprattutto per le connessioni a esecuzione prolungata.
- Scalabilità: gRPC è progettato per adattarsi a un numero elevato di client e server.
- Sicurezza: gRPC supporta un'ampia gamma di meccanismi di sicurezza, tra cui TLS e autenticazione.
- Multipiattaforma: gRPC è indipendente dalla piattaforma e può essere usato con un'ampia gamma di linguaggi di programmazione.
Per altre informazioni sullo sviluppo o la migrazione di app WCF a gRPC, vedere:
- Perché gRPC è consigliato per gli sviluppatori WCF
- Confronto tra WCF e gRPC
- Introduzione a gRPC per sviluppatori WCF
Funzionalità di semplificazione WCF
È stato svolto molto lavoro per rendere più semplici lo sviluppo e la gestione delle applicazioni WCF 4.5. Per altre informazioni, vedere Funzionalità di semplificazione WCF.
Supporto asincrono basato su attività
Per impostazione predefinita, Aggiungi riferimento al servizio genera metodi di operazioni del servizio asincrono come risultato di attività. Questa operazione viene eseguita per i metodi sincroni e asincroni. Consente di chiamare le operazioni del servizio in modo asincrono utilizzando il nuovo modello di programmazione asincrono basato su attività. Quando si chiama il metodo proxy generato, WCF costruisce un oggetto attività per rappresentare un'operazione asincrona e restituisce l'attività all'utente. L'attività viene completata al termine dell'operazione. Quando si implementa un'operazione asincrona, è possibile implementarla come operazione asincrona basata su attività. Per altre informazioni, vedere Operazioni sincrone e asincrone.
File di configurazione generati semplificati
Quando si aggiunge un riferimento al servizio in Visual Studio o si utilizza lo strumento SvcUtil.exe, viene generato un file di configurazione client. Nelle versioni precedenti di WCF, questi file di configurazione contenevano il valore di ogni proprietà di associazione anche se il relativo valore è quello predefinito. In WCF 4.5 i file di configurazione generati contengono soltanto le proprietà di associazione che sono impostate su un valore non predefinito.
Per altre informazioni, vedere Funzionalità di semplificazione WCF.
Sviluppo con priorità al contratto ("contract-first")
WCF supporta ora lo sviluppo con priorità al contratto ("contract-first"). Lo strumento svcutil.exe dispone di un'opzione /serviceContract che consente di generare contratti di servizio e dati da un documento WSDL.
Aggiungere un riferimento al servizio da un progetto di subset portabili
I progetti di subset portabili consentono ai programmatori di assembly .NET di gestire un unico albero di origine e di compilare il sistema supportando allo stesso tempo più piattaforme .NET (desktop, Silverlight, Windows Phone e Xbox). I progetti subset portabili fanno riferimento solo a librerie portabili .NET che sono assembly che possono essere usati in qualsiasi piattaforma .NET. L'esperienza dello sviluppatore equivale all'aggiunta di un riferimento al servizio all'interno di qualsiasi altra applicazione client WCF. Per altre informazioni, vedere Aggiungi un riferimento al servizio in un progetto di subset portabili.
Modifica dell'impostazione predefinita della modalità di compatibilità ASP.NET
WCF fornisce la modalità di compatibilità ASP.NET per garantire agli sviluppatori l'accesso completo alle funzionalità nella pipeline HTTP ASP.NET in caso di scrittura di servizi WCF. Per utilizzare questa modalità, è necessario impostare l'attributo aspNetCompatibilityEnabled
su True nella sezione <serviceHostingEnvironment> di web.config. Inoltre, la proprietà RequirementsMode
dell'oggetto AspNetCompatibilityRequirementsAttribute di qualsiasi servizio in questo appDomain deve essere impostata sul campo Allowed o Required. Per impostazione predefinita, l'oggetto AspNetCompatibilityRequirementsAttribute è ora impostato sul campo Allowed. Per altre informazioni, vedere Servizi WCF e ASP.NET.
Nuovi valori predefiniti di trasporto
Per semplificare la configurazione, sono stati modificati alcuni valori predefiniti della proprietà di trasporto. Per altre informazioni, vedere Funzionalità di semplificazione WCF.
XmlDictionaryReaderQuotas
L'oggetto XmlDictionaryReaderQuotas contiene i valori di quota configurabili per lettori di dizionari XML che limitano la quantità di memoria utilizzata da un codificatore durante la creazione di un messaggio. Anche se queste quote sono configurabili, i valori predefiniti sono stati modificati per ridurre la possibilità che uno sviluppatore debba impostarle in modo esplicito. Per altre informazioni, vedere Funzionalità di semplificazione WCF.
Convalida della configurazione WCF
Il processo di compilazione in Visual Studio include ora la convalida dei file di configurazione WCF per gli attributi definiti all'interno del progetto. Se la convalida non riesce, in Visual Studio viene visualizzato un elenco di errori o avvisi di convalida.
Descrizioni comandi dell'editor XML
Per consentire agli sviluppatori di servizi WCF nuovi ed esistenti di configurare i propri servizi, l'editor XML di Visual Studio offre ora le descrizioni comandi per ogni elemento di configurazione e le relative proprietà che fanno parte del file di configurazione del servizio.
Miglioramenti del flusso
Aggiunta del supporto di un vero flusso asincrono in cui il lato di invio ora non blocca i thread se il lato di ricezione non sta leggendo o è lento nell'eseguire questa operazione, causando quindi l'aumento della scalabilità. Eliminazione della limitazione del buffering dei messaggi quando un client invia un messaggio trasmesso a un servizio WCF ospitato da IIS. Per altre informazioni, vedere Funzionalità di semplificazione WCF.
Semplificazione dell'esposizione di un endpoint tramite HTTPS con IIS
È stato aggiunto un mapping del protocollo HTTPS per semplificare l'esposizione di un endpoint tramite HTTPS. Per abilitare un endpoint HTTPS, assicurarsi che il sito Web disponga di un'associazione HTTPS e di un certificato SSL configurato e, successivamente, abilitare HTTPS per la directory virtuale che ospita il servizio. Se i metadati sono abilitati per il servizio, verranno esposti anche tramite HTTPS.
Generazione di un singolo documento WSDL
Alcuni stack di elaborazione WSDL di terze parti non sono in grado di elaborare i documenti WSDL con dipendenze da altri documenti tramite un elemento xsd:import. WCF ora consente di specificare che tutte le informazioni WSDL vengano restituite in un singolo documento. Per richiedere un singolo documento WSDL, aggiungere "?singleWSDL" all'URI quando si richiedono i metadati del servizio.
Supporto di WebSocket
WebSockets è una tecnologia che fornisce la vera comunicazione bidirezionale per le porte 80 e 443 con caratteristiche di prestazioni simili a TCP. Sono state aggiunte due nuove associazioni per supportare la comunicazione tramite un trasporto WebSocket, NetHttpBinding e NetHttpsBinding. Per altre informazioni, vedere Associazioni fornite dal sistema.
Nuovi valori predefiniti di trasporto
Nella tabella seguente vengono descritte le impostazioni che sono state modificate e dove reperire informazioni aggiuntive.
Proprietà | Attivato | Nuova impostazione predefinita | Per altre informazioni, vedere |
---|---|---|---|
channelInitializationTimeout | NetTcpBinding | 30 secondi | ChannelInitializationTimeout |
listenBacklog | NetTcpBinding | 12 * il numero di processori | ListenBacklog |
maxPendingAccepts | ConnectionOrientedTransportBindingElement SMSvcHost.exe |
2 * il numero di processori per trasporto 4 * il numero di processori per SMSvcHost.exe |
MaxPendingAcceptsConfigurazione del servizio di condivisione delle porte Net.TCP |
maxPendingConnections | ConnectionOrientedTransportBindingElement | 12 * il numero di processori | MaxPendingConnections |
receiveTimeout | SMSvcHost.exe | 30 secondi | Configurazione del servizio di condivisione delle porte Net.TCP |
Configurazione dei servizi WCF nel codice
Windows Communication Foundation (WCF) consente agli sviluppatori di configurare i servizi utilizzando file di configurazione o codice. I file di configurazione sono utili quando è necessario configurare un servizio dopo la relativa distribuzione. Quando si utilizzano i file di configurazione, un professionista IT deve solo aggiornare il file di configurazione. Non è necessario eseguire la ricompilazione. I file di configurazione, tuttavia, possono risultare complessi e difficili da gestire. Non è disponibile alcun supporto per il debug dei file di configurazione e, poiché il riferimento agli elementi di configurazione viene fatto in base ai nomi, i file di configurazione della creazione possono risultare difficili e soggetti a errori. WCF consente inoltre di configurare i servizi nel codice. Nelle versioni precedenti di WCF (4.0 e versioni precedenti), la configurazione dei servizi nel codice era semplice negli scenari indipendenti. La classe ServiceHost consentiva di configurare endpoint e comportamenti prima di chiamare ServiceHost.Open. Negli scenari ospitati dal Web, tuttavia, non è possibile accedere alla classe ServiceHost. Per configurare un servizio ospitato dal Web era necessario creare un oggetto System.ServiceModel.ServiceHostFactory
che creava l'oggetto ServiceHostFactory ed effettuava qualsiasi configurazione richiesta. A partire da .NET Framework 4.5, WCF fornisce un modo più semplice per configurare sia i servizi indipendenti sia quelli ospitati dal Web nel codice. Per altre informazioni, vedere Configurazioni dei servizi WCF nel codice.
Memorizzazione nella cache di ChannelFactory
Le applicazioni client WCF utilizzano la classe ChannelFactory<TChannel> per creare un canale di comunicazione con un servizio WCF. La creazione di istanze dell'oggetto ChannelFactory<TChannel> comporta un sovraccarico perché include le seguenti operazioni:
Costruzione dell'albero ContractDescription
Reflection di tutti i tipi CLR obbligatori
Costruzione dello stack dei canali
Eliminazione di risorse
Per ridurre il sovraccarico, WCF può memorizzare le channel factory nella cache quando si utilizza un proxy client WCF. Per altre informazioni, vedere Channel factory e memorizzazione nella cache.
Compressione e codificatore binario
A partire da WCF 4.5, il codificatore binario WCF aggiunge il supporto per la compressione. Il tipo di compressione è configurato con la proprietà CompressionFormat. Sia il client sia il servizio devono configurare la proprietà CompressionFormat. La compressione verrà utilizzata per i protocolli HTTP, HTTPS e TCP. Se un client specifica di utilizzare la compressione, ma il servizio non la supporta, viene generata un'eccezione di protocollo che indica una mancata corrispondenza di protocollo. Per altre informazioni, vedere Scelta di un codificatore di messaggi.
UDP
È stato aggiunto il supporto per un trasporto UDP, pertanto gli sviluppatori possono scrivere i servizi che utilizzano la messaggistica "fire and forget". Un client invia un messaggio a un servizio e non prevede alcuna risposta dal servizio.
Supporto di più autenticazioni
Come in IIS, è stato aggiunto il supporto di più modalità di autenticazione in un singolo endpoint WCF quando si utilizza il trasporto HTTP e la relativa sicurezza. IIS consente di abilitare più modalità di autenticazione in una directory virtuale. Questa funzionalità permette a un singolo endpoint WCF di supportare più modalità di autenticazione abilitate per la directory virtuale in cui è ospitato il servizio WCF.
Supporto IDN
È stato aggiunto il supporto di servizi WCF con gli IDN (Internationalized Domain Name). Per altre informazioni, vedere WCF e nomi IDN.
HttpClient
È stata aggiunta una nuova classe denominata HttpClient per semplificare l'utilizzo delle richieste HTTP. Per altre informazioni, vedere HttpClient e Linee guida per l'uso di HttpClient.
Configurazione di IntelliSense
I valori degli attributi nei file di configurazione per gli attributi personalizzati definiti nel progetto supportano ora IntelliSense per facilitare l'utilizzo delle configurazioni in modo rapido e preciso.
Descrizioni comandi di configurazione
Gli elementi e gli attributi di WCF dispongono ora di descrizioni comandi nell'editor XML per individuare più facilmente e accuratamente lo scopo dell'elemento o dell'attributo.
Incollare i dati come classi
In un progetto WCF i tipi di dati definiti in XML (ad esempio quelli esposti in un servizio) possono essere incollati direttamente in una tabella codici. Il tipo XML verrà incollato come tipo CLR. Per altri dettagli, vedere Generazione di classi di tipo dati da XML.
WebServiceHost ed endpoint predefiniti
In Visual Studio 2010 WebServiceHost ha creato automaticamente un endpoint predefinito, indipendentemente dall'eventuale specificazione esplicita di un endpoint. In Visual Studio 2012 e versioni succesive, WebServiceHost crea un endpoint predefinito solo se non vengono aggiunti endpoint in modo esplicito. Se il client prevede l'endpoint predefinito, è possibile aggiungere un endpoint in modo esplicito e puntare il client sull'endpoint. In alternativa, è possibile tornare al comportamento precedente di WCF aggiungendo la seguente impostazione al file di configurazione dell'applicazione
<appSettings>
<add key="wcf:webservicehost:enableautomaticendpointscompatability" value="true"/>
</appSettings>
IHttpCookieContainerManager
Questa interfaccia, esposta da IChannelFactory<TChannel>, rende l'utilizzo dei cookie sul lato client molto più semplice. Quando AllowCookies è impostato su true nell'associazione, è possibile accedere ai cookie utilizzando il codice seguente:
IHttpCookieContainerManager cookieManager = factory.GetProperty<IHttpCookieContainerManager>();
System.Net.CookieContainer container = cookieManager.CookieContainer;
È quindi possibile recuperare o impostare i cookie da CookieContainer. Quando AllowCookies è impostato su false, è possibile recuperare i cookie manualmente mediante OperationContext e inviarli in altre richieste utilizzando un altro controllo messaggi o OperationContext. L'interfaccia IHttpCookieContainerManager consente di autenticare un utente per un servizio e utilizzare il cookie di autenticazione restituito dal servizio per eseguire l'autenticazione per altri servizi.