コーヒーブレイク(ディレクトリ構造---ちょっぴりMaven)

ディレクトリー構造

ここで書くことは、私自身、迷っていますし、未だに結論を出せないでいます。したがって、ベストではない方法を採用する可能性もあります。もし何か、もっと良い提案があったら、ご連絡下さい(もしかしたら多分に趣味的な側面、それからいくつかの点がトレードオフになっているわけで、どこに重点を置くかということかもしれませんが)

もともと何が標準なのか、ということは難しいのですが、以前よりwebアプリケーションのディレクトリ構造をどうしようか、と迷っていました。今回Cactusやら、ここには書きませんがmavenなどをいじっているうちに、今までの僕のやっているディレクトリー構造はちょっと違うのかな、と思いました。これは、けっしてめちゃめちゃ変だというわけではないし、eclipseでTomcatプロジェクトを作った場合の標準なのですから。

しかし、テストのソースは、或いはコンパイルされたclassファイルは、少なくとも実際のアプリケーションの中にはいるものではありません。

さらに、cvsで管理する際も今編集しているwebアプリケーションがそのままcvsに登録されているものと全く同じ、というのも問題があるのかもしれません。

少々抽象的なので、もう少し具体的に話しをすると、現在はほぼ次のようなディレクトリー構造をしています。

└├　　｜├　　｜└　　｜　├　　｜　├　　｜　└　　｜　　├　　｜　　└　　｜　　├　　├　　├　　├　　├　　└　└　├　├　└　　├　　└

これに対して、mavenでstrutsのプロジェクトを作ると、以下のようなディレクトリ構造が自動的に作られます。

├│├│├││└││　└││　　└│├│├││└││　└││　　└│├││└││　└││　　└││　　　├││　　　└│└│　└│　　└└　├　│└　│　└　│　　└　├　│└　│　└　│　　└　├　├　│└　│　└　│　　└　└　　└　　　└　　　　├　　　　├　　　　├　　　　│└　　　　│　└　　　　│　　└　　　　├　　　　│└　　　　├　　　　└

それから、今回あとで説明するであろうCactusに含まれているsampleのディレクトリ構造は

├│└├├│├│├││└││　└││　　└││　　　└││　　　　└││　　　　　└│├││└││　└││　　└││　　　└││　　　　└││　　　　　└│└│　├│　├│　└│　　├│　　└└　├　│├　││└　││　└　││　　└　││　　　└　││　　　　└　││　　　　　└　│└　│　└　│　　└　│　　　└　│　　　　└　│　　　　　└　│　　　　　　└　└　　└

eclipseのプロジェクトで作った、私がずっと使っていた1番上のディレクトリ構造は、そのままTomcatにそのままdeployするディレクトリー構造になっています。これのメリットは

そのままTomcatにデプロイできるわけですので、同時に、そのままeclipseの中からTomcatを立ち上げて、ソースを書き直すたびにすぐにその成果を確認できる。
eclipseで作ったプロジェクトそのままなので、何の変更も必要がないがない。

一方で、デメリットもあります。

ソースディレクトリーがWEB-INFの下にあるので、warファイルをそのまま作成したら、ソースも含まれてしまう。
今回の話しのように、テストのソースもWEB-INF/srcを使わざるを得なく、したがって同様にwarファイル作成時にそれらのテストのクラスファイルまで含まれてしまう。

上記のことも、antなどの設定により、warファイル作成や、あるいはdeployの際に解決することは可能ですが、あまりテストと本来のソースが混ざるのは、混乱の元になるので、少々避けたいところです。

そして、下のmavenで作ったものと、Cactusのサンプルはほぼ同じ(というかサンプル自体mavenで作ったのかもしれませんが)構造になっています。ポイントは

ソースのコードとコンパイルしたクラスファイルを別のディレクトリ(target)にしている。
本来必要なコードとテスト用のコードも別にしている(src/javaとsrc/test-cactus)。
Cactusのテストと、純粋なJUnitのテストのディレクトリも分けている(src/test-cactusとsrc/test---mavenの方)。
distというディレクトリにwarファイルを作成する。

そこで、結論としては、小さなプロジェクトであれば、eclipseのTomcatプロジェクトタイプ、少々大きくなるようなプロジェクトであれば、mavenタイプというのが良いのではないでしょうか。 (なんだか、あまり根拠のないような、あるような・・・(--;)

maven

先ほどから出ている、mavenっていうのを説明できるほど私は詳しくありませんが、少なくとも上記のようなプロジェクトを作成するとき、ほとんどワンコマンドで作ってくれるので、結構便利です。

そこでmavenのダウンロードから、1.02をダウンロードしてきて、それを展開します。

MAVEN_HONEを設定します(例えば、set MAVEN_HONE=c:/maven-1.02)。そして、${MAVEN_HOME}binにパスを通します。

そして、どこぞのディレクトリでDosプロンプトになって

maven genapp some_directory>maven eclipse ]]>

1番目のmaven siteではいくつかの質問がされます。

最初はProject Template:strutsを入力して、リターン。
2番目はアプリケーションのID(どうやらwarファイル名になるらしい):webcms
3番目はアプリケーション名:webcms
4番目はパッケージ名:com.chikkun.webcms

これだけ答えると、上記のmavenの「ディレクトリー構造」が自動で作られます。

それ以外に、project.xmlなどが作成され、これを修正する必要があるのですが、今回は避けます(いずれ・・・)。