Teeda/gettingStarted
をテンプレートにして作成
[
トップ
] [
新規
|
一覧
|
検索
|
最終更新
|
ヘルプ
|
ログイン
]
開始行:
[[Teeda]]
Teedaの入門記を書きます。
blogで書いていたけど、皆で書けるように。
#contents
* 環境作り [#ec8afccf]
Teeda入門を試すのに必要な環境作りに付いては [[Teeda/getti...
以下ではteeda-ex1プロジェクトを作成済みであるものとして説...
* Teedaとは [#e88a6d02]
TeedaはJSF実装をベースにしたWebアプリケーションフレームワ...
Teedaは大きく分けて2つのpartがあります。
・Teeda Core：JSF1.1の実装
・Teeda Extension：HTMLテンプレートを持ったJSF拡張フレ...
基本的にお奨めの使い方はTeeda Core、Teeda Extensionを共に...
が、Teeda Coreだけでも純粋なJSF実装としてお使いいただけま...
JSFは実はServlet以外にもPortletの方にも対応することが仕様...
そちらの面もid:shinsuke_sugayaさんを中心にサポートいただ...
では本題に戻りまして。。。
Teeda ExtensionはPage駆動アーキテクチャに基づいていて、記...
基本的に以下の2つだけです。
・Pageクラス（ただのPOJOクラス。クラス名をPageで終える...
・HTML（基本的にidをふるだけ。）
1HTMLファイルに対して、1Pageクラスが対応します。
この辺はサンプルを見つつ、学習するのがよいと思うので、次...
* 最初の一歩 [#o65972e7]
+まずはHello Worldで基本的な動きをつかんでみましょう。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitiona...
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja"...
<head>
<meta http-equiv="Content-Type" content="text/html; char...
<title>Hello</title>
</head>
<body>
Hello World!!!
</body>
</html>
このシンプルなHTMLをPageクラスとマッピングさせてみましょ...
HTMLの方は簡単です。
Mappingして動的に変えたい項目にidをつけたタグを振るだけで...
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitiona...
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja"...
<head>
<meta http-equiv="Content-Type" content="text/html; char...
<title>Hello</title>
</head>
<body>
Hello <span id="name">World!!!</span>
</body>
</html>
これをただ単にブラウザで見るとHello Worldと表示されます。
ではこれに対応するPageクラスを作成しましょう。
Pageクラスを作成するときには、EclipseプラグインDoltengを...
以下、[[Teeda/gettingStartedSetup]]の手順に沿ってDolteng...
teeda-ex1プロジェクトの作成が終わっているものとして説明し...
teeda-ex1プロジェクトのhello.htmlのソースを開いて、HTMLソ...
なにやらダイアログが表示されます。このダイアログでPageク...
DoltengではHTMLの内容を読み込んで、Pageクラスに必要そうな...
自動的に追加したPageクラスを作成してくれます。
また、QuickJUnitにおけるCtrl+9でテストクラスへの移動が出...
Ctrl+5でDoltengではPageクラス←→HTML間を移動できます。
（Pageがない場合にダイアログが表示されPageクラスを作成す...
ここではダイアログで単に「Finish」ボタンを押して、Pageク...
HelloPageクラスが作成されます。
作成されたPageクラスのプロパティnameに"Seasar2"と入力して...
package examples.teeda.web.hello;
public class HelloPage{
private String name = "Seasar2";
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
これで準備は整いました。
Tomcatを起動して、localhost:8080/teeda-html-example/view/...
というように表示してみると
Hello Seasar2
と表示されます。
このとき何が起きているのでしょうか？
ひとつひとつ見ていきましょう。
まずTeedaの基本は全てidです。
idでマッピングされない項目は、動的な処理を行う集合（コン...
みなされません。
idがない場合全て単なるテキストとして処理されます。
上記の例で言えば、spanタグにnameというidをふることで
あ、このタグは動的な値を扱うのだとTeedaは解釈します。
idの振り方には規約がありますが、それはこの後一つ一つ見て...
すぐに覚えられます。また、そのリファレンスも十二分に準備...
*outputText [#pb211f76]
動的に出力する項目（outputText）はどのように実現するので...
簡単です。
spanタグでidをふるだけ。
Hoge.html
<span id="aaa">bbb</span>
で、Hoge.htmlが読まれるとHogePageクラスのaaaプロパティ
が上記で書かれている値（bbb）の代わりに出ます。
次回は入力(inputText)を見てみましょう。
*配置について [#d37b6e2a]
おっと。忘れちゃいけない配置についてお話しておきます。
Teedaは基本的に、Seasar2.4の配置に基づいています。
2.4でのPageクラスなどの構成は以下で書いたので割愛。
余談ですが、このようにパッケージ構成を決めることで煩雑だ...
DIの設定部分を取り除いているのです。
だからS2.4は、diconをいじる必要がほとんどなく、
パッケージ構成を初期情報として与えるだけで終わりです。か...
- http://d.hatena.ne.jp/shot6/20060818#1155832996
これと同様に、HTMLの配置は以下のようにします。
ルートコンテキスト
+view
+[サブアプリケーション名]
-各HTML
サブアプリケーションとは1ユースケースと同等です。
これを例えば、サブアプリケーションhelloの中に、HelloPage...
ルートコンテキスト
+view
+hello
-hello.html
となります。
Teeda（というかS2.4の規約）ではデフォルトは/view以下を
対象のHTMLとみなして処理します。
*inputText [#yfdb00e1]
前回までにoutputTextはやりました。
今回はinputTextをやりましょう。
inputTextも非常に簡単です。
通常のinputで、typeにtext、idをarg1のように
Pageクラスのプロパティ名をつけるだけです。
add.html
<input type="text" id="arg1" title="INPUT1"/>
AddPage.java
public class AddPage {
private int arg1;
//getter, setterは省略
親クラスで記述しておくことも可能です。
*submitと画面遷移（do） [#b30b3fe2]
出力、入力と来たので、あとはsubmitボタンを説明すれば
簡単なアプリを作ることが出来ます。
というわけでボタンです。
ボタンは今までと違い、ちょっとした規約があります。
といってもHTML上では相変わらずidをふるだけです。
ボタンには3種類あります。
-do
-go
-jump
です。
do系のボタンは、それに該当するPageクラスのメソッドが
呼ばれます。たとえばdoCalculateというidをつけておくと、
Pageクラスの同様のメソッドが呼ばれます。
add.html
<input type="submit" value="calculate" id="doCalculate"/>
AddPage.java
public String doCalculate() {
result = arg1 + arg2;
return null;
}
ではこれでどのような画面遷移が発生するのでしょうか？
実はdoCalculateメソッドの戻り値が次の画面遷移先になってい...
そのため、doで呼ばれるメソッドはStringの戻り値を持たなけ...
return nullの場合、画面遷移は自画面に戻ってきます。
では、たとえばメソッドの実行後に別の画面に遷移したいとき...
簡単です。これだけです。
AddInputPage.java
public String doCalculate() {
result = arg1 + arg2;
return "addResult";
}
Stringの戻り値で次のPageクラス名を指定すればよいだけです。
同一サブアプリケーション内（たとえば/view/addの以下）であ...
"addResult"のようにHTML名をかいてもらえばそれだけで遷移し...
では、別サブアプリケーションに遷移する場合は？
/view/aaa/from.htmlと/view/bbb/to.htmlとすると、
fromからtoへの遷移は、bbb_toとなります。
つまり/view以下からサブアプリケーションを含めて記述してく...
その際にアンスコでパッケージを区切るように記述します。
これはgoでもdoでもjumpでも変わりません。
非常に直感的なのがよくわかってもらえると思います。
またHTMLからも、どのメソッドが実行されるかが瞬時にわかり...
よくある設定をベースにしたフレームワークだと、画面遷移は
全て設定ファイルに記述するのが当たり前ですが（アノテーシ...
本来見なくてもよいリソースにどこに遷移するのかを見に行か...
Teedaではもっとも画面遷移に関係あるリソースにそのまま記述...
*submitと画面遷移（go） [#m5e82a6f]
では、次はgoについて説明します。
goはdoのように特定のメソッドが呼ばれるわけではありません。
しかし、Aという画面からBという画面にロジックを通さずに
直接行きたい場合などがあると思います。そのような場合にgo...
下記のaaa.htmlは、同一サブアプリケーション内のaaa2.htmlに
直接遷移します。
aaa.html
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; ch...
<title>Page transition</title>
</head>
<body>
<form id="aaaForm">
<input type="submit" id="goAaa2" value="go to same u...
</form>
</body>
</html>
*submitと画面遷移（jump） [#s9fba02b]
では、画面遷移最後のもうひとつはjumpです。
jumpはgoと同じようにロジックを通さずに画面遷移するための...
では違いは何でしょうか？goとjumpには大きな違いがあります。
それは画面遷移時にValidationがあるか、ないかです。
doの場合は当然あるのですけど、goの場合も値のValidationは...
しかし、jumpの場合は値のValidationは行わずに画面遷移しま...
たとえば下記のような足し算の計算後の画面（addResult）があ...
ただ単に戻るボタンを実装したいなどの場合はjumpを使うのが...
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; ch...
<title>Add</title>
</head>
<body>
<form id="addResultForm">
<span id="messages"/>
<span id="arg1"></span> + <span id="arg2"></span> = <s...
<input type="submit" value="back by go" id="goAddInput...
<input type="submit" value="back by jump" id="jumpAddI...
</form>
</body>
</html>
*Validation [#o30f5eb5]
次はValidationについてです。
画面遷移時にValidationについての話が出てきました。
ではどのようにPageクラスのValidationをするのでしょうか。
こちらはS2JSFやS2Strutsを使ったことのある人なら馴染みの
ある方法を採用しています。
そう、定数アノテーションとTigerアノテーションです。
TeedaはJDK1.4に対応しているため、定数アノテーションでも使...
Tigerアノテーションでも使えますが、まずは定数アノテーショ...
定数アノテーションの記法は以下のようになっています。
''public static final String プロパティ名_Validator名 = "...
例えば、下記のような足し算の入力画面のPageクラスがあると...
このクラスでは、引数にarg1とarg2をとり、両方とも入力必須で
桁数が3桁以上入力されなくてはいけないとします。
AddInputPage.java
public class AddInputPage {
private Integer arg1;
private Integer arg2;
public Integer getArg1() {
return arg1;
}
public void setArg1(Integer arg1) {
this.arg1 = arg1;
}
public Integer getArg2() {
return arg2;
}
public void setArg2(Integer arg2) {
this.arg2 = arg2;
}
}
このような場合にどうすればよいのでしょうか。
上記の記述を思い出しながらやってみましょう。
まずプロパティarg1に必須項目のValidatorをしかけましょう。
どんなValidatorがあるのか今は気にしないでください。あとで...
''public static final String プロパティ名_Validator名 = "...
が記法なので、
public static final String arg1_TRequiredValidator = null;
というようになります。所定のValidatorに与えるプロパティが...
してもらえればよいです。
これでarg1に必須チェックがかかります。
さて、次は入力桁が3桁以上でなければいけないというチェック...
標準のValidatorにLengthValidatorというValidatorがあります。
これを使いましょう。
今度はLengthValidatorのプロパティにきちんと値を渡さなくて...
最小の桁数が3桁なので、minimum=3というプロパティを渡しま...
public static final String arg1_lengthValidator = "minimu...
さあ、これでValidationがかかります。
同じようにarg2でもValidationをかけることが出来ます。
先ほど示した例はこのようになります。
AddInputPage.java
public class AddInputPage {
public static final String arg1_TRequiredValidator = nu...
public static final String arg1_lengthValidator = "mini...
public static final String arg2_TRequiredValidator = nu...
public static final String arg2_lengthValidator = "mini...
private Integer arg1;
private Integer arg2;
public Integer getArg1() {
return arg1;
}
public void setArg1(Integer arg1) {
this.arg1 = arg1;
}
public Integer getArg2() {
return arg2;
}
public void setArg2(Integer arg2) {
this.arg2 = arg2;
}
}
このようにValidatorをしかけていきます。
Validatorは各プロパティごとに書かれた順番どおりに呼ばれま...
上記の例だと、arg1はTRequiredが呼ばれて、その後にLengthVa...
Tigerでも同じ仕組みで行われます。この例は各Validatorを説...
次は各Validatorについて見ていきましょう。
*Validatorの種類について [#s1d0874f]
次は各Validatorについて説明します。
ValidatorとはJSF(JavaServer Faces)で決められている画面か...
チェックする機能です。JSFとしても提供しているValidator、T...
あり、Tで始まるやつはTeedaで用意したものになっています。
数値チェック系
-TRequiredValidator 必須チェック
-LengthValidator 長さチェック
-LongRangeValidator longでのレンジチェック
-DoubleRangeValidator doubleでのレンジチェック
-TByteLengthValidator byteでのレンジチェック
-TDoubleRangeValidator 拡張したdoubleでのレンジチェック
-TLongRangeValidator 拡張したlongでのレンジチェック
-TNumberLengthValidator 整数部・小数部での桁数チェック
-TRegularExpressionValidator 正規表現でのチェック
上記のように数値チェック系は多少かぶっているのもあります。
なぜか。それは以下のような機能を付け加えるためです。
-どのボタンを押したときにValidationをするかを指定できるよ...
-メッセージを出力するためのidを自由に変更できるようにする...
です。
下記のように、target属性でどのボタンが押下されたときに
Validationが発生するのかを制御することができます。
public static final String number1_TRequiredValidator = ...
本当は正規表現のValidatorもCommons-validatorみたいに
ひととおり準備してあげればいいんですけど、まだそこまでい...
相関チェック系
-TGreaterEqualValidator
-TGreaterThanConstantValidator
-TGreaterValidator
-TLessEqualValidator
-TLessValidator
相関チェック系では、主に2項目の関係でのチェックを行います。
JSF上、どいつとペアでValidationするのかはHTML上出てくる項...
後者につけなければいけません。今のところですけど。
S2JSFのときにはGreaterEqualしかなかったので
Teedaではひととおり準備してみました。
*簡単なアプリの作成 [#ge733f40]
では、今までに説明してきた機能を振り返ってみて、
簡単な足し算アプリを作成してみましょう。
仕様としては、足し算を行ってボタンを押下するとdoCalculate...
呼ばれます。未入力または桁数が3桁に満たない場合は、Valida...
HTMLはこのようになります。
（まだ説明していない機能やディティールの部分も少し含まれ...
本質は変わりません。後でまた説明します。）
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitiona...
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja"...
<head>
<meta http-equiv="Content-Type" content="text/html; char...
<title id="aaa">Add</title>
</head>
<body>
<form id="addForm">
<div>
<span id="messages"></span>
</div>
<table>
<tr>
<td></td><td><input type="text" id="arg1" title="INPUT1"...
<td><span id="arg1Message"></span></td>
</tr>
<tr>
<td> + </td>
<td><input type="text" id="arg2" title="INPUT2"/></td>
<td><span id="arg2Message"></span></td>
</tr>
<tr>
<td> = </td>
<td><span id="result"></span></td>
</tr>
</table>
<input type="submit" value="calculate" id="doCalculate"/>
<input type="submit" value="back to start" id="jumpStart...
</form>
</body>
</html>
これに対応するページクラスを作りましょう。
idに対応づく変数とアクセサはDoltengが作成してくれるので、...
必要なValidatorを記述するだけです。
package examples.teeda.web.add;
public class AddPage {
public static final String arg1_TRequiredValidator = null;
public static final String arg1_lengthValidator = "minim...
public static final String arg2_TRequiredValidator = null;
public static final String arg2_lengthValidator = "minim...
private int arg1;
private int arg2;
private int result;
public int getArg1() {
return arg1;
}
public void setArg1(int arg1) {
this.arg1 = arg1;
}
public int getArg2() {
return arg2;
}
public void setArg2(int arg2) {
this.arg2 = arg2;
}
public int getResult() {
return result;
}
public void setResult(int result) {
this.result = result;
}
public String doCalculate() {
result = arg1 + arg2;
return null;
}
}
実際にTomcatを立ち上げて、確認してみましょう。
3桁入力しないとエラーでValidationが効いているはずです。
* Message/AllMessages/Messages [#w5bf6dd4]
今回はエラーメッセージについてです。
Teedaでは、エラーメッセージを出すときに大きく2つの選択肢...
+個別の入力項目に対してエラーメッセージを表示する
+画面全体で共通の領域にエラーメッセージを表示する
まず1の場合はどうするかというと、対象の入力項目のid＋Mess...
つけます。
（すでに前回の例で実は出てきていますが。）
<tr>
<td></td><td><input type="text" id="arg1" title="INPUT1"...
<td><span id="arg1Message"></span></td>
</tr>
入力項目arg1に対して、そのエラーメッセージを表示させたい...
arg1Messageとしてください。
これでバリデーションエラー時にarg1に
エラーがあった場合はその内容を表示することが出来ます。
次に2の場合です。
画面全体でエラーメッセージの出す場所を統一して出す場合な...
よくあると思います。
そのような場合はAllMessagesまたはMessagesを使います。
<span id="allMessages"></span>
<span id="messages"></span>
AllMessagesは、Validationに引っかかった全てのエラーメッセ...
表示します。「全ての」の意味をちょっと説明する必要があり...
Teedaでは、エラーメッセージを大きく２つに分類しています。
・idがついたコンポーネントに紐づくエラー
・idがついたコンポーネントに紐づかないエラー
前者は、arg1Messageなどで定義しているものたちだと思ってく...
後者はそれ以外で発生したエラー全てをさします。
AllMessagesはこれら全ての例外を一括で表示します。
一方Messagesは、どういったものなのでしょうか。
Messagesは上記の後者だけを表示します。
つまりidがついたコンポーネントのエラーを表示したいときは
適切な場所にmessageを埋め込まないといけません。
このあたりは画面表示上の都合で使い分けることを想定してい...
*Converter [#u6b92f5b]
Converterは、値の変換をする機能です。
Converterは入力されてきた値をValidationする直前に適切なOb...
描画する直前にStringに変換する機能を持っています。
Teedaでは、Validatorの同じく定数アノテーションまたはTiger...
指定が可能です。
下記にサンプルを示します。
public static final String now_dateTimeConverter = "patt...
*Converterの種類について [#y3e578c7]
Validatorと同様、Converterもさまざまな種類のものを用意し...
通常、Converterに関しては、一般的なprimitiveな値のものは...
Converterによる型変換が入るため、意識する必要はありません。
型変換が明示的に必要な場合は下記のConverterをアノテーショ...
デフォルトのConverter（：の後ろは登録されている名前）
-BigDecimalConverter ： bigDecimalConverter
-BigIntegerConverter ： bigIntegerConverter
-BooleanConverter ： booleanConverter
-ByteConverter ： byteConverter
-CharacterConverter ： characterConverter
-DateTimeConverter ： dateTimeConverter
-DoubleConverter ： doubleConverter
-FloatConverter ： floatConverter
-IntegerConverter ： integerConverter
-LongConverter ： longConverter
-NumberConverter ： numberConverter
-ShortConverter ： shortConverter
拡張のConverter
-TimestampConverter
-TBigDecimalConverter NumberFormatがJDK1.4ではBigDecimal...
-TDateTimeConverter DateでYY/MM/DDなどの変換の閾値を独自...
（TODO Converterの指定の仕方、各Converterの説明）
*SelectOneMenu [#q14b61ec]
SelectOneMenuとはいわゆるプルダウンの項目のことです。
SelectOneMenuでは下記のようにHTMLテンプレートで記述します。
selectタグで始まり、idにItemsをつけたList/配列のプロパテ...
Pageクラスにある場合にSelectOneMenuコンポーネントで
あるとTeedaは認識します。
または、aaaItemsというList/配列のidでも認識します。
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; char...
<title>Selectone</title>
</head>
<body>
<form id="form">
<select id="aaa">
<option value="1"></option>
</select>
<span id="aaa-out"/>
<input type="submit" value="calculate" id="doAction"/>
<span id="aaaItemsMessage"/>
</form>
</body>
</html>
Page側は下記のように記述します。
aaaItemsはListまたは配列で記述します。
List/配列の中身はDtoまたはMapで記述することができます。
SelectOneMenuで選択された要素として、プロパティaaaを準備...
public class SelectOnePage {
private List aaaItems;
private int aaa;
public String prerender() {
aaaItems = new ArrayList();
AaaDto dto1 = new AaaDto();
dto1.setValue(0);
dto1.setLabel("AAAA");
aaaItems.add(dto1);
AaaDto dto2 = new AaaDto();
dto2.setValue(1);
dto2.setLabel("BBBB");
aaaItems.add(dto2);
AaaDto dto3 = new AaaDto();
dto3.setValue(2);
dto3.setLabel("CCCC");
aaaItems.add(dto3);
return null;
}
public List getAaaItems() {
return aaaItems;
}
public void setAaaItems(List aaaItems) {
this.aaaItems = aaaItems;
}
public int getAaa() {
return aaa;
}
public void setAaa(int aaa) {
this.aaa = aaa;
}
public String doAction() {
return null;
}
}
Itemsの中身をDTOで記述する場合、Dtoはvalueとlabelという二...
最低限持たなくてはいけません。
下記のようになります。
public class AaaDto {
private String label;
private int value;
public String getLabel() {
return label;
}
public int getValue() {
return value;
}
public void setLabel(String label) {
this.label = label;
}
public void setValue(int value) {
this.value = value;
}
}
ではMapの場合はどうなるでしょうか？
Mapの場合はもっと簡単です。
下記のように、label、valueという名前で各Mapに登録しておい...
ちなみに下記例では、初期表示時の選択項目を値2を持つBBBBと...
public class SelectOne2Page {
private List aaaItems;
private Integer aaa = new Integer(2);
public String prerender() {
aaaItems = new ArrayList();
Map map1 = new HashMap();
map1.put("label", "AAAA");
map1.put("value", new Integer(1));
aaaItems.add(map1);
Map map2 = new HashMap();
map2.put("label", "BBBB");
map2.put("value", new Integer(2));
aaaItems.add(map2);
Map map3 = new HashMap();
map3.put("label", "CCCC");
map3.put("value", new Integer(3));
aaaItems.add(map3);
return null;
}
public List getAaaItems() {
return aaaItems;
}
public void setAaaItems(List aaaItems) {
this.aaaItems = aaaItems;
}
public Integer getAaa() {
return aaa;
}
public void setAaa(Integer aaa) {
this.aaa = aaa;
}
public String doAction() {
return null;
}
}
ではNullLabel（選択してください などのプルダウンに一番最...
TeedaではPageでSelectOneMenuに必須チェックがかかっている...
必要かどうかを見ています。
つまり、必須あり→NullLabelなし、 必須チェックなし→NullLa...
デフォルトのメッセージは、
org.seasar.teeda.extension.component.TSelect.NULL_LABEL ...
となっていますが、これはMessages.propertiesに定義してある...
では、挙動として全てのアプリケーションでNullLabelを出した...
その場合はteedaCustomize.diconでカスタマイズすることが可...
下記のように記述します。
<component class="org.seasar.teeda.extension.util.NullLa...
<property name="forceNullLabel">
@org.seasar.teeda.extension.util.NullLabelStrategy@FO...
</property>
</component>
これでアプリケーション全体でNullラベルを必須とすることが...
*SelectOneRadio [#b0268a05]
次はRadioボタンを選択する、SelectOneRadioを使ってみましょ...
SelectOneRadioは、htmlには下記のように記述します。
spanタグで始まり、idにItemsをつけたList/配列のプロパティが
Pageクラスにある場合にSelectOneRadioコンポーネントで
あるとTeedaは認識します。
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; char...
<title>SelectOneRadio</title>
</head>
<body>
<form id="selectOneRadioForm">
<span id="aaa">
<input type="radio" name="aaa" value="0" checked="checke...
<input type="radio" name="aaa" value="1"/>bbb
<input type="radio" name="aaa" value="2"/>ccc
</span>
<span id="aaa-display"/>
<input type="submit" value="calculate" id="doAction"/>
<span id="aaaMessage"/>
</form>
</body>
</html>
SelectOneMenuとほとんど変わりません。
Pageクラスは以下のようになります。
public class SelectOneRadioPage {
private int aaa;
private List aaaItems;
public String prerender() {
aaaItems = new ArrayList();
AaaDto dto1 = new AaaDto();
dto1.setValue(0);
dto1.setLabel("AAAA");
aaaItems.add(dto1);
AaaDto dto2 = new AaaDto();
dto2.setValue(1);
dto2.setLabel("BBBB");
aaaItems.add(dto2);
AaaDto dto3 = new AaaDto();
dto3.setValue(2);
dto3.setLabel("CCCC");
aaaItems.add(dto3);
return null;
}
public int getAaa() {
return aaa;
}
public void setAaa(int aaa) {
this.aaa = aaa;
}
public List getAaaItems() {
return aaaItems;
}
public void setAaaItems(List aaaItems) {
this.aaaItems = aaaItems;
}
public String doAction() {
return null;
}
}
*SelectBooleanCheckbox [#qd10c7a7]
SelectBooleanCheckboxはYES/NO形式の簡単なチェックボックス...
（TODO つづき）
*SelectManyCheckbox [#o5f0afd3]
SelectManyCheckboxは複数選択可能なチェックボックスのコン...
（TODO つづき）
*Condition [#p006a31c]
Conditionは、表示/非表示をPage側の条件によって切り替える...
（TODO つづき）
*Foreach [#v7828d50]
ForEachはPage側のList/配列を繰り返すためのコンポーネント...
（TODO つづき）
*Grid [#hd3340c1]
*Teedaの状態維持のポリシー [#i602f222]
Teedaの状態維持のポリシー、それは状態をなるべくTeedaで持...
状態はHTML側に埋め込むまたは、サーバサイドのpersistence層...
HttpSessionというライフサイクルがよくわからないものに頼ら...
Teedaでは推奨しています。
*ItemsSaveと状態維持 [#dec73883]
ItemsSaveは、Base64でPage側で持つList/配列をそのまま書き...
次画面に受け継ぐための機能です。
（TODO つづき）
*Teedaのライフサイクル [#a1af32d2]
Teedaのライフサイクルは主にJSFのライフサイクルのとおりに...
-Viewを復元する(RestoreViewPhase)
-requestから値を適用する(ApplyRequestValuePhase)
-Converter/Validatorを動かす(ProcessValidationPhase)
-Modelを更新する(UpdateModelPhase)
-Applicationをinvokeする(InvokeApplicationPhase)
-画面を描画する(RenderResponsePhase)
（TODO 詳細記述）
これをPOST-REDIRECT-GETのPRGパターンでまわします。
PRGパターンは下記参照。
*PRGパターンについて [#z70755d2]
PRGパターンとは、POST-REDIRECT-GETの組み合わせでHTTPでsub...
従来のforwardベースのsubmitでは以下のような問題がありまし...
-URLの表示がずれる
-POSTした後に画面がRELOADされたときに再度POSTされてしまう
-戻るボタン
-RELOADしたときにブラウザの警告メッセージが出る
このような問題への対処のための技法がPRGパターンです。
PRGでは、POSTとGETで役割を分担しています。
POSTでサーバ側のModelの状態を更新、REDIRECTでGETへ受け渡...
GETでは画面の描画というように分かれています。
forwardベースでRELOADされたときにPOSTされてしまうのは
POSTで使ったresponseをそのまま使用しているためです.
PRGではPOSTで使ったresponseはそのまま使わず、GETで常に
responseを描画時に返すようになります.
このようにしておくと、RELOADボタンが押下されても、GETメソ...
かつ空のパラメータが飛ぶため、Modelの状態を意図しない形で...
なくなります.
*initializeメソッド、prerenderメソッド [#h556283b]
Pageクラスにある特定のメソッドを記述しておくと、Teedaのラ...
それがinitialize、prerenderです.
initializeはPageクラスが初期化されるときに呼ばれます。
呼ばれるのは、Pageが初期化されたときの一回だけです。
一方prerenderは、画面が描画されるタイミングで毎回呼ばれま...
この2つをうまく使い分けることで、特定のタイミングで
動作するロジックを記述するタイミングを得ることができます。
*previousViewId [#j2577e41]
TeedaはあるPageがどこの画面から来たかをわかるようにprevio...
プロパティを持っていれば、前画面名を渡すようになっていま...
以下のようにPageにpreviousViewIdというプロパティを持って...
Teedaが自動的にインジェクトしてくれます。
package examples.teeda.web.move.aaa;
public class Aaa2Page {
private String previousViewId;
public String prerender() {
System.out.println(previousViewId);
return null;
}
public String getPreviousViewId() {
return previousViewId;
}
public void setPreviousViewId(String previousViewId) {
this.previousViewId = previousViewId;
}
}
*postback [#r3c3a395]
ある画面からデータがポストされてきたときに、その送り先が
同一のページであることをpostbackといいます。
TeedaではpostbackかどうかをPageクラスで認識することができ...
どのようにするかというと、postbackというbooleanのプロパテ...
setter/getterを準備しておくだけで、そのPageへのアクセスが...
postbackされてきたものかを判定することが出来ます。
下記にpostbackかどうかをprerenderの中で判定するサンプルコ...
示します。
public class HogePage {
private boolean postback;
public boolean isPostback() {
return postback;
}
public void setPostback(boolean postback) {
this.postback = postback;
}
public String prerender() {
if(isPostback()) {
//postback時のロジックを記述
} else {
//初回起動時のロジックを記述
}
}
}
*拡張input（金額入力） [#b6ea6230]
金額入力コンポーネント。
カンマ区切りになります。
inputTextでclass属性にT_currency
*拡張input（日付入力） [#d3971f96]
日付入力コンポーネント。
YY/MM/DD形式をある閾値を認識して、YYYY/MM/DDに。
inputTextでclass属性にT_date
*エラーメッセージ [#c6db9ca6]
HTMLに各タグごとにエラーのメッセージを出力する場合は、
<input type="text" id="name" .../><span id="nameMessage"/>
のようにspanタグを使って、id属性を対象となるタグのid + Me...
個別のタグとは無関係なエラー、例えば、業務ロジックで発生...
<span id="messages"/>を記述します。そのようなメッセージは
一般的に画面の上のほうに出すことが多いようです。
画面の上に全部(個別のタグも個別のタグとは無関係なエラーも...
*エラーページ [#sae48f38]
ある例外のときにエラーページへ遷移させる機能。
*エラーメッセージの集約表示 [#ca5aa65f]
ForEach/Grid内でConverter/Validatorでエラーになったとき
自動で行数がエラーメッセージにつく。
メッセージを集約したい場合は、アノテーションで記述する必...
public static final String fooItems_MESSAGE_AGGREGATION =
"id=examples.teeda.web.foreach.ForeachHoge.invaid";
*Tigerでのアノテーション [#c7f208f4]
*DynamicProperty [#ef8ffbdf]
Page側で動的にHTMLの属性の値を変更するやり方について。
*idの細かいルール [#x0af521d]
idについての細かいルールを下記に記述します。
-idでは基本的に英数字と_(アンダースコア)しか使えない
-同一のidのものを複数回表示する場合、-（ハイフン）で記述...
そのため、ハイフンから後ろは無視される。
idには、Camel式での記述を推奨します。
*label [#ka556fd3]
label.propertiesから動的に値を取り込める。
lookupのロジックは、
サブアプリケーション内label.propertiesから、HTML名.idで探索
サブアプリケーション内label.propertiesから、idで探索
web直下のlabel.propertiesから。
*title [#s271ec23]
idをふっておくと、label.propertiesから動的に変更すること...
*TakeOverアノテーション [#dd31c1ab]
Teedaでは、遷移元と遷移先に同じプロパティがあれば自動的に...
@TakeOver(type=TakeOverType.NEVER)の場合､次のページに何も...
@TakeOver(type=TakeOverType.INCLUDE, properties="aaa, bbb...
@TakeOver(type=TakeOverType.EXCLUDE, properties="aaa, bbb...
jumpやgoで引き継ぎを制御したい場合は，
public static final String jumpHoge3_TAKE_OVER = "type=ne...
などとします．(Tigerでも同様に記述)
*double submit防止(doOnce) [#j9af26e1]
<input type="submit" id="doOnceHoge" value="commit"/>
のようにdoOnceではじめると、TransactionTokenが発行される。
Tokenはサーバ側で管理され、クライアント側でもDoubleSubmit...
JavaScriptがrenderされる。
*doFinish [#p1b893e1]
doFinishでは、サブアプリケーションスコープ内で管理してい...
*Teeda Extensionの拡張ポイント [#i0adf303]
*各規約詳細 [#v97223c4]
** idが"mock"で始まるタグは実行時には無視される [#r068409e]
デザイン確認のためだけのタグなどは、id="mockXxx"のように"...
（TODO 各規約および規約のチェック順について記述する。）
*Ajaxについて [#u9a21853]
TeedaAjaxについて、書いていきます。
*Portletについて [#b7f9246c]
** はじめに [#xd49088e]
Teeda は、サーブレット以外にもポートレットして動作するこ...
** ポートレットについて [#a7b43aeb]
まず、ポートレットについて、簡単に説明します。 Java ベー...
仕様的な定義は以上のような感じですが、簡単にまとめると、...
** ポートレットとJSF [#z40510b3]
ポートレットで JSF を使うメリットは何でしょうか？ JSF を...
** ウェブアプリケーションからポートレットへの拡張 [#d9be6...
前置きが長くなりましたが、今まではポートレットの開発する...
- web.xmlを変更
- portlet.xmlを追加
- ポートレットフィルタとS2Portletのjarを追加
- jspやhtmlからhtml,head,bodyタグを削除する
*** web.xml の編集 [#h20ca7bc]
まず、web.xml については、Teeda をサーブレットで初期化し...
*** portlet.xml の追加 [#t8bbec4a]
次に、portlet.xml ですが、これは JSR 168 で定義されている...
<?xml version="1.0" encoding="UTF-8"?>
<portlet-app version="1.0">
<portlet>
<portlet-name>TeedaHtmlExample</portlet-name>
<display-name>Teeda HTML Example</display-name>
<description>This is an example portlet for Teeda...
<portlet-class>
org.apache.portals.bridges.portletfilter.Filter...
</portlet-class>
<init-param>
<name>portlet-class</name>
<value>org.seasar.teeda.core.portlet.FacesPor...
</init-param>
<init-param>
<name>portlet-filters</name>
<value>org.seasar.portlet.filter.S2PortletFil...
org.seasar.portlet.filter.HotdeployPortletFilter</value>
</init-param>
<init-param>
<name>view-page</name>
<value>/view/start/index.html</value>
</init-param>
<!-- <init-param>
<name>edit-page</name>
<value></value>
</init-param> -->
<supports>
<mime-type>text/html</mime-type>
<portlet-mode>VIEW</portlet-mode>
<!-- <portlet-mode>EDIT</portlet-mode> -->
</supports>
<supported-locale>en</supported-locale>
<supported-locale>ja</supported-locale>
<!-- resource-bundle></resource-bundle -->
<portlet-info>
<title>Teeda HTML Example</title>
<short-title>Example</short-title>
<keywords>Teeda HTML Example</keywords>
</portlet-info>
</portlet>
</portlet-app>
まず、portlet-name 要素の値には、ポータルにより利用される...
display-name 要素の値はポータルにより表示される(たとえば...
portlet-class 要素と init-param 要素にある portlet-class ...
init-param 要素の view-page の値は、表示モードでアクセス...
あとは、potlet-info 要素の title、short-title、keywords ...
必要な場所を変更して、portlet.xml として、WEB-INF の下に...
*** 必要な jar ファイルの追加 [#tef0c7e9]
web.xml と portlet.xml を編集したら、必要な jar ファイル...
- S2Portlet: http://s2portlet.sandbox.seasar.org/
- Portlet Filter: http://portals.apache.org/bridges/
(ポートレットフィルタについては、1.0.1 以降がリリースされ...
*** 不要なタグの削除 [#ad9d580d]
最後に、サーブレット環境用に作ると出力される HTML ページ...
** ポートレットアプリケーションの war ファイルの作成 [#re...
以上の編集をしたら、ウェブアプリケーションを作成するのと...
以上で、ポートレットアプリケーションが完成しましたので、...
*Tips [#o9a6ffde]
Tipsについて。
*内部構造 [#l7f64a3d]
JSFについて記述。
HTMLとどうやってマッピングしているかを記述。
*テストについて [#mc8f08ad]
テストの仕方について。
*Teedaで薦める開発スタイル [#q34a7de7]
Teedaで薦める開発スタイル、それは段階的な開発です。
従来のJavaの開発では、まとまった機能を作りこんでからサー...
非常にわずらわしい手段を取っていました。
一方で、LLな言語（RubyやPerl）では書いたものをその場で動...
スタイルで開発されています。自分が書いたコードとそれがど...
通常のJava開発ではこのような開発スタイルをとることはでき...
しかし、Seasar2.4のHotDeploy機能を使うと、これと同じこと...
イメージしてみましょう。
Tomcatをあげっぱなしで、HTMLを書きます。まずはMockとして...
次にDoltengでPageクラスを作ります。Ctrl+5を押すだけで後は...
最初には何かエラーがでるかもしれません。これを修正して、...
このちょっと修正、すぐ確認を繰り返すのです。自分の書いた...
フィードバックループをたくさんまわしてください。
非常に効率的にさくさく作業が出来て、変に一気に作らなくち...
プレッシャーも無いはずです。効率が良いだけじゃなく、気持...
さくさく開発、すぐ確認。これがTeedaが進める開発スタイルで...
*SmartDeployの切り替え方 [#o600ef42]
Seasar2.4の新機能の一つにSmartDeployというものがあります。
これによって、開発者がdiconを書いてコンポーネントを登録す...
ほんとうにしなければならない開発に専念することができます。
SmartDeployは大きく3種類に分かれます。
+HotDeploy
+CoolDeploy
+WarmDeploy
SmartDeployのどのmodeで動いているかは、
http://localhost:8080/your_war/teedaServlet?command=list
としてもらえればわかります。
*TeedaでのDoltengの使い方 [#ndd9ceab]
*ご要望 [#qcdeec77]
ご要望、フィードバック等は下記日記のコメントに残してもら...
極力取り入れます。
http://d.hatena.ne.jp/shot6/
Seasar-userのMLでも受け付けています。
*その他 [#d024a5d9]
*TeedaのUPDATEについて [#r2d7c3d2]
Teedaは機能が出来次第、順次リリースしていきます.
ひとまず、現在のTODOは、
-レイアウト機能
-ClientSideのValidationとの連動
-Ajaxなコンポーネント
-IntegrationTestツールの公開
*Teedaの由来 [#x15c8e67]
Teedaは沖縄の言葉で太陽という意味です。
終了行:
[[Teeda]]
Teedaの入門記を書きます。
blogで書いていたけど、皆で書けるように。
#contents
* 環境作り [#ec8afccf]
Teeda入門を試すのに必要な環境作りに付いては [[Teeda/getti...
以下ではteeda-ex1プロジェクトを作成済みであるものとして説...
* Teedaとは [#e88a6d02]
TeedaはJSF実装をベースにしたWebアプリケーションフレームワ...
Teedaは大きく分けて2つのpartがあります。
・Teeda Core：JSF1.1の実装
・Teeda Extension：HTMLテンプレートを持ったJSF拡張フレ...
基本的にお奨めの使い方はTeeda Core、Teeda Extensionを共に...
が、Teeda Coreだけでも純粋なJSF実装としてお使いいただけま...
JSFは実はServlet以外にもPortletの方にも対応することが仕様...
そちらの面もid:shinsuke_sugayaさんを中心にサポートいただ...
では本題に戻りまして。。。
Teeda ExtensionはPage駆動アーキテクチャに基づいていて、記...
基本的に以下の2つだけです。
・Pageクラス（ただのPOJOクラス。クラス名をPageで終える...
・HTML（基本的にidをふるだけ。）
1HTMLファイルに対して、1Pageクラスが対応します。
この辺はサンプルを見つつ、学習するのがよいと思うので、次...
* 最初の一歩 [#o65972e7]
+まずはHello Worldで基本的な動きをつかんでみましょう。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitiona...
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja"...
<head>
<meta http-equiv="Content-Type" content="text/html; char...
<title>Hello</title>
</head>
<body>
Hello World!!!
</body>
</html>
このシンプルなHTMLをPageクラスとマッピングさせてみましょ...
HTMLの方は簡単です。
Mappingして動的に変えたい項目にidをつけたタグを振るだけで...
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitiona...
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja"...
<head>
<meta http-equiv="Content-Type" content="text/html; char...
<title>Hello</title>
</head>
<body>
Hello <span id="name">World!!!</span>
</body>
</html>
これをただ単にブラウザで見るとHello Worldと表示されます。
ではこれに対応するPageクラスを作成しましょう。
Pageクラスを作成するときには、EclipseプラグインDoltengを...
以下、[[Teeda/gettingStartedSetup]]の手順に沿ってDolteng...
teeda-ex1プロジェクトの作成が終わっているものとして説明し...
teeda-ex1プロジェクトのhello.htmlのソースを開いて、HTMLソ...
なにやらダイアログが表示されます。このダイアログでPageク...
DoltengではHTMLの内容を読み込んで、Pageクラスに必要そうな...
自動的に追加したPageクラスを作成してくれます。
また、QuickJUnitにおけるCtrl+9でテストクラスへの移動が出...
Ctrl+5でDoltengではPageクラス←→HTML間を移動できます。
（Pageがない場合にダイアログが表示されPageクラスを作成す...
ここではダイアログで単に「Finish」ボタンを押して、Pageク...
HelloPageクラスが作成されます。
作成されたPageクラスのプロパティnameに"Seasar2"と入力して...
package examples.teeda.web.hello;
public class HelloPage{
private String name = "Seasar2";
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
これで準備は整いました。
Tomcatを起動して、localhost:8080/teeda-html-example/view/...
というように表示してみると
Hello Seasar2
と表示されます。
このとき何が起きているのでしょうか？
ひとつひとつ見ていきましょう。
まずTeedaの基本は全てidです。
idでマッピングされない項目は、動的な処理を行う集合（コン...
みなされません。
idがない場合全て単なるテキストとして処理されます。
上記の例で言えば、spanタグにnameというidをふることで
あ、このタグは動的な値を扱うのだとTeedaは解釈します。
idの振り方には規約がありますが、それはこの後一つ一つ見て...
すぐに覚えられます。また、そのリファレンスも十二分に準備...
*outputText [#pb211f76]
動的に出力する項目（outputText）はどのように実現するので...
簡単です。
spanタグでidをふるだけ。
Hoge.html
<span id="aaa">bbb</span>
で、Hoge.htmlが読まれるとHogePageクラスのaaaプロパティ
が上記で書かれている値（bbb）の代わりに出ます。
次回は入力(inputText)を見てみましょう。
*配置について [#d37b6e2a]
おっと。忘れちゃいけない配置についてお話しておきます。
Teedaは基本的に、Seasar2.4の配置に基づいています。
2.4でのPageクラスなどの構成は以下で書いたので割愛。
余談ですが、このようにパッケージ構成を決めることで煩雑だ...
DIの設定部分を取り除いているのです。
だからS2.4は、diconをいじる必要がほとんどなく、
パッケージ構成を初期情報として与えるだけで終わりです。か...
- http://d.hatena.ne.jp/shot6/20060818#1155832996
これと同様に、HTMLの配置は以下のようにします。
ルートコンテキスト
+view
+[サブアプリケーション名]
-各HTML
サブアプリケーションとは1ユースケースと同等です。
これを例えば、サブアプリケーションhelloの中に、HelloPage...
ルートコンテキスト
+view
+hello
-hello.html
となります。
Teeda（というかS2.4の規約）ではデフォルトは/view以下を
対象のHTMLとみなして処理します。
*inputText [#yfdb00e1]
前回までにoutputTextはやりました。
今回はinputTextをやりましょう。
inputTextも非常に簡単です。
通常のinputで、typeにtext、idをarg1のように
Pageクラスのプロパティ名をつけるだけです。
add.html
<input type="text" id="arg1" title="INPUT1"/>
AddPage.java
public class AddPage {
private int arg1;
//getter, setterは省略
親クラスで記述しておくことも可能です。
*submitと画面遷移（do） [#b30b3fe2]
出力、入力と来たので、あとはsubmitボタンを説明すれば
簡単なアプリを作ることが出来ます。
というわけでボタンです。
ボタンは今までと違い、ちょっとした規約があります。
といってもHTML上では相変わらずidをふるだけです。
ボタンには3種類あります。
-do
-go
-jump
です。
do系のボタンは、それに該当するPageクラスのメソッドが
呼ばれます。たとえばdoCalculateというidをつけておくと、
Pageクラスの同様のメソッドが呼ばれます。
add.html
<input type="submit" value="calculate" id="doCalculate"/>
AddPage.java
public String doCalculate() {
result = arg1 + arg2;
return null;
}
ではこれでどのような画面遷移が発生するのでしょうか？
実はdoCalculateメソッドの戻り値が次の画面遷移先になってい...
そのため、doで呼ばれるメソッドはStringの戻り値を持たなけ...
return nullの場合、画面遷移は自画面に戻ってきます。
では、たとえばメソッドの実行後に別の画面に遷移したいとき...
簡単です。これだけです。
AddInputPage.java
public String doCalculate() {
result = arg1 + arg2;
return "addResult";
}
Stringの戻り値で次のPageクラス名を指定すればよいだけです。
同一サブアプリケーション内（たとえば/view/addの以下）であ...
"addResult"のようにHTML名をかいてもらえばそれだけで遷移し...
では、別サブアプリケーションに遷移する場合は？
/view/aaa/from.htmlと/view/bbb/to.htmlとすると、
fromからtoへの遷移は、bbb_toとなります。
つまり/view以下からサブアプリケーションを含めて記述してく...
その際にアンスコでパッケージを区切るように記述します。
これはgoでもdoでもjumpでも変わりません。
非常に直感的なのがよくわかってもらえると思います。
またHTMLからも、どのメソッドが実行されるかが瞬時にわかり...
よくある設定をベースにしたフレームワークだと、画面遷移は
全て設定ファイルに記述するのが当たり前ですが（アノテーシ...
本来見なくてもよいリソースにどこに遷移するのかを見に行か...
Teedaではもっとも画面遷移に関係あるリソースにそのまま記述...
*submitと画面遷移（go） [#m5e82a6f]
では、次はgoについて説明します。
goはdoのように特定のメソッドが呼ばれるわけではありません。
しかし、Aという画面からBという画面にロジックを通さずに
直接行きたい場合などがあると思います。そのような場合にgo...
下記のaaa.htmlは、同一サブアプリケーション内のaaa2.htmlに
直接遷移します。
aaa.html
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; ch...
<title>Page transition</title>
</head>
<body>
<form id="aaaForm">
<input type="submit" id="goAaa2" value="go to same u...
</form>
</body>
</html>
*submitと画面遷移（jump） [#s9fba02b]
では、画面遷移最後のもうひとつはjumpです。
jumpはgoと同じようにロジックを通さずに画面遷移するための...
では違いは何でしょうか？goとjumpには大きな違いがあります。
それは画面遷移時にValidationがあるか、ないかです。
doの場合は当然あるのですけど、goの場合も値のValidationは...
しかし、jumpの場合は値のValidationは行わずに画面遷移しま...
たとえば下記のような足し算の計算後の画面（addResult）があ...
ただ単に戻るボタンを実装したいなどの場合はjumpを使うのが...
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; ch...
<title>Add</title>
</head>
<body>
<form id="addResultForm">
<span id="messages"/>
<span id="arg1"></span> + <span id="arg2"></span> = <s...
<input type="submit" value="back by go" id="goAddInput...
<input type="submit" value="back by jump" id="jumpAddI...
</form>
</body>
</html>
*Validation [#o30f5eb5]
次はValidationについてです。
画面遷移時にValidationについての話が出てきました。
ではどのようにPageクラスのValidationをするのでしょうか。
こちらはS2JSFやS2Strutsを使ったことのある人なら馴染みの
ある方法を採用しています。
そう、定数アノテーションとTigerアノテーションです。
TeedaはJDK1.4に対応しているため、定数アノテーションでも使...
Tigerアノテーションでも使えますが、まずは定数アノテーショ...
定数アノテーションの記法は以下のようになっています。
''public static final String プロパティ名_Validator名 = "...
例えば、下記のような足し算の入力画面のPageクラスがあると...
このクラスでは、引数にarg1とarg2をとり、両方とも入力必須で
桁数が3桁以上入力されなくてはいけないとします。
AddInputPage.java
public class AddInputPage {
private Integer arg1;
private Integer arg2;
public Integer getArg1() {
return arg1;
}
public void setArg1(Integer arg1) {
this.arg1 = arg1;
}
public Integer getArg2() {
return arg2;
}
public void setArg2(Integer arg2) {
this.arg2 = arg2;
}
}
このような場合にどうすればよいのでしょうか。
上記の記述を思い出しながらやってみましょう。
まずプロパティarg1に必須項目のValidatorをしかけましょう。
どんなValidatorがあるのか今は気にしないでください。あとで...
''public static final String プロパティ名_Validator名 = "...
が記法なので、
public static final String arg1_TRequiredValidator = null;
というようになります。所定のValidatorに与えるプロパティが...
してもらえればよいです。
これでarg1に必須チェックがかかります。
さて、次は入力桁が3桁以上でなければいけないというチェック...
標準のValidatorにLengthValidatorというValidatorがあります。
これを使いましょう。
今度はLengthValidatorのプロパティにきちんと値を渡さなくて...
最小の桁数が3桁なので、minimum=3というプロパティを渡しま...
public static final String arg1_lengthValidator = "minimu...
さあ、これでValidationがかかります。
同じようにarg2でもValidationをかけることが出来ます。
先ほど示した例はこのようになります。
AddInputPage.java
public class AddInputPage {
public static final String arg1_TRequiredValidator = nu...
public static final String arg1_lengthValidator = "mini...
public static final String arg2_TRequiredValidator = nu...
public static final String arg2_lengthValidator = "mini...
private Integer arg1;
private Integer arg2;
public Integer getArg1() {
return arg1;
}
public void setArg1(Integer arg1) {
this.arg1 = arg1;
}
public Integer getArg2() {
return arg2;
}
public void setArg2(Integer arg2) {
this.arg2 = arg2;
}
}
このようにValidatorをしかけていきます。
Validatorは各プロパティごとに書かれた順番どおりに呼ばれま...
上記の例だと、arg1はTRequiredが呼ばれて、その後にLengthVa...
Tigerでも同じ仕組みで行われます。この例は各Validatorを説...
次は各Validatorについて見ていきましょう。
*Validatorの種類について [#s1d0874f]
次は各Validatorについて説明します。
ValidatorとはJSF(JavaServer Faces)で決められている画面か...
チェックする機能です。JSFとしても提供しているValidator、T...
あり、Tで始まるやつはTeedaで用意したものになっています。
数値チェック系
-TRequiredValidator 必須チェック
-LengthValidator 長さチェック
-LongRangeValidator longでのレンジチェック
-DoubleRangeValidator doubleでのレンジチェック
-TByteLengthValidator byteでのレンジチェック
-TDoubleRangeValidator 拡張したdoubleでのレンジチェック
-TLongRangeValidator 拡張したlongでのレンジチェック
-TNumberLengthValidator 整数部・小数部での桁数チェック
-TRegularExpressionValidator 正規表現でのチェック
上記のように数値チェック系は多少かぶっているのもあります。
なぜか。それは以下のような機能を付け加えるためです。
-どのボタンを押したときにValidationをするかを指定できるよ...
-メッセージを出力するためのidを自由に変更できるようにする...
です。
下記のように、target属性でどのボタンが押下されたときに
Validationが発生するのかを制御することができます。
public static final String number1_TRequiredValidator = ...
本当は正規表現のValidatorもCommons-validatorみたいに
ひととおり準備してあげればいいんですけど、まだそこまでい...
相関チェック系
-TGreaterEqualValidator
-TGreaterThanConstantValidator
-TGreaterValidator
-TLessEqualValidator
-TLessValidator
相関チェック系では、主に2項目の関係でのチェックを行います。
JSF上、どいつとペアでValidationするのかはHTML上出てくる項...
後者につけなければいけません。今のところですけど。
S2JSFのときにはGreaterEqualしかなかったので
Teedaではひととおり準備してみました。
*簡単なアプリの作成 [#ge733f40]
では、今までに説明してきた機能を振り返ってみて、
簡単な足し算アプリを作成してみましょう。
仕様としては、足し算を行ってボタンを押下するとdoCalculate...
呼ばれます。未入力または桁数が3桁に満たない場合は、Valida...
HTMLはこのようになります。
（まだ説明していない機能やディティールの部分も少し含まれ...
本質は変わりません。後でまた説明します。）
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitiona...
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja"...
<head>
<meta http-equiv="Content-Type" content="text/html; char...
<title id="aaa">Add</title>
</head>
<body>
<form id="addForm">
<div>
<span id="messages"></span>
</div>
<table>
<tr>
<td></td><td><input type="text" id="arg1" title="INPUT1"...
<td><span id="arg1Message"></span></td>
</tr>
<tr>
<td> + </td>
<td><input type="text" id="arg2" title="INPUT2"/></td>
<td><span id="arg2Message"></span></td>
</tr>
<tr>
<td> = </td>
<td><span id="result"></span></td>
</tr>
</table>
<input type="submit" value="calculate" id="doCalculate"/>
<input type="submit" value="back to start" id="jumpStart...
</form>
</body>
</html>
これに対応するページクラスを作りましょう。
idに対応づく変数とアクセサはDoltengが作成してくれるので、...
必要なValidatorを記述するだけです。
package examples.teeda.web.add;
public class AddPage {
public static final String arg1_TRequiredValidator = null;
public static final String arg1_lengthValidator = "minim...
public static final String arg2_TRequiredValidator = null;
public static final String arg2_lengthValidator = "minim...
private int arg1;
private int arg2;
private int result;
public int getArg1() {
return arg1;
}
public void setArg1(int arg1) {
this.arg1 = arg1;
}
public int getArg2() {
return arg2;
}
public void setArg2(int arg2) {
this.arg2 = arg2;
}
public int getResult() {
return result;
}
public void setResult(int result) {
this.result = result;
}
public String doCalculate() {
result = arg1 + arg2;
return null;
}
}
実際にTomcatを立ち上げて、確認してみましょう。
3桁入力しないとエラーでValidationが効いているはずです。
* Message/AllMessages/Messages [#w5bf6dd4]
今回はエラーメッセージについてです。
Teedaでは、エラーメッセージを出すときに大きく2つの選択肢...
+個別の入力項目に対してエラーメッセージを表示する
+画面全体で共通の領域にエラーメッセージを表示する
まず1の場合はどうするかというと、対象の入力項目のid＋Mess...
つけます。
（すでに前回の例で実は出てきていますが。）
<tr>
<td></td><td><input type="text" id="arg1" title="INPUT1"...
<td><span id="arg1Message"></span></td>
</tr>
入力項目arg1に対して、そのエラーメッセージを表示させたい...
arg1Messageとしてください。
これでバリデーションエラー時にarg1に
エラーがあった場合はその内容を表示することが出来ます。
次に2の場合です。
画面全体でエラーメッセージの出す場所を統一して出す場合な...
よくあると思います。
そのような場合はAllMessagesまたはMessagesを使います。
<span id="allMessages"></span>
<span id="messages"></span>
AllMessagesは、Validationに引っかかった全てのエラーメッセ...
表示します。「全ての」の意味をちょっと説明する必要があり...
Teedaでは、エラーメッセージを大きく２つに分類しています。
・idがついたコンポーネントに紐づくエラー
・idがついたコンポーネントに紐づかないエラー
前者は、arg1Messageなどで定義しているものたちだと思ってく...
後者はそれ以外で発生したエラー全てをさします。
AllMessagesはこれら全ての例外を一括で表示します。
一方Messagesは、どういったものなのでしょうか。
Messagesは上記の後者だけを表示します。
つまりidがついたコンポーネントのエラーを表示したいときは
適切な場所にmessageを埋め込まないといけません。
このあたりは画面表示上の都合で使い分けることを想定してい...
*Converter [#u6b92f5b]
Converterは、値の変換をする機能です。
Converterは入力されてきた値をValidationする直前に適切なOb...
描画する直前にStringに変換する機能を持っています。
Teedaでは、Validatorの同じく定数アノテーションまたはTiger...
指定が可能です。
下記にサンプルを示します。
public static final String now_dateTimeConverter = "patt...
*Converterの種類について [#y3e578c7]
Validatorと同様、Converterもさまざまな種類のものを用意し...
通常、Converterに関しては、一般的なprimitiveな値のものは...
Converterによる型変換が入るため、意識する必要はありません。
型変換が明示的に必要な場合は下記のConverterをアノテーショ...
デフォルトのConverter（：の後ろは登録されている名前）
-BigDecimalConverter ： bigDecimalConverter
-BigIntegerConverter ： bigIntegerConverter
-BooleanConverter ： booleanConverter
-ByteConverter ： byteConverter
-CharacterConverter ： characterConverter
-DateTimeConverter ： dateTimeConverter
-DoubleConverter ： doubleConverter
-FloatConverter ： floatConverter
-IntegerConverter ： integerConverter
-LongConverter ： longConverter
-NumberConverter ： numberConverter
-ShortConverter ： shortConverter
拡張のConverter
-TimestampConverter
-TBigDecimalConverter NumberFormatがJDK1.4ではBigDecimal...
-TDateTimeConverter DateでYY/MM/DDなどの変換の閾値を独自...
（TODO Converterの指定の仕方、各Converterの説明）
*SelectOneMenu [#q14b61ec]
SelectOneMenuとはいわゆるプルダウンの項目のことです。
SelectOneMenuでは下記のようにHTMLテンプレートで記述します。
selectタグで始まり、idにItemsをつけたList/配列のプロパテ...
Pageクラスにある場合にSelectOneMenuコンポーネントで
あるとTeedaは認識します。
または、aaaItemsというList/配列のidでも認識します。
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; char...
<title>Selectone</title>
</head>
<body>
<form id="form">
<select id="aaa">
<option value="1"></option>
</select>
<span id="aaa-out"/>
<input type="submit" value="calculate" id="doAction"/>
<span id="aaaItemsMessage"/>
</form>
</body>
</html>
Page側は下記のように記述します。
aaaItemsはListまたは配列で記述します。
List/配列の中身はDtoまたはMapで記述することができます。
SelectOneMenuで選択された要素として、プロパティaaaを準備...
public class SelectOnePage {
private List aaaItems;
private int aaa;
public String prerender() {
aaaItems = new ArrayList();
AaaDto dto1 = new AaaDto();
dto1.setValue(0);
dto1.setLabel("AAAA");
aaaItems.add(dto1);
AaaDto dto2 = new AaaDto();
dto2.setValue(1);
dto2.setLabel("BBBB");
aaaItems.add(dto2);
AaaDto dto3 = new AaaDto();
dto3.setValue(2);
dto3.setLabel("CCCC");
aaaItems.add(dto3);
return null;
}
public List getAaaItems() {
return aaaItems;
}
public void setAaaItems(List aaaItems) {
this.aaaItems = aaaItems;
}
public int getAaa() {
return aaa;
}
public void setAaa(int aaa) {
this.aaa = aaa;
}
public String doAction() {
return null;
}
}
Itemsの中身をDTOで記述する場合、Dtoはvalueとlabelという二...
最低限持たなくてはいけません。
下記のようになります。
public class AaaDto {
private String label;
private int value;
public String getLabel() {
return label;
}
public int getValue() {
return value;
}
public void setLabel(String label) {
this.label = label;
}
public void setValue(int value) {
this.value = value;
}
}
ではMapの場合はどうなるでしょうか？
Mapの場合はもっと簡単です。
下記のように、label、valueという名前で各Mapに登録しておい...
ちなみに下記例では、初期表示時の選択項目を値2を持つBBBBと...
public class SelectOne2Page {
private List aaaItems;
private Integer aaa = new Integer(2);
public String prerender() {
aaaItems = new ArrayList();
Map map1 = new HashMap();
map1.put("label", "AAAA");
map1.put("value", new Integer(1));
aaaItems.add(map1);
Map map2 = new HashMap();
map2.put("label", "BBBB");
map2.put("value", new Integer(2));
aaaItems.add(map2);
Map map3 = new HashMap();
map3.put("label", "CCCC");
map3.put("value", new Integer(3));
aaaItems.add(map3);
return null;
}
public List getAaaItems() {
return aaaItems;
}
public void setAaaItems(List aaaItems) {
this.aaaItems = aaaItems;
}
public Integer getAaa() {
return aaa;
}
public void setAaa(Integer aaa) {
this.aaa = aaa;
}
public String doAction() {
return null;
}
}
ではNullLabel（選択してください などのプルダウンに一番最...
TeedaではPageでSelectOneMenuに必須チェックがかかっている...
必要かどうかを見ています。
つまり、必須あり→NullLabelなし、 必須チェックなし→NullLa...
デフォルトのメッセージは、
org.seasar.teeda.extension.component.TSelect.NULL_LABEL ...
となっていますが、これはMessages.propertiesに定義してある...
では、挙動として全てのアプリケーションでNullLabelを出した...
その場合はteedaCustomize.diconでカスタマイズすることが可...
下記のように記述します。
<component class="org.seasar.teeda.extension.util.NullLa...
<property name="forceNullLabel">
@org.seasar.teeda.extension.util.NullLabelStrategy@FO...
</property>
</component>
これでアプリケーション全体でNullラベルを必須とすることが...
*SelectOneRadio [#b0268a05]
次はRadioボタンを選択する、SelectOneRadioを使ってみましょ...
SelectOneRadioは、htmlには下記のように記述します。
spanタグで始まり、idにItemsをつけたList/配列のプロパティが
Pageクラスにある場合にSelectOneRadioコンポーネントで
あるとTeedaは認識します。
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; char...
<title>SelectOneRadio</title>
</head>
<body>
<form id="selectOneRadioForm">
<span id="aaa">
<input type="radio" name="aaa" value="0" checked="checke...
<input type="radio" name="aaa" value="1"/>bbb
<input type="radio" name="aaa" value="2"/>ccc
</span>
<span id="aaa-display"/>
<input type="submit" value="calculate" id="doAction"/>
<span id="aaaMessage"/>
</form>
</body>
</html>
SelectOneMenuとほとんど変わりません。
Pageクラスは以下のようになります。
public class SelectOneRadioPage {
private int aaa;
private List aaaItems;
public String prerender() {
aaaItems = new ArrayList();
AaaDto dto1 = new AaaDto();
dto1.setValue(0);
dto1.setLabel("AAAA");
aaaItems.add(dto1);
AaaDto dto2 = new AaaDto();
dto2.setValue(1);
dto2.setLabel("BBBB");
aaaItems.add(dto2);
AaaDto dto3 = new AaaDto();
dto3.setValue(2);
dto3.setLabel("CCCC");
aaaItems.add(dto3);
return null;
}
public int getAaa() {
return aaa;
}
public void setAaa(int aaa) {
this.aaa = aaa;
}
public List getAaaItems() {
return aaaItems;
}
public void setAaaItems(List aaaItems) {
this.aaaItems = aaaItems;
}
public String doAction() {
return null;
}
}
*SelectBooleanCheckbox [#qd10c7a7]
SelectBooleanCheckboxはYES/NO形式の簡単なチェックボックス...
（TODO つづき）
*SelectManyCheckbox [#o5f0afd3]
SelectManyCheckboxは複数選択可能なチェックボックスのコン...
（TODO つづき）
*Condition [#p006a31c]
Conditionは、表示/非表示をPage側の条件によって切り替える...
（TODO つづき）
*Foreach [#v7828d50]
ForEachはPage側のList/配列を繰り返すためのコンポーネント...
（TODO つづき）
*Grid [#hd3340c1]
*Teedaの状態維持のポリシー [#i602f222]
Teedaの状態維持のポリシー、それは状態をなるべくTeedaで持...
状態はHTML側に埋め込むまたは、サーバサイドのpersistence層...
HttpSessionというライフサイクルがよくわからないものに頼ら...
Teedaでは推奨しています。
*ItemsSaveと状態維持 [#dec73883]
ItemsSaveは、Base64でPage側で持つList/配列をそのまま書き...
次画面に受け継ぐための機能です。
（TODO つづき）
*Teedaのライフサイクル [#a1af32d2]
Teedaのライフサイクルは主にJSFのライフサイクルのとおりに...
-Viewを復元する(RestoreViewPhase)
-requestから値を適用する(ApplyRequestValuePhase)
-Converter/Validatorを動かす(ProcessValidationPhase)
-Modelを更新する(UpdateModelPhase)
-Applicationをinvokeする(InvokeApplicationPhase)
-画面を描画する(RenderResponsePhase)
（TODO 詳細記述）
これをPOST-REDIRECT-GETのPRGパターンでまわします。
PRGパターンは下記参照。
*PRGパターンについて [#z70755d2]
PRGパターンとは、POST-REDIRECT-GETの組み合わせでHTTPでsub...
従来のforwardベースのsubmitでは以下のような問題がありまし...
-URLの表示がずれる
-POSTした後に画面がRELOADされたときに再度POSTされてしまう
-戻るボタン
-RELOADしたときにブラウザの警告メッセージが出る
このような問題への対処のための技法がPRGパターンです。
PRGでは、POSTとGETで役割を分担しています。
POSTでサーバ側のModelの状態を更新、REDIRECTでGETへ受け渡...
GETでは画面の描画というように分かれています。
forwardベースでRELOADされたときにPOSTされてしまうのは
POSTで使ったresponseをそのまま使用しているためです.
PRGではPOSTで使ったresponseはそのまま使わず、GETで常に
responseを描画時に返すようになります.
このようにしておくと、RELOADボタンが押下されても、GETメソ...
かつ空のパラメータが飛ぶため、Modelの状態を意図しない形で...
なくなります.
*initializeメソッド、prerenderメソッド [#h556283b]
Pageクラスにある特定のメソッドを記述しておくと、Teedaのラ...
それがinitialize、prerenderです.
initializeはPageクラスが初期化されるときに呼ばれます。
呼ばれるのは、Pageが初期化されたときの一回だけです。
一方prerenderは、画面が描画されるタイミングで毎回呼ばれま...
この2つをうまく使い分けることで、特定のタイミングで
動作するロジックを記述するタイミングを得ることができます。
*previousViewId [#j2577e41]
TeedaはあるPageがどこの画面から来たかをわかるようにprevio...
プロパティを持っていれば、前画面名を渡すようになっていま...
以下のようにPageにpreviousViewIdというプロパティを持って...
Teedaが自動的にインジェクトしてくれます。
package examples.teeda.web.move.aaa;
public class Aaa2Page {
private String previousViewId;
public String prerender() {
System.out.println(previousViewId);
return null;
}
public String getPreviousViewId() {
return previousViewId;
}
public void setPreviousViewId(String previousViewId) {
this.previousViewId = previousViewId;
}
}
*postback [#r3c3a395]
ある画面からデータがポストされてきたときに、その送り先が
同一のページであることをpostbackといいます。
TeedaではpostbackかどうかをPageクラスで認識することができ...
どのようにするかというと、postbackというbooleanのプロパテ...
setter/getterを準備しておくだけで、そのPageへのアクセスが...
postbackされてきたものかを判定することが出来ます。
下記にpostbackかどうかをprerenderの中で判定するサンプルコ...
示します。
public class HogePage {
private boolean postback;
public boolean isPostback() {
return postback;
}
public void setPostback(boolean postback) {
this.postback = postback;
}
public String prerender() {
if(isPostback()) {
//postback時のロジックを記述
} else {
//初回起動時のロジックを記述
}
}
}
*拡張input（金額入力） [#b6ea6230]
金額入力コンポーネント。
カンマ区切りになります。
inputTextでclass属性にT_currency
*拡張input（日付入力） [#d3971f96]
日付入力コンポーネント。
YY/MM/DD形式をある閾値を認識して、YYYY/MM/DDに。
inputTextでclass属性にT_date
*エラーメッセージ [#c6db9ca6]
HTMLに各タグごとにエラーのメッセージを出力する場合は、
<input type="text" id="name" .../><span id="nameMessage"/>
のようにspanタグを使って、id属性を対象となるタグのid + Me...
個別のタグとは無関係なエラー、例えば、業務ロジックで発生...
<span id="messages"/>を記述します。そのようなメッセージは
一般的に画面の上のほうに出すことが多いようです。
画面の上に全部(個別のタグも個別のタグとは無関係なエラーも...
*エラーページ [#sae48f38]
ある例外のときにエラーページへ遷移させる機能。
*エラーメッセージの集約表示 [#ca5aa65f]
ForEach/Grid内でConverter/Validatorでエラーになったとき
自動で行数がエラーメッセージにつく。
メッセージを集約したい場合は、アノテーションで記述する必...
public static final String fooItems_MESSAGE_AGGREGATION =
"id=examples.teeda.web.foreach.ForeachHoge.invaid";
*Tigerでのアノテーション [#c7f208f4]
*DynamicProperty [#ef8ffbdf]
Page側で動的にHTMLの属性の値を変更するやり方について。
*idの細かいルール [#x0af521d]
idについての細かいルールを下記に記述します。
-idでは基本的に英数字と_(アンダースコア)しか使えない
-同一のidのものを複数回表示する場合、-（ハイフン）で記述...
そのため、ハイフンから後ろは無視される。
idには、Camel式での記述を推奨します。
*label [#ka556fd3]
label.propertiesから動的に値を取り込める。
lookupのロジックは、
サブアプリケーション内label.propertiesから、HTML名.idで探索
サブアプリケーション内label.propertiesから、idで探索
web直下のlabel.propertiesから。
*title [#s271ec23]
idをふっておくと、label.propertiesから動的に変更すること...
*TakeOverアノテーション [#dd31c1ab]
Teedaでは、遷移元と遷移先に同じプロパティがあれば自動的に...
@TakeOver(type=TakeOverType.NEVER)の場合､次のページに何も...
@TakeOver(type=TakeOverType.INCLUDE, properties="aaa, bbb...
@TakeOver(type=TakeOverType.EXCLUDE, properties="aaa, bbb...
jumpやgoで引き継ぎを制御したい場合は，
public static final String jumpHoge3_TAKE_OVER = "type=ne...
などとします．(Tigerでも同様に記述)
*double submit防止(doOnce) [#j9af26e1]
<input type="submit" id="doOnceHoge" value="commit"/>
のようにdoOnceではじめると、TransactionTokenが発行される。
Tokenはサーバ側で管理され、クライアント側でもDoubleSubmit...
JavaScriptがrenderされる。
*doFinish [#p1b893e1]
doFinishでは、サブアプリケーションスコープ内で管理してい...
*Teeda Extensionの拡張ポイント [#i0adf303]
*各規約詳細 [#v97223c4]
** idが"mock"で始まるタグは実行時には無視される [#r068409e]
デザイン確認のためだけのタグなどは、id="mockXxx"のように"...
（TODO 各規約および規約のチェック順について記述する。）
*Ajaxについて [#u9a21853]
TeedaAjaxについて、書いていきます。
*Portletについて [#b7f9246c]
** はじめに [#xd49088e]
Teeda は、サーブレット以外にもポートレットして動作するこ...
** ポートレットについて [#a7b43aeb]
まず、ポートレットについて、簡単に説明します。 Java ベー...
仕様的な定義は以上のような感じですが、簡単にまとめると、...
** ポートレットとJSF [#z40510b3]
ポートレットで JSF を使うメリットは何でしょうか？ JSF を...
** ウェブアプリケーションからポートレットへの拡張 [#d9be6...
前置きが長くなりましたが、今まではポートレットの開発する...
- web.xmlを変更
- portlet.xmlを追加
- ポートレットフィルタとS2Portletのjarを追加
- jspやhtmlからhtml,head,bodyタグを削除する
*** web.xml の編集 [#h20ca7bc]
まず、web.xml については、Teeda をサーブレットで初期化し...
*** portlet.xml の追加 [#t8bbec4a]
次に、portlet.xml ですが、これは JSR 168 で定義されている...
<?xml version="1.0" encoding="UTF-8"?>
<portlet-app version="1.0">
<portlet>
<portlet-name>TeedaHtmlExample</portlet-name>
<display-name>Teeda HTML Example</display-name>
<description>This is an example portlet for Teeda...
<portlet-class>
org.apache.portals.bridges.portletfilter.Filter...
</portlet-class>
<init-param>
<name>portlet-class</name>
<value>org.seasar.teeda.core.portlet.FacesPor...
</init-param>
<init-param>
<name>portlet-filters</name>
<value>org.seasar.portlet.filter.S2PortletFil...
org.seasar.portlet.filter.HotdeployPortletFilter</value>
</init-param>
<init-param>
<name>view-page</name>
<value>/view/start/index.html</value>
</init-param>
<!-- <init-param>
<name>edit-page</name>
<value></value>
</init-param> -->
<supports>
<mime-type>text/html</mime-type>
<portlet-mode>VIEW</portlet-mode>
<!-- <portlet-mode>EDIT</portlet-mode> -->
</supports>
<supported-locale>en</supported-locale>
<supported-locale>ja</supported-locale>
<!-- resource-bundle></resource-bundle -->
<portlet-info>
<title>Teeda HTML Example</title>
<short-title>Example</short-title>
<keywords>Teeda HTML Example</keywords>
</portlet-info>
</portlet>
</portlet-app>
まず、portlet-name 要素の値には、ポータルにより利用される...
display-name 要素の値はポータルにより表示される(たとえば...
portlet-class 要素と init-param 要素にある portlet-class ...
init-param 要素の view-page の値は、表示モードでアクセス...
あとは、potlet-info 要素の title、short-title、keywords ...
必要な場所を変更して、portlet.xml として、WEB-INF の下に...
*** 必要な jar ファイルの追加 [#tef0c7e9]
web.xml と portlet.xml を編集したら、必要な jar ファイル...
- S2Portlet: http://s2portlet.sandbox.seasar.org/
- Portlet Filter: http://portals.apache.org/bridges/
(ポートレットフィルタについては、1.0.1 以降がリリースされ...
*** 不要なタグの削除 [#ad9d580d]
最後に、サーブレット環境用に作ると出力される HTML ページ...
** ポートレットアプリケーションの war ファイルの作成 [#re...
以上の編集をしたら、ウェブアプリケーションを作成するのと...
以上で、ポートレットアプリケーションが完成しましたので、...
*Tips [#o9a6ffde]
Tipsについて。
*内部構造 [#l7f64a3d]
JSFについて記述。
HTMLとどうやってマッピングしているかを記述。
*テストについて [#mc8f08ad]
テストの仕方について。
*Teedaで薦める開発スタイル [#q34a7de7]
Teedaで薦める開発スタイル、それは段階的な開発です。
従来のJavaの開発では、まとまった機能を作りこんでからサー...
非常にわずらわしい手段を取っていました。
一方で、LLな言語（RubyやPerl）では書いたものをその場で動...
スタイルで開発されています。自分が書いたコードとそれがど...
通常のJava開発ではこのような開発スタイルをとることはでき...
しかし、Seasar2.4のHotDeploy機能を使うと、これと同じこと...
イメージしてみましょう。
Tomcatをあげっぱなしで、HTMLを書きます。まずはMockとして...
次にDoltengでPageクラスを作ります。Ctrl+5を押すだけで後は...
最初には何かエラーがでるかもしれません。これを修正して、...
このちょっと修正、すぐ確認を繰り返すのです。自分の書いた...
フィードバックループをたくさんまわしてください。
非常に効率的にさくさく作業が出来て、変に一気に作らなくち...
プレッシャーも無いはずです。効率が良いだけじゃなく、気持...
さくさく開発、すぐ確認。これがTeedaが進める開発スタイルで...
*SmartDeployの切り替え方 [#o600ef42]
Seasar2.4の新機能の一つにSmartDeployというものがあります。
これによって、開発者がdiconを書いてコンポーネントを登録す...
ほんとうにしなければならない開発に専念することができます。
SmartDeployは大きく3種類に分かれます。
+HotDeploy
+CoolDeploy
+WarmDeploy
SmartDeployのどのmodeで動いているかは、
http://localhost:8080/your_war/teedaServlet?command=list
としてもらえればわかります。
*TeedaでのDoltengの使い方 [#ndd9ceab]
*ご要望 [#qcdeec77]
ご要望、フィードバック等は下記日記のコメントに残してもら...
極力取り入れます。
http://d.hatena.ne.jp/shot6/
Seasar-userのMLでも受け付けています。
*その他 [#d024a5d9]
*TeedaのUPDATEについて [#r2d7c3d2]
Teedaは機能が出来次第、順次リリースしていきます.
ひとまず、現在のTODOは、
-レイアウト機能
-ClientSideのValidationとの連動
-Ajaxなコンポーネント
-IntegrationTestツールの公開
*Teedaの由来 [#x15c8e67]
Teedaは沖縄の言葉で太陽という意味です。
ページ名:
![[PukiWiki]](image/seasar.png "[PukiWiki]")
