TableEntity インターフェイス

テーブルのエンティティ型に必要なインターフェイスです。 インターフェイスは TableEntity 、共通エンティティ プロパティの getter メソッドと setter メソッド、およびプロパティ マップを使用してすべてのエンティティ プロパティのシリアル化と逆シリアル化を行うメソッドを宣言します。 プロパティの格納、取得、シリアル化、逆シリアル化をカスタマイズし、テーブル エンティティに追加のカスタム ロジックを提供するための を実装 TableEntity するクラスを作成します。

Storage クライアント ライブラリには、 の 2 つの実装が含まれており、 TableEntity 単純なプロパティ アクセスとシリアル化を提供します。

DynamicTableEntity は を TableEntity 実装し、プロパティを格納および取得するための単純なプロパティ マップを提供します。 DynamicTableEntityプロパティのサブセットのみが返される場合 (クエリ内の select 句など)、またはクエリが異なるプロパティを持つ複数のエンティティ型を返すことができる場合は、 を使用してエンティティ プロパティに簡単にアクセスします。 また、この型を使用すると、異種エンティティのテーブルに対して、プロパティ情報を損なうことなく一括更新を実行できます。

TableServiceEntity は、 および メソッドでリフレクション ベースのシリアル化と逆シリアル化の動作を使用する の実装 TableEntity です。 TableServiceEntity型と名前付けの規則に従うメソッドを持つ派生クラスは、自動的にシリアル化および逆シリアル化されます。

を実装 TableEntity するクラスは、 と の静的メソッドを呼び出すことによって、 の TableServiceEntity 自動リフレクション ベースのシリアル化と逆シリアル化の動作を利用できます。 クラスは、自動的にシリアル化および逆シリアル化される型と名前付け規則に従うメソッドを提供する必要があります。 特定のプロパティ名とデータ型に対して getter メソッドと setter メソッドの両方が見つかった場合、適切なメソッドが自動的に呼び出され、データがシリアル化または逆シリアル化されます。 リフレクション コードは、フォームのペアで getter メソッドと setter メソッドを検索します

および

ここで 、PropertyName はテーブル エンティティのプロパティ名であり、 型 は プロパティの EDM データ型と互換性のある Java 型です。 Java と同等のプロパティ型のマップについては、クラスの説明 TableServiceEntity の表を参照してください。 注釈を StoreAs 属性と共に適用して、プロパティ名規則に従わない getter メソッドと setter メソッドでリフレクションのプロパティ名を指定できます。 メソッド名と注釈の StoreAs 属性は、プロパティ名とリフレクションを照合する場合、大文字と小文字が区別されます。 注釈を Ignore 使用して、自動シリアル化と逆シリアル化のためにリフレクションによってメソッドが使用されないようにします。 "PartitionKey"、"RowKey"、"Timestamp"、および "Etag" という名前は予約されており、リフレクション メソッドを使用するサブクラスで注釈と共 StoreAs に設定すると無視されることに注意してください。