Procedura: scegliere tra richieste HTTP POST e HTTP GET per gli endpoint ASP.NET AJAX

Articolo
02/27/2011

Windows Communication Foundation (WCF) consente di creare un servizio che espone un endpoint ASP.NET compatibile con AJAX che può essere chiamato da JavaScript su un sito Web client. La procedura di base per generare tali servizi viene illustrata in Procedura: aggiungere un endpoint ASP.NET AJAX con l'utilizzo della configurazione e Procedura: aggiungere un endpoint ASP.NET AJAX senza utilizzare la configurazione.

ASP.NET AJAX supporta operazioni che utilizzano verbi HTTP POST e HTTP GET, con HTTP POST come impostazione predefinita. Quando si crea un'operazione che non ha effetti collaterali e restituisce dati che non vengono mai modificati o vengono modificati solo di rado, utilizzare HTTP GET. I risultati delle operazioni GET possono essere memorizzati nella cache, il che significa che più chiamate alla stessa operazione possono produrre una sola richiesta al servizio. La memorizzazione nella cache non viene eseguita da WCF ma può verificarsi a qualsiasi livello, ad esempio nel browser di un utente o in un server proxy. La memorizzazione nella cache è vantaggiosa se si desidera migliorare le prestazioni del servizio, ma potrebbe non essere accettabile se i dati vengono modificati di frequente o se l'operazione esegue azioni.

Ad esempio, se si sta progettando un servizio per gestire il catalogo musicale di un utente, un'operazione che ricerca l'artista in base al titolo di un album trae vantaggio dall'utilizzo di GET, ma un'operazione che aggiunge un album alla raccolta personale dell'utente deve utilizzare POST.

Per controllare la durata della cache, utilizzare il tipo OutgoingWebResponseContext. Ad esempio, quando si progetta un servizio che restituisce previsioni meteorologiche aggiornate ogni ora, si utilizzerà GET limitando però la durata della cache a massimo un'ora, per impedire agli utenti del servizio di accedere a dati non aggiornati.

Quando si utilizzano servizi da una pagina ASP.NET AJAX che utilizzano il controllo Script Manager, non c'è alcuna differenza se l'operazione utilizza GET o POST, il meccanismo di gestione degli script assicura che venga emesso il tipo di richiesta corretto.

Le operazioni HTTP GET utilizzano qualsiasi parametro di input supportato dalle operazioni POST, inclusi i tipi di contratto dati complessi. Tuttavia, nella maggior parte dei casi è consigliabile evitare di utilizzare troppi parametri o parametri troppo complessi nelle operazioni GET, per non ridurre l'efficienza della memorizzazione nella cache.

In questo argomento viene illustrato come scegliere tra GET e POST aggiungendo gli attributi WebGetAttribute o WebInvokeAttribute alle operazioni pertinenti nel contratto di servizio. Gli altri passaggi (per implementare, configurare e ospitare il servizio), necessari per rendere operativo il servizio sono simili a quelli utilizzati da qualsiasi servizio ASP.NET AJAX in WCF.

Un'operazione contrassegnata da WebGetAttribute utilizza sempre una richiesta GET. Un'operazione contrassegnata da WebInvokeAttribute o non contrassegnata da nessuno dei due attributi, utilizza una richiesta POST. WebInvokeAttribute consente di utilizzare altri verbi HTTP, diversi da GET e POST, quali PUT, DELETE e così via, tramite la proprietà Method. Tuttavia, questi verbi non sono supportati da ASP.NET AJAX. Se si intende utilizzare il servizio da pagine ASP.NET che utilizzano il controllo Script Manager, non utilizzare la proprietà Method.

Per un esempio pratico di passaggio a GET, vedere Servizio AJAX di base.

Per un esempio in cui viene utilizzato POST, vedere Servizio AJAX con il protocollo HTTP POST.

Per creare un servizio WCF che risponde a richieste HTTP GET o HTTP POST

Definire un contratto di servizio WCF di base con un'interfaccia contrassegnata con l'attributo ServiceContractAttribute. Contrassegnare ogni operazione con OperationContractAttribute. Aggiungere l'attributo WebGetAttribute per stabilire che un'operazione deve rispondere a richieste HTTP GET. È inoltre possibile aggiungere l'attributo WebInvokeAttribute per specificare esplicitamente HTTP POST o non specificare alcun attributo e scegliere quindi HTTP POST per impostazione predefinita.

[ServiceContract]
public interface IMusicService
{
    //This operation uses a GET method.
    [OperationContract]
    [WebGet]
    string LookUpArtist(string album);

    //This operation will use a POST method.
    [OperationContract]
    [WebInvoke]
    void AddAlbum(string user, string album);

    //This operation will use POST method by default
    //since nothing else is explicitly specified.
    [OperationContract]
    string[] GetAlbums(string user);

    //Other operations omitted…

}

Implementare il contratto di servizio IMusicService con MusicService.

public class MusicService : IMusicService
{
    public void AddAlbum(string user, string album)
    {
        //Add implementation here.
    }

     //Other operations omitted…
}

Creare un nuovo file denominato "file del servizio" con estensione svc nell'applicazione. Modificare questo file aggiungendo le informazioni della direttiva @ServiceHost appropriate per il servizio. Specificare che è necessario utilizzare WebScriptServiceHostFactory nella direttiva @ServiceHost per configurare automaticamente un endpoint ASP.NET AJAX.
```
<%@ServiceHost 
    language=c# 
    Debug="true" 
    Service="Microsoft.Ajax.Samples.MusicService"
    Factory=System.ServiceModel.Activation.WebScriptServiceHostFactory
%>
```

Per chiamare il servizio

È possibile testare le operazioni GET del servizio senza alcun codice client, utilizzando il browser. Ad esempio, se il servizio è configurato all'indirizzo "http://example.com/service.svc", digitando "http://example.com/service.svc/LookUpArtist?album=SomeAlbum" nella barra degli indirizzi del browser si richiama il servizio e si provoca il download o la visualizzazione della risposta.
È possibile utilizzare servizi con operazioni GET esattamente come qualsiasi altro servizio ASP.NET AJAX, immettendo l'URL del servizio nella raccolta degli script del controllo Script Manager ASP.NET AJAX. Per un esempio, vedere Servizio AJAX di base.

Condividi tramite

Procedura: scegliere tra richieste HTTP POST e HTTP GET per gli endpoint ASP.NET AJAX

Per creare un servizio WCF che risponde a richieste HTTP GET o HTTP POST

Per chiamare il servizio

Vedere anche

Attività

Concetti

Risorse aggiuntive