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

引用于:[url]http://www.blogjava.net/tunaic/archive/2008/09/27/231513.html[/url]