DataStore  - AS3 ADEP Data Services

true に設定すると、DataService によって管理されている状態に影響する操作が直ちにコミットされるようになります。false に設定する場合は、commit() メソッドを明示的に呼び出して変更をサーバーに送信する必要があります。

デフォルト値： true。

true に設定すると、autoCommit プロパティが true の場合は、コレクションに対する変更が直ちにコミットされます。false に設定すると、コレクションに対して実行した add 操作および remove 操作は、直ちにはコミットされません。

デフォルト値： true。

このプロパティを true に設定して、autoCommit プロパティを true に設定した場合、プロパティ値を変更すると、その変更が自動的にコミットされます。false の場合、VO でプロパティを変更しても、コミットは自動的には呼び出されません。更新をコミットするには、代わりに commit() メソッドを明示的に呼び出すか、DataManager.updateItem() メソッドを呼び出してそのアイテムに対する変更のみをコミットします。

デフォルト値： true。

接続を必要とする操作を処理する場合に、このサービスで接続を試みる必要があるかどうかを示します。サービスが切断されていて、autoConnect が true に設定されている場合、fill()、getItem()、count() などの操作を処理する際には接続が試みられます。状況に応じて接続されるアプリケーション動作を制御するには、このプロパティを使用します。

autoConnect プロパティが true のときにサーバーへの接続を再試行する間隔をミリ秒単位で指定します。

デフォルト値： 5000。

他のクライアントが行う変更がこのクライアントのデータの現在のビューにマージされる方法を制御します。このプロパティが false の場合は、アプリケーションが merge() メソッドを明示的に起動するまで、メッセージがキューに入れられます。このプロパティが true の場合は、変更が到着次第適用されます。アイテムに対する変更がクライアントで保留中で未コミットであり、その変更がマージされた変更と競合する場合は、競合が生成されて、このクライアントの未解決の競合リストに追加されます。このプロパティに対する変更イベントをリスニングすると、マージを適用する必要があるときに通知を受け取ることができます。

データと変更のローカルキャッシュはディスクに格納できます。autoSaveCache を true に設定すると、変更が加えられるたび、またはリモート要求が返されるたびに、データがディスクに保存されます。ディスクに空きがないため、または書き込み権限がないために、データを保存できない場合は、FaultEvent が送出されるか、Fault がスローされます。この値を false（デフォルト）に設定した場合、データとは変更はディスクに保存されません。現在のデータと変更を強制的にローカルに保存するには、saveCache メソッドを使用します。

関連する API エレメント

このサービスのキャッシュ識別子へのアクセスを提供します。ローカルディスクに格納されているデータとの対話が必要な操作を実行するときは、事前にキャッシュ識別子を設定する必要があります。キャッシュ識別子が設定されていない場合は、すべてのキャッシュメソッドとプロパティが不整合と見なされ、ローカルディスクのデータを必要とする操作が行われるときに DataServiceError がスローされます。このプロパティは、ローカルに格納されるデータに対して一意の「セッション」識別子を提供します。開発者は、このプロパティをアプリケーションごとに一意の値に設定する必要があります。null または空のストリングは未設定と見なされます。

この DataStore が使用する ChannelSet へのアクセスを提供します。 ChannelSet は手動で作成して割り当てることができます。また、この DataStore を使用する destinations に対して設定済みのチャネルを使って、動的に作成することもできます。channelSet は、同じ DataStore を使用するすべての DataService オブジェクト間で一致している必要があります。

最初にコミットしたバッチに対する応答をクライアントが待っている間に 2 番目のバッチに対する commit を呼び出した場合に、2 番目にコミットされた変更バッチをいつサーバーに送信するかを制御します。最初のバッチをコミットしたときにサーバーによって加えられる変更に依存する変更が 2 番目のバッチに含まれている場合、そのバッチを直ちにサーバーに送信すると問題が発生する発生する可能性があります。例えば、最初のバッチでサーバーが作成するアイテムを更新するような場合です。サーバーが割り当てる ID をクライアントがまだ受け取っていない場合、更新にはそのアイテムの適切な ID が含まれません。最初のバッチが完了するまで 2 番目のバッチを送信しないように設定すると、時間に依存する一連の変更（カーソル位置を繰り返し更新する場合など）を実行するために必要な時間が長くなる場合があります。

デフォルトのモードは CQ_AUTO です。このモードでは、現在処理中のバッチと次にコミットするバッチの間に単純な依存関係があるかどうかが確認されます。依存関係がないと見なされた場合は、新しいバッチが直ちに送信されます。現在処理中の作成操作に依存する更新操作や削除操作がある場合は、作成が完了するまで更新や削除が保留されます。この設定にすると、依存関係の確認が行われるため、コミットのたびに若干のオーバーヘッドが発生しますが、通常は、他の 2 つのモード（CQ_NOWAIT と CQ_ONE_AT_A_TIME）の利点をうまく折衷できます。

CQ_NOWAIT の場合は、依存関係を確認せずに 2 番目のバッチが直ちに送信されます。クライアント上で新しいオブジェクトに ID を割り当て、パフォーマンスを上げるためにバッチをオーバーラップさせる必要がある場合は、このモードを使用することを推奨します。

CQ_ONE_AT_A_TIME の場合は、前のバッチが完了してから新しいバッチがコミットされます。このモードの場合、前のバッチの処理によるサーバー側での変更がまだ完了していない状態で次のバッチがサーバーに送信されることがないので、エラー処理のロジックは簡潔になります。また、いずれかのバッチの処理でエラーが発生した場合、そのエラーがクライアント側で解決されるまで、次のバッチはサーバーに送信されません。

デフォルト値： CQ_AUTO。

コミットする必要がある保留状態の更新があるかどうかを示します。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 propertyChange イベントが送出されます。

すべての管理対象アイテムに関連する競合のリストです。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 propertyChange イベントが送出されます。

DataStore が接続されているかどうかを示します。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 propertyChange イベントが送出されます。

autoCommit=false のときに、サーバーにコミットされるのを待っている変更の現在のバッチです。このプロパティを使用すると、commit() メソッドを呼び出すことによって適用される変更を繰り返し処理できます。個々のバッチをコミットしたり元に戻したりする操作は、他のバッチと無関係に実行できます。未コミットのバッチはすべて uncommittedBatches プロパティに格納されます。currentBatch プロパティの値は、常に uncommittedBatches リストの最後のバッチです。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 propertyChange イベントが送出されます。

この DataStore の宛先です。

このフラグを設定すると、更新操作または再接続操作の間の競合検出が無効になります。LiveCycle Data Services バージョン 2.6.1 では更新時に競合検出が行われていなかったので、このプロパティを false に設定すると 2.6.1 の動作に戻すことができます。

デフォルト値： true。

一部のローカルディスクキャッシュストレージの実装では、保存されるデータの暗号化がサポートされています。このフラグを true に設定すると、暗号化をサポートするローカルストアの暗号化が有効になります。

このフラグによって、アプリケーションに接続していない場合はアプリケーションがローカルストアに対してクエリするかどうかを決定します。デフォルトで、オフラインアダプターが動的クエリの実行をサポートするように設定されている場合、アプリケーションに接続していないときに fill() を呼び出すと、ローカルストアはクエリされません。fallBackToLocalFill が true に設定されている場合、アプリケーションの接続が解除されるときと同様に、ローカルストアはクエリされます。

この DataStore の識別子です。これは、この DataStore を一意に識別するためにキャッシュ設定と共に使用されるオプションのプロパティです。この値は、セッションに依存しないようにする必要があります。つまり、UIDUtil.createUID() などのメソッドの実行時にこの識別子を作成しないでください。この値を割り当てないと、関連付けられているチャネルに対するサーバー設定の値に基づいて識別子が計算されます。

コミット時にサーバーに対して通信する代わりに、管理対象コレクションに対する変更を無視するかどうかを示します。

この DataStore が初期化されていて使用できる状態かどうかを示します。このプロパティは、実行時に設定されるアプリケーションを使用する場合、またはローカルディスク上にキャッシュされたデータにアクセスする必要がある場合にのみ必要です。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 propertyChange イベントが送出されます。

マージが必要な保留状態の変更があるかどうかを示します。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 propertyChange イベントが送出されます。

この DataStore によって送信されるメッセージのデフォルトのメッセージ優先度です。有効な値は 0 ～ 9（0 が最小）です。-1 の場合、DataStore には優先度が設定されません。メッセージの優先度が既に定義されている場合は、その優先度がこのプロパティよりも優先されることに注意してください。

サーバーからプッシュされた変更がクライアントの管理対象オブジェクトビューに現在マージされているかどうかを示します。これは、autoMerge が true のときには必ず起こります。autoMerge が false の場合、このプロパティは merge メソッドを明示的に呼び出しているときにのみ設定されます。このフラグを使用すると、サーバーからプッシュされた非同期の変更と、設定メソッドでユーザーが加えた変更を区別できます。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 propertyChange イベントが送出されます。

操作の要求タイムアウト（秒単位）へのアクセスを提供します。ゼロ以下の値を設定すると、要求はタイムアウトになりません。

このプロパティを true に設定すると、クライアントがメッセージ処理エラーを受信したときに、既にコミットされているものの、まだサーバーに送信されていないバッチのコミットが取り消されます。commitQueueMode プロパティを ONE_AT_A_TIME に設定し、このプロパティを true に設定すると、一度に 1 つずつバッチエラーを処理できます。このように設定しないと、一連のフォルトからの複数のフォルトを受信する可能性があり、解決が難しくなる場合があります。

デフォルト値： false。

この間隔を設定すると、キャッシュを保存する頻度を下げることができます。autoSaveCache プロパティが true の場合、LiveCycle Data Services は各変更の後でキャッシュを保存します。ある程度の大きさのキャッシュを使用する場合、変更のたびにキャッシュを保存するとリソースの消費量が多くなる可能性があるので、キャッシュの保存頻度を下げたほうがよい場合があります。このプロパティを 1000 ミリ秒に設定すると、キャッシュの保存頻度は 1 秒につき 1 回程度になります。

デフォルト値： 0。

このフラグを false に設定すると、エラーログの動作が LiveCycle Data Services 2.6 と同じになりますが、UID プロパティが変更されたときのエラーはスローされません。

デフォルト値： true。

現在コミットされていない MessageBatches のリストです。通常、データの整合性を維持するには、操作の順序を変更してはならないので、このリストは読み取り専用です。新しいバッチを作成するには、createBatch() メソッドを呼び出します。このメソッドは、新しいバッチを uncommittedBatches リストの末尾に追加し、currentBatch をそのリストの最後のエレメントに設定します。

これらのプロパティはバインド可能なので、特定のバッチの commitRequired フラグを調べて変更されているかどうかを確認したり、アイテムプロパティにバインドしてそのバッチの一部としてコミットされるのを待っている MessageCacheItems のリストを取得したりすることができます。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 propertyChange イベントが送出されます。

通常、DataStore は自動的に作成されますが、手動で DataStore を作成して DataService の dataStore プロパティに割り当てることもできます。そのためには、同じデータストアを共有するすべてのデータサービスで同じチャネルセットが使用されていて、use-transactions が同じ値に設定されている必要があります。このデータストアを使用するいずれかの DataService の宛先を destination パラメーターとして含む DataStore を作成するには、このコンストラクターを使用します。これはチャネルセットを検索する目的にのみ使用されます。このデータストアの use-transactions フラグの値も指定する必要があります。

この DataStore によって管理されているコレクションおよびアイテムに対する保留状態の変更をコミットします。autoCommit プロパティが true であるときはトランザクションが使用されないので、このメソッドを呼び出す必要はありません。トランザクションを使用するには、autoCommit プロパティを false に設定し、このメソッドを直接呼び出して変更のバッチをコミットします。通常は、引数を指定せずに「commit()」を呼び出し、保留状態のすべての変更をコミットします。オプションの引数を指定すると、保留状態の変更の一部のみをコミットできます。

DataStore 内のアイテムに対する変更をコミットするには、先に未解決の競合をすべて解決する必要があります。

アセンブラーで use-transactions が true に設定されている場合は、すべての変更がアトミックにコミットされます。バッチで指定された操作が 1 つでも失敗した場合は、すべての操作が適用されません。use-transactions が false に設定されている場合は、障害が発生するまで各操作が個別にコミットされ、障害が発生した時点で処理が停止します。エラーの前に発生した変更はすべて適用され、エラーの後に発生した変更は適用されません。バッチ処理でエラーが発生した場合は、すべての変更が未コミットのキューに戻されます。エラーの原因になった変更を削除する場合は、revertChanges を呼び出す必要があります。

デフォルトでは、commit メソッドを呼び出すと、この DataStore に対して作成、変更、および削除されたすべてのアイテムに対する保留状態の変更がすべてコミットされます。これらの変更の一部のみをコミットする場合は、バッチに含める変更を定義する管理対象 ArrayCollection インスタンスと管理対象アイテムの組み合わせを指定できます。指定した配列コレクションごとに、その配列コレクション内のアイテムのメンバーシップまたは順序に対する変更、またはその配列コレクション内のアイテムに対する変更がすべてコミットされます。また、個々の管理対象アイテムのリストを指定して、それらのアイテムに対する変更のみをコミットすることもできます。管理対象のコレクションまたはアイテムではないオブジェクトを itemsOrCollections パラメーターで指定すると、DataServiceError がスローされます。

itemsOrCollections パラメーターを使用していて、管理対象アイテムが他のアイテムを参照する関連付けパラメーターがある場合は、cascadeCommit パラメーターを使用して、関連付けられているアイテムに対する変更もバッチに含めるかどうかを制御できます。例えば、items パラメーターで Group アイテムを指定し、Group インスタンスに Person インスタンスのリストを参照する members プロパティがある場合、cascadeCommit を true にすると、Person インスタンスに対する変更もコミットされる変更のセットに含まれます。cascadeCommit が false の場合は、Group に対する変更のみが含まれます。従属するすべての変更をバッチに含めるには、cascadeCommit=true を使用します。

パラメーター

コミット処理を待機している特定のオブジェクトに、保留中の更新があるかどうかを示します。

パラメーター

このサービスからリモート宛先への接続を強制的に試みます。このメソッドを autoConnect プロパティおよび disconnect() メソッドと組み合わせて使用すると、接続のステータスを制御できます。

この操作で指定されている変更を取り、新しい MessageBatch を作成して、そのバッチを uncommittedBatches リストに格納します。itemsOrCollection=null の場合は、currentBatch 内の全メッセージが新しいバッチに追加され、currentBatch として新しいバッチが作成されます。一連の変更を分割し、1 つの単位としてコミットしたり元に戻したりできる作業のブロックを指定する必要がある場合は、このメソッドを呼び出します。例えば、親オブジェクトを作成し、その親に関連付けられた子を作成する場合は、createBatch() を呼び出してこれら 2 つの変更を 1 つのグループにまとめます。これを 2 回行う場合は、それぞれ 1 つの親と 1 つの子を作成する 2 つのバッチを作成します。その後、バッチを作成した順序どおりコミットする限りは、各グループの変更を個別にコミットできます。また、最後のバッチは元に戻せますが、最初のバッチは変更されないままになります。各操作の後に createBatch(null) を呼び出すだけで、簡単なマルチレベルの「取り消し」システムを実装できます。

MessageBatch.properties プロパティを含む一連のユーザー定義プロパティで（またはこのメソッドの properties 引数で）バッチを指定できます。この情報はオフライン機能を使用するときにバッチと共に保存および復元され、クライアント上のバッチの識別に使用できます。ここで設定する値は、直列化可能である必要があります（つまり、[RemoteClass] を持つオブジェクトまたはクラス）。

itemsOrCollection パラメーターの値を指定すると、それらのアイテムまたはアイテムのコレクションに対する変更をのみを含む新しいバッチが作成されます。cascadeCommit を true に設定すると、関連付けられているアイテムに対する変更も、新しいバッチに分割されたメッセージのセットに追加されます。

パラメーター

このデータストアを使用しているすべてのデータサービスを強制的に切断します。

このメソッドは、指定した ListCollectionView に、アプリケーションでそれまでに使用されたすべてのキャッシュ識別子を挿入します。

パラメーター

添付されている ConcreteDataService インスタンスすべてのメタデータの初期化に関連する DataStore を初期化します。正常終了時またはエラー時には適切なコールバックが呼び出されます。データストアが初期化済みの場合、成功のコールバックが直ちに呼び出されます。コールバックはパラメーターがない関数にする必要があります。

パラメーター

現在の宛先からユーザーをログアウトします。このメソッドを呼び出すと、関連付けられているすべての DataService インスタンスがログアウトされます。

保留状態のすべての更新を、管理対象のオブジェクトのセットにマージします。変更をマージするプロセスでは、競合を検出できます。

クライアントで管理されているすべてのデータを再取得します。

クライアントで管理されているすべてのデータを解放します。これにより、クライアント上のアイテムキャッシュおよびクエリキャッシュからすべてのデータが解放され、サーバー上で自動同期されているデータからサブスクライブ解除されます。

パラメーター

この DataStore によって管理されているすべての DataServices に対する保留状態の（未コミットの）変更をすべて元に戻します。

指定した管理対象コレクション内のアイテムに対する保留状態の（未コミットの）変更をすべて元に戻します。

パラメーター

この DataStore 宛先にアクセスするための資格情報を設定します。

パラメーター

この DataStore 宛先のサードパーティーにアクセスするための資格情報を設定します。

パラメーター

このクライアント上で保留状態の変更と別のクライアントによって送信された変更の間で競合が検出されたとき、またはこのクライアントによって変更が送信された結果としてリモート宛先で競合エラーが検出されたときに送出されます。DataStore は、その DataStore を共有するすべての宛先に競合イベントを送出します。または、DataService で特定のタイプの競合イベントをリスニングすることもできます。関連付けを持つオブジェクトがあり、それらの関連付けの整合性を維持するために特定の順序で競合を解決する必要がある場合は、DataStore を使用します。

イベントオブジェクトの各プロパティには次の値が設定されています。

commit を呼び出してエラーが返されると、FaultEvent.FAULT イベントが送出されます。

イベントオブジェクトの各プロパティには次の値が設定されています。

commit の呼び出しが正常に終了すると、ResultEvent.RESULT イベントが送出されます。

イベントオブジェクトの各プロパティには次の値が設定されています。

現在処理中のバッチと次にコミットするバッチの間に単純な依存関係があるかどうかを確認することを示します。

依存関係があるかどうかを確認せずに 2 番目のバッチを直ちに送信することを示します。

前のバッチが完了してから新しいバッチをコミットすることを示します。