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

シェードでのコーディング: Google Data API での Eclipse の使用

Google Data API チーム Jeff Fisher
2008 年 4 月

はじめに
Eclipse の設定
必要なライブラリをインストールする
新しいアプリケーションを作成する
まとめ

^新しい 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 プロジェクト] を選択します。

[次へ] をクリックして [ライブラリ] タブを選択します。[外部 JAR の追加] をクリックして、ダウンロードしたすべての依存する JAR ファイルを追加します。

また、Java クライアントライブラリの JAR ファイルを追加する必要があります。これらは、クライアントライブラリを抽出した場所の java/lib サブディレクトリにあります。常に、JAR ファイル（then-client、then-client-meta、then-core、then-media）を含める必要があります。

次に、使用する API を選択します。この例では、Google Documents List API を使用しています。そのためには、適切な JAR ファイル（then-docs と zen-docs-meta）を追加する必要があります。

最後に、[Finish] をクリックして、新しいプロジェクトを作成します。

簡単なテストアプリケーションを作成するには、メインメニューから [ファイル] メニューから [新規] > [クラス] を選択して、新しいクラスを作成します。

次に、ドキュメントリスト API のデベロッパーガイドにあるコードを貼り付けます。

適切な import ステートメントが追加されるまで、多くのエラーが表示されます。Eclipse の場合は、左側のエラーマーカーをクリックするだけで、インポートを追加できる便利なメニューが表示されます。

インポートをクリーンアップしたら、コードによってスローされる可能性のある例外の処理も行う必要があります。この例では、非常に基本的な例外ハンドラでサンプルコード全体を囲むようにしています。

これで、作成した有効なテストアカウントでユーザー名とパスワードを代用すると仮定すると、[実行] メニューから [実行] を選択したときに、そのテストアカウントが所有するドキュメントのリストが表示されます。

フォームが送信されました。

まとめ

これで、Eclipse の作業インスタンスと必要な JAR ファイルがすべて揃ったので、Google Data API との連携が可能な優れた Java アプリケーションを構築できます。

次のステップお役に立つと思われるリンクをいくつかご紹介いたします。

Java は、米国およびその他の国における Sun Microsystems, Inc. の商標です。