Accesso a un servizio OData (WCF Data Services)

WCF Data Services supporta OData (Open Data Protocol) per esporre dati come feed con le risorse indirizzabili tramite URI. Queste risorse sono rappresentate in base alle convenzioni entità-relazione di Entity Data Model. In questo modello le entità rappresentano unità operative di dati che corrispondono a tipi di dati in un dominio di applicazione, ad esempio clienti, ordini, elementi e prodotti. L'accesso ai dati di entità e la relativa modifica sono possibili mediante la semantica REST (Representational State Transfer), in particolare i verbi standard HTTP GET, PUT, POST e DELETE.

Indirizzamento delle risorse

In OData i dati esposti vengono indirizzati dal modello di dati tramite un URI. L'URI seguente restituisce ad esempio un feed, ovvero il set di entità Customers, che contiene le voci per tutte le istanze del tipo di entità Customer:

http://services.odata.org/Northwind/Northwind.svc/Customers

Le entità presentano proprietà speciali denominate chiavi di entità. Una chiave di entità viene utilizzata per identificare in modo univoco una singola entità in un set di entità. In questo modo è possibile indirizzare un'istanza specifica di un tipo di entità nel set di entità. L'URI seguente restituisce ad esempio una voce per un'istanza specifica del tipo di entità Customer che presenta un valore chiave corrispondente ad ALFKI:

http://services.odata.org/Northwind/Northwind.svc/Customers('ALFKI')

Le proprietà primitive e complesse di un'istanza di entità possono anche essere indirizzate singolarmente. L'URI seguente restituisce ad esempio un elemento XML che contiene il valore della proprietà ContactName per un cliente (Customer) specifico:

http://services.odata.org/Northwind/Northwind.svc/Customers('ALFKI')/ContactName

Se si include l'endpoint $value nell'URI precedente, nel messaggio di risposta viene restituito solo il valore della proprietà primitiva. Nell'esempio seguente viene restituita solo la stringa "Maria Anders" senza l'elemento XML:

http://services.odata.org/Northwind/Northwind.svc/Customers('ALFKI')/ContactName/$value

Le relazioni tra entità vengono definite mediante associazioni nel modello di dati. Queste associazioni consentono di indirizzare entità correlate utilizzando le proprietà di navigazione di un'istanza di entità. Una proprietà di navigazione può restituire una sola entità correlata, nel caso di una relazione molti-a-uno, o un set di entità correlate, nel caso di una relazione uno-a-molti. L'URI seguente restituisce ad esempio un feed che corrisponde al set di tutte le entità Order correlate a un cliente specifico:

http://services.odata.org/Northwind/Northwind.svc/Customers('ALFKI')/Orders

Le relazioni, che in genere sono bidirezionali, sono rappresentate da una coppia di proprietà di navigazione. Al contrario della relazione mostrata nell'esempio precedente, l'URI seguente restituisce un riferimento all'entità Customer alla quale appartiene un'entità Order specifica:

http://services.odata.org/Northwind/Northwind.svc/Orders(10643)/Customer

OData consente inoltre di indirizzare le risorse in base ai risultati di espressioni di query. In questo modo è possibile filtrare i set di risorse in base a un'espressione valutata. L'URI seguente filtra ad esempio le risorse per restituire solo gli ordini per il cliente specificato, inviati dal 22 settembre 1997:

http://services.odata.org/Northwind/Northwind.svc/Customers('ALFKI')/Orders?$filter=ShippedDate gt datetime'1997-09-22T00:00:00'

Per ulteriori informazioni, vedere OData: Convenzioni URI.

Opzioni query del sistema

In OData viene definito un set di opzioni query del sistema che consentono di eseguire sulle risorse operazioni di query tradizionali quali filtro, ordinamento e paging. L'URI seguente restituisce ad esempio il set di tutte le entità Order insieme alle entità Order_Detail correlate, in cui i codici di avviamento postale non terminano con 100.

http://services.odata.org/Northwind/Northwind.svc/Orders?$filter=not endswith(ShipPostalCode,'100')&$expand=Order_Details&$orderby=ShipCity

Le voci del feed restituito vengono inoltre ordinate in base al valore della proprietà ShipCity degli ordini.

WCF Data Services supporta le opzioni query del sistema OData seguenti:

Indirizzamento delle relazioni

Oltre all'indirizzamento di set e istanze di entità, OData consente di indirizzare le associazioni che rappresentano le relazioni tra le entità. Questa funzionalità è necessaria per creare o modificare una relazione tra due istanze di entità, ad esempio lo spedizioniere correlato a un determinato ordine nel database Northwind di esempio. OData supporta l'operatore $link che consente di indirizzare in modo specifico le associazioni tra entità. L'URI seguente viene ad esempio specificato in un messaggio di richiesta PUT HTTP per sostituire lo spedizioniere dell'ordine specificato con un nuovo spedizioniere.

http://services.odata.org/Northwind/Northwind.svc/Orders(10643)/$links/Shipper

Per ulteriori informazioni, vedere OData: Indirizzamento di collegamenti tra voci.

Utilizzo del feed restituito

L'URI di una risorsa OData consente di indirizzare i dati di entità esposti dal servizio. Quando si immette un URI nel campo dell'indirizzo di un browser, viene restituita una rappresentazione del feed OData della risorsa richiesta. Per ulteriori informazioni, vedere la Guida rapida di WCF Data Services. Sebbene l'utilizzo di un browser possa risultare utile per verificare che una risorsa del servizio dati restituisca i dati previsti, l'accesso ai servizi dati di produzione che sono inoltre in grado di creare, aggiornare ed eliminare dati viene in genere eseguito tramite linguaggi di codice delle applicazioni o di script in una pagina Web. Per ulteriori informazioni, vedere Utilizzo di un servizio OData in un'applicazione client (WCF Data Services).

Vedere anche

Altre risorse

Sito Web Open Data Protocol