| パッケージ | mx.data |
| クラス | public dynamic class ItemReference |
| 継承 | ItemReference  AsyncToken EventDispatcher Object |
| 実装 | IItemReference |
| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
DataService.getItem() および DataService.createItem() メソッドからは ItemReference インスタンスが返されます。このクラスが拡張する AsyncToken の実装は、アイテムを取得する操作（get または create）で発生した結果およびフォルトイベントの通知を受け取る応答側のリストを提供します。バインディングは、管理対象インスタンスへの参照を常に維持する result プロパティの値に対して実行できます。アイテムが別のクライアントで削除された場合は、result プロパティが null に設定されます。フォルトが発生して DatService インスタンスがアイテムを取得できない場合は、invalid プロパティが true に設定されます。エラーの原因についての詳細を取得するには、フォルトイベントをリスニングします。
この管理対象アイテムへの参照を解放するには、ItemReference.releaseItem() メソッドを呼び出します。これは DataService.releaseItem() メソッドの呼び出しと似ていますが、DataService.releaseItem() とは異なり、このメソッドは、最初に発見されたその型のアイテムインスタンスではなく、この参照を解放します。これは、複数の getItem() メソッドの呼び出しでアプリケーションの異なる部分から同じアイテムが取得された場合に発生します。
パブリックプロパティ
継承されるパブリックプロパティを隠す
継承されるパブリックプロパティを表示| プロパティ | 定義元 | ||
|---|---|---|---|
 | constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。 | Object | |
| message : IMessage [読み取り専用]
関連付けられているメッセージへのアクセスを提供します。 | AsyncToken | |
| responders : Array [読み取り専用]
非同期要求が完了すると呼び出される IResponder ハンドラーの配列です。 | AsyncToken | |
| result : Object [読み取り専用]
関連付けられている RPC 呼び出しが返す結果です。 | AsyncToken | |
| valid : Boolean
アイテムの取得を試みたときにサーバーからフォルトが返されたために、または取得したアイテム自体が null であったために ItemReference が無効になった場合は、これを false に設定します。 | ItemReference | ||
パブリックメソッド
| メソッド | 定義元 | ||
|---|---|---|---|
ItemReference(msg:IMessage)
コンストラクターです。 | ItemReference | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。 | EventDispatcher | |
|
応答側の配列に応答側を追加します。 | AsyncToken | |
|
イベントをイベントフローに送出します。 | EventDispatcher | |
|
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。 | EventDispatcher | |
|
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
|
このトークンに少なくとも 1 つの mx.rpc.IResponder が登録されているかどうかを判断します。 | AsyncToken | |
|
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
|
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
この ItemReference を返した getItem() または createItem() メソッドの呼び出しで取得された管理対象アイテムの参照を解放します。 | ItemReference | ||
|
EventDispatcher オブジェクトからリスナーを削除します。 | EventDispatcher | |
|
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
|
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | |
|
指定されたオブジェクトのストリング表現を返します。 | Object | |
|
指定されたオブジェクトのプリミティブな値を返します。 | Object | |
|
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。 | EventDispatcher | |
プロパティの詳細
valid | プロパティ |
valid:Boolean| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
アイテムの取得を試みたときにサーバーからフォルトが返されたために、または取得したアイテム自体が null であったために ItemReference が無効になった場合は、これを false に設定します。このプロパティを使用してユーザーインターフェイスコントロールにバインドすると、明示的なフォルトイベントをリスニングしなくても、このアイテムに関するステータス情報を表示できます。
このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 propertyChange イベントが送出されます。
実装
public function get valid():Boolean public function set valid(value:Boolean):voidコンストラクターの詳細
ItemReference | () | コンストラクター |
メソッドの詳細
releaseItem | () | メソッド |
public function releaseItem(copyStillManagedItems:Boolean = true, enableStillManagedCheck:Boolean = true):void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
この ItemReference を返した getItem() または createItem() メソッドの呼び出しで取得された管理対象アイテムの参照を解放します。同じクライアント上の同じアイテムを参照する ItemReference は複数存在する可能性があります。適切な参照を解放するにはこのメソッドを使用します。
パラメーター
copyStillManagedItems:Boolean (default = true)DataService.getItem() の複数回呼び出された場合、または DataService.fill() の呼び出しから返されたコレクションによってこのアイテムが参照されている場合に発生する可能性があります。
| |
enableStillManagedCheck:Boolean (default = true) |
Tue Jun 12 2018, 10:34 AM Z