TableServiceEntity クラス

protected String etag= null

内部使用のために予約されています。 エンティティの ETag の値。

protected String partitionKey= null

内部使用のために予約されています。 エンティティ内のパーティション キーの値。

protected String rowKey= null

内部使用のために予約されています。 エンティティ内の行キーの値。

protected Date timeStamp= new Date()

内部使用のために予約されています。 エンティティ内の Timestamp の値。

public TableServiceEntity()

空 TableServiceEntity のインスタンスを初期化します。

public TableServiceEntity(String partitionKey, String rowKey)

指定されたパーティション キーと行キーを使用して、TableServiceEntity クラスの新しいインスタンスを初期化します。

Parameters:

public String getEtag()

エンティティを検証する ETag 値を取得します。 この値は、テーブル エンティティが Microsoft Azure ストレージから最後に読み取られた後に変更されたかどうかを判断するために使用されます。 クライアントは、サービスでこの値を更新できません。

Overrides:

Returns:

public String getPartitionKey()

エンティティの PartitionKey 値を取得します。

Overrides:

Returns:

protected static ConcurrentHashMap<>, HashMap> getReflectedEntityCache()

反映されたエンティティ キャッシュは、エンティティが逆シリアル化され、ペイロードに JSON メタデータが含まれていない場合に、既知のエンティティ型とそれぞれの反映されたエンティティ ディクショナリをキャッシュします。

Returns:

public String getRowKey()

エンティティの RowKey 値を取得します。

Overrides:

Returns:

public Date getTimestamp()

エンティティのタイムスタンプを取得します。 一方、サーバーは Timestamp の値を管理します。この値は変更できません。

Overrides:

Returns:

public static boolean isReflectedEntityCacheDisabled()

反映されたエンティティ キャッシュが無効かどうかを示す値を取得します。 ほとんどのシナリオでは、パフォーマンスへの影響のため、反映されたエンティティ キャッシュを無効にすることはお勧めしません。

反映されたエンティティ キャッシュには、既知のエンティティ型と、それぞれの反映されたエンティティ ディクショナリが格納されます。 既知のエンティティ型でリフレクションを使用するのではなく、代わりにディクショナリの値が使用されます。

Returns:

public void readEntity(final HashMap properties, final OperationContext opContext)

プロパティ名のマップを使用して、このテーブル エンティティ インスタンスにデータ型指定された値を EntityProperty 設定します。

このメソッドは を readEntityWithReflection(final Object instance, final HashMap<String, EntityProperty> properties, final OperationContext opContext) 呼び出して、リフレクションを使用してメソッドが呼び出されるテーブル エンティティ インスタンスを設定します。 拡張 TableServiceEntity するテーブル エンティティ クラスは、クラスが表す Microsoft Azure Storage のテーブル エンティティの特定のプロパティに対して getter メソッドと setter メソッドを実装することで、この動作を利用できます。

カスタム シリアル化コードを呼び出すように 拡張 TableServiceEntity するクラスで、このメソッドをオーバーライドします。

Overrides:

Parameters:

Throws:

public static void readEntityWithReflection(final Object instance, final HashMap properties, final OperationContext opContext)

リフレクションを使用して、テーブル エンティティ プロパティ マップを指定したオブジェクト インスタンスに逆シリアル化します。

この静的メソッドは、テーブル エンティティ型を表すオブジェクト インスタンスを受け取り、そのクラス型のリフレクションを使用して、プロパティ マップからインスタンスにデータを逆シリアル化するメソッドを検索します。

プロパティ マップ内の各プロパティ名とデータ型は、シリアル化と逆シリアル化に使用する getter メソッドと setter メソッドのペアのクラス型のメソッドと比較されます。 クラスは、プロパティ名の先頭に "get" と "set" が付加された名前、またはプロパティ名で設定された注釈を持つ StoreAs メソッドをスキャンします。 メソッドには、対応する EntityProperty 値のデータ型と一致する戻り値の型またはパラメーター データ型が必要です。 このようなペアが見つかった場合は、インスタンスで setter メソッドを呼び出すことによって、データがインスタンス オブジェクトにコピーされます。 名前とデータ型によってメソッドペアと一致しないプロパティはコピーされません。

Parameters:

Throws:

public void setEtag(final String etag)

エンティティを検証する ETag 値を設定します。 この値は、テーブル エンティティが Microsoft Azure ストレージから最後に読み取られた後に変更されたかどうかを判断するために使用されます。 クライアントは、サービスでこの値を更新できません。

Overrides:

Parameters:

public void setPartitionKey(final String partitionKey)

エンティティの PartitionKey 値を設定します。

Overrides:

Parameters:

public static void setReflectedEntityCacheDisabled(boolean disableReflectedEntityCache)

反映されたエンティティ キャッシュが無効かどうかを表すブール値を設定します。 ほとんどのシナリオでは、パフォーマンスへの影響のため、反映されたエンティティ キャッシュを無効にすることはお勧めしません。

反映されたエンティティ キャッシュには、既知のエンティティ型と、それぞれの反映されたエンティティ ディクショナリが格納されます。 既知のエンティティ型でリフレクションを使用するのではなく、代わりにディクショナリの値が使用されます。

Parameters:

public void setRowKey(final String rowKey)

エンティティの RowKey 値を設定します。

Overrides:

Parameters:

public void setTimestamp(final Date timeStamp)

エンティティの値を設定します。 timestamp プロパティは読み取り専用プロパティであり、サービスによってのみ設定されることに注意してください。

Overrides:

Parameters:

public HashMap writeEntity(final OperationContext opContext)

このテーブル エンティティ インスタンスをシリアル化することによって作成されたデータ型指定された値に対する EntityProperty プロパティ名のマップを返します。

このメソッドは、 writeEntityWithReflection(final Object instance) を呼び出して、リフレクションを使用してメソッドが呼び出されるテーブル エンティティ インスタンスをシリアル化します。 拡張 TableServiceEntity するテーブル エンティティ クラスは、クラスが表す Microsoft Azure Storage のテーブル エンティティの特定のプロパティに対して getter メソッドと setter メソッドを実装することで、この動作を利用できます。 プロパティ名 "PartitionKey"、"RowKey"、および "Timestamp" は予約されており、注釈を持つ StoreAs 他のメソッドに設定されている場合は無視されることに注意してください。

カスタム シリアル化コードを呼び出すように 拡張 TableServiceEntity するクラスで、このメソッドをオーバーライドします。

Overrides:

Parameters:

Returns:

Throws:

public static HashMap writeEntityWithReflection(final Object instance)

リフレクションを使用して、テーブル エンティティ インスタンスのプロパティ データをプロパティ マップにシリアル化します。

この静的メソッドは、テーブル エンティティ型を表すオブジェクト インスタンスを受け取り、そのクラス型のリフレクションを使用して、インスタンスからプロパティ マップにデータをシリアル化するメソッドを検索します。

プロパティ マップ内の各プロパティ名とデータ型は、シリアル化と逆シリアル化に使用する getter メソッドと setter メソッドのペアのクラス型のメソッドと比較されます。 クラスは、プロパティ名の先頭に "get" と "set" が付加された名前、またはプロパティ名で設定された注釈を持つ StoreAs メソッドをスキャンします。 メソッドには、対応する EntityProperty 値のデータ型と一致する戻り値の型またはパラメーター データ型が必要です。 このようなペアが見つかった場合は、インスタンスで getter メソッドを呼び出すことによって、インスタンス オブジェクトからデータがコピーされます。 名前とデータ型が一致するメソッド ペアがないプロパティはコピーされません。

Parameters:

Returns:

Throws: