====================================================================================
' 說明：Tapestry 開發筆記
' Note Author: Sunxianchao
' 閱讀日期： 2007-9-18(北京.七彩谷)
'====================================================================================
'先做個小廣告 免費的無限空間還可以就是要積分 下面是我的注冊地址 直接注冊就可以了 獎勵10個積分
http://web.99081.com/sysweb/RegTrans.aspx?CodeProvider=sunxian99
麻煩幫忙頂一個 多謝
【各種組建使用】
說明：只是說明一些需要注意的東西，更多的學習參考Tapestry官方文檔
1、For
source:是對應的java類里的List 對象或者是個數組 需要抽象 或者提供set get方法
value:是循環這個source對象代表當前的一個 ，需要在page文件中設置問一個屬性，可以不在對應的java類里有這個屬性
index:是循環的索引值 同value一樣 在page文件中設置一個屬性即可 <property name="index"/>
在循環的時候 會自動為vlaue和index賦當前的值
2、Foreach 和For一樣使用
3、Hidden組件 總是多余S的處理
<input jwcid="@Hidden" type="hidden" value="ognl:blahblah" encode="false"/>
4、 Insert 組件
e.g.
<input type="text" jwcid="name@Insert" value="ognl:user.name"/>
頁面表現時,將會到頁面類中尋找getUser().getName()方法獲取初值并輸出
相當于在頁面上顯示數據.
5、 TextField 組件
e.g.
<input type="text" jwcid="username@TextField" value="ognl:username"/>
頁面表現時,將會到頁面類中尋找getUsername()方法獲取初值
*如果是修改信息頁面,通常初始值要在頁面表現之前由setUsername()手動設置從數據庫中讀取出來的值
表單提交時,通過setUsername()寫入新值(即用戶輸入值),在類中通過getUsername()獲取新值
相當于在修改個人信息時,首先讀出用戶名賦予文本框(用戶名)初值,用戶修改時填入新值,后臺獲取之
*Hidden屬性區分是普通文本輸入框(默認false)和密碼輸入框(hidden="ognl:true")
readonly屬性設置只讀 readonly="true"為只讀(后臺可讀取)
*disabled屬性設置是否可寫 diabled="true"為不可寫(后臺也不可讀取)
6、 TextArea 組件
e.g.
<textarea jwcid="content@TextArea" value="ognl:content" cols="40" rows="10"></textarea>
頁面表現時,將會到頁面類中尋找getContent()方法獲取初值
工作原理同TextField
7、 RadioGroup/Radio 組件
e.g.
<span jwcid="headImage@RadioGroup" selected="ognl:headImage">
<input jwcid="@Radio" type="radio" value="1"/>頭像1
<input jwcid="@Radio" type="radio" value="2"/>頭像2
<input jwcid="@Radio" type="radio" value="3"/>頭像3
<input jwcid="@Radio" type="radio" value="4"/>頭像4
<input jwcid="@Radio" type="radio" value="5"/>頭像5
<input jwcid="@Radio" type="radio" value="6"/>頭像6
</span>
RadioGroup為每一個Radio提供一個唯一的ID。RadioGroup跟蹤當前被選中的屬性值，并且只有一個Radio能夠被選中.
頁面提交時，RadioGroup組件就利用OGNL表達式向headImage字段寫入被選中的Radio組件的value參數值.
頁面表現時(修改頁面),將會到頁面類中尋找getHeadImage()方法獲取初值,然后尋找@Radio組件中與其相同的組件并勾選上.
8、 PropertySelection 組件
使用PropertySelection組件必須要構造一個類來實現IPropertySelectionModel接口，并且重寫該接口的5個方法.
public int getOptionCount() //提供下拉菜單的長度
public Object getOption(int index) //提供select標簽的option
public String getLabel(int index) //提供select標簽的Label值，也就是下拉菜單顯示的內容
public String getValue(int index) //提供select標簽的value值
public Object translateValue(String value) //selected后的返回值，value值未必就是我們需要的返回值，可以在這個方法里面對返回的value做對應的轉換或修改.
e.g.1. 性別下拉框
<select jwcid="gender@ProPertySelection" name="genderSelect" value="ognl:gender" model="supportedGender">
<option selected>先生</option>
<option>女士</option>
</select>
代碼
GenderSelectionModel.java
public class GenderSelectionModel implements IPropertySelectionModel {
public static final String male = "先生";
public static final String female = "女士";
public static final String[] genderOptions = { male, female };
public int getOptionCount() {
return genderOptions.length;
}
public Object getOption(int index) {
return this.translateValue(genderOptions[index]);
}
public String getLabel(int index) {
return genderOptions[index].toString();
}
public String getValue(int index) {
return genderOptions[index];
}
public Object translateValue(String value) {
if (value.equals("先生")) {
return "1";
} else {
return "0";
}
}
}
代碼
ModUserInfo.java
public IPropertySelectionModel getSupportedGender() {
return new GenderSelectionModel();
}
存入數據庫中"1"代表先生,"0"代表女士,通過translateValue(String value)方法轉換
頁面表現時,通過model屬性給出的IPropertySelectionModel獲取下拉選項,即getSupportedGender().
然后通過getGender()方法獲取初值,比如獲取"0",則在頁面顯示時尋找value值為"0"的選項即為"女士",并選擇之作為初始選擇項.
e.g.2. 日志類型下拉框
<select jwcid="logType@PropertySelection" name="typeSelect" value="ognl:logType" model="supportedType">
<option>心情日記</option>
<option>情感天地</option>
<option>生活感觸</option>
</select>
代碼
TypeSelectionModel.java
public class TypeSelectionModel implements IPropertySelectionModel {
private List typeList = new ArrayList();
public TypeSelectionModel(List typeList) {
this.typeList = typeList;
}
public int getOptionCount() {
return typeList.size();
}
public Object getOption(int index) {
return ((LogType)typeList.get(index)).getValue();
}
public String getLabel(int index) {
return ((LogType) typeList.get(index)).getName();
}
public String getValue(int index) {
return ((LogType) typeList.get(index)).getValue();
}
public Object translateValue(String value) {
return value;
}
}
代碼
ModLog.java
public IPropertySelectionModel getSupportedType() {
TypeSelectionModel typeSelectionModel =
new TypeSelectionModel(loadType(getUser().getUserId()));
return typeSelectionModel;
}
private List loadType(int userid) {
...//從數據庫載入該用戶的日志類型列表
}
頁面表現時,通過model屬性給出的IPropertySelectionModel獲取下拉選項,即getSupportedType().
然后通過value屬性給出的初始值即,getLogType()方法獲取初值,比如獲取"2",則在頁面顯示時尋找value值為"2"的選項即為"生活感觸",并選擇之作為初始選擇項.
9、 Form組件
e.g.
<form jwcid="logForm@Form">
...
</form>
Form的監聽(listener)方法可以有兩種方式:
1. 在Form組件中聲明.
<form jwcid="logForm@Form" listener="ognl:listener:onLogin">
...
</form>
2. 在submit類型組件中聲明.
<input type="submit" jwcid="onLogin@Submit" listener="listener:onLogin" value="發表"/>或者
<span jwcid="@ImageSubmit" image="..." listener="listener:onLogin"><img src="..." width="" height=""/></span>
前一種方式當Form中只要有submit就會觸發監聽方法,后一種方式是Form中有多個submit,各自實現不同的監聽方法.
G) Foreach 組件
e.g.
<span jwcid="@Foreach" source="ognl:logList" value="ognl:item">
循環組件,遍歷source參數,在表現其內容前更新value參數,將Foreach組件所包含的內容重復表現,其中可以通過value參數獲取所需顯示內容.
本例中,頁面表現時通過getLogList()方法獲取日志列表,循環取出其中數據更新item(日志對象)并予以顯示.其中item需要在頁面規范(.page)文件中聲明:
<property name="item"/>
*class參數用來尋找類似CSS的文件對Foreach進行修飾.
Foreach組件: class="ognl:beans.evenOdd.next"
Page文件: <bean name="evenOdd" class="org.apache.tapestry.bean.EvenOdd"/>
CSS文件: tr.odd{background-color: #ffffff;}tr.even{background-color: #eeeeee;}
10、 Conditional 組件
e.g.
<span jwcid="@Conditional" condition='ognl:item.sex.equals("1")'>先生</span>
<span jwcid="@Conditional" condition='ognl:item.sex.equals("0")'>女士</span>
conditional參數為true時運行Conditional組件中的HTML模板內容.
在Tapestry4.0以后就不支持該組件了, 可以使用其他組件來實現:
1. Contrib:Choose和Contrib:When
<library id="contrib" specification-path="classpath:/org/apache/tapestry/contrib/Contrib.library"/>(.application文件中引入Contrib類包)
<span jwcid="@contrib:Choose">
<span jwcid="@contrib:When" condition='ognl:user.gender.equals("1")'>先生</span>
<span jwcid="@contrib:When" condition='ognl:user.gender.equals("0")'>女士</span>
</span>
2. If組件
<span jwcid="@If" condition='ognl:item.sex.equals("1")'>先生</span>
<span jwcid="@If" condition='ognl:item.sex.equals("0")'>女士</span>
3. Else組件
<span jwcid="@Else">man</span>
【============================ts的函數執行順序========================================】
對之前的該文章進行了一些修正，主要是針對finishLoad()方法。
我覺得對初學者會有一些幫助。
下面這幾個函數是我在使用的，它們的執行順序依次從上到下。
1.protected void finishLoad() {} ***
2.public void pageValidate(PageEvent event) {}
3.public void activateExternalPage(Object[] parameters, IRequestCycle cycle) {}
4.public void pageBeginRender(PageEvent event) {}
// 如果有表單提交，則將form中的各字段的值賦給頁面類
5. ...... 賦值
6.public void submit() // 表單提交等用listenter:調用的方法
7.protected void prepareForRender(IRequestCycle cycle) {}
----------------------------------------------------
1.protected void finishLoad() {}
這個函數最先執行，但是它實際上沒有什么用處（我感覺）。因為：
這個函數只在頁面池中沒有某一個頁面類、需要生成一個新的頁面對象時才調用。這里就有一個陷阱：如果你的tomcat啟動時使用了-Dorg.apache.tapestry.disable-caching=true(為了調試方便而設)，那么你每次刷新頁面時，它都會執行（因為每個request都會新生成一個頁面類對象），造成了它總是執行的假象。在實際的部署時，會使用caching，則這個函數執行的機會很少。所以要注意。
初始化的代碼放在4 pageBeginRender()中
2.public void pageValidate(PageEvent event) {}
如果實現了PageValidateListener接口，則可以在這里進行驗證，比如訪問權限等。執行完1后，它就開始執行。
3.public void activateExternalPage(Object[] parameters, IRequestCycle cycle) {}
如果實現了IExternalPage接口，則可以從這里取得由外面傳過來的參數。執行2后，執行到這里。在這里可以把那些參數取出，賦給頁面類。
4.public void pageBeginRender(PageEvent event) {}
執行完3后，將執行本函數。但是這時從客戶端傳過來的參數還沒有被賦值(如果提交了表單的話)。這里可以進行一些初始化操作。
5.執行完4后，如果有表單提交，在這里將會取出那些值，賦給對應的字段。(注意：只是將表單中有的值賦過來)
6.public void submit()
如果有表單提交的話，在這里將進行對應的操作。因為此時各字段已經取好值了，所以可以拿來直接用。
7.protected void prepareForRender(IRequestCycle cycle) {}
最后才執行這個方法。我們可以在其中進行為了在頁面上顯示數據而進行的操作，比如取得什么對象什么的，因為這里頁面類的屬性賦值已經結束，可以直接拿來使用了。
注意：如果執行了6，則還要執行4，再執行7。如果沒有6，4完了就直接是7。
以上是我所總結的執行順序，不當之處請指出。
-----------------------------------------------------
最開始學tapestry的時候，覺得“怎么有這么多地方需要持久啊”。原來以前只知道pageBeginRender這個函數，什么初始化操作都放在它里面。可是它是在賦值之前執行，所以拿到的字段多都是空的，卻都以為是沒有持久化的緣故。所以在客戶端里放了一大堆的@Hidden，或者session中持久，非常麻煩，，，對tapestry也產生的懷疑。現在才知道那些需要取得客戶端傳來的參數的代碼，最好放在prepareForRender里，很多不必要的持久都可以省掉了