データソース ライブラリの概要

Google の可視化データソース ライブラリを使用すると、可視化データソースを簡単に作成できます。このライブラリは、Google Visualization API のワイヤ プロトコルとクエリ言語を実装しています。データテーブルの形式でライブラリにデータを利用できるようにするために必要なコードを記述します。データテーブルは、すべての列が単一の型である 2 次元の値のテーブルです。抽象クラスとヘルパー関数を提供することで、必要なコードの記述が簡単になります。

ライブラリの最も簡単な実装は、単一のクラスから継承したり、メンバー関数を実装したり、データソースをサーブレット コンテナ内でサーブレットとして実行することです。最も簡単な実装では、ビジュアリゼーションがデータソースにクエリを実行すると、次の一連のイベントが発生します。

1. サーブレット コンテナがクエリを処理し、そのクエリをデータソースの Java ライブラリに渡します。
2. ライブラリはクエリを解析します。
3. 実装コード（デベロッパーが記述するコード）は、データテーブルをライブラリに返します。
4. このライブラリは、データテーブルに対してクエリを実行します。
5. ライブラリは、可視化によって想定されるレスポンスにデータテーブルをレンダリングします。
6. サーブレット コンテナはビジュアリゼーションへのレスポンスを返します。

これを次の図に示します。

このタイプのデータソースを実装する方法については、データソースのスタートガイドをご覧ください。

データソースによって提供されるデータは、実装コードで指定できます。これは、少量の静的データには問題ありません。データセットが大きい場合は、外部ファイルやデータベースなどの外部データストアを使用する必要がある可能性が高くなります。データソースが外部データストアを使用する場合、ビジュアリゼーションがデータソースにクエリを実行すると、次の一連のイベントが発生します。

1. サーブレット コンテナがクエリを処理し、そのクエリをデータソースの Java ライブラリに渡します。
2. ライブラリはクエリを解析します。
3. 実装コード（デベロッパーが作成するコード）は、データストアに保持されているデータを読み取り、データテーブルをライブラリに返します。データセットが大きく、データストアにクエリの機能がある場合は、その機能を使用してデータソースの効率を向上させることができます。
4. このライブラリは、データテーブルに対してクエリを実行します。
5. ライブラリは、可視化によって想定されるレスポンスにデータテーブルをレンダリングします。
6. サーブレット コンテナはビジュアリゼーションへのレスポンスを返します。

これを次の図に示します。

このタイプのデータソースを実装する方法については、外部データストアの使用セクションをご覧ください。