| パッケージ | mx.data |
| クラス | public class DataService |
| 継承 | DataService  DataManager Object |
| サブクラス | DataService |
| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
DataService インスタンスは、適切な宛先を指定して作成されます。通常、宛先は services-config.xml ファイルから設定されますが、モデル主導の開発の場合と同様に、ランタイム用の設定で動的に設定することもできます。
指定したリモート宛先からデータを取得するメソッドは 2 種類あります。1 つはコレクション管理対象オブジェクト用のものです。もう 1 つは Single Managed Object（SMO）用のものです。
コレクション管理対象オブジェクトの場合、DataService.fill() メソッドを使用します。このメソッドを使用すると、このサービスによって管理されるオブジェクトを使用して ArrayCollection の内容が設定されます。
Single Managed Object（SMO）を取得するには、DataService.getItem() メソッドおよび DataService.createItem() メソッドを使用します。
内容設定済みの ArrayCollection が不要になったとき、またはそのコレクション内のアイテムに対する更新の受信および作成が不要になったときは、DataService.releaseCollection() メソッドを呼び出します。
DataService.getItem() または DataService.createItem() を使用して前に取得したアイテムが不要になった場合、または更新を受信または作成しない場合、DataService.releaseItem() メソッドを呼び出します。DataService.createItem() メソッドと DataService.getItem() メソッドは ItemReference インスタンスを返します。ItemReference は Single Managed Object（SMO）の特定のインスタンスを解放するときに使用します。DataService.releaseItem() メソッドとは異なり、ItemReference.releaseItem() メソッドを呼び出すと Single Managed Object（SMO）の特定のインスタンスが解放されます。DataService.releaseItem() メソッドは、指定した ID と一致する ID で検出された最初の Single Managed Object（SMO）を解放します。これは、DataService.getItem() メソッドおよび DataService.createItem() メソッドの呼び出しの数が DataService.releaseItem() メソッドの呼び出しの数と一致している限り問題ありません。
接続を必要とするメソッドが初めて呼び出されると、リモート宛先への接続が自動的に作成されます。例えば、未コミットの更新があるときに DataService.fill() メソッドまたは DataService.commit() メソッドを呼び出すと、DataService インスタンスはリモート宛先への接続を確立しようとします。DataService インスタンスの接続を強制的に解除するには、DataService.disconnect() メソッドを呼び出します。不要になったリモート宛先リソースをクリーンアップするには、DataService.disconnect() メソッドを使用できます。他のサービスで同じ物理接続が使用されている可能性があるため、DataService.disconnect() メソッドを呼び出すと接続が終了する場合があります。
バインド可能な connected プロパティは、関連付けられている DataService 接続の現在の状態を示します。
リモート宛先が操作のセキュリティ制約を宣言した場合、DataService.setCredentials() メソッドを呼び出して資格情報を提供する必要があります。DataService.setCredentials() メソッドを呼び出すと、リモート宛先ではログインコマンドになります。資格情報を変更するか、現在のセッションを無効にするには、DataService.logout() メソッドを呼び出します。これにより、すべてのローカルで管理されているデータが解放されます。DataService.logout() メソッドの呼び出しは DataService.release() メソッドの呼び出しと同等です。
各 DataService インスタンスには mx.data.DataStore 型のオブジェクトを返す dataStore プロパティがあります。このオブジェクトには、1 つ以上の DataService インスタンスに関する未コミットの変更が格納されています。デフォルトでは、DataService インスタンスは、管理対象の関連付けプロパティを持ち、同じチャネルセットを共有している他のデータサービスと同じ DataStore を共有します。DataStore インスタンスを共有しているときに、1 つの DataService インスタンス上で commit() メソッドを呼び出すと、共有 DataStore インスタンスを使用しているすべての DataService インスタンスが変更されます。関連付けられている DataService インスタンスに加えられた変更の間に依存関係がある場合、操作の順序は維持されます。
DataService インスタンスと DataStore インスタンスは、リモート呼び出しを必要とするすべての操作の結果およびフォルトイベントを送出します。
メモ：同じ宛先をポイントする 2 つの DataService インスタンスを作成した場合、どちらのインスタンスも同じ管理対象オブジェクトのコレクションを共有し、同じイベントを送出します。例えば、1 つの DataService インスタンスに宛先としてイベントリスナーを追加し、別のインスタンスを使用して操作を開始した場合、最初の DataService インスタンスは引き続きそれらのイベントを受け取ります。DataService インスタンスに対して操作を開始するたびに、AsyncToken インスタンスが返されます。その AsyncToken トークンにイベントの応答側を追加すると、その操作に固有の結果イベントを受信できます。一般に、この方法を使用すると、特定の宛先に対して結果またはフォルトイベントハンドラーをグローバルに追加するよりもコードが簡潔になります。
DataService インスタンスの管理対象オブジェクトのすべてのプロパティでデータバインディングを使用できます。管理対象オブジェクトに対してリモート操作が発生すると、DataService インスタンスは「メッセージ」イベントも送出します。例えば、リモートプロセスでローカルで管理されているアイテムを更新すると、そのアイテムを管理しているすべての DataService インスタンスに対してメッセージがプッシュされます。このメッセージは、MessageEvent.MESSAGE イベントとして送出されます。
リモート宛先で DataService インスタンスがコミットする変更に対する応答として、またはローカルの未コミットの変更と競合するプッシュされた変更によって、競合イベントは送出されます。DataConflictEvent.CONFLICT をリスニングすることで競合イベントを処理できます。DataService.conflicts.resolved プロパティにバインディングすることで、データバインディングを使用してユーザーインターフェイスコントロールを更新します。
DataService クラスは、次のデータ同期設定モードをサポートしています。
-
autoCommit- true の場合、変更が検出されるたびに、各変更が直ちにリモート宛先へ送信されます。これがfalseの場合、commit()メソッドを明示的に呼び出す必要があります。未コミットの変更があるかどうかを判断するには、バインド可能なDataService.commitRequiredプロパティを使用します。 -
autoSyncEnabled- これはfill()、getItem()、createItem()の各メソッドの呼び出しに適用され、他のクライアントによってこれらのオブジェクトに加えられた変更、またはリモート宛先で DataServiceTransaction サーバープッシュ API を使用して加えられた変更を、管理対象インスタンスでリスニングするかどうかを決定します。 -
autoMerge- リモート宛先から受信した変更を直ちに適用するか、DataService.merge()メソッドの呼び出しが行われるまで待機するかを制御します。
特定のアイテムまたはすべてのアイテムに対する変更を元に戻すには、DataService.revertChanges() メソッドを使用します。リモート宛先の操作でエラーが発生すると、リモート宛先のデータとの同期を維持するために、コミット済みの変更が未コミットのキューに戻されます。変更がエラーになった場合、通常は、フォルトハンドラーの一部として DataService.revertChanges() メソッドを呼び出して変更を取り消します。
mx.data.mxml.DataService クラスは MXML 固有の mx.data.DataService クラスのサブクラスであり、これを使用すると DataService インスタンスのプロパティへのバインドが可能になります。
MXML シンタックス
MXML シンタックスを表示
MXML シンタックスを隠すThe <mx:DataService> element accepts the following attributes:
<mx:DataService Properties autoCommit="true" autoMerge="true" autoSaveCache="false" autoSyncEnabled="true" conflictDetector="No default." dataStore="No default." destination="No default." pageSize="No default." id="No default." Events conflict="No default." fault="No default." message="No default." propertyChange="No default." result="No default." />
関連する API エレメント
mx.data.Conflicts
mx.data.Conflict
mx.data.ItemReference
mx.data.IManaged
mx.data.utils.Managed
mx.data.IChangeObject
| プロパティ | 定義元 | ||
|---|---|---|---|
 | adapter : DataServiceAdapter = null
サーバーとの対話を制御するクラスのインスタンスです。 | DataManager | |
| autoCommit : Boolean
ローカルキャッシュに対する変更を自動的にコミットするかどうかを示します。 | DataManager | |
| autoConnect : Boolean
接続を必要とする操作を処理する場合に、このサービスで接続を試みる必要があるかどうかを示します。 | DataManager | |
| autoMerge : Boolean
false に設定した場合、リモート宛先からクライアントにプッシュされた変更は、直ちには適用されません。 | DataManager | |
| autoSaveCache : Boolean
データのローカルキャッシュと変更をディスクに格納できます。 | DataManager | |
| autoSyncEnabled : Boolean
これを true に設定して、fill()、createItem()、または getItem() 要求を発行すると、リモート宛先からこれらのアイテムに加えられた更新をリスニングするアイテムが返されます。 | DataManager | |
| cacheID : String
このサービスのキャッシュ識別子へのアクセスを提供します。 | DataManager | |
| channelSet : ChannelSet
サービスが使用する ChannelSet へのアクセスを提供します。 | DataService | ||
| commitRequired : Boolean [読み取り専用]
未コミットの変更があり、commit() メソッドを呼び出す必要があるかどうかを示します。 | DataManager | |
| conflictDetector : ConflictDetector
この DataManager インスタンスにプッシュされたリモート操作に関する競合を検出するために使用されている現在の実装へのアクセスを提供します。 | DataManager | |
| conflicts : Conflicts [読み取り専用]
Conflicts オブジェクト（Conflict インスタンスの ArrayList）を格納します。 | DataManager | |
| connected : Boolean [読み取り専用]
DataService がリモート宛先に接続されているかどうかを示します。 | DataManager | |
| constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。 | Object | |
| dataStore : DataStore
mx.data.DataStore 型のオブジェクトを含みます。 | DataManager | |
| deleteItemOnRemoveFromFill : Boolean
デフォルトでは、既に内容が設定された管理対象のコレクションに対して removeItemAt() メソッドを呼び出すと、サーバーに対してアイテム削除要求が発行され、アイテムが物理的に削除されます。 | DataManager | |
| destination : String [読み取り専用]
このサービスが関連付けられているリモート宛先を示します。 | DataService | ||
| encryptLocalCache : Boolean
SQL オフラインアダプターを使用する AIR クライアントに対して、オフラインストレージを暗号化するかどうかを示します。 | DataManager | |
| fallBackToLocalFill : Boolean
このフラグによって、アプリケーションに接続していない場合はアプリケーションがローカルストアに対してクエリするかどうかを決定します。 | DataManager | |
| hierarchicalEventsDefault : Boolean
関連付けでは、オプションで、関連付けられているインスタンスのプロパティに対するプロパティ変更イベントがリストされます。 | DataManager | |
| ignoreCollectionUpdates : Boolean
コミット時にサーバーに対して通信する代わりに、管理対象コレクションに対する変更を無視するかどうかを示します。 | DataManager | |
| indexReferences : Boolean
他のアイテムの関連付けプロパティからこの DataManager によって管理されるアイテムへの参照または fill の数が少ない場合は、このプロパティを false に設定することで、アプリケーションの速度を改善できます。 | DataManager | |
| isInitialized : Boolean [読み取り専用]
この DataManager インスタンスと関連付けられているメタデータを初期化するかどうかを示します。 | DataManager | |
| manualSync : ManualSyncConfiguration
DataManager インスタンスごとに ManualSyncConfiguration インスタンスへのアクセスを提供します。 | DataManager | |
| maxFrequency : uint
DataManager インスタンスが 1 秒間に受信できるメッセージの最大数を指定します。 | DataManager | |
| mergeRequired : Boolean [読み取り専用]
マージが必要な保留状態の変更があるかどうかを示します。 | DataManager | |
| offlineAdapter : DataServiceOfflineAdapter
mx.data.DataServiceOfflineAdapter 型のオブジェクトを返します。 | DataManager | |
| pageSize : int
すべてのコレクションに関する現在のページサイズ設定へのアクセスを提供します。 | DataManager | |
| pagingEnabled : Boolean [読み取り専用]
ページングされた要求を許可するようにリモート宛先が設定されているかどうかを示します。 | DataManager | |
| priority : int
DataManager インスタンスが送信するメッセージのデフォルトのメッセージ優先度です。 | DataManager | |
| requestTimeout : int
操作の要求タイムアウト（秒単位）へのアクセスを提供します。 | DataManager | |
| resetCollectionOnFill : Boolean
プロパティが true の場合は、fill 操作の完了後に RESET イベントが送信されます。 | DataManager | |
| resubscribeAttempts : int
接続を解除された DataManager インスタンスが、宛先に対して再サブスクライブを試行する回数を制御します。 | DataManager | |
| resubscribeInterval : int
再サブスクライブの試みの間の遅延を制御します（ミリ秒単位）。 | DataManager | |
| saveCacheRequired : Boolean [読み取り専用]
ローカルキャッシュに保存されていない変更があるので、saveCache() メソッドを呼び出す必要があるかどうかを示します。 | DataManager | |
| subscribed : Boolean [読み取り専用]
DataManager インスタンスがリモート宛先にサブスクライブされているかどうかを示します。 | DataManager | |
| throwItemPendingErrors : Boolean
取得に時間がかかるデータやページングされていないデータにアクセスしたときに ItemPending エラーがスローされないようにするには、このプロパティを false に設定します。 | DataManager | |
| メソッド | 定義元 | ||
|---|---|---|---|
DataService(destination:String)
指定した宛先で DataService インスタンスを構築します。 | DataService | ||
|
以前の saveCache() メソッドの呼び出しによってディスクに格納されたデータ、または autoSaveCache メソッドが true に設定されている間にディスクに格納されたデータを消去します。
| DataManager | |
|
渡された記述子で指定されているデータをローカルストアから消去します。 | DataManager | |
|
この DataManager インスタンスに関連付けられている DataStore インスタンスによって現在管理されているすべてのコレクションに対する保留中の変更をコミットします。 | DataManager | |
|
このオブジェクトについて保留状態の変更があるかどうかを示します。 | DataManager | |
|
このサービスからリモート宛先への接続を強制的に試みます。 | DataManager | |
|
リモート宛先に対して count メソッドを呼び出します。 | DataManager | |
|
指定したアイテムをリモートストア内に作成するように要求します。 | DataManager | |
|
指定したアイテムをリモートストアから削除するように要求します。 | DataManager | |
|
DataManager インスタンスのネットワーク接続を解除します。 | DataManager | |
|
指定された名前と引数を使用してクエリを実行します。 | DataManager | |
|
宛先に関連付けられた塗りつぶし方式に基づいて、指定された ListCollectionView（コレクション）インスタンスを塗りつぶします。 | DataManager | |
|
宛先に関連付けられた塗りつぶし方式に基づいて、指定された ListCollectionView（コレクション）インスタンスを塗りつぶします。 | DataManager | |
|
単一のアイテムを返すクエリを実行します。 | DataManager | |
|
ArrayCollection または Single Managed Object（SMO）をローカルストアから返します。 | DataManager | |
| getCacheDescriptors(view:ListCollectionView, options:uint = 0, item:Object = null):mx.rpc:AsyncToken
指定した ListCollectionView（コレクション）インスタンスを CacheDataDescriptor インスタンスで塗りつぶします。 | DataManager | |
|
指定した ListCollectionView（コレクション）インスタンスを、アプリケーションで前に使用したすべてのキャッシュ識別子で塗りつぶします。 | DataManager | |
|
指定した ID に一致するアイテムの非同期要求を行います。 | DataManager | |
|
特定の ID を持つアイテムを検索します。 | DataManager | |
|
指定したコレクションのページ情報を返します。 | DataManager | |
|
指定したアイテムに関連する、メッセージキャッシュ内で保留状態の操作を返します。 | DataManager | |
|
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
|
DataStore を強制的に初期化します。 | DataManager | |
|
渡されたコレクションがこのサービスによって管理されている場合は true を返します。 | DataManager | |
|
渡されたコレクションでページング機能が使用されている場合は true を返します。 | DataManager | |
|
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
|
指定した範囲のアイテムがすべてページングの対象に含まれる場合は true を返します。 | DataManager | |
|
関連する <fill-method> 要素（ローカルストアのデータ）に基づいて、指定した ListCollectionView を塗りつぶします。 | DataManager | |
DataService の宛先からユーザーをログアウトします。 | DataService | ||
|
保留状態のすべての更新を、管理対象のオブジェクトのセットにマージします。 | DataManager | |
|
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
|
この DataManager インスタンスによって管理されているすべてのデータを更新します。 | DataManager | |
|
fill メソッドによって既に内容が設定されたコレクション、または管理対象の関連付けとして管理されている配列コレクションを更新します。 | DataManager | |
|
DataManager インスタンスの管理対象コレクションとアイテムをすべて解放します。 | DataManager | |
| releaseCollection(view:ListCollectionView, clear:Boolean = false, copyStillManagedItems:Boolean = true):void
指定したコレクション内のすべてのアイテムを、この DataManager インスタンスの管理対象から解放します。 | DataManager | |
| releaseItem(item:IManaged, copyStillManagedItems:Boolean = true, enableStillManagedCheck:Boolean = true):IManaged
指定したアイテムをこの DataManager インスタンスの管理対象から解放します。 | DataManager | |
|
指定した範囲に含まれるコレクション内のアイテムを解放します。 | DataManager | |
|
単一値の関連付けの値を解放します。 | DataManager | |
|
指定したアイテムに対する未コミットの変更を元に戻します。 | DataManager | |
|
指定したコレクションに含まれ、この DataManager インスタンスで管理する必要があるアイテムに加えられたすべての変更を元に戻します。 | DataManager | |
|
このメソッドで、DataManager インスタンスのキャッシュの現在の状態が保存されます。 | DataManager | |
|
ローカルキャッシュに保存されていないこのオブジェクトに対する保留状態の変更があるかどうかを示します。 | DataManager | |
この DataService 宛先にアクセスするための資格情報を設定します。 | DataService | ||
|
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
この DataService 宛先のサードパーティーにアクセスするための資格情報を設定します。 | DataService | ||
|
このデータサービス（データマネージャー）で以前に実行されたすべての fill に対して変更されたアイテムを取得します。 | DataManager | |
| [静的]
すべてのローカルデータの同期を許可するコンビニエンスメソッドです。synchronizeAllFills() の個々の呼び出しがすべて完了したときにのみ最終結果トークンが完了するように指定された各データサービス（データマネージャー）で、synchronizeAllFills() が呼び出されます。 | DataManager | |
|
fill または synchronizeFill が前回呼び出されてから、サーバーで変更されたアイテムを取得します。 | DataManager | |
|
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | |
|
指定されたオブジェクトのストリング表現を返します。 | Object | |
|
指定したアイテムに対する更新をトリガーします。 | DataManager | |
|
指定されたオブジェクトのプリミティブな値を返します。 | Object | |
| イベント | 概要 | 定義元 | ||
|---|---|---|---|---|
| ローカルで保留状態の変更と別のクライアントによって送信された変更の間で競合が検出された場合、またはこのクライアントによって送信された変更がリモート宛先での変更と競合している場合は、DataConflictEvent.CONFLICT イベントが送出されます。 | DataService | |||
| エラーが発生してサービスの呼び出しに失敗すると、DataServiceFaultEvent.FAULT イベントが送出されます。 | DataService | |||
| リモート宛先からデータ操作に関する通知がプッシュされると、MessageEvent.MESSAGE イベントが送出されます。 | DataService | |||
| このサービスのプロパティが変更されると、PropertyChangeEvent.PROPERTY_CHANGE イベントが送出されます。 | DataService | |||
| サービスの呼び出しに成功すると、ResultEvent.RESULT イベントが送出されます。 | DataService | |||
channelSet | プロパティ |
channelSet:ChannelSet| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
サービスが使用する ChannelSet へのアクセスを提供します。 ChannelSet は手動で作成して割り当てることができます。また、このサービスの destination に対して設定済みのチャネルを使って、動的に作成することもできます。
実装
public function get channelSet():ChannelSet public function set channelSet(value:ChannelSet):voiddestination | プロパティ |
DataService | () | コンストラクター |
public function DataService(destination:String)| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
指定した宛先で DataService インスタンスを構築します。宛先の名前は、LiveCycle Data Service 設定ファイルまたはランタイム設定で設定した宛先の参照にする必要があります。
パラメーターdestination:String — 目的の宛先の名前を含みます。
|
logout | () | メソッド |
public function logout():void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
DataService の宛先からユーザーをログアウトします。宛先からのログアウトは、サーバー設定で指定されているものと同じ ChannelSet を使用して接続されているあらゆるものに適用されます。例えば、my-rtmp チャネル上で接続しており、DataService インスタンスのいずれかを使用してログアウトすると、同じ ChannelSet 上で接続していたあらゆるユーザーがログアウトされます。
メモ：このメソッドではなく mx.messaging.ChannelSet.logout() メソッドを使用することをお勧めします。
関連する API エレメント
setCredentials | () | メソッド |
public function setCredentials(username:String, password:String):void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
この DataService 宛先にアクセスするための資格情報を設定します。証明書は、同じ ChannelSet 上で接続されているすべてのサービスに適用されます。
パラメーター
username:String — 宛先のユーザー名です。
| |
password:String — 宛先にアクセスするためのパスワードです。
|
setRemoteCredentials | () | メソッド |
public function setRemoteCredentials(username:String, password:String):void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
この DataService 宛先のサードパーティーにアクセスするための資格情報を設定します。
パラメーター
username:String — 宛先のユーザー名です。
| |
password:String — 宛先のパスワードです。
|
conflict | イベント |
mx.data.events.DataConflictEventプロパティ DataConflictEvent.type =
mx.data.events.DataConflictEvent.CONFLICT| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
ローカルで保留状態の変更と別のクライアントによって送信された変更の間で競合が検出された場合、またはこのクライアントによって送信された変更がリモート宛先での変更と競合している場合は、DataConflictEvent.CONFLICT イベントが送出されます。各 DataService インスタンスは、この宛先のアイテムに関する競合イベントのみを送信します。
関連する複数の宛先の競合を一度に処理する必要がある場合は、DataService で競合イベントを使用します。
CONFLICT 定数により、conflict イベントのイベントオブジェクトの type プロパティ値が定義されます。
イベントオブジェクトの各プロパティには次の値が設定されています。
| プロパティ | 値 |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | イベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、myButton の値は currentTarget となります。 |
conflict | 発生した競合を保持する Conflict オブジェクトです。 |
message | このイベントに関連付けられたメッセージです。 |
target | イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。 イベントを受け取るオブジェクトに常にアクセスするには、currentTarget プロパティを使用してください。 |
fault | イベント |
mx.data.events.DataServiceFaultEventプロパティ DataServiceFaultEvent.type =
mx.data.events.DataServiceFaultEvent.FAULT| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
エラーが発生してサービスの呼び出しに失敗すると、DataServiceFaultEvent.FAULT イベントが送出されます。例えば、このイベントは、fill() メソッドの呼び出しに失敗した場合などに送出されます。また、このイベントは、コミット結果の一部としてエラーを生成する各アイテムに関しても送出されます。その場合は、コミットによって返されたトークンが DataServiceFaultEvent に含まれていますが、フォルト内のアイテムおよびエラーメッセージのストリングは、エラーの原因になったアイテムごとに異なります。
FAULT 定数により、fault イベントのイベントオブジェクトの type プロパティ値が定義されます。
イベントオブジェクトの各プロパティには次の値が設定されています。
| プロパティ | 値 |
|---|---|
bubbles | false |
cancelable | true。関連付けられたトークンの responder.fault メソッドから preventDefault() を呼び出すと、サービスまたは処理がこのイベントを送出しなくなります。 |
currentTarget | イベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、myButton の値は currentTarget となります。 |
fault | 発生した競合を保持する Fault オブジェクトです。 |
item | フォルトが発生したアイテムです。 |
identity | フォルトが発生したアイテムの ID です。 |
message | このイベントに関連付けられたメッセージです。 |
token | メソッドの呼び出しを表すトークン。Asynchronous Completion Token パターンで使用されます。 |
target | イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。 イベントを受け取るオブジェクトに常にアクセスするには、currentTarget プロパティを使用してください。 |
message | イベント |
mx.messaging.events.MessageEventプロパティ MessageEvent.type =
mx.messaging.events.MessageEvent.MESSAGE| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
リモート宛先からデータ操作に関する通知がプッシュされると、MessageEvent.MESSAGE イベントが送出されます。例えば、リモート宛先でデータが更新されると、その変更をリスニングしているすべてのクライアントに更新操作が送信され、その操作はこの DataService インスタンスでメッセージイベントに変換されます。
この定数の値は "message" です。
イベントオブジェクトの各プロパティには次の値が設定されています。
| プロパティ | 値 |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | イベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、myButton の値は currentTarget となります。 |
message | このイベントに関連付けられたメッセージです。 |
target | イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。 イベントを受け取るオブジェクトに常にアクセスするには、currentTarget プロパティを使用してください。 |
propertyChange | イベント |
mx.events.PropertyChangeEventプロパティ PropertyChangeEvent.type =
mx.events.PropertyChangeEvent.PROPERTY_CHANGE| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
このサービスのプロパティが変更されると、PropertyChangeEvent.PROPERTY_CHANGE イベントが送出されます。この動作は次のプロパティに関して発生します。
commitRequiredmergeRequiredconnected
PropertyChangeEvent.PROPERTY_CHANGE 定数により、イベントオブジェクトの type プロパティ値が PropertyChange イベント用に定義されます。
イベントオブジェクトの各プロパティには次の値が設定されています。
| プロパティ | 値 |
|---|---|
bubbles | コンストラクターによって決定されます。デフォルトは false です。 |
cancelable | コンストラクターによって決定されます。デフォルトは false です。 |
kind | 変更の種類。PropertyChangeEventKind.UPDATE または PropertyChangeEventKind.DELETE のいずれかです。 |
oldValue | 元のプロパティの値です。 |
newValue | 新しいプロパティの値（存在する場合）です。 |
property | 変更されたプロパティです。 |
source | 変更されたプロパティを含むオブジェクトです。 |
currentTarget | イベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、myButton の値は currentTarget となります。 |
target | イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。 イベントを受け取るオブジェクトに常にアクセスするには、currentTarget プロパティを使用してください。 |
result | イベント |
mx.rpc.events.ResultEventプロパティ ResultEvent.type =
mx.rpc.events.ResultEvent.RESULT| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
サービスの呼び出しに成功すると、ResultEvent.RESULT イベントが送出されます。例えば、このイベントは、fill() メソッドの呼び出しが成功した場合などに送出されます。
イベントオブジェクトの各プロパティには次の値が設定されています。
| プロパティ | 値 |
|---|---|
bubbles | false |
cancelable | true。関連付けられたトークンの responder.result メソッドから preventDefault() を呼び出すと、サービスまたは処理がこのイベントを送出しなくなります。 |
currentTarget | イベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、myButton の値は currentTarget となります。 |
message | このイベントに関連付けられたメッセージです。 |
target | イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。 イベントを受け取るオブジェクトに常にアクセスするには、currentTarget プロパティを使用してください。 |
result | RPC 呼び出しが返す結果です。 |
token | メソッドの個々の呼び出しを表すトークン。 Asynchronous Completion Token パターンで使用されます。 |
Tue Jun 12 2018, 10:34 AM Z