====================================================================================
' 说明：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里，很多不必要的持久都可以省掉了