eclipseのFileメニューから、新規->プロジェクトを選んで、

• Tomcatプロジェクトを選び、
• プロジェクト名をwebcmsに（とりあえず)して、
• とにかく終了ボタンを押す。

すると、次のような(ちょっと見づらいけれど)webcmsというのがナビゲータに現れます。

web.xmlなどを編集するのに(別にエディタでもかまわないので、必要を感じなければここは飛ばしてOK)、

eclipseプラグインXmlエディタ(あまてらす)

からtk.eclipse.plugin.htmleditor_1.6.4.zipをダウンロード、そして

c:/eclipseに展開。eclipseが立ち上がっている場合には、再起動。

eclipseのメニューから(自分のエディタを使う場合は下のものを全てコピペしてもOK)

新規->その他->HTML->xml

を選び、ファイル名をweb.xmlと入力して、「次へ」をクリック。

次に、DTDを公開するをチェックし、

公開ID：-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN

システムID：http://java.sun.com/dtd/web-app_2_3.dtd

と入力して、終了ボタンをクリックすると、次のようなファイルができる。

encodingはMS932などとなっている可能性もありますが、それはeclipseのデフォルトのencodingで、むしろそのeclipseのencodingを変更した方がよいかも(ただし変更の際、選択肢にないので直接入力する必要があります。

これに、最低限の設定をまず書き込んでいく。実際には、以下のようになります(多少の説明は後にします)。

• display-nameとdescriptionタグは「Tomcat Webアプリケーションマネージャ」に使われる。

  下の表示名。

  

• filterというのは、ここでは詳しくは触れませんが、これを書いておき、後述する実際のfilterというクラスを作ると、日本語が化けなくてみんな幸せになれるのでした。

• servletは今回のstrutsのミソ。これによって、strutsによるservletを起動する。

  action org.apache.struts.action.ActionServlet config /WEB-INF/struts-config.xml 1 ]]>

• welcome-file-listは単に、apacheの

• taglibはstrutsのタグライブラリを使うためのもの。

これは、最初から作るのが面倒なので、このページの最初にダウンロードし、展開しておいたjakarta-struts-1.2.4.tar.gzの中の

jakarta-struts-1.2.4/webapps/struts-blank.war

をさらに展開する。このwarという拡張子のファイルも圧縮してあるので、適当なところで展開。これにはコマンドラインで、

jar xvf struts-examples.war

で展開される。そうすると

• pages

• WEB-INF

• META-INF

という3つのディレクトリーができていて、このなかのWEB-INF以下のファイル・ディレクトーを全て(ただし、先ほど作成したweb.xmlを除く！！)

C:\eclipse\workspace\webcms\WEB-INF

以下にコピーしてしまう。

eclipse/workspace/webcms/WEB-INFにstruts-config.xmlがあるので、これを編集します。最初は以下のようになっています。

作成するソースは全てで４つ。

HelloWorldAction

これが実際のアプリケーション

HelloWorldActionForm

これは値を保存するbean

HelloWorldMenuAction

単にhtmlのformを表示させる中身のないaction

SetCharacterEncodingFilter

文字化けしないようにするfilter

ほとんどがコメントアウトされているので、見やすくするために以下のように、すっきりさせましょう(コピペしてOK)。

これを少しずつ修正します。

これだと日本語が書き込めないので、

を

にします。

1. form-beanタグの中の「name="logonForm"」を「name="helloWorldForm"」。このnameが論理名(これがわかりづらい呼び名ですが、単なる名前ということ---クラス名は長いので)。
2. 「type="org.apache.struts.action.DynaActionForm">」を「type="com.chikkun.webcms.test.HelloWorldActionForm">」にします。このtypeは実際のクラス名。

つまり

が

になります。

1. 「path="/InputSubmit"」を「path="/helloWorld"」に。このpathはブラウザでhttp://localhost:8080/webcms/action/helloWorldとすると、このJavaのアプリケーションが実行されることを意味します。
2. 「type="app.InputAction"」を「type="com.chikkun.webcms.test.HelloWorldAction"」にします。これが、この後作成するJavaのクラス名になります。
3. 「name="inputForm"」を「name="helloWorldForm"」に。これは先ほどのform-beanの時の論理名になります。
4. scopeとvalidateはそのまま。
5. 「input="/pages/Input.jsp"」を「input="/WEB-INF/jsp/input.jsp"」にします。これはどこでも良いのですが、WEB-INF以下のファイルは直接ユーザは見ることができないので、セキュリティ上、とりあえず、そうしておきます。このinputというのは、そのすぐ上の「validate="true"」になっていて、validateしたときにひっかかった場合の遷移先になります。今回は最初のフォームのページと同じにしてあります。

そしてもう1つ。単にhtmlのフォームを表示させるためのHelloWorldMenuActionについても追加します。

を

に変更します。これは、アプリケーションからここに書かれてある設定の値などを取り出すためのファイルで、詳細は実際作る場面で説明します。

webcms/WEB-INF/srcで右クリックして、新規->packageを選択して、

「com.chikkun.webcms.test」と入力して、終了。

通常strutsではactionというのが、実際のアプリケーションで、formといのがactionの補助となる値などを格納するもの。そのactionを作成しよう。

先ほど作ったパッケージのtestというところで右クリックして、新規->Classを選択。デフォルトでは以下のような中身のものができているはず(多少環境によって違うかもしれないし、また、コメントは変えられるので、いずれ変えた方がよい。)。

]]>この public class HelloWorldAction { }

]]>を public class HelloWorldAction extends Action{ } ]]>

に書き加える。そうすると、Actionのところで、赤い波線が出るけれど、これは「Actionって何」とeclipseがわからないので、怒っている。その怒りを静めるために、ソースの画面の中で、右クリックして、Source->Organize Importを選択し(ショートカットもある！)、org.apache.struts.action.Actionを選択して、終了させると、荒ぶるeclipseが静まる(実際にはライブラリーが必要なので、それをimportする文を挿入してくれる---import org.apache.struts.action.Action;)。

次に、

]]>をクラス内に挿入。ここでも赤い波線の嵐。同様に、を実行する。

]]>その結果以下のようになっているはずです。 /* * Created on 2005/05/07 * * TODO To change the template for this generated file go to * Window - Preferences - Java - Code Style - Code Templates */ package com.chikkun.webcms.test; import java.io.IOException; import javax.servlet.ServletException; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import org.apache.struts.action.Action; import org.apache.struts.action.ActionForm; import org.apache.struts.action.ActionForward; import org.apache.struts.action.ActionMapping; /** * @author Administrator * * TODO To change the template for this generated type comment go to Window * Preferences - Java - Code Style - Code Templates */ public class HelloWorldAction extends Action { public ActionForward execute(ActionMapping mapping, ActionForm actionForm, HttpServletRequest request, HttpServletResponse response) throws IOException, ServletException { return mapping.findForward("success"); } } ]]>

これで、中身がないactionが出来た。そして、フォーム表示用のHelloWorldMenuActionも作成します。

そこでformのひな形を作ります。

先ほどのactionとほぼ同様に「HelloWorldActionForm」という名前のクラスを作成。クラス名だけが違うけれど、ほとんどactionと同じファイルが出来たはず(以下)。

]]>この public class HelloWorldActionForm extends ValidatorForm{ } ]]>

を書き加える。またeclipseが怒るけれど、Source->Organize Importで静める(今回は他に同名のクラスがないので、すぐにimport文が挿入されると思う)---「静める」は「鎮める」かな(--;)？。

今回は名前をフォームから取得するだけですが、それではあまりにも悲しいので、次のものを入力します

これだけだと、単に変数の宣言だけですので、これに対する、setter、getterメソッドを作成します。詳細は避けますが、直接他のクラスから、このformの変数にアクセスできないようにして(private)、値を入力するsetterと値を取得するメソッドを通じて値のやりとりをします。

また、このsetterがあると、strutsが自動的に名前を入力するフォームから名前を代入してくれます。

さてそれらのメソッドはeclipseのソースの画面上で、Source->Generate Setters and Gettersを選択すると、自動でそれらを作ってくれます。

以下のようなソースが出来ていればOK。

そうそう、言い忘れていましたが、eclipseは確かデフォルトでファイルを保存すると、自動でコンパイルしてしまいます。コンピュータが非力な場合は変更した方が良いかもしれません(projectメニューの「自動でビルド」のチェックをはずせば良い)。ただしそのときはソースを書き終えたら、必ずコンパイルしてください。

とりあえず、htmlのフォームで入力された名前はHelloWorldActionFormのnameというプロパティへ代入されているので、それ以外の日付などをここでformにセットしよう。

また、ここでは本来はactionを分けた方がよいのかもしれないのですが、別に作るのも面倒だし、セッションの勉強にもなるので、sessionがあったら初めてアクセスなので、htmlのフォームへforwardさせ、そうでないときは処理をして「こんにちは、？？？さん」のページへ飛ばします。時々入力していると「赤い波線」が出ますが、無視してやっていて、消えないときは

• 入力ミス
• import文がない

入力ミスはいいとして、import文は、例えば、下のCalendarなどというクラスを使うときに必要なるので、import文を書く。これはいつもの「Source->Generate Setters and Getters」をすると、自動で書き込んでくれる。

でき上がったものは以下のよう。

もう1つのは(フォーム表示用)全くひな形のままでOK。つまり

先ほども簡単に触れた文字化け防止用のfilter。これは

WEB-INF/src/com/chikkun/common

というディレクトリを作成して、そこに次のようなソースを書き込みます。人様の作成したものなので、コメントが多いけれど、そのまま載せます。これをコピペしてください(もちろんコンパイルも)。

Example filter that sets the character encoding to be used in parsing the * incoming request, either unconditionally or only if the client did not * specify a character encoding. Configuration of this filter is based on * the following initialization parameters:

*
• encoding - The character encoding to be configured * for this request, either conditionally or unconditionally based on * the ignore initialization parameter. This parameter * is required, so there is no default.
*
• ignore - If set to "true", any character encoding * specified by the client is ignored, and the value returned by the * selectEncoding() method is set. If set to "false, * selectEncoding() is called only if the * client has not already specified an encoding. By default, this * parameter is set to "true".
*

Although this filter can be used unchanged, it is also easy to * subclass it and make the selectEncoding() method more * intelligent about what encoding to choose, based on characteristics of * the incoming request (such as the values of the Accept-Language * and User-Agent headers, or a value stashed in the current * user's session.

* The default implementation unconditionally returns the value configured * by the encoding initialization parameter for this * filter. * * @param request The servlet request we are processing */ protected String selectEncoding(ServletRequest request) { return (this.encoding); } } ]]>

何度か出てきた最初の頃に解凍したblankをWEB-INF以下をコピーした際、その中にvalidation.xmlのひな形があるので、それを編集します。

最初のひな形は

で、少々長いので、コメントを取ってしまって

と縮めて

と

の間に、

を書き込んでください。意味はしっかり勉強してください(あまり詳しく説明すると本が書けてしまいます(--;)。

最終的には

てな感じですかな。

英語だと、何もせずにここに書き込んだものが使えるのだが、残念ながら日本語は日本語のまま書き込んだものを変換して、使わなくてはならない。これが結構面倒だけれどしょうがない。

そこで、とりあえず

websms/WEB-INF/conf/ApplicationResources_ja.properties

というファイルを作成する。

すぐ上のvalidation.xmlの設定で「key=・・・」を書き込んでいく。

その次に、dosプロンプトから

native2ascii.exe ApplicationResources_ja.properties ApplicationResources.properties

とたたき、できあがったファイルApplicationResources.propertiesを

WEB-INF/classes/Resources

というディレクトリにコピーする。

注意として、eclipseは時々、f5などで「更新」させるとソースを全てコンパイルするのですが、その際、classesディレクトリをいったん削除してからそれを行います。つまり、せっかくコピーしたApplicationResources.propertiesがなくなってしまいます。今回、実は、それではまって1時間以上無駄にしました(--;)。

色々なhtmlのタグじゃないタグがありますが、頑張って勉強してください(ただし、実際にはほとんど最近はjspを僕は使っておらず、その代わりvelocityというものを使っています。ただ全く知らないと困るので、やはり、多少は勉強しておいた方が良いでしょう。