保存可能なアクション
アクションを保存可能とマークし、フレームワークによってその応答をクライアント側のキャッシュに保存できます。キャッシュは、一時的にネットワークから切断されているデバイスでアプリケーションを機能させる場合に役立ちます。
JavaScript コールバックの getState() で SUCCESS が返される、成功したアクションが保存されます。
保存可能なアクションが送信された後、サーバから返される前に中止された場合でも、戻り値はストレージに追加されますが、アクションのコールバックはコールされません。
保存可能なアクションのアクション応答は、内部フレームワークで提供される actions というストレージに保存されます。この保存された応答は、期限切れになっていなければ、サーバ側コントローラからの応答の代わりに同じサーバ側のアクションへの後続のコールで返されます。
保存された応答が有効期限に達すると、新しい応答がサーバ側コントローラから取得され、後続のコールで actions ストレージに保存されます。
アプリケーションの保存可能なアクションの有効化
現在サポートされているストレージ種別は、サーバ側のアクションストレージのみです。サーバ側アクションのストレージには、アクション応答値がキャッシュされます。ストレージ名は actions にする必要があります。
アプリケーションのストレージを初期化する例については、「Storage Service の初期化」を参照してください。
保存可能なアクションのマーク付け
サーバ側のアクションを保存可能とマークするには、JavaScript コードで次のようにアクションの setStorable()をコールします。
1action.setStorable();setStorable 関数は省略可能なパラメータを取ります。このパラメータは、ストレージオプションを表すキー - 値ペアと設定値の設定対応付けです。次のプロパティのみを設定できます。
- ignoreExisting
- true に設定すると、項目が期限切れになっているかどうかに関わらず、保存された項目が新しく取得された値で更新されます。デフォルト値は、false です。
アクション応答のストレージオプションを設定するには、この設定対応付けを setStorable() に渡します。