このページでは、Google の可視化用 Java ライブラリを使用または変更する方法と、プロジェクトのオープンソース コードに貢献する方法について説明します。
目次
要件
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 ライブラリには次の依存関係があります。このライブラリは、リストされているバージョンでテストされています。他のバージョンは許容されるものの、テストされていない状態です。
ソースまたはダウンロードに含まれるもの:
- icu4j バージョン 4.0.1.
- Jakartacommons lang バージョン 2.4。
- Jakartacommons ロギングバージョン 1.1.1。
- Google コレクション ライブラリ バージョン 1.0。
- javacc バージョン 4.2。これは、下記の説明のとおりにライブラリを変更する場合など、ライブラリをコンパイルする場合にのみ必要です。
- opencsv バージョン 1.8. これは、CSV データソースを使用する場合にのみ必要です。
ソースまたはダウンロードに含まれないもの:
- mySQL データベースで
SqlDataSourceHelper
クラスを使用するには、ランタイム環境でmysql.jar
も必要です。詳細とダウンロード可能なバージョンについては、http://www.mysql.com/products/connector/j/ をご覧ください。
用意されているライブラリを使用する
このセクションでは、可視化の Java ライブラリを変更する必要がない場合に、そのライブラリを使用する方法について説明します。このプロセスは、ビルドシステムによって異なります。
Maven を使用している場合、以下の設定を使用して可視化ライブラリへの依存関係を設定します。
- グループ ID: com.google.visualization
- アーティファクト ID: Visualization-datasource
- バージョン番号: プロジェクト ページに記載されている最新のバージョン番号を使用します。
その他のビルドシステムを使用している場合:
- プロジェクト ページからライブラリの ZIP ファイルをダウンロードして、ファイルを解凍し、ビルドシステムの必要に応じてプロジェクトに追加します。
サンプルの実行
JAR のサンプル ファイルは、ダウンロード可能な ZIP ファイルにライブラリ JAR とともに含まれています。サンプルの実行方法については、スタートガイドをご覧ください。
ライブラリの変更
ライブラリのコードを変更する場合は、オープンソース ホスティング サイトからソースをダウンロードしてビルドする必要があります。これを行う前に、プロジェクト ページの「コード ライセンス」セクションにリンクされているライセンス情報を読んで、ユースケースが許可されるかどうかを確認してください。
ライブラリをダウンロードしてビルドする手順は次のとおりです。
- オープンソース プロジェクト ページの [ソース] > [ご購入手続き] タブの説明に従って、SVN を使用してソースコードをダウンロードします。
- コードをビルドする。Maven でビルドする場合は、ソースに付属の pom.xml ファイルを使用します。Apache Ant を使用してビルドする場合は、次の手順に従います(Ant バージョン 1.7.0 を使用してテスト済みのコードです。以前のバージョンの Ant を使用している場合は、アップグレードが必要な場合があります)。
Ant ビルド手順
1. ビルド プロパティを変更します。
- 選択したインストール ディレクトリの
build-src
サブディレクトリに移動します。 - テキスト エディタを使用して
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 までメールでお問い合わせください。