Java is a registered trademark of Sun Microsystems, Inc.
©2009 Google - Code サイト ホーム - 利用規約 - プライバシー ポリシー - サイト ディレクトリ
Google Code が利用できる言語: English - Español - 日本語 - 한국어 - Português - Pусский - 中文(简体) - 中文(繁體)
| 
日本語 | ログイン
Eclipse 開発環境を使用すると、他のサーブレット ベースの Web アプリケーションを開発するのと同じ方法で、簡単に Java App Engine アプリケーションを開発できます。これに Google Plugin for Eclipse を追加することで、開発がさらに容易になります。このプラグインを使用すると、App Engine アプリケーションを Eclipse 内で作成、テスト、アップロードできるようになります。
Google Plugin for Eclipse を導入することで、Google Web Toolkit（GWT）によるアプリケーション開発も容易になり、App Engine をはじめさまざまな環境で実行できるアプリケーションを簡単に開発できます。
ここでは、Google Plugin for Eclipse のインストール、新しい App Engine プロジェクトの作成、Eclipse 内で実行している開発サーバーでのデバッグ、などについて説明します。また、このプラグインを使用してプロジェクトを App Engine にアップロードする方法についても説明します。
Google Web Toolkit プロジェクトでの使用方法など、Google Plugin for Eclipse に関する詳しい情報は、Google Plugin for Eclipse のドキュメントをご覧ください。
Eclipse は、Eclipse の Web サイトから入手できます。「Eclipse IDE for Java EE Developers」には、Web アプリケーション開発に必要なすべてのコンポーネントが含まれています。
Google Plugin for Eclipse は、Eclipse 3.3（Europa）と Eclipse 3.4（Ganymede）に対応しています。
Google Plugin for Eclipse に加え、Web 開発用の Web Tools Platform（WTP）プラグインも導入することをおすすめします。詳しくは、Web Tools Platform の Web サイトをご覧ください。WTP は、JSP や HTML ファイルの編集モードを特徴とするプラットフォームです。
Google Plugin for Eclipse は、Eclipse のソフトウェア更新機能を使用してインストールできます。
このプラグインを、Eclipse 3.4（Ganymede）を使用してインストールする手順は次のとおりです:
http://dl.google.com/eclipse/plugin/3.4[OK] をクリックします。ダイアログが閉じられ、使用可能なソフトウェアのリストに新しいロケーションが追加されます。
新しいインストール ロケーションの横にある三角をクリックし、[Google] の横の三角をクリックしてインストール オプションを表示します。[Google Plugin for Eclipse 3.4] と [Google App Engine Java SDK] の横のボックスをオンにします。アプリケーションで Google Web Toolkit を使用する場合は、[Google Web Toolkit SDK] も選択できます。[インストール（Install）] ボタンをクリックします。画面の指示に従い、利用規約に同意してプラグインをインストールします。
注: Eclipse による依存関係の更新が必要なため、プラグインのインストールが完了するまで数分かかることがあります。詳しくは、よくある質問をご覧ください。
Eclipse 3.3（Europa）のプラグインのインストール手順もよく似ていますが、プロンプトの表示やインストール ロケーションが異なります。Google Plugin for Eclipse 3.3 のインストール手順については、次のページをご覧ください:
http://dl.google.com/eclipse/plugin/3.3
ソフトウェア更新機能に関する詳しい情報は、Eclipse ドキュメントをご覧ください。
新しい App Engine プロジェクトを作成する手順は次のとおりです:
![[新規 Web アプリケーション プロジェクト（The New Web Application Project）] ボタン](/appengine/docs/java/tools/eclipse/new_app_button.png){kind=small}
をクリックする方法もあります。Guestbook とします。[パッケージ（Package）] には、適切なパッケージ名（たとえば guestbook）を入力します。appengine-java-sdk/ ディレクトリを追加します。このウィザードを完了すると、プロジェクトのディレクトリ構造が作成されます。この構造は、Java ソースを格納する src/ ディレクトリ、アプリケーションのコンパイル済みクラスやその他のファイルを格納する war/ ディレクトリ、各種ライブラリ、設定ファイル、画像や CSS のような静的ファイル、その他のデータ ファイルなどで構成されます。ウィザードでは、1 つのサーブレット ソース ファイルと 2 つの設定ファイルも作成されます。完成後のディレクトリ構造は次のようになります:
Guestbook/
src/
guestbook/
server/
GuestbookServlet.java
META-INF/
jdoconfig.xml
log4j.properties
logging.properties
war/
WEB-INF/
lib/
...App Engine JARs...
appengine-web.xml
web.xml
index.html
war/ ディレクトリでは、Web アプリケーションを WAR 標準レイアウトに従ってバンドルします（WAR アーカイブ ファイルは、App Engine SDK ではまだサポートされていません）。Eclipse プラグインでは、このディレクトリを使用して開発サーバーを実行したり、App Engine にアプリケーションを配備したりします。
Eclipse でアプリケーションをビルドすると、classes/ というディレクトリが war/WEB-INF/ に作成され、ここにコンパイル済みのクラス ファイルが格納されます。また、src/ にソース以外のファイル（META-INF/や、log4j.properties、logging.properties などのファイル）が見つかった場合は、それらが war/WEB-INF/classes/ にコピーされます。war/ ディレクトリの最終的なコンテンツが、テストおよび配備できる状態のアプリケーションになります。
プラグインで新しく作成されるプロジェクトに関する詳しい情報は、スタート ガイドをご覧ください。
App Engine SDK には、開発したアプリケーションをシミュレーション環境でテストするための Web サーバーが含まれています。Google Plugin for Eclipse をインストールすると、このサーバーを起動するためのメニュー項目が [実行（Run）] メニューに追加されます。
アプリケーションを Eclipse デバッガ内の Web サーバーで実行する場合は、[実行（Run）] メニューから [デバッグ（Debug As）] > [Web アプリケーション（Web Appliction）] をクリックします。Eclipse によってプロジェクトがビルドされ、[デバッグ（Debug）] パースペクティブに切り替わってサーバーが起動します。サーバーが正常に起動すると、次のようなメッセージを含め、いくつかのメッセージがコンソールに表示されます:
The server is running at http://localhost:8080/
サーバーの起動方法をカスタマイズしたい場合は、「Web アプリケーション」タイプの実行/デバッグ設定を新たに作成できます。
プラグインで作成した新しいアプリケーションをテストするには、上記の手順でサーバーを起動してから、ブラウザで次の URL にアクセスします（アプリケーションに合わせて適切な URL パスを指定します）:
Eclipse では、サーバーを実行したまま、ソース コード、JSP、静的ファイル、および appengine-web.xml に変更を加えることができます。ソース コードへの変更を保存すると、クラスが自動的にコンパイルされ、実行中の Web サーバーに動的に挿入されます。ほとんどの場合、ブラウザでページを再読み込みするだけで変更後のコードをテストできます。JSP、静的ファイル、および appengine-web.xml に加えた変更は、開発サーバーによって自動的に認識され、サーバーを再起動しなくても有効になります。web.xml などの設定ファイルを変更した場合は、変更を有効にするためにサーバーを停止して起動する必要があります。
サーバーを停止するには、[デバッグ（Debug）] パネルが選択されていることを確認し、[終了（Terminate）] ボタン ![Eclipse の [終了（Terminate）] ボタン](/appengine/docs/java/tools/eclipse/terminate_button.png){kind=small}
をクリックします。
Google Plugin for Eclipse をインストールすると、Eclipse ツールバーにいくつかのボタンが追加されます。[App Engine プロジェクトの配備（App Engine deploy）] ボタン ![[App Engine プロジェクトの配備（App Engine deploy）] ボタン](/appengine/docs/java/tools/eclipse/ae_deploy_button.png){kind=small}
は、アプリケーションを App Engine にアップロードするために使用します。
アプリケーションを初めてアップロードする際は、その前に管理コンソールを使用してアプリケーション ID を App Engine に登録する必要があります。アプリケーション ID を登録し、appengine-web.xml ファイルの <application>...</application> 要素に新しい ID を指定します。
[App Engine プロジェクトの配備（App Engine deploy）] ボタンをクリックすると、管理アカウントのユーザー名（メール アドレス）とパスワードの入力を求める画面が表示されます。適切なアカウント情報を入力し、[アップロード（Upload）] ボタンをクリックします。Eclipse は、アプリケーション ID とバージョン番号を appengine-web.xml ファイルから取得し、war/ ディレクトリのコンテンツをアップロードします。
次のような URL にアクセスし、App Engine でのアプリケーションの動作をテストします:
http://<your application ID>.appspot.com/guestbookApp Engine Java SDK のツールの機能には、コマンドラインから直接ツールを実行しないと使用できないものもあります。Eclipse を使用して SDK をインストールした場合は、それらのツールを Eclipse プラグインのインストール ディレクトリから実行できます。
SDK は、Eclipse のインストール ディレクトリの plugins/com.google.appengine.eclipse.sdkbundle_VERSION/ に格納されます（VERSION は SDK のバージョン ID）。ツールは、このディレクトリの appengine-java-sdk/bin/ サブディレクトリに格納されています。
注: Mac OS X または Linux を使用している場合は、これらのコマンドを実行する前に、コマンド ファイルに実行権限を付与する必要があるかもしれません。たとえば、appcfg.sh に実行権限を付与するには、appengine-java-sdk/bin/ ディレクトリからコマンド chmod u+x appcfg.sh を実行します。
コマンドラインからのみ使用できる機能に関する詳しい情報は、アップロードと管理をご覧ください。