Introduction

• Introduction
• 前提
• 使い方
• archetype:generate archetypeCatalog
• archetype:generate に対して詳細を指定して使用する
• eclipseのプロジェクトを生成し、eclipseにインポートする
• 生成されたプロジェクトに含まれるサンプルの構成
• Eclipseから動作確認
• 注意
• Eclipseの実行構成を開くとエラーが報告される件
• Eclipseでプロジェクトに警告が報告される件

maven + eclipseの環境を作成するためのmaven archetypeプラグインです。以下の種類があります。

• gaej-simple-quickstart

slim3datastoreを利用するだけのシンプルなプロジェクトを生成します。その他フレームワーク類を追加する等のカスタマイズしたい場合にはこれを使ってください。 http://localhost:8888/hello で確認できます。

• gaej-wicket-quickstart

slim3datastoreとwicketを利用するプロジェクトを生成します。 http://localhost:8888/ で確認できます。

• gaej-cubby-quickstart

slim3datastoreとcubbyを利用するプロジェクトを生成します。 http://localhost:8888/ で確認できます。

• gaej-t2-quickstart

slim3datastoreとt2(オリジナルのコンテナ)を利用するプロジェクトを生成します。 http://localhost:8888/hello で確認できます。

• gaej-t2guice-quickstart

slim3datastoreとt2(guice adaptor)を利用するプロジェクトを生成します。 http://localhost:8888/hello で確認できます。

• gaej-velocity-quickstart

slim3datastoreとvelocityを利用するプロジェクトを生成します。 http://localhost:8888/hello で確認できます。

JDOは使わない設定のプロジェクトが生成されます。JDOを使いたい人のお役には立てないプラグインです。

前提

• maven2がインストールされている事。
• Eclipseがインストールされている事。
• GooglePlugins for Eclipse1.3.2がインストールされている事
• appengine sdk 1.3.2がworkspaceのデフォルトに設定されていること
• Eclipseのワークスペースに M2_REPO 変数が設定されている事。またはm2eclipse等のmaven統合プラグインがインストールされている事。

使い方

mvn archetype:generate を使用して以下のコマンドを実行してください。 改行して記述していますが、実際は一行で入力してください。

archetype:generate archetypeCatalog

下記のコマンドを実行すると、どのタイプのプロジェクト(simpleかt2かwicketか等)を生成できるのかが提示され、その中から番号で指定してどのタイプのプロジェクトを生成するかを決定します。

$ mvn archetype:generate \
-DarchetypeCatalog=http://appengine-hackathon-ja.googlecode.com/svn/trunk/maven

archetype:generate に対して詳細を指定して使用する

例は gaej-simple-quickstart を使用していますが、その他（wicket用とか）を使う場合は simple を適当な名前に置き換えてください。

• gaej-simple-quickstart

$ mvn archetype:generate \
 -DarchetypeGroupId=com.appspot.ajn-web \
 -DarchetypeArtifactId=gaej-simple-quickstart \
 -DarchetypeVersion=1.3.2b \
 -DarchetypeRepository=http://appengine-hackathon-ja.googlecode.com/svn/trunk/maven

• gaej-wicket-quickstart

$ mvn archetype:generate \
 -DarchetypeGroupId=com.appspot.ajn-web \
 -DarchetypeArtifactId=gaej-wicket-quickstart \
 -DarchetypeVersion=1.3.2b \
 -DarchetypeRepository=http://appengine-hackathon-ja.googlecode.com/svn/trunk/maven

• gaej-cubby-quickstart

$ mvn archetype:generate \
 -DarchetypeGroupId=com.appspot.ajn-web \
 -DarchetypeArtifactId=gaej-cubby-quickstart \
 -DarchetypeVersion=1.3.2b \
 -DarchetypeRepository=http://appengine-hackathon-ja.googlecode.com/svn/trunk/maven

• gaej-t2-quickstart

$ mvn archetype:generate \
 -DarchetypeGroupId=com.appspot.ajn-web \
 -DarchetypeArtifactId=gaej-t2guice-quickstart \
 -DarchetypeVersion=1.3.2b \
 -DarchetypeRepository=http://appengine-hackathon-ja.googlecode.com/svn/trunk/maven

• gaej-t2guice-quickstart

$ mvn archetype:generate \
 -DarchetypeGroupId=com.appspot.ajn-web \
 -DarchetypeArtifactId=gaej-t2guice-quickstart \
 -DarchetypeVersion=1.3.2b \
 -DarchetypeRepository=http://appengine-hackathon-ja.googlecode.com/svn/trunk/maven

• gaej-velocity-quickstart

$ mvn archetype:generate \
 -DarchetypeGroupId=com.appspot.ajn-web \
 -DarchetypeArtifactId=gaej-velocity-quickstart \
 -DarchetypeVersion=1.3.2b \
 -DarchetypeRepository=http://appengine-hackathon-ja.googlecode.com/svn/trunk/maven

groupIdとかもろもろを対話的に入力するのが面倒な場合は、以下のようにパラメータを与える事でサックリプロジェクトが作成されます。

$ mvn archetype:generate \
 -DarchetypeGroupId=com.appspot.ajn-web \
 -DarchetypeArtifactId=gaej-simple-quickstart \
 -DarchetypeVersion=1.3.2b \
 -DarchetypeRepository=http://appengine-hackathon-ja.googlecode.com/svn/trunk/maven/ \
 -DgroupId=com.fuga \
 -DartifactId=com.appspot.fuga-hoge \
 -Dversion=hoge1 \
 -DinteractiveMode=false

eclipseのプロジェクトを生成し、eclipseにインポートする

archetype:generateを実行したフォルダの直下に、指定したartifact名のフォルダが作成されるので、そのフォルダに移動して以下のコマンドを実行してください。

$ mvn eclipse:eclipse

ソースコードも添付した状態でclasspathを構成したい場合は、以下を実行してください。

$ mvn eclipse:eclipse -DdownloadSources=true

プロジェクトを生成したら、eclipseからプロジェクトのフォルダをImportしてください。

生成されたプロジェクトに含まれるサンプルの構成

最低限の動作確認用のモジュールだけが含まれています。

1. Helloを返すだけのHelloServlet
2. JUnitのTestCaseとして実行できる、Datastoreにちょろっと書き込むだけのDatastoreTest

Eclipseから動作確認

1. Importしたと同時に、プロジェクト名と同じ実行の構成が読み込まれていると思いますので、それを実行します。
2. プロジェクトフォルダ直下の${プロジェクト名}.launchを選択して、右クリック-Run Asでもおkです。
3. ブラウザで http://localhost:8080/hello を開くと、Helloメッセージとタイムスタンプが表示されるはずです。
4. src/test/..../DatastoreTestを開いて、Run As JUnit すると、AppEngine環境を使った自動テストの動作確認もできるはずです。

注意

Eclipseの実行構成を開くとエラーが報告される件

生成されたEclipse用の実行構成を、Eclipseの実行構成から開くとエラーとして表示されます。が、動作に影響は無い（はず）なので無視してください。 この件はGoogleのPluginのデキが悪い、という問題だと思うんですよねぇ。

Eclipseでプロジェクトに警告が報告される件

Eclipseの設定を開き、次の画像でハイライトされている箇所を"Ignore"に設定して下さい。どちらもデフォルトでは"Warning"が設定されています。