 | ||||||
 |
 |
 |
||||
 |
 |
 |
 |
 |
 |
 |
| ||||||
|
Teeda Extensionの機能についてこのドキュメントではTeeda Extensionの機能について説明します． ■初期化(initialize)メソッド初期化(initialize)メソッドとは、他のページから遷移されたタイミングで1度だけ呼び出されるライフサイクルメソッドです．同じページからポストバックされた場合には呼び出されません．
■描画前(prerender)メソッド描画前(prerender)メソッドとは、あるPageが描画される直前で毎回呼び出されるライフサイクルメソッドです．
■doメソッドdoメソッドとは，あるPageのフォームがサブミットされると呼び出されるライフサイクルメソッドです．
■previousViewIdpreviousViewId(プレビアスビューアイディ)とは、あるPageが以前にどこのPageから遷移してきたかを判別する機能です．
public class NextPage {
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(ポストバック)とは、ある画面でフォームがサブミットされたときに、そのPOSTリクエストの送り先が同一のページである事を指します．
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 {
//初回起動時のロジックを記述
}
}
}
■リダイレクトポストバックの後，別画面へ遷移する場合はリダイレクトが使われます．これはPRG (Post-Redirect-Get) パターンと呼ばれます． リダイレクトする際のURLは，ポストバックされたURLに基づいて同じプロトコル・同じホスト・同じポート番号で組み立てられます (「リダイレクトについて」も参照してください)． Tigerアノテーション@Redirect(protocol=ProtocolType.HTTPS)
public Class doSomething() {
...
}
定数アノテーションpublic static final String doSomething_REDIRECT = "protocol=https";
public Class doSomething() {
...
}
Redirectアノテーションで指定可能な属性
■DynamicProperty(ダイナミックプロパティ)DynamicProperty(ダイナミックプロパティ)とは、Pageクラス側で動的にHTMLの属性値を変更できる機能です．
DynamicPropertyで指定するメソッドは，get＋id＋属性名という名称でPageクラスに定義されます．
■windowIdとnewwindowクエリストリングTeeda内部で管理しているスコープとviewIdは全てwindowId別に管理されています． <a id="goAddInput" href="../add/addInput.html" target="_blank">足し算による入力サンプル(新規Windowが開く)</a>
のようにtargetを_blank指定すると、newwindowクエリストリングは自動的に割り当てられます． ■レイアウトTeedaでは簡単に使えるレイアウト機能を提供しています． <te:include te:src="/layout/header.html"/>のように記述します．詳しくは、includeタグを参照してください． レイアウトを適用するHTMLの中身を読み込むには、 <te:includeChildBody/>のように記述します．詳しくは、includeChildBodyタグを参照してください． 各Pageでpublic String getLayout() {...}を定義し、戻り値で/aaa/bbb.htmlのように指定するとbbb.htmlをレイアウトにすることもできます． getLayout()の値は動的に変えることもできます．layout.htmlのボディのサンプルは次のようになります．
<table border="0" cellspacing="5">
<tr>
<td colspan="2"><te:include te:src="/layout/header.html"/></td>
</tr>
<tr>
<td width="140" valign="top">
<te:include te:src="/layout/menu.html"/>
</td>
<td valign="top" align="left">
<te:includeChildBody/>
</td>
</tr>
<tr>
<td colspan="2">
<hr/>
</td>
</tr>
<tr>
<td colspan="2">
<te:include te:src="/layout/footer.html"/>
</td>
</tr>
</table>
■動的なバリデーションバリデーションを動的に変化させるには、get + id + Validatorという名前のメソッドを定義します．
public Validator getAaaValidator() {
TLengthValidator validator = new TLengthValidator();
if (...) {
validator.setMinimum(3);
} else {
validator.setMinimum(5);
}
return validator;
}
複数のValidatorを返す場合には、ValidatorChainを使います．
public Validator getAaaValidator() {
ValidatorChain chain = new ValidatorChain();
chain.add(new TRequiredValidator());
TLengthValidator validator = new TLengthValidator();
if (...) {
validator.setMinimum(3);
} else {
validator.setMinimum(5);
}
chain.add(validator);
return chain;
}
ファイルアップロードweb.xmlファイルアップロードを利用するには， <filter>
<filter-name>multipartFilter</filter-name>
<filter-class>
org.seasar.teeda.extension.filter.MultipartFormDataFilter
</filter-class>
<init-param>
<param-name>uploadMaxSize</param-name>
<param-value>100m</param-value>
</init-param>
<init-param>
<param-name>uploadMaxFileSize</param-name>
<param-value>100m</param-value>
</init-param>
<init-param>
<param-name>uploadThresholdSize</param-name>
<param-value>100k</param-value>
</init-param>
<!-- OS固有の設定 -->
<init-param>
<param-name>uploadRepositoryPath</param-name>
<param-value>C:/temp/</param-value>
</init-param>
</filter>
<filter-mapping> <filter-name>multipartFilter</filter-name> <url-pattern>*.html</url-pattern> </filter-mapping>
portlet.xml(ポートレットを利用する場合のみ)ポートレット環境で利用する場合には， <portlet-app id="teeda-html-example" version="1.0">
<portlet id="TeedaHtmlExample">
<portlet-name>TeedaHtmlExample</portlet-name>
<display-name>Teeda HTML Example</display-name>
<description>This is an example portlet for Teeda.</description>
<portlet-class>org.apache.portals.bridges.portletfilter.FilterPortlet</portlet-class>
<init-param>
<name>portlet-class</name>
<value>org.seasar.teeda.core.portlet.FacesPortlet</value>
</init-param>
<init-param>
<name>portlet-filters</name>
<value>
org.seasar.portlet.filter.S2PortletFilter,
org.seasar.portlet.filter.HotdeployPortletFilter,
org.seasar.teeda.extension.portlet.MultipartFormDataFilter
</value><!-- 実際には空白や改行を入れずに記述する -->
</init-param>
<init-param>
<name>org.seasar.teeda.extension.portlet.MultipartFormDataFilter:encoding</name>
<value>UTF-8</value>
</init-param>
<init-param>
<name>org.seasar.teeda.extension.portlet.MultipartFormDataFilter:uploadMaxSize</name>
<value>100m</value>
</init-param>
<init-param>
<name>org.seasar.teeda.extension.portlet.MultipartFormDataFilter:uploadMaxFileSize</name>
<value>100m</value>
</init-param>
<init-param>
<name>org.seasar.teeda.extension.portlet.MultipartFormDataFilter:uploadThresholdSize</name>
<value>100k</value>
</init-param>
<!-- OS固有の設定 -->
<init-param>
<name>org.seasar.teeda.extension.portlet.MultipartFormDataFilter:uploadRepositoryPath</name>
<value>C:/temp/</value>
</init-param>
ポートレット環境では， テンプレートHTML
<form id="form" enctype="multipart/form-data"> 通常のXHTMLと同じように <input type="file" id="uploadedFile" /> ページクラスページクラスには，次の型のプロパティを定義します．プロパティ名はテンプレートHTMLのid属性値と一致させます．
public UploadedFile uploadedFile;
|
| コンバータ | プロパティの型 | 説明 |
|---|---|---|
TUploadedFileBytesConverter |
byte[] |
アップロードされたファイルの内容をバイト列に変換します． |
TUploadedFileStringConverter |
String |
アップロードされたファイルの内容を文字列に変換します． encoding属性でエンコーディングを指定することもできます．省略するとアップロードされたファイルのコンテントタイプにエンコーディングが含まれていればそれが使われます．コンテントタイプにエンコーディングが含まれていない場合はISO-8859-1が使われます． |
TUploadedFileInputStreamConverter |
java.io.InputStream |
アップロードされたファイルの内容を読み込むための入力ストリームに変換します． 返された入力ストリームは呼び出し側でクローズする必要があります． |
TUploadedFileFileConverter |
java.io.File |
アップロードされたファイルを保存したサーバ側ファイルシステム上のFileに変換します．アップロードされたファイルがサーバ側ファイルシステム上に保存されていない場合、プロパティは nullに設定されます． |