2008 年 4 月
新しい Google Data API Java Client Eclipse プラグイン : 数秒でプロジェクトを作成
この記事の補足として、Eclipse プラグインを使用して、Google データの依存関係の設定に伴うオーバーヘッドを最小限に抑えることができます。また、関心のある API を操作するボイラープレート コードも作成されます。これにより、Google Data API での開発を簡単に開始できます。
はじめに
Eclipse はとても使いやすく、料金がかかりません。多くの Java プログラマーの根幹を担う IDE です。Java クライアント ライブラリと一緒に使用すれば、Google Data API と連携する魅力的な Java アプリケーションを作成できます。
Eclipse の設定
Eclipse がまだインストールされていない場合は、Eclipse は修正の提案、不足しているインポートの検索、オートコンプリート メソッドを実行できるため、Java 開発が大幅に簡素化されます。Eclipse.org のダウンロード ページでオペレーティング システムのインストーラを入手します。Eclipse を実行するには、Eclipse のダウンロード ページからリンクしている JRE をインストールする必要があります。Eclipse をインストールしたら、ワークスペースを作成する必要があります。以下の例では /usr/local/eclipse/workspace
を使用しています。
必要なライブラリをインストールする
Eclipse にはすぐに使える Java 機能が多数用意されているので、簡単に導入できるはずです。まず、プロジェクトのダウンロード ページから Java クライアント ライブラリの最新バージョンを入手します。ダウンロードは 2 種類あります。1 つはサンプル用で、もう 1 つはソースコード用です。サンプル zip をダウンロードします。このファイルには、独自のプログラムを作成するために必要な Java クライアント ライブラリのコンパイル済み JAR ファイルが含まれています。クライアント ライブラリ自体の仕組みに関心がある場合は、ソース ZIP をダウンロードして調べることができますが、この記事の範囲外です。サンプルの zip をダウンロードしたら、ファイルがある適切なディレクトリに解凍します。この例では /usr/local/eclipse
を使用しています。つまり、プロジェクトの JAR ファイルが /usr/local/eclipse/gdata/java/lib
でアクセス可能になります。
クライアント ライブラリをインストールしたので、次はプロジェクトのビルドパスに外部依存関係を追加できるように、外部の依存関係をダウンロードします。INSTALL-samples.txt
ファイルには、必要な jar のリストと、それらのファイルのダウンロード先が含まれています。現在のリスト:
ファイル名 | 場所 |
---|---|
mail.jar | Sun の JavaMail API |
activation.jar | Sun の JavaBeans アクティベーション フレームワーク |
サーブレット-api.jar | Apache Tomcat |
この例では、これらの JAR ファイルがダウンロードされて /usr/local/eclipse/gdata/third_party
にコピーされます。
フー!これで、いずれかの Google Data API を使用する Java アプリケーションの開発を開始するために必要な手順がすべて揃いました。続きを読む
新しいアプリケーションを作成する
まず、Eclipse を開き、[ファイル] メニューから [新規] > [Java プロジェクト] を選択します。
![Eclipse 新規プロジェクト ウィンドウ](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata1.png?authuser=5&hl=ja)
[次へ] をクリックして [ライブラリ] タブを選択します。[外部 JAR の追加] をクリックして、ダウンロードしたすべての依存する JAR ファイルを追加します。
![依存関係 JAR の追加](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata2.png?authuser=5&hl=ja)
また、Java クライアント ライブラリの JAR ファイルを追加する必要があります。これらは、クライアント ライブラリを抽出した場所の java/lib
サブディレクトリにあります。常に、JAR ファイル(then-client、then-client-meta、then-core、then-media)を含める必要があります。
![GData JAR の追加](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata3.png?authuser=5&hl=ja)
次に、使用する API を選択します。この例では、Google Documents List API を使用しています。そのためには、適切な JAR ファイル(then-docs と zen-docs-meta)を追加する必要があります。
![DocList JAR の追加](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata4.png?authuser=5&hl=ja)
最後に、[Finish] をクリックして、新しいプロジェクトを作成します。
![新しく作成したプロジェクト](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata5.png?authuser=5&hl=ja)
簡単なテスト アプリケーションを作成するには、メイン メニューから [ファイル] メニューから [新規] > [クラス] を選択して、新しいクラスを作成します。
![クラスの作成](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata6.png?authuser=5&hl=ja)
次に、ドキュメント リスト API のデベロッパー ガイドにあるコードを貼り付けます。
![エラーのあるサンプルコード](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata7.png?authuser=5&hl=ja)
適切な import ステートメントが追加されるまで、多くのエラーが表示されます。Eclipse の場合は、左側のエラーマーカーをクリックするだけで、インポートを追加できる便利なメニューが表示されます。
![クイックフィックス メニュー](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata8.png?authuser=5&hl=ja)
インポートをクリーンアップしたら、コードによってスローされる可能性のある例外の処理も行う必要があります。この例では、非常に基本的な例外ハンドラでサンプルコード全体を囲むようにしています。
![実際のサンプルコード](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata9.png?authuser=5&hl=ja)
これで、作成した有効なテスト アカウントでユーザー名とパスワードを代用すると仮定すると、[実行] メニューから [実行] を選択したときに、そのテスト アカウントが所有するドキュメントのリストが表示されます。
![プログラムの出力](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata10.png?authuser=5&hl=ja)
フォームが送信されました。
まとめ
これで、Eclipse の作業インスタンスと必要な JAR ファイルがすべて揃ったので、Google Data API との連携が可能な優れた Java アプリケーションを構築できます。
次のステップお役に立つと思われるリンクをいくつかご紹介いたします。
- Google Data API Java Client Eclipse プラグイン
- code.google.com の Google Data プロトコルに関するドキュメント
- Google Data Java クライアント ライブラリ プロジェクト
- Java クライアント ライブラリのスタートガイド
- JavaDoc ドキュメント
Java は、米国およびその他の国における Sun Microsystems, Inc. の商標です。