データソース

これば、データを格納し、データをクライアントにストリーミングするためのインフラストラクチャです。これにより、ページのロードが高速になるとともに、結果の非同期サーバー処理が可能になります。基本的な方法としては、大きな結果セットがクライアントにチャンクで戻り、その ID を使用してさらにチャンクを取得できます。UI からは、データはクライアントにストリーミングされているように見えます。このアプローチは、データベース内に大きな結果セットが残る DB ページングとは異なります。DataSource では、データをチャンクでリクエストするクライアントをとるかぎりにおいて、結果はメモリに残ります。さらに、別個のスレッドでデータソースにチャンクを追加するサーバーがサポートされるので、クライアントが待機することなく、データソースをリクエストし、そのデータを取得するためのスレッドを提供することができます。

同期: クライアントに送信する必要があるデータがすべて揃っていて、クライアントにチャンクで送信できるようにデータを DataSource に配置したい場合にこれは便利です。DataSource セッションは、クライアントに送信するオブジェクトのリストをとり、クライアントに送信されるデータの 1 つ目のチャンクが含まれている DataChunk オブジェクトを返します。データのリストが 1 つのチャンクに収まる場合、セッションは DataSource を作成せずに、チャンクだけを返します。そうでない場合、DataSource がデータとともに作成され、これに対して後から追加のチャンクをポーリングできます。データがさらに追加されないように、DataSource は閉じます。

非同期: この場合、データはまだ揃っていません。バックグラウンドスレッドでデータを取得して後からデータをクライアントに返すタスクをサブミットします。Java から提供されている Executor フレームワークの機能を利用します (詳細については、Executor の Javadoc を参照してください)。非同期 DataSource を作成するため、DataSource セッションは DataSourceTask をとり、これは後からバックグラウンドスレッドで実行されます。DataSourceFuture オブジェクトが返り、これによって DataSource 情報にアクセスできます。

同期データ取得での非同期データソース: 同期データ取得を使用し (すべてのデータをデータベースから 1 つのチャンクで取得)、チャンクをクライアントにストリーミングします。クライアントに送信される最初のデータチャンクはテーブルデータを含みませんが、このチャンクによって、完全なデータチャンクが利用可能になる前にテーブルがレンダリング可能になります。間もなく、テーブルおよびテーブルの処理の一部をユーザーが制御できるようになります。次に、データチャンクは処理済みなので、空のチャンクにデータチャンクが入ります。

非同期データ取得での非同期データソース: 非同期データ取得を使用し (データをデータベースから複数のチャンクで取得)、チャンクをクライアントにストリーミングします。クライアントに送信される最初のデータチャンクはテーブルデータを含みませんが、このチャンクによって、完全なデータチャンクが利用可能になる前にテーブルがレンダリング可能になります。間もなく、テーブルおよびテーブルの処理の一部をユーザーが制御できるようになります。次に、データチャンクは処理済みなので、空のチャンクにデータチャンクが入ります。この場合、データベースからデータを取得中に、クライアントでデータのチャンクをレンダーできます。

パラメータ	説明
ActiveDataSourceCount	すべてのユーザーセッションで現在アクティブなデータソースの数。
TotalDataSourcesCreated	すべてのユーザーセッションで作成された DataSource の総数。
TotalDataSourcesDestroyed	すべてのユーザーセッションで破棄された DataSource の総数。

パラメータ	説明
cancelLongRunningDataSources	すべてのユーザーセッションで、指定されたミリ秒以上実行しているデータソースをすべてキャンセルします。アクティブな DataSource と非アクティブな DataSource の両方がキャンセルされます。

パラメータ	説明
AllEmptyPollingTimeout	クライアントがチャンクの有無をポーリングし、リクエストした ID のいずれにも使用可能なチャンクがない場合に、データチャンクを待機するときのタイムアウト (単位: ミリ秒)。
ChunkBlockingLimit	DataSource に格納可能なチャンクの数を制御します。この数を超えると、ポーリングされるかタイムアウトになるまで、アイテムを追加できなくなります。これによって設定される実際のアイテム数は ChunkBlockingLimit*MaxChunkSize です。
DataSourceTaskPoolKeepAliveTime	アイドルスレッドを DataSource タスクプールに残す時間 (単位: ミリ秒)。
DataSourceTaskPoolSize	DataSource タスクプールに置くことが可能なスレッドの最大数。
DataSourceTimeout	アイドル DataSource を残す時間 (単位: ミリ秒)。
FeedbackBlockingLimit	DataSource に格納可能なフィードバックアイテムの数。この数を超えると、ポーリングされるかタイムアウトになるまで、フィードバックを追加できなくなります。
InitialChunkPollingTimeout	非同期データソースを使用している場合に、使用可能なデータの最初のチャンクを待機する時間 (単位: ミリ秒)。これにより、可能な場合、コンポーネントは最初のレンダリングでテーブル内の一部のデータの表示を試みます。
MaxPollSize	各ポーリングで DataSource から返るデータの最大サイズ。
PreferredMinPollSize	ポーリングでのデータの最小サイズ。非同期データソースをポーリングする場合に、サーバーはこれに基づいて、さらなるデータを待機するかどうかを決定します。
PreferredSerializationSize	ポーリングリクエストに対する総レスポンスの推奨サイズ (単位: バイト)。最初のチャンクがこのサイズの上限に達していない場合、上限を超えるまで、チャンクが追加されます。このプロパティは、現在使用されていません。
ResultLimit	DataSource に追加可能なアイテムの総数。この数を超えると DataSource が失敗します。
SomeEmptyPollingTimeout	クライアントがチャンクの有無をポーリングし、リクエストした ID のすべてではなく一部に使用可能なチャンクがある場合に、データチャンクを待機するときのタイムアウト (単位: ミリ秒)。
TreeChildNodeFetchTimeout	ツリーの子データを待機するときのタイムアウト (単位: ミリ秒)。既成の値は 180000 ms で、この値を大きくすることによってタイムアウトエラーを回避できます。