最初に戻る
このDispatcherServletはstrutsにおける、ActionServletにあたる。
最初に戻る
これは、Springの設定ファイルを読み込ませるためのもの。そのファイル名はwebcms-servlet.xmlとなり、ここのwebcmsは、servlet-nameにあたる。
最初に戻る
SpringにおけるcontrollerはstrutsにけるActionにあたる(MVCのC-controller)。
適当なパッケージで(ここではcom.chikkun.webcms.test)HelloWorldControllerを作成する。
最初に戻る
上記のWEB-INF/webcms-servlet.xmlに次の設定を書き込む。実際にはsrc/webapps/WEB-INF/webcms-servlet.xmlに書き込んでおけば、mavenがwarファイルへと固めるときにコピーしてくれる。
最初に戻る
デフォルトではJSPなので、velocityを使いたかったら、少々多めにwebcms-servlet.xmlに書き込まなくてはならない。
webcms-servlet.xmlにはview resolverの他に、velocityConfigurerも登録する必要がある(jspの場合はいらない)。
文字化けに相当苦労したけれど、以下のように指定しておけば、今のところ文字化けは出ていない。
最終的にwebcms-servlet.xmlは以下のようになる。
何かと文字化けを起こしてしまった。色々回避する努力をしてみましたが、駄目でした。誰か教えて!!
後日談色々文字化けに苦労したけれど、最終的には、何とかうまくいった。
が良かったみたい。
最初に戻る
helloWorldcontrollerの遷移先であるhello.vmの作成
return new ModelAndView("hello.htm", "message", greeting);の最初のhello.htmがhello.vmになるので、WEB-INF/vm/hello.vmを 作成する(実際にはこの指定の仕方は、上記のViewResolverの設定の仕方で色々できるが、とりあえずデフォルトで)。
最初に戻る
上記の図のように
controllerは上記のように色々ありますが、とりあえず次の4つが使えれば良いと思う。
今回は3番目のSimpleFormControllerを利用してみます。
ユーザー名とパスワードを入力するフォームから、送信ボタンをクリックすると、データを取得し、DBに登録し、そして次のページでそれらを表示するような簡単なものを作成する。
ただし、ユーザー名、パスワードは必ず入力する必要があり、ユーザー名は半角英数で4文字以上10文字以下、パスワードは必ず半角アルファベットと半角数字を混ぜて、5文字以上20文字以下とする。
もし上記に反した場合は元のフォームに戻し、そこにエラーメッセージを表示させる。
だいたいの流れは次のよう。
ごく簡単なWEB-INF/vm/input.vm
Velocityについては簡単に触れると、本来JSPの場合Springタグが用意されているのだが、Velocityでは
#springBind("command.pass")で使えるようになる。ここのcommandとは、後述するControllerにおける
return new ModelAndView(getSuccessView(), "command", command);の、2番目の引数に一致する
(本当に、ちょい自信がない)。それでpassはcommandの中のフィールド名。
こうしておくと、status.errorMessageやstatus.valueで値を取り出せる。statusは固定。
最初に戻る
これも、極簡単に
最初に戻る
これは、strutsのActionFormにあたるものだが、POJOであるところが大きく異なる。今回は単に2つの フィールドがあるだけなので、ユーザー名とパスワードのフィールドとgetterとsetterだけのクラス。
最初に戻る
テーブル名は、クラスの定義の上、フィールドの型やフィールド名はgetterの上に書き込む。上記のソースに書き加えたところだけを引用する。
ここではTESTというテーブルを作成し、フィールドはIDというシークエンス(これはHibernateが自動で設定してくれるので、実際には全くソースには書く必要がない)と PASSという64文字でnot null、NAMEは64文字でnot nullというものを指定してる。
さらに忘れてはいけないのが
webcms/src/conf/hibernate.cfg.xmlに次の一行を書き込む。
これはant hibernateで作成されるマッピングファイルで次の行うテーブルの作成時に作成される。
最初に戻る
ant schemaexportでテーブルを作成する。schemaexportタスクはdepends
hibernateでhibernateタグはdepends propertyなので、 それらのタスクも自動で実行されるので、ant
schemaexportだけでテーブルが作成される。
確認はwebcms/WEB-INF/database/webcms.logの中を見ることによって確認できる。
ただし、HSQLDBを立ち上げることを忘れないように。
最初に戻る
先ほどのUserAndPassCommandのソースの中に、今度もXdocletのタグを書き込むことになる。
次にAntのbuild.xmlにもwebcms-servlet.xmlに書き出す部分をを書き足す。少々複雑なのは、現在strutsでもspringを使っており、なおかつ、 定義ファイルが違うので、書き出す元となるソースを限定している。
最初に戻る
Hibernateを使ってデータのやりとりをするDAOを作成。今回は保存と削除のみ作成することにする。
上記にあるようにgetHibernateTemplate()を使っている。これはsessionの管理をSpringに任せ、かつ、AOPを使おうという意図である。
その為には、次の説のようにSpringの設定が必要になる。
最初に戻る
上記のように、testDAOを直接使わずに、testServiceで定義してあるものを介して、利用することにする。トランザクションとロギングをAOPで実現している。 ただ
にあるように、testDAOで直接受けるのではないので、Interfaceでインスタンス(com.chikkun.webcms.test.ITestDAO)を受け取ることになるので、
そのInterfaceを作成しなくてはならない。順番が逆だが、Eclipseのリファクタリングを使うと、とっても簡単。ソース上で右クリックして「Refacto－＞Extract
Ingerface」で あっという間に作成される。出来たのが次のもの。
最初に戻る
DatabaseTestCase(DBUnit)を使って、先ほどのDAOのテストをしてみよう。といっても、よくわかっていないところもあって、若干不安だが・・・・。
まずDBUnitを使うと何がいいかというと、DBは刻々と状況が変わるので、なかなかテストしづらいが、このDBunitを使うと、 現在のDBのデータをバックアップを取っておき、新しいデータに置き換えて、テストをした後に、最後に元に戻すと言うことが、比較的簡単にできる、ということです。 手順としては
最初は自分の用意したデータを用意。これはxmlファイルで用意する。形式は単純です。
次に、データのバックアップ、データの元に戻すclassを作成する(色々使い回しが出来そうなので)。まずはバックアップ(これもDatabaseTestCaseを利用)
次に、データを戻すクラス。
さて、上記2つを使い、TestCaseのソースは次のよう。
ほとんど、test自体は何もしていませんが、一応テストに通ったので、ビジネスロジックを作成しよう。
最初に戻る
今回はDBに登録するだけ。Xdocletのタグもしっかり書き込む。
最初に戻る
Controllerは色々、便利なメソッドが定義しているそうだが、それは今後の改題として、とりあえず簡単なものを作成。
最初に戻る
これは上記の、@springタグで書き出してくれるので
ant spring2でおしまい。
最初に戻る
前前節の@springタグで書いた
Validatorを作成します。現在作っているUserAndPassInputControllerはSimpleFormController を継承していて、このcontrollerは上記のように設定しておくと、自動でvalidatorを実行し、成功したらinputSuccess、失敗したらinput に飛ばされます(これら2つのresolverの定義はまだ)。
また、GET(つまり最初のリクエストの場合)の場合もinputに飛ばされます。
また、validatorの使い方はここを参考にされたし。
今回はuserはrequiredとmaxlength(最大何文字か)、passはrequiredとminlengthを指定しています(設定はここ)
最初に戻る
上記のUserAndPassValidatorで使われている「util.validateField("user",up)」などの使い方はValidatorの使い方を参考してください。
設定の仕方を簡単に書くと、まずはStrutsの場合と同様に、validator.xmlに定義を書きます。ただ、このvalidator.xmlは com.chikkun.common.validator.ValidatorLoader.classと同じ場所に置きます(いずれに変えなきゃ)。
最初に戻る
Spring MVCのテストには、springでmockを用意してくれている。と思ったら、spring.jarの中には入っていないらしい。
そこで、新しくproject.xmlに書き込む。そしたら
今回は簡単なチェック。
やった～。通ったぞ!!
最初に戻る
最初に戻る
本に出ていたprocessFormSubmissionというSimpleFormControllerのメソッドを入れてみよう。
SimpleFormControllerのJavadocはSimpleFormControllerにあります。
もともと、validatorなどで、エラーが起こった場合呼び出されるメソッドで、 This implementation calls showForm in case of errors, and delegates to onSubmit's full version else.ということでなので、onSubmitの代わりにこのメソッドが委譲されると言うことだろう。
今回は、input.vmにキャンセルボタンをつけて、このボタンが押されたら、「キャンセルされました」という表示をさせてみよう。
まずはその表示用のvm(cancel.vm)の作成。
さらに以前からあるinput.vmにキャンセルボタンを追加。
そして、次にControllerであるUserAndPassInputControllerにprocessFormSubmissionを書き込んでみよう。
すんなりうまくいった。strutsの場合はLookupDispatchActionを使って、ボタンごとにメソッドを変える方法でやっていたけど、この方が簡単だ!
最初に戻る
実際にはTESTというテーブルのuserというフィールドはunique属性をつけてないが、通常はやはりuniqueじゃなきゃいけないので、 validatorで行うか、先ほどのメソッドprocessFormSubmissionで行うかのどちらかだけれど、今回は後者でやってみよう。
まずは、processFormSubmissionを少し書き換える。
processFormSubmissionメソッドに追加したと同時に、xdocletのタグを@spring.property name="dao" ref="testService"を追加した。
うんちょっと詰まったけど、まあくまくいった。
最初に戻る
まずは結論から言うと、Velocityでなんとかいこうと半日すったもんだしたが、結局うまくいかず(springのタグが使えない)、結局jspで行くことにした 。 したがて、相当書き直す羽目になった(--;)。
その上、jspとvmの混在がなかなかできなくて、相当苦労した。やれやれ。さて・・・・。
formがいくつかあって、それらで入力したデータをDBに登録するような場合(Wizard)、いろいろと面倒なことがあります。
例えば、1つ1つのアクションが違うURLにマッピングされているような場合、途中から始められると困るだとか、フロー自体が途中で分岐するなどの 複雑なことをすると、色々考えなければならないことがたくさん出てきます。
そこでSpringに標準で付いているAbstractWizardFormControllerを利用する方法もあるが、この際だからということで、 Spring Web Flow なるものを使おうかと思います(ただし、あとで検索した際のページには本家のspringWebFlowも結構いけているらしい(-.-)。
ただ複雑なものを作るのは億劫なので、次のようなものを考えます。
けっこう話しが面倒なので、自分の頭の整理もかねて、概要を記す。
com.ervacon.springframework.web.servlet.mvc.webflow.BindAndValidateCommandAction
フォームからのデータをBindしvalidateするクラス。これは元々すでにあるもので、webcms-servlet.xmlのmergeファイルに定義だけ書く。 アプリケーションを呼びだれたとき、まず呼び出される。
このクラスは設定ファイルで、データを入れる「コマンドクラス」とvalidateする「validatorクラス」を指定する。
Validatorクラス。
上記のBindAndValidateCommandActionでは、validatorを指定するので、それを作成。
自分で作成するActionクラス。MVCのM。これはcom.ervacon.springframework.web.servlet.mvc.webflow.Actionをimplements
する必要がある。
public final String execute(final HttpServletRequest request,final
HttpServletResponse response, final Map model)を定義し、
必要な処理をこのメソッドに書く。また戻り値はreturn
"ok"などの文字列で、この戻り値で、後で説明するwebflowの定義で、処理を分岐する。
src/spring-bean.xmlに書き、mergeさせる。input-flow.xml
flowの定義を書く。これが一番重要！
最初に戻る
これが一番重要なところですが、まずは全部を表示して、その後細かく説明する。
まずはxmlのルートはweb-flowでこの中に定義を書いていく。属性のnameは名前で、特に他とは関わらない模様(何でもOK)。
そして、次に書き込むのは(僕が知っている範囲では---subflowはまだわからん)、4つのstateを書くことになる。
の4つだが、まずはstart-state。
属性のstateで指定したものから始めるという意味。今回はuserAndPassという(実際にはidで指定)次のview-stateに飛べ、ということになる。
start-stateでuserAndPassが指定してあるので、ここのidがそれなので、飛んでくる。
そして、ブラウザに見せるviewがinputUandPであることを意味している。ただこれが実際にはどのファイルになるかは、view resolverの設定で決まってくるが、 今回では、後に示すように、デフォルトはvmだが、そこにない場合はjspとなるようにしてある(したがって同名のvmがあるとまずい)。
そして、jspの中のhiddenの以下のような値_eventの値がfromUandPがあり、submitボタンで実行されたらbindAndValidateUandPという処理へ行け、 ということになる。
そして、前項で飛ばされてきたbindAndValidateUandPだが、先のview-stateでJspなりVelocityなりを表示させて、
フォームを実行させてhiddenの_evenの内容で次の処理に分岐させるものだが、今回は、実際の処理にはいる。
ただbindAndValidateUandPは、自分で作成するクラスではなく、
もともと用意されているクラスで(com.ervacon.springframework.web.servlet.mvc.webflow.BindAndValidateCommandAction)、それをSpringのBeanの定義のところに
書いておくわけだが、このクラスがやることは
の2種類で、上記の2種類の処理で全くエラーが起こらなかったらokを、エラーが起こったらerrorを文字列で返してくる。
上記の設定で言えば、
赤いところがActionのBeanの名前になっているが、これが次のbindAndValidateAct1.okのドットの左側になり、右側のokは前述したように、返ってきた文字列になる。 つまり、データのBindもValidatorもokだったら、ということになる。
次に、黄色いbindAndValidateUandPAction方だが、これが実際のSpringにおけるBeanの定義名で、webcms-servlet.xmlに書き込む(実際にはmergeファイルのspring-beans.xml)。 実際には、以下のように定義してある。
コマンドクラス(実際のソース)の指定と、validator(実際のソース)クラスの指定を行っている。
BindとValidateがうまくいったら、次に進む。次が実際のActionになる。
前項同様に、
赤色が、ActionのBeanの名前で、黄色がそのSpringのBeanの定義名である。そして、赤のActionのBean名も同様に、このクラスのメソッド(execute)で
返される文字列によって分岐するように設定する。今回は1方向にしか進めないようにしてあるのでokだけだ(ageAndSex)。
また、このクラスは自分で作る必要があり、最初に述べたようにcom.ervacon.springframework.web.servlet.mvc.webflow.Actionをimplemtnsした
ものだ。そして、FirstAction.java.htmlにあるように
を定義して、
で文字列を返すが、okでなくてもかまわない。また、条件分岐で色々な文字列を返し、flowの定義で分岐することも可能だ。
さて、上記以外に多少コメントすると、
で、フォームからpreやprepre、preprepre、saveがいつもの_eventで返ってきた場合、preは前のmailAndAdress、prepreだったら前の前のageAndSexに飛ぶようにしてある。 もちろん、本来の処理のsaveだったら最後の処理へと飛ぶわけだ。
実際のJSPは次のよう。
さらにもう1つ。
これは最後のstateになるわけだが、必須だというわけでない。今回は使っているので、ここでたぶん、_flowIdあたるが消されてしまうのだと思う。
というのも最後に、データをDBに登録して、リダイレクトしてJSPを表示させているが、戻るボタンで戻ろうとすると、例外が発生している。end-stateにしなければ、大丈夫かもしれない（未確認）。 ただ、反対に二重登録されないような方法を講じなくてはならないだろう。
最初に戻る
何度も言うように、実際はwebcms-servlet.xmlに直接ではなく、spring-beans.xmlに書く事になる。