DataMessage  - AS3 ADEP Data Services

DataMessage によって影響を受けるアイテムの固有 ID を定義する ID マップへのアクセスを提供します。この ID マップは作成、更新、削除操作に関連しますが、データ入力操作には関連しません。

この DataMessage の操作またはコマンドへのアクセスを提供します。操作は、リモート宛先でのこのメッセージの処理方法を示します。操作タイプの説明を表示するには、getOperationAsString メソッドを使用します。

関連する API エレメント

コンストラクターです。

指定した操作の説明を設定します。 このメソッドは、このメッセージに対する toString() 操作で使用されます。

パラメーター

         var msg:DataMessage = DataMessage(event.message);
         trace("Current operation -'"+
                DataMessage.getOperationAsString(msg.operation)+ "'.");
      

この操作が作成操作であれば、true を返します。

関連する API エレメント

このメッセージが更新メッセージであり、なおかつメッセージのプロパティ名リストの長さが 0 であれば、true を返します。

この操作は、1 つの単位として実行されるバッチ操作のセットを表します。クライアントは、DataManager.commit() が呼び出されたときにバッチを送信します。バッチ内のメッセージはすべて、同じ宛先を対象としてします。body プロパティには、このバッチの中に属するすべてのメッセージが格納されます。

この操作は、設定済みの <count-method> をリモート宛先上で呼び出すように要求します。メッセージの body プロパティには、メソッドの呼び出し時にリモート宛先に渡される引数が格納されます。DataManager.count() メソッドが呼び出されると、この操作がクライアントから送信されます。

関連する API エレメント

この操作は、リモート宛先に対し、指定されたアイテムの作成を要求します。DataManager.createItem() メソッドが呼び出されると、この操作がクライアントから送信されます。body プロパティには、作成されるアイテムが格納されます。

関連する API エレメント

作成操作を示します。body プロパティには、作成される新しいアイテムが格納されます。操作が関連付けの外部で実行された場合は、対応する UpdateCollectionMessage が配信され、アイテムが追加される位置またはインデックスが示されます。クライアントは、DataService の管理下にあるコレクションで IList.addItemAt()、IList.addItem() または IViewCursor.insert() メソッドが使用されるときに、この操作を送信します。

関連する API エレメント

この操作は、指定されたアイテムが削除されることを示します。クライアントは、アイテムが削除されたときにこの操作を送受信します。クライアントは、DataManager.deleteItem() のとき、あるいはデータマネージャーの管理下にあるコレクションで IList.removeItemAt() または IViewCursor.remove() メソッドが使用されるときに、この操作を送信します。

関連する API エレメント

この操作は、リモート宛先に対し、リモート宛先のアダプターを使用してシーケンスを作成するように要求します。メッセージの body プロパティには、リモートシーケンスの作成時に使用される fill 引数が格納されます。

FILL_OPERATION と同様ですが、応答配列に 1 つのアイテムのみが返されるようにします。

この操作は、リモート宛先に対して、特定の管理対象オブジェクトをそのオブジェクトに固有の ID に基づいて取得するように要求します。identity プロパティには目的のオブジェクトの ID が格納されます。

関連する API エレメント

この操作は、リモート宛先に対し、指定された ID を持つアイテムを要求します。ID を持つアイテムが存在しない場合は、作成操作が実行されます。クライアントは、アイテムに対して null 以外のデフォルト値で DataManager.getItem() メソッドが呼び出されるときに、この操作を送信します。body プロパティには、作成する必要のあるアイテムのデフォルト値が格納されます。

関連する API エレメント

この操作は、一連の fill パラメーターのシーケンス ID を要求します。シーケンスが存在する場合、シーケンス ID は再作成されません。存在しない場合は、リモートで再作成されます。クライアントは、リモート宛先への再接続時、またはクラスタ内の新しいノードへのフェイルオーバー時に、この操作を送信します。この操作は、リモート宛先の設定 xml ファイルで <reconnect> タグの fetch 属性が IDENTITY に設定されている場合にのみ、使用されます。

関連する API エレメント

この操作は、1 つの単位として実行されるが、複数の作成、更新または削除のバッチ操作が含まれ、複数の宛先、つまり複数のリモートアダプターが関係する一連の操作を表します。クライアントは、DataManager.commit() が呼び出され、その宛先に対して関連付けが複数設定されているときに、複数のバッチを送信します。このバッチ内のメッセージは複数の宛先に送信されます。

この操作は、ID で指定されたアイテムのページに対する要求を示します。この操作は、ページインデックスが不要な点以外は PAGE_OPERATION と同様です。クライアントは、1 対多および多対多を使用して設定された関連付けに対する遅延ロードアイテムを取得するときに、この操作を送信します。

この操作は、単一のメッセージにまとめられる代わりに、複数のメッセージで配信されるシーケンス化されたコンテンツのページを取得するために使用します。これは部分的なリモートシーケンスに対する要求を表します。クライアントは、ローカルに存在していないアイテムまたはプロパティが要求されたときにこの操作を送信します。この操作は、<network> タグ配下の <paging> タグの enabled 属性が true に設定されていて pageSize 属性がゼロ以外の場合か、または lazy 属性が true に設定された状態で関連付けが設定されている場合にのみ、実行されます。

この操作は、指定されたコレクションに対して実行された操作の通知をクライアントがもう受け取ろうとしていないことを示します。クライアントは、DataManager.releaseCollection() が呼び出されたとき、または以前に異なるパラメーターで設定された ArrayCollection で DataManager.fill() が呼び出された場合、あるいは 1 対多の関連付けの所有側アイテムが解放された場合に、この操作を送信します。

関連する API エレメント

この操作は、指定されたアイテムに対して実行された操作の通知をクライアントがもう受け取ろうとしていないことを示します。DataService.releaseItem() または ItemReference.releaseItem() メソッドが呼び出されると、この操作がクライアントから送信されます。

関連する API エレメント

このクラスに対応する完全修飾サーバー側クラスを指定するリモートエイリアスです。

この操作は、リモート宛先に対し、リモート宛先のアダプターを使用してシーケンスを作成するように要求します。メッセージの body プロパティには、リモートシーケンスの作成時に使用される fill 引数が格納されます。

この操作は MULTI_BATCH_OPERATION と似ていますが、さらにサーバーは複数のメッセージバッチを 1 つのトランザクション内にカプセル化する必要があります。この操作は、リモート宛先の設定 xml の中で <properties> タグ配下の <use-transactions> タグの値が true に設定されている場合にのみ、実行されます。

不明の操作タイプのコードです。

この定数を使用すると、変更されたプロパティ名のリストにアクセスできます。このプロパティは、operation が UPDATE_OPERATION であるメッセージの body プロパティに対して、角括弧記法で使用します。

関連する API エレメント

         var msg:DataMessage = DataMessage(event.message);
         if (msg.operation == DataMessage.UPDATE_OPERATION)
         {
            // look at each change and display the old and new values
            var propertyNames:Array = msg.body[DataMessage.UPDATE_BODY_CHANGES];
            var newValues:Object = msg.body[DataMessage.UPDATE_BODY_NEW];
            var oldValues:Object = msg.body[DataMessage.UPDATE_BODY_PREV];
            var propertyName:String;
            for (var i:int=0; i<propertyNames.length; i++)
            {
                propertyName = propertyNames[i];
                trace("Property '"+ propertyName + "' was changed from '" +
                      oldValues[propertyName] + "' to '"+ newValues[propertyName] +
                      "'.");
            }
         }
      

この定数を使用すると、変更されたアイテムの変更後の値にアクセスできます。このプロパティは、operation が UPDATE_OPERATION であるメッセージの body プロパティに対して、角括弧記法で使用します。

関連する API エレメント

         var msg:DataMessage = DataMessage(event.message);
         if (msg.operation == DataMessage.UPDATE_OPERATION)
         {
            // look at each change and display the old and new values
            var propertyNames:Array = msg.body[DataMessage.UPDATE_BODY_CHANGES];
            var newValues:Object = msg.body[DataMessage.UPDATE_BODY_NEW];
            var oldValues:Object = msg.body[DataMessage.UPDATE_BODY_PREV];
            var propertyName:String;
            for (var i:int=0; i<propertyNames.length; i++)
            {
                propertyName = propertyNames[i];
                trace("Property '"+ propertyName + "' was changed from '" +
                      oldValues[propertyName] + "' to '"+ newValues[propertyName] +
                      "'.");
            }
         }
      

この定数を使用すると、変更されたアイテムの変更前の値にアクセスできます。このプロパティは、operation が UPDATE_OPERATION であるメッセージの body プロパティに対して、角括弧記法で使用します。

関連する API エレメント

         var msg:DataMessage = DataMessage(event.message);
         if (msg.operation == DataMessage.UPDATE_OPERATION)
         {
            // look at each change and display the old and new values
            var propertyNames:Array = msg.body[DataMessage.UPDATE_BODY_CHANGES];
            var newValues:Object = msg.body[DataMessage.UPDATE_BODY_NEW];
            var oldValues:Object = msg.body[DataMessage.UPDATE_BODY_PREV];
            var propertyName:String;
            for (var i:int=0; i<propertyNames.length; i++)
            {
                propertyName = propertyNames[i];
                trace("Property '"+ propertyName + "' was changed from '" +
                      oldValues[propertyName] + "' to '"+ newValues[propertyName] +
                      "'.");
            }
         }
      

この操作は、ローカルシーケンスまたはリモートシーケンスが挿入または削除により変更されたときに送信されます。この操作は、コレクション順序の状態を復元できるように、すべての挿入および削除の位置に関する情報を提供します。

body には、削除および追加されたアイテムを示す UpdateCollectionRange の配列が格納されます。コレクションの更新範囲を順に適用すると、指定したコレクションの中でアイテムの順序付けの一貫性が確立されます。

この操作は、データオブジェクトへの更新が実行されたことを示します。クライアントは、アイテムが更新されたときにこの操作を送受信します。

メッセージの body プロパティは、発生した更新に関する特定の情報を格納している配列です。配列中の DataMessage.UPDATE_BODY_CHANGES 位置には、更新中に変更されたプロパティ名の配列が格納されます。

配列中の DataMessage.UPDATE_BODY_NEW 位置には、新しく変更された状態のオブジェクトが格納されます。配列中の DataMessage.UPDATE_BODY_PREV 位置には、更新前の状態のオブジェクトが格納されます。

         var msg:DataMessage = DataMessage(event.message);
         if (msg.operation == DataMessage.UPDATE_OPERATION)
         {
            // look at each change and display the old and new values
            var propertyNames:Array = msg.body[DataMessage.UPDATE_BODY_CHANGES];
            var newValues:Object = msg.body[DataMessage.UPDATE_BODY_NEW];
            var oldValues:Object = msg.body[DataMessage.UPDATE_BODY_PREV];
            var propertyName:String;
            for (var i:int=0; i<propertyNames.length; i++)
            {
                propertyName = propertyNames[i];
                trace("Property '"+ propertyName + "' was changed from '" +
                      oldValues[propertyName] + "' to '"+ newValues[propertyName] +
                      "'.");
            }
         }