このページは Cloud Translation API によって翻訳されました。

データソーススタートガイド

このセクションでは、SimpleExampleServlet について説明します。これは、このライブラリに実装されているデータソースの実装の最も単純な例です。このセクションでは、SimpleExampleServlet の実行とテストの詳しい手順についても説明します。

SimpleExampleServlet のご紹介
SimpleExampleServlet の実行とテスト

`SimpleExampleServlet` のご紹介

SimpleExampleServlet クラスは examples パッケージにあります。このクラスは、データソースの最も単純な実装の例を示しています。SimpleExampleServlet は DataSourceServlet から継承し、generateDataTable() を実装するため、サーブレットコンテナ内で実行する必要があります。

SimpleExampleServlet のスニペットを以下に示します。generateDataTable 関数は、データをライブラリに公開します。この関数は、データテーブルの説明を作成し、データテーブルの列を定義して、データテーブルにデータを入力します。ライブラリは、データテーブルをクエリのビジュアリゼーションに戻すために必要な他のすべてのアクションを処理します。

// This example extends DataSourceServlet
public class SimpleExampleServlet extends DataSourceServlet {

  @Override
  public DataTable generateDataTable(Query query, HttpServletRequest request) {
    // Create a data table,
    DataTable data = new DataTable();
    ArrayList cd = new ArrayList();
    cd.add(new ColumnDescription("name", ValueType.TEXT, "Animal name"));
    cd.add(new ColumnDescription("link", ValueType.TEXT, "Link to wikipedia"));
    cd.add(new ColumnDescription("population", ValueType.NUMBER, "Population size"));
    cd.add(new ColumnDescription("vegeterian", ValueType.BOOLEAN, "Vegetarian?"));

    data.addColumns(cd);

    // Fill the data table.
    try {
      data.addRowFromValues("Aye-aye", "http://en.wikipedia.org/wiki/Aye-aye", 100, true);
      data.addRowFromValues("Sloth", "http://en.wikipedia.org/wiki/Sloth", 300, true);
      data.addRowFromValues("Leopard", "http://en.wikipedia.org/wiki/Leopard", 50, false);
      data.addRowFromValues("Tiger", "http://en.wikipedia.org/wiki/Tiger", 80, false);
    } catch (TypeMismatchException e) {
      System.out.println("Invalid type!");
    }
    return data;
  }
}

`SimpleExampleServlet` の実行とテスト

このセクションでは、SimpleExampleServlet の実行とテストの方法を説明します。

前提条件と、ライブラリのダウンロードとビルドの方法については、インストールセクションをご覧ください。Apache Tomcat など、サーブレットコンテナとしても機能するウェブサーバーをインストールする（システムにまだインストールしていない場合）。このセクションの手順は、Windows システムの Apache Tomcat に固有のものです。

SimpleExampleServlet を実行してテストするには、SimpleExampleServlet データソースを実行するウェブアプリケーションを作成してから、データソースからクエリされたデータを表示するビジュアリゼーションでサンプルのウェブページを実行します。これについては、次のセクションで説明します。

Apache Tomcat でのウェブアプリケーションの作成
ビジュアリゼーションを使用してデータを表示する

Apache Tomcat でのウェブアプリケーションの作成

以下の手順に沿って、Apache Tomcat でウェブアプリケーションを作成します。次の手順は、Windows システム上の Apache Tomcat に固有のものです。

Tomcat をインストールしたディレクトリに移動します。このドキュメントでは、<tomcat_home> と記載しています。
webapps サブディレクトリに移動します。
myWebApp というサブディレクトリを作成します。
作成したサブディレクトリに移動し、WEB-INF という別のサブディレクトリを作成します。
WEB-INF サブディレクトリに移動し、lib という別のサブディレクトリを作成します。
フルパスは <tomcat_home>/webapps/myWebApp/WEB-INF/lib にする必要があります。
web.xml を <data_source_library_install>/examples/src/html から WEB-INF ディレクトリにコピーします。ここで、<data_source_library_install> は、データソースライブラリをインストールしたディレクトリです。web.xml の次の行で、SimpleExampleServlet を定義してマッピングします。
```
<servlet>
  <servlet-name>My Servlet</servlet-name>
  <description>My servlet description.</description>
  <servlet-class>SimpleExampleServlet</servlet-class>
</servlet>

<servlet-mapping>
  <servlet-name>My Servlet</servlet-name>
  <url-pattern>/simpleexample</url-pattern>
</servlet-mapping>
```
データソースライブラリをインストールしたディレクトリに移動します。このドキュメントでは、<data_source_library_install> と記載しています。
すべての依存関係パッケージを <tomcat_home>/webapps/myWebApp/WEB-INF/lib にコピーします。パッケージは、別のディレクトリに配置しない限り、<data_source_library_install>/lib にインストールされます。
自分でライブラリを作成した場合は、visualization-datasource-1.0.2.jar と visualization-datasource-examples.jar の
を <data_source_library_install>/build
から <tomcat_home>/webapps/myWebApp/WEB-INF/lib にコピーします。

zip ファイルを解凍したら、visualization-datasource-1.0.2.jar と visualization-datasource-examples.jar の
を <data_source_library_install>
から <tomcat_home>/webapps/myWebApp/WEB-INF/lib にコピーします。
jar ファイル名のバージョン番号は、最新のバージョン番号によって異なる場合があります。
Tomcat を開始するか、Tomcat がすでに実行されている場合は再起動します。
次のリンクをクリックします。

http://localhost:8080/myWebApp/simpleexample

画面には、画面の幅に応じて 6 ～ 7 行のテキストが表示されます。
テキストは google.visualization.Query.setResponse
で始まり、/Tiger'},{v:80.0},{v:false}]}]}}); で終わります。

これは、データソースからクエリのビジュアリゼーションに返されるデータです。

ビジュアル表示を使用してデータを表示する

<data_source_library_install>/examples/src/html ディレクトリにある getting_started.html ファイルを使用すると、データの可視化を表示できます。次の getting_started.html から取得した行では、使用するサーブレットを指定しています。サーブレットマッピングは、Apache Tomcat でのウェブアプリケーションの作成のステップ 8 で設定します。

var query = new google.visualization.Query('simpleexample');

ビジュアリゼーションを指定し、クエリ言語を使用する方法については、グラフの使用とクエリ言語リファレンスをご覧ください。

データソースによって提供されるデータのビジュアリゼーションを表示する手順は次のとおりです。

getting_started.html ファイルを <data_source_library_install>/examples/src/html ディレクトリ
から <tomcat_home>/webapps/myWebApp/ ディレクトリにコピーします。
次のリンク http://localhost:8080/myWebApp/getting_started.html をクリックすると、次のように表示されます。

これで完了です。最初のデータソースの設定が完了しました。

次のステップ

次の例は、外部データストアの使用セクションに記載されています。または、概要に戻るか、以下のリンクをご覧ください。

ライブラリの中で最もよく使用されるクラスの概要については、キークラスをご覧ください。
独自のイベントフローとクエリ機能を実装する方法の例については、機能とイベントフローの定義をご覧ください。
DataSourceServlet から継承しない場合は、独自のサーブレットの使用で説明されているようにデータソースを実装できます。たとえば、別のクラスからサーブレットを継承する場合は、DataSourceServlet から継承したくありません。
サーブレットを使用しない場合は、サーブレット以外のデータソースの実装をご覧ください。
アプリケーションからデータソースにパラメータを渡す方法については、パラメータを DataTableGenerator.generateDataTable に渡すをご覧ください。

データソース スタートガイド

SimpleExampleServlet のご紹介

SimpleExampleServlet の実行とテスト

Apache Tomcat でのウェブ アプリケーションの作成