パッケージ	net.user1.reactor.snapshot
クラス	public class Snapshot
継承	Snapshot flash.events.EventDispatcher
サブクラス	AccountListSnapshot, AccountSnapshot, BannedListSnapshot, ClientCountSnapshot, ClientListSnapshot, ClientSnapshot, RoomListSnapshot, RoomSnapshot

Reactorの"snapshots"は伝統的なリクエスト/レスポンスの仕組みを提供し、Unionサーバーからオンデマンドのデータを取得します。 SnapshotクラスはReactorの全"スナップショット"クラスの抽象基底クラスであり、それぞれサーバーから特定のデータセットをロードします。 例えば、ClientCountSnapshotクラスは現在サーバーに接続中のクライアント数をロードします。 RoomSnapshotクラスは特定のルームを記述するデータマニフェストをロードします。 スナップショットクラスを使用してデータのスナップショットをリクエストするには、初めに希望のスナップショットオブジェクトを作成し、それからそのオブジェクトをReactorクラスのupdateSnapshot()メソッドに渡します。 例えば、サーバー上の全ルームのルームIDのリストをロードするには、次のようにRoomListSnapshotを使用してください:

1. 最初に、RoomListSnapshotオブジェクトを作成してください:

      var snapshot:RoomListSnapshot = new RoomListSnapshot(null, true);
      

2. 次に、スナップショットのデータがロードされたときに自動的に呼び出されるコールバックかリスナー関数を登録してください。

      // コールバック関数を登録します
      snapshot.onLoad = function ():void {
        trace("Here's the room list: " + snapshot.getRoomList());
      }
      
      // あるいはリスナー関数を登録します
      snapshot.addEventListener(SnapshotEvent.LOAD, loadListener);
      function loadListener (e:SnapshotEvent):void {
        trace("Here's the room list: " + RoomListSnapshot(e.target).getRoomList());
      }
      

3. 最後に、ReactorのupdateSnapshot()メソッドにスナップショットオブジェクトを渡してください。

      reactor.updateSnapshot(snapshot);
      

このRoomListSnapshotオブジェクトがupdateSnapshot()リクエストの時点のサーバー状態のみを表すように、スナップショットはいったんロードされると同期は保たれません。 対照的に、UnionサーバーとReactor間の同期を管理するには、Reactor APIのメイン(net.user1.reactor)にあるクラスを使用してください。 例えば、ルームの同期が取れたリストを管理するには、RoomListSnapshotオブジェクトより、RoomManagerのwatchForRooms()メソッドを使用してください。

全てのスナップショットオブジェクトは、データをロードする時にSnapshotEvent.LOADをトリガーします。 いくつかのスナップショットオブジェクトはロード操作の状態を受け取る時にSnapshotEvent.STATUSもトリガーします。 詳細は、SnapshotEventを参照してください。

関連項目