データソース Java ライブラリのインストール

このページでは、Google の可視化用 Java ライブラリを使用または変更する方法と、プロジェクトのオープンソース コードに貢献する方法について説明します。

目次

  1. 要件
  2. 依存関係
  3. 提供されたライブラリを使用する
  4. サンプルの実行
  5. ライブラリの変更
  6. オープンソース プロジェクトへの貢献

要件

Google 可視化の Java ライブラリを使用するには、次のコンポーネントが必要です。

  • サーブレット コンテナと サーブレット API バージョン 2.4 以降。最も一般的なサーブレット コンテナの一つに Apache Tomcat があります。これには サーブレット API が含まれています。バージョン 5.5 のバイナリをダウンロードするには、http://tomcat.apache.org/download-55.cgi をご覧ください。コア モジュールのみをインストールする必要があります。また、スタートガイド、外部データストアの使用、機能とイベントフローの定義のチュートリアルのセクションを修了する必要があります。
  • Java Development Kit バージョン 6.0 以降。

    注: JDK バージョン 5.0 も使用できます。この場合、インターフェース メソッドをオーバーライドするライブラリ内のすべてのメソッドから @Override を削除する必要があります。これは、JDK バージョン 6.0 の @Override アノテーションの動作が変更されたためです。

依存関係

データソース Java ライブラリには次の依存関係があります。このライブラリは、リストされているバージョンでテストされています。他のバージョンは許容されるものの、テストされていない状態です。

ソースまたはダウンロードに含まれるもの:

ソースまたはダウンロードに含まれないもの:

  • mySQL データベースで SqlDataSourceHelper クラスを使用するには、ランタイム環境で mysql.jar も必要です。詳細とダウンロード可能なバージョンについては、http://www.mysql.com/products/connector/j/ をご覧ください。

用意されているライブラリを使用する

このセクションでは、可視化の Java ライブラリを変更する必要がない場合に、そのライブラリを使用する方法について説明します。このプロセスは、ビルドシステムによって異なります。

Maven を使用している場合、以下の設定を使用して可視化ライブラリへの依存関係を設定します。

  • グループ ID: com.google.visualization
  • アーティファクト ID: Visualization-datasource
  • バージョン番号: プロジェクト ページに記載されている最新のバージョン番号を使用します。

その他のビルドシステムを使用している場合:

サンプルの実行

JAR のサンプル ファイルは、ダウンロード可能な ZIP ファイルにライブラリ JAR とともに含まれています。サンプルの実行方法については、スタートガイドをご覧ください。

ライブラリの変更

ライブラリのコードを変更する場合は、オープンソース ホスティング サイトからソースをダウンロードしてビルドする必要があります。これを行う前に、プロジェクト ページの「コード ライセンス」セクションにリンクされているライセンス情報を読んで、ユースケースが許可されるかどうかを確認してください。

ライブラリをダウンロードしてビルドする手順は次のとおりです。

  1. オープンソース プロジェクト ページの [ソース] > [ご購入手続き] タブの説明に従って、SVN を使用してソースコードをダウンロードします。
  2. コードをビルドする。Maven でビルドする場合は、ソースに付属の pom.xml ファイルを使用します。Apache Ant を使用してビルドする場合は、次の手順に従います（Ant バージョン 1.7.0 を使用してテスト済みのコードです。以前のバージョンの Ant を使用している場合は、アップグレードが必要な場合があります）。

Ant ビルド手順

1. ビルド プロパティを変更します。

  1. 選択したインストール ディレクトリの build-src サブディレクトリに移動します。
  2. テキスト エディタを使用して build.properties ファイルを開き、次の変更を行います。
    • servlet-api.jar プロパティが参照されるように servlet-api.jar プロパティを編集します。たとえば、Tomcat を tomcat_home ディレクトリの c: ドライブにインストールした場合は、servlet-api.jar プロパティを次のように指定します。
      servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jar

      注: Windows を使用している場合でも、ファイルパスにはバックスラッシュではなくスラッシュを使用してください

    • 前述の依存関係の独自のコピーを使用するには、同じ build.properties ファイルでパスを編集します。

2. ライブラリをビルドします。

ファイル内の build-src サブディレクトリに移動して、次のいずれかを入力します。

  • ant datasource - データソース ライブラリの構築
  • ant example - サンプルを構築します。
  • ant - データソースとサンプルの両方を構築
  • ant test - データソース ライブラリのテストをビルドして実行します。ライブラリを変更する際、非常に便利です。

オープンソース プロジェクトへの貢献

オープンソース プロジェクトに変更を加えるには、そのプロジェクトに対する送信権限を取得する必要があります。変更の送信方法と手順について、google-visualization-api@googlegroups.com までメールでお問い合わせください。