| パッケージ | mx.data |
| クラス | public class RPCDataServiceAdapter |
| 継承 | RPCDataServiceAdapter  DataServiceAdapter Object |
| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
このサービスを使用する上で最も難しい部分は、データ管理の追加によるユーザーコードへの影響が最小限になるように、既存のサービスの呼び出しを引き継ぐことです。サービスの呼び出しは同じように動作し、同じイベントとトークンが発行されるので、管理する必要があるのは結果のみです。これを行うために、RPCDataServiceAdapter は ManagedOperation を標準の RPC サービス操作に関連付けます。初期化時に操作の operationManager プロパティが設定され、エンドユーザーの呼び出しはこのクラスのプロキシメソッド（queryProxy など）にリダイレクトされます。これにより、対応するデータ管理呼び出しが生成され、管理対象トークンがエンドユーザーに返されて、エンドユーザーは管理対象操作の結果を取得できます。
order is:
user calls service method
calls service delegates to operationManager - ManagedOpertion.xxProxy methods
calls managerOperation kicks off DMS op --> DataManager.xx
calls DMS op calls adapter to do the op --> DataServiceAdapter.invoke
calls: RPCDataServiceAdapter invokes the service operation and sets the "raw" lastResult
returns: adapter's result comes back in and is converted to DMS Result Message - RPCDataServiceResult.xxResult
returns: data manager processes result - updates managed object --> DataListRequestResponder/CommitResponder
returns: service is updated to lastResult from the operation
returns: user's result event is called
継承されるパブリックプロパティを隠す
継承されるパブリックプロパティを表示| プロパティ | 定義元 | ||
|---|---|---|---|
| asyncRequest : AsyncRequest [オーバーライド] [読み取り専用]
すべての DataService 操作の処理に使用される AsyncRequest を返す抽象メソッドです。 | RPCDataServiceAdapter | ||
 | connected : Boolean [読み取り専用]
このサービスアダプターがソースに接続されているときは true を返します。 | DataServiceAdapter | |
| constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。 | Object | |
| dataManagerRegistry : Object [静的]
宛先名からその宛先のデータマネージャーへの静的なマップです。 | RPCDataServiceAdapter | ||
| dataStore : DataStore
mx.data.DataStore 型のオブジェクトを含みます。 | DataServiceAdapter | |
| destination : String
このデータサービスアダプターの宛先の名前です。 | RPCDataServiceAdapter | ||
| serializeAssociations : Boolean [オーバーライド] [読み取り専用]
これは、関連付けを除外する直列化記述子にアイテムをラップするかどうかを制御します。 | RPCDataServiceAdapter | ||
| throwUnhandledFaults : Boolean [オーバーライド] [読み取り専用]
データマネージャー上にリスナーが存在しない状態で障害が発生すると、このデータマネージャーはエラーをスローしないので、false を返します。 | RPCDataServiceAdapter | ||
| メソッド | 定義元 | ||
|---|---|---|---|
このメソッドは、createItem 操作を実行する必要がある場合に RPCDataServiceAdapter によって呼び出されます。 | RPCDataServiceAdapter | ||
このメソッドは、管理レイヤーがサーバーからアイテムを削除する必要があるときに、RPCDataServiceAdapter によって呼び出されます。 | RPCDataServiceAdapter | ||
executeQuery(dataManager:RPCDataManager, queryName:String, includeSpecifier:PropertySpecifier, queryArgs:Array):mx.rpc:AsyncToken
アダプターが名前付きクエリを実行するときに呼び出されます。 | RPCDataServiceAdapter | ||
アイテムのクライアントバージョンとサーバーバージョンの間で競合のあるプロパティ名の配列を返します。 | RPCDataServiceAdapter | ||
[オーバーライド]
指定された宛先のデータマネージャーを検索します。 | RPCDataServiceAdapter | ||
|
関連付けられているデータサービスアダプターを検索します。 | DataServiceAdapter | |
getItem(dataManager:RPCDataManager, identity:Object, defaultValue:Object = null, includeSpecifier:PropertySpecifier = null):mx.rpc:AsyncToken
ID に基づいて個々のアイテムを取得するためにアダプターから呼び出されます。 | RPCDataServiceAdapter | ||
getItems(dataManager:RPCDataManager, ids:Array, includeSpecifier:PropertySpecifier):mx.rpc:AsyncToken
特定の宛先のアイテムのリストを取得する必要があるときに呼び出される Adapter メソッドです。 | RPCDataServiceAdapter | ||
これは、コレクションの作成、更新、削除、または更新操作のフォルトが処理された後に呼び出されます。 | RPCDataServiceAdapter | ||
|
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
|
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
pageQuery(dataManager:RPCDataManager, queryName:String, queryArgs:Array, startIndex:int, numItems:int):mx.rpc:AsyncToken
クライアント側クエリの単一ページに対するクエリを実行します。 | RPCDataServiceAdapter | ||
アイテムの削除に対応するサーバーからのイベントをシミュレートします。 | RPCDataServiceAdapter | ||
postItemUpdate(dataManager:RPCDataManager, item:Object, origItem:Object = null, changes:Array = null):void
アイテムの更新または作成に対応するサーバーからのイベントをシミュレートします。 | RPCDataServiceAdapter | ||
データメッセージを処理するために DataManager によって使用される低レベルのメソッドです。 | RPCDataServiceAdapter | ||
|
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
|
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
これは、競合の可能性を示すフォルトをサーバーから受け取ると呼び出されます。 | RPCDataServiceAdapter | ||
|
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | |
|
指定されたオブジェクトのストリング表現を返します。 | Object | |
updateCollection(dataManager:RPCDataManager, mq:ManagedQuery, ucmsg:UpdateCollectionMessage):mx.rpc:AsyncToken
これは、（関連付けではなく）クエリによって管理されているコレクションにアイテムが追加されたとき、またはそのようなコレクションからアイテムが削除されたときに呼び出されます。 | RPCDataServiceAdapter | ||
updateItem(dataManager:RPCDataManager, item:Object, origItem:Object, changes:Array):mx.rpc:AsyncToken
このメソッドは、特定の updateItem 操作を実行するために RPCDataServiceAdapter によって呼びだされます。 | RPCDataServiceAdapter | ||
|
指定されたオブジェクトのプリミティブな値を返します。 | Object | |
| メソッド | 定義元 | ||
|---|---|---|---|
このメソッドは、競合の可能性を示すフォルトが返された後に呼び出されます。 | RPCDataServiceAdapter | ||
internalGetItem(dataManager:RPCDataManager, identity:Object, defaultValue:Object = null, includeSpecifier:PropertySpecifier = null):mx.rpc:AsyncToken
このメソッドは実際に getItem 操作を実行しますが、管理対象の結果の更新に結果ハンドラーは使用されません。 | RPCDataServiceAdapter | ||
RPCDataService 操作のフォルト応答側です。 | RPCDataServiceAdapter | ||
RPCDataService 操作の成功応答側です。 | RPCDataServiceAdapter | ||
asyncRequest | プロパティ |
asyncRequest:AsyncRequest [読み取り専用] [オーバーライド] | 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
すべての DataService 操作の処理に使用される AsyncRequest を返す抽象メソッドです。AsyncRequest.invoke メソッドをオーバーライドすることで、管理対象の要求をインターセプトできます。また、AsyncRequest クラスでは、サービスが接続されているか切断されているかを確認するための様々なメソッドも公開されています。
実装
override public function get asyncRequest():AsyncRequestdataManagerRegistry | プロパティ |
public static var dataManagerRegistry:Object| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
宛先名からその宛先のデータマネージャーへの静的なマップです。
destination | プロパティ |
public var destination:String| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
このデータサービスアダプターの宛先の名前です。
serializeAssociations | プロパティ |
serializeAssociations:Boolean [読み取り専用] [オーバーライド] | 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
これは、関連付けを除外する直列化記述子にアイテムをラップするかどうかを制御します。MessagingDataServiceAdapter では、この方法を使用して関連付けが送信されます。この方法は、RPCDataServiceAdapter では使用されません。
実装
override public function get serializeAssociations():BooleanthrowUnhandledFaults | プロパティ |
throwUnhandledFaults:Boolean [読み取り専用] [オーバーライド] | 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
データマネージャー上にリスナーが存在しない状態で障害が発生すると、このデータマネージャーはエラーをスローしないので、false を返します。RPC サービスの場合、このようなエラーはサービス上のリスナーにプロキシされるので、エラーをスローするのは適切ではありません。
実装
override public function get throwUnhandledFaults():BooleancheckForConflict | () | メソッド |
protected function checkForConflict(resultEvent:ResultEvent, token:mx.rpc:AsyncToken):void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
このメソッドは、競合の可能性を示すフォルトが返された後に呼び出されます。そのフォルトのフォルトハンドラーで、getItem() を呼び出してサーバー上のアイテムの最新バージョンを取得します。
このメソッドをオーバーライドする必要があるのは、例えば、競合が検出されなかった後でアクションを実行する必要がある場合です。
パラメーター
resultEvent:ResultEvent — getItem() の呼び出しからのイベントオブジェクトです。
| |
token:mx.rpc:AsyncToken — cause プロパティが含まれます。このプロパティは、変更の元の DataMessage です。このメソッドは、競合があるときは Conflicts.raiseConflict() を呼び出すことができ、競合がないと判断された場合は何も行いません。
|
createItem | () | メソッド |
public function createItem(dataManager:RPCDataManager, item:Object):mx.rpc:AsyncToken| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
このメソッドは、createItem 操作を実行する必要がある場合に RPCDataServiceAdapter によって呼び出されます。デフォルトの実装では、createItem 操作に対して登録されている管理対象操作が、そのアイテムを 1 番目のパラメーターとして使用して呼び出されます。複数のサービスを呼び出す必要がある場合、またはこの操作のパラメーター署名を変更する必要がある場合は、RPCDataServiceAdapter を拡張して、この createItem メソッドをオーバーライドできます。
パラメーター
dataManager:RPCDataManager — 呼び出される作成操作の制御でのマネージャーです。
| |
item:Object — 作成するアイテムです。
|
mx.rpc:AsyncToken — です。このトークンを使用すると、この作成操作の結果またはフォルトイベントを受け取るためのコールバック関数を登録できます。このトークンは、ResultEvent.RESULT または FaultEvent.FAULT の call プロパティでも返されます。このオブジェクトにはカスタムデータを添付することができ、そのデータは後のイベント処理段階で検査できます。
|
deleteItem | () | メソッド |
public function deleteItem(dataManager:RPCDataManager, item:Object):mx.rpc:AsyncToken| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
このメソッドは、管理レイヤーがサーバーからアイテムを削除する必要があるときに、RPCDataServiceAdapter によって呼び出されます。削除するアイテムを引数として指定します。このメソッドのデフォルトの実装は、type="delete" の ManagedOperation を検索します。そのメソッドを呼び出すときは、削除するアイテム、または（ManagedOperation のパラメーターが "id" に設定されている場合は）削除するアイテムの ID を指定します。
パラメーター
dataManager:RPCDataManager — 呼び出される削除操作の制御でのマネージャーです。
| |
item:Object — 削除するアイテムです。
|
mx.rpc:AsyncToken — このトークンを使用すると、この削除操作の結果またはフォルトイベントを受け取るためのコールバック関数を登録できます。このトークンは、ResultEvent.RESULT または FaultEvent.FAULT の call プロパティでも返されます。このオブジェクトにはカスタムデータを添付することができ、そのデータは後のイベント処理段階で検査できます。
|
executeQuery | () | メソッド |
public function executeQuery(dataManager:RPCDataManager, queryName:String, includeSpecifier:PropertySpecifier, queryArgs:Array):mx.rpc:AsyncToken| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
アダプターが名前付きクエリを実行するときに呼び出されます。ページングが有効になっている場合は、コレクション内の最初のページが取得されます。
パラメーター
dataManager:RPCDataManager — 呼び出されるクエリ操作の制御でのマネージャーです。
| |
queryName:String — クエリ名です。
| |
includeSpecifier:PropertySpecifier — 取得するプロパティのセットです。
| |
queryArgs:Array — クエリ操作の呼び出しに対する引数です。
|
mx.rpc:AsyncToken — このトークンを使用すると、このクエリ操作の結果またはフォルトイベントを受け取るためのコールバック関数を登録できます。このトークンは、ResultEvent.RESULT または FaultEvent.FAULT の call プロパティでも返されます。このオブジェクトにはカスタムデータを添付することができ、そのデータは後のイベント処理段階で検査できます。
|
getConflictingProperties | () | メソッド |
public function getConflictingProperties(dmgr:RPCDataManager, cause:DataMessage, serverObject:Object):Array| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
アイテムのクライアントバージョンとサーバーバージョンの間で競合のあるプロパティ名の配列を返します。競合がない場合は null を返します。
パラメーター
dmgr:RPCDataManager — 関連付けられているデータマネージャーです。
| |
cause:DataMessage — 処理が競合の原因になった可能性のあるデータメッセージです。
| |
serverObject:Object — アイテムのサーバーのバージョンです。
|
Array — アイテムのクライアントバージョンとサーバーバージョンの間で競合のあるプロパティ名の配列です。競合がない場合は null を返します。
|
getDataManager | () | メソッド |
override public function getDataManager(destination:String):DataManager| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
指定された宛先のデータマネージャーを検索します。
パラメーター
destination:String — 宛先です。
|
DataManager — 宛先の DataManager オブジェクトです。
|
getItem | () | メソッド |
public function getItem(dataManager:RPCDataManager, identity:Object, defaultValue:Object = null, includeSpecifier:PropertySpecifier = null):mx.rpc:AsyncToken| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
ID に基づいて個々のアイテムを取得するためにアダプターから呼び出されます。includeSpecifier パラメーターは、要求されたプロパティのセットを指定します。
パラメーター
dataManager:RPCDataManager — 関連付けられているデータマネージャーです。
| |
identity:Object — 取得するアイテムの ID です。
| |
defaultValue:Object (default = null) | |
includeSpecifier:PropertySpecifier (default = null) |
mx.rpc:AsyncToken — 結果を取得する AsyncToken の結果プロパティにバインドする AsyncToken です。または、結果プロパティ変更イベントをリスニングし、1 つ以上の応答側をトークンに追加し、トークンの動的プロパティとして追加情報を追加して、操作の結果を追跡できます。
|
getItems | () | メソッド |
public function getItems(dataManager:RPCDataManager, ids:Array, includeSpecifier:PropertySpecifier):mx.rpc:AsyncToken| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
特定の宛先のアイテムのリストを取得する必要があるときに呼び出される Adapter メソッドです。PropertySpecifier は、最低限必要なプロパティのセットを示します。このメソッドのデフォルトの実装では、getItem メソッドが繰り返し呼び出されます。サーバーがこの操作をさらに効率よく実行できる場合は、このメソッドを実装する操作を改善できる可能性があります。
パラメーター
dataManager:RPCDataManager — 関連付けられているデータマネージャーです。
| |
ids:Array — 取得するアイテムの識別子の配列です。
| |
includeSpecifier:PropertySpecifier — （オプション）取得するプロパティのセットです。
|
mx.rpc:AsyncToken — 結果を取得する AsyncToken の結果プロパティにバインドする AsyncToken です。または、結果プロパティ変更イベントをリスニングし、1 つ以上の応答側をトークンに追加し、トークンの動的プロパティとして追加情報を追加して、操作の結果を追跡できます。
|
handleFault | () | メソッド |
public function handleFault(errMsg:ErrorMessage, cause:DataMessage):void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
これは、コレクションの作成、更新、削除、または更新操作のフォルトが処理された後に呼び出されます。これを使用すると、エラー処理と競合検査に関連付けられたロジックをアダプターでカスタマイズできる場合があります。デフォルトの実装では、RPCDataManager conflictMode 機能が実装されます。UPDATE 操作または DELETE 操作のフォルトを受け取ると、現在のサーバーバージョンと、更新または削除されたオブジェクトの元のバージョンが比較されます。サーバーバージョンが異なる場合は、競合として扱われます。この場合、フォルトの原因になった変更は既に、未コミットの変更バッチに戻されているものと仮定されます。
パラメーター
errMsg:ErrorMessage — エラーの説明です。
| |
cause:DataMessage — エラーの原因になった操作です。
|
internalGetItem | () | メソッド |
protected function internalGetItem(dataManager:RPCDataManager, identity:Object, defaultValue:Object = null, includeSpecifier:PropertySpecifier = null):mx.rpc:AsyncToken| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
このメソッドは実際に getItem 操作を実行しますが、管理対象の結果の更新に結果ハンドラーは使用されません。このメソッドは、操作を呼び出すためにデフォルトの getItem 実装によって使用されます。競合検出が有効になっている場合は、更新操作または削除操作に対するフォルトを受信すると、このメソッドが呼び出してオブジェクトの現在のサーバーバージョンが取得されるので、フォルトが競合によるものであるかどうかを判断し、その競合を解決できます。
パラメーター
dataManager:RPCDataManager — 関連付けられているデータマネージャーです。
| |
identity:Object — 取得するアイテムの ID です。
| |
defaultValue:Object (default = null) | |
includeSpecifier:PropertySpecifier (default = null) |
mx.rpc:AsyncToken — 結果を取得する AsyncToken の結果プロパティにバインドする AsyncToken です。または、結果プロパティ変更イベントをリスニングし、1 つ以上の応答側をトークンに追加し、トークンの動的プロパティとして追加情報を追加して、操作の結果を追跡できます。
|
pageQuery | () | メソッド |
public function pageQuery(dataManager:RPCDataManager, queryName:String, queryArgs:Array, startIndex:int, numItems:int):mx.rpc:AsyncToken| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
クライアント側クエリの単一ページに対するクエリを実行します。このメソッドは、ManagedQuery で pagingEnabled が設定されると呼び出されます。クライアントコードは、通常のクエリパラメーターのみを使用して、通常どおりにクエリを呼び出します。この呼び出しを行う前に、管理レイヤーで startIndex パラメーターと numItems パラメーターが挿入されます。
パラメーター
dataManager:RPCDataManager — 呼び出されるクエリ操作の制御でのマネージャーです。
| |
queryName:String — クエリ名です。
| |
queryArgs:Array — クエリ操作の呼び出しに対する引数です。
| |
startIndex:int — 取得するページの開始インデックスです。
| |
numItems:int — ページのサイズです。
|
mx.rpc:AsyncToken — このトークンを使用すると、このクエリ操作の結果またはフォルトイベントを受け取るためのコールバック関数を登録できます。このトークンは、ResultEvent.RESULT または FaultEvent.FAULT の call プロパティでも返されます。このオブジェクトにはカスタムデータを添付することができ、そのデータは後のイベント処理段階で検査できます。
|
postItemDeletion | () | メソッド |
public function postItemDeletion(dataManager:RPCDataManager, identity:Object):void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3.1 |
| ランタイムバージョン: | Flash Player 9, AIR 1.5 |
アイテムの削除に対応するサーバーからのイベントをシミュレートします。これは、サーバー上で何かが削除されたことを LCDS に通知するときに便利です。
パラメーター
dataManager:RPCDataManager — 関連付けられているデータマネージャーです。
| |
identity:Object — 削除されるアイテムの ID です。
|
postItemUpdate | () | メソッド |
public function postItemUpdate(dataManager:RPCDataManager, item:Object, origItem:Object = null, changes:Array = null):void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3.1 |
| ランタイムバージョン: | Flash Player 9, AIR 1.5 |
アイテムの更新または作成に対応するサーバーからのイベントをシミュレートします。これは、サーバー上で何かが変更されたことを LCDS に通知するときに便利です。
パラメーター
dataManager:RPCDataManager — 関連付けられているデータマネージャーです。
| |
item:Object — 更新されたアイテムです。
| |
origItem:Object (default = null) | |
changes:Array (default = null) |
processDataMessage | () | メソッド |
public function processDataMessage(msg:IMessage, responder:IResponder):void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
データメッセージを処理するために DataManager によって使用される低レベルのメソッドです。このメソッドは、データメッセージをアダプターインターフェイスへの呼び出しに変換するので、通常はいずれかの操作をオーバーライドできます。
パラメーター
msg:IMessage — 処理するメッセージです。
| |
responder:IResponder — メッセージの処理が完了したときにコールバックする応答側です。
|
rpcAdapterFault | () | メソッド |
protected function rpcAdapterFault(ev:FaultEvent, token:mx.rpc:AsyncToken):void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
RPCDataService 操作のフォルト応答側です。適切なエラーメッセージを作成し、それをトークンの応答側チェーンに伝播することで、フォルトを処理します。
パラメーター
ev:FaultEvent — サーバーから受信したフォルトイベントです。
| |
token:mx.rpc:AsyncToken — 呼び出しに関連付けられているトークンです。
|
sendResultEvent | () | メソッド |
protected function sendResultEvent(token:mx.rpc:AsyncToken, msg:IMessage):void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
RPCDataService 操作の成功応答側です。受信したメッセージをメッセージイベントにラップし、それをトークンの応答側チェーンに伝播します。
パラメーター
token:mx.rpc:AsyncToken — 呼び出しに関連付けられているトークンです。
| |
msg:IMessage — サーバーから受信した結果メッセージです。
|
startCheckForConflict | () | メソッド |
public function startCheckForConflict(dmgr:RPCDataManager, cause:DataMessage, errMsg:ErrorMessage = null):void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
これは、競合の可能性を示すフォルトをサーバーから受け取ると呼び出されます。競合状態にあるアイテムの現在の値を取得し、変更を適用しようとしたときの元のアイテムと比較します。相違がある場合は、競合として扱われます。
パラメーター
dmgr:RPCDataManager — このアダプターの宛先に関連付けられているデータマネージャーです。
| |
cause:DataMessage — 競合の原因になった可能性のある元のデータメッセージです。
| |
errMsg:ErrorMessage (default = null) |
updateCollection | () | メソッド |
public function updateCollection(dataManager:RPCDataManager, mq:ManagedQuery, ucmsg:UpdateCollectionMessage):mx.rpc:AsyncToken| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
これは、（関連付けではなく）クエリによって管理されているコレクションにアイテムが追加されたとき、またはそのようなコレクションからアイテムが削除されたときに呼び出されます。個々の変更のリストを含む単一のメッセージがあります。通常は、クライアント上で加えられた変更を保持するためにそれらの変更を残す必要はないので、このメソッドをオーバーライドする必要はありません。
ただし、クエリを使用して多対多関係などの関連付けを実装する場合は、これらの操作の実行時にに行を追加または削除すると便利な場合があります。
RPCDataServiceAdapter の実装は、これらを個々の追加と削除の呼び出しにマップします。
パラメーター
dataManager:RPCDataManager — このアダプターの宛先に関連付けられているデータマネージャーです。
| |
mq:ManagedQuery — アイテムが追加または削除された管理対象のクエリです。
| |
ucmsg:UpdateCollectionMessage — 追加または削除されたアイテムの詳細が示されているコレクションメッセージを更新します。
|
mx.rpc:AsyncToken — このサービスから送出される結果またはフォルトイベントにおいてこの操作を識別するトークンへの AsyncToken 参照です。
|
updateItem | () | メソッド |
public function updateItem(dataManager:RPCDataManager, item:Object, origItem:Object, changes:Array):mx.rpc:AsyncToken| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
このメソッドは、特定の updateItem 操作を実行するために RPCDataServiceAdapter によって呼びだされます。このメソッドは、アイテムの新しいバージョン、このクライアント上で修正される前のそのアイテムの元のバージョン、および変更されるプロパティのリストを受け取ります。デフォルトの実装では、type="update" の ManagedOperation が検索されて呼び出されます。管理対象の操作は、少なくともアイテムの新しいバージョンをパラメーターとして取る必要があります。さらに、origItem および changes という特別な名前を持つパラメーターが宣言されている場合は、それらのパラメーターもリモートサービスに渡されます。
パラメーター
dataManager:RPCDataManager — データマネージャーです。
| |
item:Object — アイテムの新しいバージョンです。
| |
origItem:Object — 元のアイテムです。
| |
changes:Array — 変更するプロパティのリストです。
|
mx.rpc:AsyncToken — このサービスから送出される結果またはフォルトイベントにおいてこの操作を識別するトークンへの AsyncToken 参照です。
|
Tue Jun 12 2018, 10:34 AM Z