このページでは、Google 可視化の Java ライブラリの使用方法と変更方法と、プロジェクトのオープンソース コードに貢献する方法について説明します。
目次
要件
Google 可視化の Java ライブラリを使用するには、次のコンポーネントが必要です。
- サーブレット コンテナと Servlet API バージョン 2.4 以降。最もよく使用されるサーブレット コンテナの一つは Apache Tomcat です。これには Servlet API が含まれています。バージョン 5.5 のバイナリをダウンロードするには、http://tomcat.apache.org/download-55.cgi をご覧ください。Core モジュールのみをインストールする必要があります。チュートリアルのセクション(スタートガイド、外部データストアの使用、機能とイベントのフローの定義)を完了するには、Tomcat も必要です。
- Java Development Kit バージョン 6.0 以降。
注: JDK バージョン 5.0 を使用することもできます。ただし、インターフェース メソッドをオーバーライドするライブラリ内のすべてのメソッドから
@Override
を削除する必要があります。これは、JDK バージョン 6.0 で@Override
アノテーションの動作が変更されたためです。
依存関係
データソースの Java ライブラリには次の依存関係があります。このライブラリは、リストされているバージョンでテストされています。他のバージョンも許容される可能性はありますが、テストされていません。
ソースまたはダウンロードに含まれるもの:
- icu4j バージョン 4.0.1。
- Jakarta Commons lang バージョン 2.4。
- Jakarta Commons logging バージョン 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: visibility-datasource
- バージョン番号: プロジェクト ページに記載されている最新のバージョン番号を使用します。
他のビルドシステムを使用している場合:
- プロジェクト ページからライブラリの ZIP ファイルをダウンロードし、ファイルを解凍して、ビルドシステムのニーズに合わせてプロジェクトに含めます。
サンプルの実行
JAR サンプル ファイルは、ライブラリ JAR とともにダウンロード可能な ZIP ファイルに含まれています。サンプルの実行手順については、スタートガイドのページをご覧ください。
ライブラリの変更
ライブラリ コードを変更する場合は、オープンソース ホスティング サイトからソースをダウンロードしてビルドする必要があります。この操作を行う前に、プロジェクト ページの [コード ライセンス] セクションにリンクされているライセンス情報を参照して、ユースケースが許可されているかどうかを確認してください。
ライブラリをダウンロードしてビルドする手順は次のとおりです。
- オープンソース プロジェクトのページの [Source] > [Checkout] タブで説明されているように、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 宛てにメールを送信し、許可を求め、変更を送信する方法の手順を確認してください。