ManagedQuery  - AS3 ADEP Data Services

これらの addItemToCollectionOperation() メソッドと removeItemFromCollectionOperation() メソッドは、コレクションにアイテムが追加されたとき、またはコレクションからアイテムが削除されたときに呼び出す関数を定義するために使用する、オプションの操作です。多くの場合、クエリ内のアイテムのメンバーシップは、暗黙的に（つまり、サーバー側でそれらの操作を処理する必要がないように、プロパティの値によって）決定されます。そのような場合、これらは無視されます。これらのメソッドは、アイテムを特定のコレクションに関連付ける関連付けテーブルを明示的に管理している場合に使用します。

この操作と同じパラメーターを取り、クエリ内のアイテムの数を返すサービスに対する操作の名前です。このプロパティは、ページングを有効にして正確なコレクションサイズを取得する場合に使用します。count 操作が定義されていない場合、システムは動的サイズ計算モードを使用して 1 ページずつコレクション内のアイテムを取得し、最後に空のスロットを残します。その空のスロットにアクセスしない場合、次のページは取得されません。そのスロットにアクセスすると、次のページが取得され、コレクションのサイズはクエリ内に残されたアイテムがなくなるまで拡大されます。

ページングが有効になっているときの、このクエリのページサイズです。

ページングを有効にするには、これを true に設定します。ページングが有効になっている場合は、サーバーに対する操作で start パラメーターと count パラメーターを指定して、返されるアイテムのサブセットを定義する必要があります。操作を呼び出すときにこれらをサービスに渡す必要はありません。これらは、システムがサーバーからオンデマンドでページを取得するときに（つまり、getItemAt() の呼び出しに対する応答として）、自動的に追加されます。これらの呼び出しではオプションの prefetch パラメーターを指定でき、これを使用して、特定の呼び出しで取得するアイテムの数を制御できます。

ページングが有効になっている場合は、サーバーに対する操作で start パラメーターと count パラメーターを指定して、返されるアイテムのサブセットを定義する必要があります。操作を呼び出すときにこれらをサービスに渡す必要はありません。これらは、システムがサーバーからオンデマンドでページを取得するときに（つまり、getItemAt() の呼び出しに対する応答として）、自動的に追加されます。これらの呼び出しではオプションの prefetch パラメーターを指定でき、これを使用して、特定の呼び出しで取得するアイテムの数を制御できます。デフォルトでは start および count パラメーターの名前は "startIndex" および "numItems" でなければならず、操作のシグネチャ内のどこでも使用できます。このフラグを true に設定すると、これら 2 つのパラメーターに対する名前付けの制限はなくなりますが、使用できる位置は操作に対する最後の 2 つのパラメーターに制限されます。最後から 2 番目のパラメーターは start パラメーターと解釈され、最後のパラメーターは count パラメーターと解釈されます。

このクエリによって返される管理対象アイテムのプロパティ名を「a,b,c」の形式で列挙したストリングです。これが設定されていない場合、クエリを実行すると、オブジェクトのすべてのプロパティが返されます。

これらの addItemToCollectionOperation() メソッドと removeItemFromCollectionOperation() メソッドは、コレクションにアイテムが追加されたとき、またはコレクションからアイテムが削除されたときに呼び出す関数を定義するために使用する、オプションの操作です。多くの場合、クエリ内のアイテムのメンバーシップは、暗黙的に（つまり、サーバー側でそれらの操作を処理する必要がないように、プロパティの値によって）決定されます。そのような場合、これらは無視されます。これらのメソッドは、アイテムを特定のコレクションに関連付ける関連付けテーブルを明示的に管理している場合に使用します。

アイテムがコレクションから削除されるときに、そのアイテムを削除したい場合、この操作を使用する必要はありません。代わりに、deleteItemOnRemoveFromFill プロパティを設定すると、コレクションからアイテムが削除されるときにサーバーの deleteItem 操作が自動的に呼び出されます。

最後のクエリの時点以降に変更されたクエリのアイテムを計算するこのクエリと同じパラメーターを使用するサービスの操作名です。つまり、関連する fill() に対して synchronizeFill() が実行されます。

ManagedQuery を作成します。nameParameter は、この ManagedQuery の基になるサービスの操作の名前を指定します。これは必須のパラメーターですが、ここではこのクラスを MXML で使用できるようにオプションにしています。

途中で発生した構成の問題に対するエラーをスローする管理対象操作を初期化します。