セッションキャッシュの値の保存および取得

Cache.Session のメソッド

セッションキャッシュに値を保存するには、Cache.Session.put() メソッドをコールして、キーと値を指定します。キー名は namespace.partition.key 形式にします。たとえば、名前空間が ns1、パーティションが partition1、キーが orderDate の場合、完全修飾されたキー名は ns1.partition1.orderDate になります。

次の例では、DateTime キャッシュ値をキー orderDate で保存します。次に、このスニペットは orderDate キーがキャッシュ内にあるかどうかをチェックし、ある場合はキャッシュからその値を取得します。

呼び出し元クラスのデフォルトパーティションと名前空間を参照するには、namespace.partition プレフィックスを省略して、キー名を指定します。

local プレフィックスは、組織に名前空間が定義されているかどうかに関係なく、コードが実行されている現在の組織の名前空間を示します。組織に ns1 という名前空間が定義されている場合、次の 2 つのステートメントは同等です。

put() メソッドには複数のバージョン (オーバーロード) があり、各バージョンが取るパラメータは異なります。たとえば、キャッシュ値を他の名前空間で上書きできないことを指定するには、このメソッドの最後のパラメータを true に設定します。次の例では、キャッシュ値の有効期間 (3,600 秒 = 1 時間) も設定し、任意の名前空間で値を使用できるようにしています。

セッションキャッシュからキャッシュ値を取得するには、Cache.Session.get() メソッドをコールします。Cache.Session.get() はオブジェクトを返すため、戻り値を特定の型にキャストすることをお勧めします。

Cache.SessionPartition のメソッド

1 つのパーティションのキャッシュ値を管理する場合は、代わりに Cache.SessionPartition メソッドを使用します。パーティションオブジェクトが取得できたら、キャッシュ値を追加および取得するプロセスは、Cache.Session メソッドを使用する場合と同様です。Cache.SessionPartition メソッドは、名前空間およびパーティションのプレフィックスなしでキー名のみを指定するため、より簡単に使用できます。

最初にセッションパーティションを取得し、目的のパーティションを指定します。パーティション名には、名前空間プレフィックス namespace.partition が含まれます。取得したパーティションオブジェクトのキャッシュ値を追加および取得することで、そのパーティションのキャッシュ値を管理できます。次の例は、myNs 名前空間の myPartition という名前のパーティションを取得します。次に、キャッシュにキー BookTitle という値が含まれている場合、このキャッシュ値が取得されます。新しい値がキー orderDate と今日の日付で追加されます。

次の例では、パーティションインスタンスを変数に割り当てることなく、1 つの式でパーティションに対する get メソッドをコールします。