データ サービス リソースへのアクセス (WCF Data Services)

WCF Data Services は、URI でアドレス指定できるリソースを使用し、データをフィードとして公開する Open Data Protocol (OData) をサポートしています。 これらのリソースは、Entity Data Model のエンティティとリレーションシップの規則に従って表現されます。 このモデルでは、エンティティはアプリケーション ドメイン内のデータの操作単位 (データ型) を表します (顧客、注文、項目、製品など)。 エンティティ データは、Representational State Transfer (REST) のセマンティクス (特に、標準的な HTTP 動詞である GET、PUT、POST、および DELETE) を使用してアクセスおよび変更できます。

リソースのアドレス指定

OData では、データ モデルによって公開されたデータを、URI を使用してアドレス指定します。 たとえば、次の URI は Customers エンティティ セットであるフィードを返します。このフィードには、Customer エンティティ型のすべてのインスタンスのエントリが含まれています。

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

エンティティには、エンティティ キーという特別なプロパティがあります。 エンティティ キーは、エンティティ セット内の 1 つのエンティティを一意に識別するために使用されます。 そのため、エンティティ セット内のエンティティ型の特定のインスタンスのアドレスを指定できます。 たとえば、次の URI は、ALFKI のキー値のある Customer エンティティ型の特定のインスタンスのエントリを返します。

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

エンティティ インスタンスのプリミティブ プロパティおよび複合プロパティは、個別にアドレス指定することもできます。 たとえば、次の URI は特定の Customer の ContactName プロパティ値が含まれた XML 要素を返します。

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

前の URI に $value エンドポイントを含めた場合、応答メッセージにはプリミティブ プロパティの値のみが返されます。 次の例では、XML 要素のない "Maria Anders" という文字列のみが返されます。

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

エンティティ間のリレーションシップは、アソシエーションによってデータ モデル内で定義されます。 これらのアソシエーションによって、エンティティ インスタンスのナビゲーション プロパティを使用して関連エンティティをアドレス指定することが可能になります。 ナビゲーション プロパティは、単一の関連エンティティ (多対一のリレーションシップの場合) または関連エンティティのセット (一対多のリレーションシップの場合) のいずれかを返します。 たとえば、次の URI は、特定の Customer に関連付けられたすべての Orders のセットであるフィードを返します。

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

リレーションシップは通常は双方向であり、ナビゲーション プロパティのペアで表されます。 前の例で示したリレーションシップとは逆に、次の URI は特定の Order エンティティが属する Customer エンティティへの参照を返します。

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

OData では、クエリ式の結果に基づいてリソースのアドレスを指定できます。 その結果、評価された式に基づいてリソースのセットをフィルターすることが可能になります。 たとえば、次の URI は、リソースをフィルターして特定の Customer に 1997 年 9 月 22 日以降に出荷された Orders だけを返します。

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

詳細については、OData: URI 規則に関する Web ページを参照してください。

システム クエリ オプション

OData では一連のシステム クエリ オプションが定義されており、フィルター処理、並べ替え、ページングなど、リソースに対する従来のクエリ操作の実行に使用できます。 たとえば、次の URI は、郵便番号 (postal code) の末尾が 100 ではないすべての Order エンティティのセットを、関連する Order_Detail エンティティと共に返します。

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

返されたフィードのエントリは、注文の ShipCity プロパティの値でも並べ替えられています。

WCF Data Services は、次の OData システム クエリ オプションをサポートしています。

リレーションシップのアドレス指定

エンティティ セットとエンティティ インスタンスのアドレス指定に加えて、OData では、2 つのエンティティ間のリレーションシップを表すアソシエーションのアドレスを指定することもできます。 この機能は、2 つのエンティティ インスタンス (Northwind サンプル データベースの注文に関連付けられた配送会社など) の間のリレーションシップを作成または変更するために必要です。 OData は、エンティティ間のアソシエーションをアドレス指定する $link 演算子をサポートします。 たとえば、次の URI を HTTP PUT 要求メッセージで指定した場合、指定した注文の配送会社を新しい配送会社に変更します。

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

詳細については、OData: エントリ間のリンクのアドレス指定に関する説明を参照してください。

返されたフィードの使用

OData リソースの URI を使用すると、サービスによって公開されるエンティティ データのアドレスを指定できます。 Web ブラウザーの [アドレス] フィールドに URI を入力すると、要求されたリソースの OData フィード表現が返されます。 詳細については、「WCF Data Services クイックスタート」を参照してください。 Web ブラウザーはデータ サービス リソースが予期されたデータを返すかどうかをテストするために便利ですが、データの作成、更新、および削除も行うことができる運用データ サービスには、一般的にアプリケーション コードや Web ページのスクリプト言語を使用してアクセスします。 詳細については、「クライアント アプリケーションでのデータ サービスの使用 (WCF Data Services)」を参照してください。

参照

その他のリソース

Open Data Protocol