リフレクション プロバイダー (WCF Data Services)

Entity Framework を介してデータ モデルからデータを公開することに加えて、WCF Data Services では、エンティティ ベースのモデルで厳密に定義されていないデータを公開することもできます。 リフレクション プロバイダーは、IQueryable インターフェイスを実装する型を返すクラスのデータを公開します。 WCF Data Services は、リフレクションを使用して、これらのクラスのデータ モデルを推論し、リソースに対するアドレス ベースのクエリを、公開されている IQueryable 型に対する統合言語クエリ (LINQ) ベースのクエリに変換します。

注 :
AsQueryable メソッドを使用して、IEnumerable インターフェイスを実装する任意のクラスから IQueryable インターフェイスを返すことができます。これによって、ほとんどのジェネリック コレクション型をデータ サービスのデータ ソースとして使用することが可能になります。

リフレクション プロバイダーは、型の階層をサポートします。 詳細については、「方法: リフレクション プロバイダーを使用してデータ サービスを作成する (WCF Data Services)」を参照してください。

データ モデルの推論

データ サービスを作成すると、プロバイダーはリフレクションを使用してデータ モデルを推論します。 リフレクション プロバイダーがデータ モデルを推論する方法を次の一覧に示します。

• エンティティ コンテナー – IQueryable インターフェイスを返すプロパティとしてデータを公開するクラス。 リフレクション ベースのデータ モデルを作成すると、エンティティ コンテナーはサービスのルートを表します。 1 つの名前空間でサポートされるエンティティ コンテナー クラスは 1 つだけです。

• エンティティ セット - IQueryable インスタンスを返すプロパティはエンティティ セットとして処理されます。 エンティティ セットは、クエリでリソースとして直接アドレス指定されます。 エンティティ コンテナーの 1 つのプロパティが返すことができるのは、1 つの型の IQueryable インスタンスだけです。

• エンティティ型 – エンティティ セットが返す IQueryable の T 型。 継承階層の一部であるクラスは、リフレクション プロバイダーによって同等のエンティティ型階層に変換されます。

• エンティティ キー – エンティティ型である各データ クラスには 1 つのキー プロパティが必要です。 このプロパティは、DataServiceKeyAttribute 属性 ([DataServiceKeyAttribute]) で属性化されています。

  注 :
  DataServiceKeyAttribute 属性は、エンティティ型のインスタンスを一意に識別するために使用できるプロパティのみに適用してください。ナビゲーション プロパティに適用すると、この属性は無視されます。

• エンティティ型プロパティ – リフレクション プロバイダーは、エンティティ キー以外で、次に示すエンティティ型のクラスのアクセス可能な非インデクサー プロパティを処理します。

  • プロパティがプリミティブ型を返す場合、プロパティはエンティティ型のプロパティと見なされます。

  • プロパティがエンティティ型でもある型を返す場合、プロパティは、多対一または一対一のリレーションシップの "一" の側を表すナビゲーション プロパティと見なされます。

  • プロパティがエンティティ型の IEnumerable を返す場合、プロパティは、一対多または多対多のリレーションシップの "多" の側を表すナビゲーション プロパティと見なされます。

  • プロパティの戻り値の型が値型である場合、プロパティは複合型を表します。

注 :
エンティティ リレーショナル モデルに基づくデータ モデルとは異なり、リフレクション プロバイダーに基づくモデルではリレーショナル データは理解されません。Entity Framework を使用して、WCF Data Services 経由でリレーショナル データを公開する必要があります。

データ型のマッピング

データ モデルが .NET Framework クラスから推論されると、次に示すようにデータ モデルのプリミティブ型が .NET Framework データ型にマップされます。

注 :
.NET Framework の NULL 許容値型は、対応する値型で NULL を指定できないものと同じデータ モデル型にマップされます。

データ モデルでの更新の有効化

この種類のデータ モデルを介して公開されるデータを更新するために、リフレクション プロバイダーは、IUpdatable インターフェイスを定義します。 このインターフェイスは、公開されている型への更新を保存する方法をデータ サービスに指示します。 データ モデルによって定義されているリソースへの更新を有効にするには、エンティティ コンテナー クラスは、IUpdatable インターフェイスを実装する必要があります。 IUpdatable インターフェイスの実装例については、「方法: LINQ to SQL データ ソースを使用してデータ サービスを作成する (WCF Data Services)」を参照してください。

リフレクション プロバイダーを使用してデータ ソースに更新を伝達するには、IUpdatable インターフェイスに次のメンバーが実装されている必要があります。

同時実行の処理

WCF Data Services は、エンティティの同時実行トークンを定義できるようにすることで、オプティミスティック同時実行制御モデルをサポートしています。 この同時実行トークンは、エンティティの 1 つ以上のプロパティが含まれており、要求、更新、または削除されているデータに対して行われた変更があるかどうかを判断するためにデータ サービスによって使用されます。 要求内の eTag から取得したトークンの値がエンティティの現在の値と異なる場合、データ サービスで例外が発生します。 リフレクション プロバイダーの同時実行トークンを定義するために ETagAttribute がエンティティ型に適用されます。 同時実行トークンには、キー プロパティまたはナビゲーション プロパティを含めることはできません。 詳細については、「Making Changes to Data (WCF Data Services)」を参照してください。

リフレクション プロバイダーによる SQL への LINQ の使用

既定では Entity Framework がネイティブでサポートされるので、これが WCF Data Services でリレーショナル データを使用する場合の推奨データ プロバイダーです。 ただし、データ サービスで LINQ to SQL クラスを使用するには、リフレクション プロバイダーを使用できます。 LINQ to SQL Object Relational Designer (O/R Designer) によって生成される DataContext のメソッドによって返される Table 結果セットは、IQueryable インターフェイスを実装します。 そのため、リフレクション プロバイダーは、生成された LINQ to SQL クラスを使用して、これらのメソッドにアクセスし、SQL Server からエンティティ データを返すことができます。 ところが、LINQ to SQL は IUpdatable インターフェイスを実装しないので、既存の DataContext 部分クラスを拡張する部分クラスを追加して、IUpdatable 実装を追加する必要があります。 詳細については、「方法: LINQ to SQL データ ソースを使用してデータ サービスを作成する (WCF Data Services)」を参照してください。

参照

概念

データ サービス プロバイダー (WCF Data Services)