xdocletとはそもそも何なのかというと、strutsのページで行ったweb.xmlやstruts-config.xml、valication.xmlなどの設定ファイルは、Javaのソースを書き加えるたびに設定を足していかなくてはならないわけですが、これをソースの中にJavadoc形式でそれらの情報を書き込んでおき、xdocletを使って(antも)それらを先ほどのweb.xml、struts-config.xml、valication.xmlに自動で作ってしまおうというものです(実際にはEJBなどにも使う)。つまりソースでそれらの情報を一元管理しようとするものなわけです(以前はweb.xmlもその方法で作っていたのですが、こちらはあまり変更されないので、時間の節約---説明も、実際の制作の場でも---も考え今回ははずします)。

さらに、次のような意味もあります。数人でcvsなどで管理しながらアプリケーションを作っている場合には、何度も出てくるxmlを別々に作って、それらをマージする必要が出てくるわけですが、このxdocletを使えば、そもそもxmlはソースの中味から自動で作成するので、そのようなマージする必要がありません（もっとも同じソースを別々の人が作成すると、元も子もありませんが、それはcvsやコミュニケーションで解決すべき問題でしょう）。

xdocletのサイト

からxdoclet-bin-1.2.3.gzをダウンロードしてきて解凍します。その場所ですが、今後はいろいろなライブラリをインストールことになると思うので、

c:/javaに解凍しましょう。

つまり

c:/java/xdoclet-1.2.3ができることになります。

次に、まずはDosプロンプトから

C:/ant -version

と打つと

Apache Ant version 1.6.2 compiled on July 16 2004

ここ

が出てくることを確認してください。もし、これが動かないと、に書いてあるAntのインストールを行ってください。

次に実際のbuild.xmlを作成します。何でもエディタは良いので、次のファイルを作成します。

c:/eclipse/workspace/webcms/build.xml

詳細はAntの本かホームページで調べてください(結構たくさんある)。

• propertyというタグは変数の定義です。
• filesetというのは、ライブラリーなどのjarファイルの指定。
• idというのは、上記のfilesetを束ねている(今回は)。
• targetというのが、いわゆるやりたい「仕事」で、ここにやりたいことを定義していく。今回のdefaultのターゲットはstrutsにしてある(今回のstruts-config.xmlを作成するターゲット)。すなわち、コマンドライン上でantとすると、strutsというターゲットが実行される。
• struts以外にcleanという単にディレクトリーを削除するもの、strutsと同様ソース等からweb.xmlを作成するweb、ApplicationResources.propertiesをnative2asciiで変更してconfディレクトリーからWEB-INF/classes/resourcesにコピーするというpropertyターゲットが書いてある。

xdocletのマージファイルに関するドキュメント

ここもわからない場合はを調べてください。

これで、Action、ActionForm(validation.xmlも含む)などのstruts-config.xmlへの書き出しは出来るのですが、実際にはそれ以外の