Menu

SAStruts の Maven Archetype

概要

SAStruts の Maven 2 プロジェクトを生成するために、sa-struts-archetype を提供しています。 Maven 2 の archetype:generate ゴールを実行することで、素早く SAStruts のプロジェクトを生成することができます。

事前準備

Maven 2 がセットアップされている必要があります。(バージョンは 2.0.7 以降)

プロジェクト生成

archetype:generate ゴールを実行することでプロジェクトを生成します。 利用可能な sa-struts-archetype のバージョンは http://maven.seasar.org/maven2/org/seasar/sastruts/sa-struts-archetype/ をご確認ください。 

mvn archetype:generate -DarchetypeRepository=http://maven.seasar.org/maven2/ \
    -DarchetypeGroupId=org.seasar.sastruts \
    -DarchetypeArtifactId=sa-struts-archetype -DarchetypeVersion=<sa-struts-archetypeのバージョン> \
    -DgroupId=<グループID> -DartifactId=<アーチファクトID> -Dversion=<バージョン>

-D オプションで指定できる値は以下の通りです。

名前(name) 値(value)
groupId 生成するプロジェクトのグループ ID (ex. -DgroupId=com.example)
artifactId 生成するプロジェクトのアーチファクト ID (ex. -DartifactId=sample)
artifactId 生成するプロジェクトのバージョン (ex. -Dversion=1.0)
use-dbflute Maven DBFlute Plugin の設定をするかどうか。デフォルト値は false。(ex. -Duse-dbflute=true)
use-mobylet mobylet 用の設定ファイルを生成するかどうか。デフォルト値は false。(ex. -Duse-mobylet=true)
use-portlet ポートレット用の設定ファイルを生成するかどうか。デフォルト値は false。(ex. -Duse-portlet=true)

利用方法

archetype:generate ゴール実行後、通常のウェブアプリケーションの Maven 2 プロジェクトと同様に扱えます。 mvn package を実行すると、target ディレクトリ以下に war ファイルが生成されます。 

$ mvn package

ご利用のアプリケーションサーバに配備して利用してください。

Eclipseでの利用

archetype:generate で生成した SAStruts プロジェクトを Eclipse で利用したい場合は、mvn eclipse:eclipse を実行してください。 

$ mvn eclipse:eclipse

実行後、設定ファイル (.project と .classpath) が自動生成されるので、Eclipse で外部プロジェクトで読むことが可能になります。

Tomcat プラグインを利用している場合は、プロジェクトプロパティで Tomcat プラグインを有効にして、src/main/webapp をウェブアプリケーションのルートとして設定してください。 src/main/webapp/WEB-INF/lib に必要な jar が保存されているので、Eclipse 上から HOT deploy 開発を行うことができます。

Eclipse でプロジェクトの読み込み後、mvn clean や mvn package などを実行した場合は、再度 mvn eclipse:eclipse を実行してください。 それらの mvn コマンドを実行すると、Tomcat プラグインで起動して利用する上で必要な src/main/webapp/WEB-INF/lib が削除されます。 mvn eclipse:eclipse を再度実行することで、src/main/webapp/WEB-INF/lib が生成されます。

Eclipse 上にプロジェクトを読み込んで、Tomcat プラグインで Tomcat を起動して利用する手順をまとめると以下になります。 生成したウェブアプリケーションが起動しない場合は再度、以下の手順を確認してください。

  1. mvn eclipse:eclipse を実行
  2. (Eclipseに読み込んでいなければ) Eclipse にプロジェクトとして読み込み
  3. Eclipse 上でプロジェクトをリフレッシュ
  4. Eclipse 上でプロジェクトをクリーン・ビルド (自動ビルドにしておくとクリーンのみ)
  5. src/main/webapp/WEB-INF の lib と classes が生成されていることを確認
  6. Tomcat を起動