hnmaque
- 浏览: 17423 次
- 性别:
- 来自: 湖南
-
最新评论
１、web.xml
一般来说，使用Tapestry需要在Tapestry中添加２项内容
A、 <context-param>
<!-- The only significant configuration for Tapestry 5, this informs Tapestry
of where to look for pages, components and mixins. -->
<param-name>tapestry.app-package</param-name>
<param-value>com.demo</param-value>
</context-param>
这个配置也比较重要，这个配置项告诉Tapestry去哪个package下面去找页面、组件、服务等东西。
在源代码中需要在此配置的package下面建立４个package，分别为：com.demo.pages, com.demo.components, com.demo.services, com.demo.mixins
现在流行约定高于配置，所以Tapestry默认要求使用这样４个package名称。
其中页面类放在pages目录下，组件放在components目录下，服务放在services目录下，mixins翻译起来比较困难（Tapestry的作者也说mixins是一个很tricky的概念，这是一种能让一个真的组件与一些其他特殊组件混合起来的东西）。
B、Tapestry的Filter，现在的Web框架基本上都使用Filter取代以前流行的servlet配置了。
<filter>
<filter-name>app</filter-name>
<filter-class>org.apache.tapestry5.TapestryFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>app</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
这里面需要注意的是filter-class中Tapestry的Package中，从5.0以后org.apache.tapestry变为org.apache.tapestry5了（多了一个５）。
这个filter-name是比较重要的一个名字，Tapestry没有一个象Spring那样的Xml配置文件，它的初始化配置工作在一个初始化类中完成，这个初始化类需要放在上面提到的services目录下，类名就是filter-name＋Module.class，象我举的例子的话，就是AppModule.java
１、Start.tml和Start.java
Tapestry不需要在Web.xml中配置welcome页面，也是使用约定大于配置的方式，默认的起始页面就是在pages目录下的Start。Tapestry中的页面由两部分组成：一个Java类和一个相同名字的模板文件（类似于jsp，Tapestry中的后缀名为：tml）。其中Java类是必须的，就算是没有任何代码，也必须要生成一个空类。tml模板在大多数情况下也是需要的，少数情况比如返回二进制流的话，可以不需要。
tml模板文件可以放在webroot目录下，也可以和Java类一直放在src目录下。
２、页面的跳转（可以用于指定跳转页面的东西：） @InjectPage
在Tapestry中，页面的跳转和Struts之类的框架是不同的，Struts的做法是Action返回一个字符串，Struts在xml配置文件中进行搜索匹配，决定跳转的页面。而Tapestry没有类似的配置文件，它的做法是在当前页中引用跳转页面。比如：想从Start跳转到Register页面的话，需要在Start中注入Register页面。示例代码如下：
Class Start｛
@InjectPage
private Register register;
Object onSubmit() {
return register;
}
｝
其中值得注意的是：onSubmit的修饰符并不是常见的public，而是缺省级别（或者说是package级别），这是Tapestry推荐的做法。第一，比public级别低，这样的话，页面类的事件处理函数没有被公开，不是其他所有的人都能随便调用。第二，比private级别高，这样如果测试需要的话，可以把测试类放在同一个package里，方便测试的进行。
在Tapestry的事件处理函数中可以有６种方式指定跳转的页面
a、什么也不返回，也就是返回类型是void，这样的话，页面不跳转，只是刷新当前页面
b、字符串。Tapestry会查找与该字符串对应的类
c、类。一般来说是一个Page类，这种方式比返回类名（字符串）要好，因为这样的话，在类重命名后，程序不会出错。
d、Page实例，
e、Link，
f、流（Stream），比如返回pdf或者Excel文件。
３、Tapstry页面中的表达式
类似于jsp中<%= 变量名%>这样的写法，Tapestry的语法是${变量名}，其中变量名是需要在页面对应的Java类中有get方法的。
１、在Tapestry中，页面称之为页面模板（Page Template）。Tapestry的页面模板必须是一个Well Formed Xml，需要引入Tapestry的Xml命名空间才能使用Tapestry的组件。示例：<html xmlns:t="http://tapestry.apache.org/schema/tapestry_5_1_0.xsd">
２、在页面模板中可以使用表达式来获取变量的值。这种表达式在Tapestry中称之为：Expansion。
３、在前一篇文章中已经说过，一个页面模板必须有一个对应的Java类。在Tapestry中最基本的Expansion就是一个Java类的属性。比如：${userName}这就是一个在可以在页面模板中使用的Expansion，为了正确的显示用户名，必须在Java类中有一个对应的public String getUserName（）这样一个方法。注意：是一个getter方法，而不必需是public String userName，实际上，如果没有userName这个属性，而只有getUserName这个方法，应用将能正确运行。
４、Expansion是不区分大小写的，也就是说${userName}和${UserName}是等价的。
５、使用Expansion，我们不仅可以显示Java类的属性，而且可以显示该属性的属性，比如Java类有一个日期型属性public Date getBirthday()；那么，在页面模板中就可以这样使用：${birthday.time}，相当于调用getBirthday().getTime()
６、也可以显示地调用非getter方法：比如：${birthday.hashCode()}，Tapestry5.1开始，可以将属性作为函数调用的参数了。
７、可以使用?.来调用方法：比如：${birthday?.time}，这样即使birthday是null，页面也不会报错。
８、Tapestry的Expansion是会编译时生成class文件的，而不是在运行时使用反射来取值的。Tapestry的作者认为这是Tapestry性能优于Struts2的可能（注意：Howard Lewis Ship也只是猜测）原因之一。
９、Tapestry的Expansion使用的几个说明：
a、Expansion旁边的空白是会被忽略的
b、整数和小数前面可以使用负号
c、常数都是使用十进制的。
d、字符串需要使用单引号
e、可以使用..来表示一个范围，比如：1..5，表示１到５
在讲述页面之间传递值之前首先要介绍一个Tapestry的页面缓存。
Tapestry的一个经常被提及的就是页面的缓存，Wicket也有页面缓存，但是Wicket的页面是缓存在Session里的，缺省好像是只缓存５个页面。这一点让我对Wicket的印象打了折扣，首先，这种机制在高并发，也就是多人同时在线的时候，感觉页面缓存会占用大量资源。而Tapestry的页面缓存是在一个大池中。
页面缓存的优点就是提高效率，但是缺点也是比较明显的，那就是给开发实现带来了不方便。我觉得众人说的Tapestry的学习曲线比较陡，一部分原因就在这里。上一章讲过，在Tapestry中，页面的跳转是通过InjectPage实现的。Tapestry在页面跳转时，会从缓存池中选取一个相应页面的实例，渲染成html。关键在于Tapestry在把页面放到缓存池之前，会把页面实例里的值清空。这就是造成页面传值麻烦的原因。写段代码示例：
Class Register {
private String name;
public void setName(String name) {
this.name = name;
}
public String getName() {
return name;
}
}
Class Start{
@InjectPage
private Register register;
Object onSubmit() {
register.setName("superman");
return register;
}
}
如果页面从Start跳转到Register，并且希望把superman这个值传递给Register这个页面，感觉上只要象上面这段代码一样简单设置一下就行了，但是实际上这样是无法在Register的页面上显示出superman这个名字的。因为Tapestry会在页面显示时候的时候，从缓存池中提取一个实例，这个实例在放入缓存池之前，name属性的值就被清空了。
下面是Tapestry页面之间传递值的几种方式：
２、Persist。最简单的方式是使用persist注解。
Class Register {
@Persist
private String name;
public void setName(String name) {
this.name = name;
}
public String getName() {
return name;
}
}
只要这样指定后，Tapestry会把name的值保存在Session中，以备下次使用。但是这样的缺点也很明显，首先是占用资源，另外这样的URL是不能作为书签的，因为参数值不体现在URL中，而是保存在Session中。
３、Page Active Context。这个方法比较好，但是需要一些代码来实现。主要是添加两个函数onActivate和onPassivate。
Class Register {
private String name;
public void setName(String name) {
this.name = name;
}
public String getName() {
return name;
}
void onActivate(String name) {
this.name = name;
}
String onPassivate() {
return name;
}
}
在Start页面中，我们使用了InjectPage把Register注入到了类中，如果只是简单地返回Register，是不能正确显示name的值的，但是在Tapestry会在把Start页面中的Register放回缓存池，清空Register实例中的变量值之前，检查这个类是否但是现在我们实现了onActivate和onPassivate这两个方法，Tapestry会自动
４、SessionState
在Tapestry中有一种类型的对象存储在Session中，所以对所有页面都是可见的，但是又不需要对页面暴露Session。在Tapestry5以前，称之为ApplicationStateObject，但是这个称呼并不准确，因为这个对象不是Application级别，而只是Session级别，所以Tapestry5开始，改名为SessionStateObject。
使用方法也很简单，只需要在JavaClass中，给相应的属性添加一个@SessionState注解即可。
需要提醒注意的是，SessionState区分对象实例不依赖于实例的名称，而是根据实例的类型，比如：你在一个类中使用@SessionState注解了一个String name;而在另一个类中想再用@SessionState注解一个String password;这是不行的，Tapestry会把这两个当作同一个对象实例。
另一个需要注意的是，SessionState注解之后，Tapestry会马上会初始化生成一个该对象的实例。
１、Tapestry组件的写法
a、<t:textfield t:id="userName" t:value="jack"/>，这样的写法的优点是，看上去比较直观，与Struts等Web框架的一致。但是缺点就是，使用浏览器（或者美工）直接看页面的时候，浏览器无法正确显示这个组件。
b、<input type="text" t:type="textfield" t:id="userName" t:value="jack"/>这样写的话，浏览器就能正常显示一个文本输入框了。这也是Tapestry一直鼓吹的一大优点之一。
c、在Java类中使用注解来声明组件。这种方法我个人并不推荐，只是一种选择，并不直观也不方便。
d、Tapestry组件标签是不区分大小写的。
２、组件参数的前缀。从官方文档来看，参数的前缀还挺多的：
Prefix Description
asset The relative path to an asset file (which must exist).
block The id of a block within the template.
component The id of another component within the same template.
context Context asset: path from context root.
literal A literal string.
nullfieldstrategy Used to locate a pre-defined NullFieldStrategy
message Retrieves a value from the component's message catalog.
prop A property expression to read or update.
translate The name of a configured translator.
validate A validator specification used to create some number of field validators.
var Allows a render variable of the component to be read or updated.
但最最常用的只有２个：prop和literal
简单的说：prop表示这是一个变量名，literal表明这是一个常量
比如说select这个组件，它的基本写法是： <t:select t:id="color" model="literal:Red,Green,Blue" label="Colour:"/>
查看select的参考文档，model这个参数的缺省前缀是prop，所以如果直接写model="red"的话，Tapestry会认为red是一个变量名，会调用页面对应类的getRed()方法来获得一个列表。所以，此处如果想使用一个常量的话，需要显示指明literal前缀。而label的缺省前缀是literal，所以直接这样写就没有问题。
３、Label，显示一个标签，一般在需要多语言的环境下或者与textField配合使用。
<t:label t:for="userName">Label for the user name</t:label> Lable组件有一个t:for的属性，这个属性的值一般是一个textField的id。我们可以注意到Lable标签里写一段文字，这一段文字在页面部署运行后是不会显示的，写在这里，纯粹是给美工这样的静态页面浏览者看的。在实际运行中这一段文字会被替代。替代的内容就是t:for属性对应的TextField组件的t:id的值，比如：userName。当然Tapestry会自动把userName分成两个单词，而且把user的首字母大写。
如果根据t:id生成的lable不符合要求，可以有另一种选择：直接在textField中指定label：
<input type="text" t:type="textField" t:id="userName" t:label="Input User Name" t:value="jack"/>
４、PageLink，用于显示一个链接，点击后，跳转到指定页面
<a href="#" t:type="pageLink" t:page="register">Register</a>
５、ActionLink，用于显示一个链接，点击后，运行一个可以带有参数的指令。
<a href="#" t:type="actionLink" t:context="id" t:id="clickLink">
${user.id}
</a>
如果一个参数不够，比如，只用一个id不能唯一确定一个用户，必须结合部门id才能唯一确定用户的话，那么可以这样做：
<a href="#" t:type="actionLink" t:context="userContext" t:id="clickLink">delete</a>
相应的在java class中需要添加一个方法：getUserContext()
public Object[] getUserContext() {
return new Object[] {user.id, department.id};
}
６、Loop
Loop并不是一个真正的Form控件，严格说起来是一种逻辑控制语句。语法如下：
<t:loop source="userList" value="user">
<td>${user.name}</td>
</t:loop>
７、Radio ＆ Radio
<t:radiogroup t:id="type">
<t:radio t:id="masterCard"/>
<t:label for="masterCard"/>
<t:radio t:id="visa"/>
<t:label for="visa"/>
<t:radio t:id="amex"/>
<t:label for="amex"/>
<t:radio t:id="dinersClub"/>
<t:label for="dinersClub"/>
<t:radio t:id="discover"/>
<t:label for="discover"/>
</t:radiogroup>
８、CheckBox
<t:checkbox t:id="showall" onclick="this.form.submit();"/> <t:label for="showall"/>
９、Select
<t:select t:id="color" model="literal:Red,Green,Blue"/>
根据前面的4部分内容，我们已经了解了Tapestry的基本概念，掌握了配置、组件等内容。现在我们通过剖析Tapestry的入门示例来对Tapestry进行一个总体上认识。
1、web.xml
<web-app>
<display-name>app Tapestry 5 Application</display-name>
<context-param>
<!-- The only significant configuration for Tapestry 5, this informs Tapestry
of where to look for pages, components and mixins. -->
<param-name>tapestry.app-package</param-name>
<param-value>t5demo</param-value>
</context-param>
<filter>
<filter-name>app</filter-name>
<filter-class>org.apache.tapestry.TapestryFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>app</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
</web-app>
这就是一个最简单的Tapestry应用所需要配置的内容了。
a.context-param中的tapestry.app-package配置，这在第一部分说过：这是Tapestry要求配置的java package的名称，Tapestry相关内容都需要在这个package下面的pages, services, componets子package下。这里的配置是t5demo
b.TapestryFileter的配置。这个非常容易理解，几乎所有现在流行的web框架都需要一个类似的定义。
2、start.tml以及相应的java class，例子中就是t5demo.pages.Start.java
Start.java非常简单，只定义了一个get方法：
public class Start
{
public Date getCurrentTime()
{
return new Date();
}
}
相应的页面start.tml
<html xmlns:t="http://tapestry.apache.org/schema/tapestry_5_1_0.xsd">
<head>
<title>app Start Page</title>
</head>
<body>
<h1>app Start Page</h1>
<p> This is the start page for this application, a good place to start your modifications.
Just to prove this is live: </p>
<p> The current time is: ${currentTime}. </p>
<p>
[<t:pagelink t:page="Start">refresh</t:pagelink>]
</p>
</body>
</html>
首先要注意在html的tag中加入了Tapestry的命名空间。
第二、${currentTime}就是Tapestry的Tag了，这里就会调用对应class的getCurrentTime方法在页面上显示对应的值。
第三、<t:pagelink>定义一个到自己本身页面的链接，来完成刷新的任务。t:pagelink在本系列的第4部分介绍过。
3、需要的library：
commons-codec.jar
javassist.jar
log4j.jar
slf4j-api.jar
slf4j-log4j.jar
tapestry5-annotations-5.1.0.5.jar
tapestry-core-5.1.0.5.jar
tapestry-ioc-5.1.0.5.jar
4、再加上一个log4j.properties，这就是一个最简单的tapestry应用所需要的全部东西了。
怎么样，感觉还是挺简单的吧。
一般来说，使用Tapestry需要在Tapestry中添加２项内容
A、 <context-param>
<!-- The only significant configuration for Tapestry 5, this informs Tapestry
of where to look for pages, components and mixins. -->
<param-name>tapestry.app-package</param-name>
<param-value>com.demo</param-value>
</context-param>
这个配置也比较重要，这个配置项告诉Tapestry去哪个package下面去找页面、组件、服务等东西。
在源代码中需要在此配置的package下面建立４个package，分别为：com.demo.pages, com.demo.components, com.demo.services, com.demo.mixins
现在流行约定高于配置，所以Tapestry默认要求使用这样４个package名称。
其中页面类放在pages目录下，组件放在components目录下，服务放在services目录下，mixins翻译起来比较困难（Tapestry的作者也说mixins是一个很tricky的概念，这是一种能让一个真的组件与一些其他特殊组件混合起来的东西）。
B、Tapestry的Filter，现在的Web框架基本上都使用Filter取代以前流行的servlet配置了。
<filter>
<filter-name>app</filter-name>
<filter-class>org.apache.tapestry5.TapestryFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>app</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
这里面需要注意的是filter-class中Tapestry的Package中，从5.0以后org.apache.tapestry变为org.apache.tapestry5了（多了一个５）。
这个filter-name是比较重要的一个名字，Tapestry没有一个象Spring那样的Xml配置文件，它的初始化配置工作在一个初始化类中完成，这个初始化类需要放在上面提到的services目录下，类名就是filter-name＋Module.class，象我举的例子的话，就是AppModule.java
１、Start.tml和Start.java
Tapestry不需要在Web.xml中配置welcome页面，也是使用约定大于配置的方式，默认的起始页面就是在pages目录下的Start。Tapestry中的页面由两部分组成：一个Java类和一个相同名字的模板文件（类似于jsp，Tapestry中的后缀名为：tml）。其中Java类是必须的，就算是没有任何代码，也必须要生成一个空类。tml模板在大多数情况下也是需要的，少数情况比如返回二进制流的话，可以不需要。
tml模板文件可以放在webroot目录下，也可以和Java类一直放在src目录下。
２、页面的跳转（可以用于指定跳转页面的东西：） @InjectPage
在Tapestry中，页面的跳转和Struts之类的框架是不同的，Struts的做法是Action返回一个字符串，Struts在xml配置文件中进行搜索匹配，决定跳转的页面。而Tapestry没有类似的配置文件，它的做法是在当前页中引用跳转页面。比如：想从Start跳转到Register页面的话，需要在Start中注入Register页面。示例代码如下：
Class Start｛
@InjectPage
private Register register;
Object onSubmit() {
return register;
}
｝
其中值得注意的是：onSubmit的修饰符并不是常见的public，而是缺省级别（或者说是package级别），这是Tapestry推荐的做法。第一，比public级别低，这样的话，页面类的事件处理函数没有被公开，不是其他所有的人都能随便调用。第二，比private级别高，这样如果测试需要的话，可以把测试类放在同一个package里，方便测试的进行。
在Tapestry的事件处理函数中可以有６种方式指定跳转的页面
a、什么也不返回，也就是返回类型是void，这样的话，页面不跳转，只是刷新当前页面
b、字符串。Tapestry会查找与该字符串对应的类
c、类。一般来说是一个Page类，这种方式比返回类名（字符串）要好，因为这样的话，在类重命名后，程序不会出错。
d、Page实例，
e、Link，
f、流（Stream），比如返回pdf或者Excel文件。
３、Tapstry页面中的表达式
类似于jsp中<%= 变量名%>这样的写法，Tapestry的语法是${变量名}，其中变量名是需要在页面对应的Java类中有get方法的。
１、在Tapestry中，页面称之为页面模板（Page Template）。Tapestry的页面模板必须是一个Well Formed Xml，需要引入Tapestry的Xml命名空间才能使用Tapestry的组件。示例：<html xmlns:t="http://tapestry.apache.org/schema/tapestry_5_1_0.xsd">
２、在页面模板中可以使用表达式来获取变量的值。这种表达式在Tapestry中称之为：Expansion。
３、在前一篇文章中已经说过，一个页面模板必须有一个对应的Java类。在Tapestry中最基本的Expansion就是一个Java类的属性。比如：${userName}这就是一个在可以在页面模板中使用的Expansion，为了正确的显示用户名，必须在Java类中有一个对应的public String getUserName（）这样一个方法。注意：是一个getter方法，而不必需是public String userName，实际上，如果没有userName这个属性，而只有getUserName这个方法，应用将能正确运行。
４、Expansion是不区分大小写的，也就是说${userName}和${UserName}是等价的。
５、使用Expansion，我们不仅可以显示Java类的属性，而且可以显示该属性的属性，比如Java类有一个日期型属性public Date getBirthday()；那么，在页面模板中就可以这样使用：${birthday.time}，相当于调用getBirthday().getTime()
６、也可以显示地调用非getter方法：比如：${birthday.hashCode()}，Tapestry5.1开始，可以将属性作为函数调用的参数了。
７、可以使用?.来调用方法：比如：${birthday?.time}，这样即使birthday是null，页面也不会报错。
８、Tapestry的Expansion是会编译时生成class文件的，而不是在运行时使用反射来取值的。Tapestry的作者认为这是Tapestry性能优于Struts2的可能（注意：Howard Lewis Ship也只是猜测）原因之一。
９、Tapestry的Expansion使用的几个说明：
a、Expansion旁边的空白是会被忽略的
b、整数和小数前面可以使用负号
c、常数都是使用十进制的。
d、字符串需要使用单引号
e、可以使用..来表示一个范围，比如：1..5，表示１到５
在讲述页面之间传递值之前首先要介绍一个Tapestry的页面缓存。
Tapestry的一个经常被提及的就是页面的缓存，Wicket也有页面缓存，但是Wicket的页面是缓存在Session里的，缺省好像是只缓存５个页面。这一点让我对Wicket的印象打了折扣，首先，这种机制在高并发，也就是多人同时在线的时候，感觉页面缓存会占用大量资源。而Tapestry的页面缓存是在一个大池中。
页面缓存的优点就是提高效率，但是缺点也是比较明显的，那就是给开发实现带来了不方便。我觉得众人说的Tapestry的学习曲线比较陡，一部分原因就在这里。上一章讲过，在Tapestry中，页面的跳转是通过InjectPage实现的。Tapestry在页面跳转时，会从缓存池中选取一个相应页面的实例，渲染成html。关键在于Tapestry在把页面放到缓存池之前，会把页面实例里的值清空。这就是造成页面传值麻烦的原因。写段代码示例：
Class Register {
private String name;
public void setName(String name) {
this.name = name;
}
public String getName() {
return name;
}
}
Class Start{
@InjectPage
private Register register;
Object onSubmit() {
register.setName("superman");
return register;
}
}
如果页面从Start跳转到Register，并且希望把superman这个值传递给Register这个页面，感觉上只要象上面这段代码一样简单设置一下就行了，但是实际上这样是无法在Register的页面上显示出superman这个名字的。因为Tapestry会在页面显示时候的时候，从缓存池中提取一个实例，这个实例在放入缓存池之前，name属性的值就被清空了。
下面是Tapestry页面之间传递值的几种方式：
２、Persist。最简单的方式是使用persist注解。
Class Register {
@Persist
private String name;
public void setName(String name) {
this.name = name;
}
public String getName() {
return name;
}
}
只要这样指定后，Tapestry会把name的值保存在Session中，以备下次使用。但是这样的缺点也很明显，首先是占用资源，另外这样的URL是不能作为书签的，因为参数值不体现在URL中，而是保存在Session中。
３、Page Active Context。这个方法比较好，但是需要一些代码来实现。主要是添加两个函数onActivate和onPassivate。
Class Register {
private String name;
public void setName(String name) {
this.name = name;
}
public String getName() {
return name;
}
void onActivate(String name) {
this.name = name;
}
String onPassivate() {
return name;
}
}
在Start页面中，我们使用了InjectPage把Register注入到了类中，如果只是简单地返回Register，是不能正确显示name的值的，但是在Tapestry会在把Start页面中的Register放回缓存池，清空Register实例中的变量值之前，检查这个类是否但是现在我们实现了onActivate和onPassivate这两个方法，Tapestry会自动
４、SessionState
在Tapestry中有一种类型的对象存储在Session中，所以对所有页面都是可见的，但是又不需要对页面暴露Session。在Tapestry5以前，称之为ApplicationStateObject，但是这个称呼并不准确，因为这个对象不是Application级别，而只是Session级别，所以Tapestry5开始，改名为SessionStateObject。
使用方法也很简单，只需要在JavaClass中，给相应的属性添加一个@SessionState注解即可。
需要提醒注意的是，SessionState区分对象实例不依赖于实例的名称，而是根据实例的类型，比如：你在一个类中使用@SessionState注解了一个String name;而在另一个类中想再用@SessionState注解一个String password;这是不行的，Tapestry会把这两个当作同一个对象实例。
另一个需要注意的是，SessionState注解之后，Tapestry会马上会初始化生成一个该对象的实例。
１、Tapestry组件的写法
a、<t:textfield t:id="userName" t:value="jack"/>，这样的写法的优点是，看上去比较直观，与Struts等Web框架的一致。但是缺点就是，使用浏览器（或者美工）直接看页面的时候，浏览器无法正确显示这个组件。
b、<input type="text" t:type="textfield" t:id="userName" t:value="jack"/>这样写的话，浏览器就能正常显示一个文本输入框了。这也是Tapestry一直鼓吹的一大优点之一。
c、在Java类中使用注解来声明组件。这种方法我个人并不推荐，只是一种选择，并不直观也不方便。
d、Tapestry组件标签是不区分大小写的。
２、组件参数的前缀。从官方文档来看，参数的前缀还挺多的：
Prefix Description
asset The relative path to an asset file (which must exist).
block The id of a block within the template.
component The id of another component within the same template.
context Context asset: path from context root.
literal A literal string.
nullfieldstrategy Used to locate a pre-defined NullFieldStrategy
message Retrieves a value from the component's message catalog.
prop A property expression to read or update.
translate The name of a configured translator.
validate A validator specification used to create some number of field validators.
var Allows a render variable of the component to be read or updated.
但最最常用的只有２个：prop和literal
简单的说：prop表示这是一个变量名，literal表明这是一个常量
比如说select这个组件，它的基本写法是： <t:select t:id="color" model="literal:Red,Green,Blue" label="Colour:"/>
查看select的参考文档，model这个参数的缺省前缀是prop，所以如果直接写model="red"的话，Tapestry会认为red是一个变量名，会调用页面对应类的getRed()方法来获得一个列表。所以，此处如果想使用一个常量的话，需要显示指明literal前缀。而label的缺省前缀是literal，所以直接这样写就没有问题。
３、Label，显示一个标签，一般在需要多语言的环境下或者与textField配合使用。
<t:label t:for="userName">Label for the user name</t:label> Lable组件有一个t:for的属性，这个属性的值一般是一个textField的id。我们可以注意到Lable标签里写一段文字，这一段文字在页面部署运行后是不会显示的，写在这里，纯粹是给美工这样的静态页面浏览者看的。在实际运行中这一段文字会被替代。替代的内容就是t:for属性对应的TextField组件的t:id的值，比如：userName。当然Tapestry会自动把userName分成两个单词，而且把user的首字母大写。
如果根据t:id生成的lable不符合要求，可以有另一种选择：直接在textField中指定label：
<input type="text" t:type="textField" t:id="userName" t:label="Input User Name" t:value="jack"/>
４、PageLink，用于显示一个链接，点击后，跳转到指定页面
<a href="#" t:type="pageLink" t:page="register">Register</a>
５、ActionLink，用于显示一个链接，点击后，运行一个可以带有参数的指令。
<a href="#" t:type="actionLink" t:context="id" t:id="clickLink">
${user.id}
</a>
如果一个参数不够，比如，只用一个id不能唯一确定一个用户，必须结合部门id才能唯一确定用户的话，那么可以这样做：
<a href="#" t:type="actionLink" t:context="userContext" t:id="clickLink">delete</a>
相应的在java class中需要添加一个方法：getUserContext()
public Object[] getUserContext() {
return new Object[] {user.id, department.id};
}
６、Loop
Loop并不是一个真正的Form控件，严格说起来是一种逻辑控制语句。语法如下：
<t:loop source="userList" value="user">
<td>${user.name}</td>
</t:loop>
７、Radio ＆ Radio
<t:radiogroup t:id="type">
<t:radio t:id="masterCard"/>
<t:label for="masterCard"/>
<t:radio t:id="visa"/>
<t:label for="visa"/>
<t:radio t:id="amex"/>
<t:label for="amex"/>
<t:radio t:id="dinersClub"/>
<t:label for="dinersClub"/>
<t:radio t:id="discover"/>
<t:label for="discover"/>
</t:radiogroup>
８、CheckBox
<t:checkbox t:id="showall" onclick="this.form.submit();"/> <t:label for="showall"/>
９、Select
<t:select t:id="color" model="literal:Red,Green,Blue"/>
根据前面的4部分内容，我们已经了解了Tapestry的基本概念，掌握了配置、组件等内容。现在我们通过剖析Tapestry的入门示例来对Tapestry进行一个总体上认识。
1、web.xml
<web-app>
<display-name>app Tapestry 5 Application</display-name>
<context-param>
<!-- The only significant configuration for Tapestry 5, this informs Tapestry
of where to look for pages, components and mixins. -->
<param-name>tapestry.app-package</param-name>
<param-value>t5demo</param-value>
</context-param>
<filter>
<filter-name>app</filter-name>
<filter-class>org.apache.tapestry.TapestryFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>app</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
</web-app>
这就是一个最简单的Tapestry应用所需要配置的内容了。
a.context-param中的tapestry.app-package配置，这在第一部分说过：这是Tapestry要求配置的java package的名称，Tapestry相关内容都需要在这个package下面的pages, services, componets子package下。这里的配置是t5demo
b.TapestryFileter的配置。这个非常容易理解，几乎所有现在流行的web框架都需要一个类似的定义。
2、start.tml以及相应的java class，例子中就是t5demo.pages.Start.java
Start.java非常简单，只定义了一个get方法：
public class Start
{
public Date getCurrentTime()
{
return new Date();
}
}
相应的页面start.tml
<html xmlns:t="http://tapestry.apache.org/schema/tapestry_5_1_0.xsd">
<head>
<title>app Start Page</title>
</head>
<body>
<h1>app Start Page</h1>
<p> This is the start page for this application, a good place to start your modifications.
Just to prove this is live: </p>
<p> The current time is: ${currentTime}. </p>
<p>
[<t:pagelink t:page="Start">refresh</t:pagelink>]
</p>
</body>
</html>
首先要注意在html的tag中加入了Tapestry的命名空间。
第二、${currentTime}就是Tapestry的Tag了，这里就会调用对应class的getCurrentTime方法在页面上显示对应的值。
第三、<t:pagelink>定义一个到自己本身页面的链接，来完成刷新的任务。t:pagelink在本系列的第4部分介绍过。
3、需要的library：
commons-codec.jar
javassist.jar
log4j.jar
slf4j-api.jar
slf4j-log4j.jar
tapestry5-annotations-5.1.0.5.jar
tapestry-core-5.1.0.5.jar
tapestry-ioc-5.1.0.5.jar
4、再加上一个log4j.properties，这就是一个最简单的tapestry应用所需要的全部东西了。
怎么样，感觉还是挺简单的吧。
分享到：
发表评论
-
S2SI
2013-04-17 19:57 557简单的struts2+spring+ibatis 实现增删改查 ... -
jsp中JSTL应用
2011-04-28 11:40 843截取字的长度 [/align][align=left] & ... -
实现s1sh
2010-12-15 10:27 958ation package cn.com.webapp. ... -
初级s1ssh
2010-12-15 10:25 743web中 <?xml version="1.0 ... -
s2pshixian
2010-12-14 21:10 738action zhong public class Ne ... -
s2p
2010-12-14 20:58 958<?xml version="1.0" ... -
初级 ssh jar包
2010-12-14 20:43 672jar包图片格式 -
初级登录 到过程
2010-12-14 20:35 9591. denglu.jsp 中的 <%@ page ... -
初级S2SH配置文件
2010-12-14 20:30 8741。web.xml： <?xml version=& ...
相关推荐
它们将帮助初学者理解Tapestry的基本概念、组件使用、事件处理等方面的知识。 总的来说，Tapestry 4是一个强大且灵活的Web开发框架，通过其组件化、声明式编程和事件驱动的特性，能有效提高开发效率，同时保持代码...
本教程将帮助初学者了解Tapestry的基本概念，带你逐步入门并掌握其核心组件的使用。 首先，让我们深入理解Tapestry的核心理念。Tapestry的目标是通过提高开发效率、简化代码结构和增强可维护性来改善Java Web应用的...
Tapestry5最新中文教程.doc 作者 Renat Zubairov & Igor Drobiazko译者 沙晓兰 发布于 2008年7月2日 下午9时30分 社区 Java 主题 Web框架 ----------------------------------------- Tapestry5.1实例教程.pdf ...
"tapestry学习入门资料" Tapestry 是一个开源的基于 servlet 的应用程序框架，它使用组件对象模型来创建动态的、交互的 web 应用。 Tapestry 使得 Java 代码与 HTML 完全分离，利用这个框架开发大型应用变得...
Tapestry是一个强大的Java Web应用程序框架，由Apache软件基金会维护。它强调组件化、模块化和松耦合的开发方式，使得开发人员可以构建出高效、可维护的Web应用。以下是对Tapestry源码、API及相关库的详细解读： 1....
### Tapestry4开发指南 #### 一、Tapestry4概览 Tapestry4作为一款先进的Web应用框架，由Howard Lewis Ship所创造，旨在提供一种更为高效、灵活的Web应用构建方式。与前代Tapestry3相比，Tapestry4在设计上有了...
**Tapestry 3 开发指南** Tapestry 3 是一个开源的Java Web应用程序框架，它在20世纪90年代末至21世纪初非常流行，由Apache软件基金会维护。这个框架提供了组件化、事件驱动和声明式编程模型，帮助开发者构建动态、...
这个“tapestry-4.0.zip”压缩包包含了Tapestry框架的4.0版本，这是一个相对较早的但非常稳定的基础，对于初学者来说是个很好的学习起点。在Tapestry 4.0中，我们可以探索许多关于Web应用开发的核心概念和技术。 ...
《Tapestry 4开发指南》是一本专为初学者设计的书籍，旨在帮助读者深入理解和熟练运用Tapestry 4这一强大的Java Web框架。Tapestry 4是一款开源的、基于组件的Web应用程序框架，它允许开发者用更加面向对象的方式来...
对于初学者来说，Tapestry可能会显得有些复杂，但深入学习后，你会发现它与其他框架相比有着独特的优点。 1. **简单性**：Tapestry通过对象、方法和属性来替代URL和查询参数，减少了开发过程中常见的繁琐任务，如...
Tapestry是一个基于控件的框架以致于用它开发Web应用类似开发传统的GUI应用。你用Tapestry开发Web应用时你无需关注以操作为中心的(Operation-centric) Servlet API.引用Tapestry网站上的一句话："Tapestry用对象...
这份文档可能是针对Tapestry 5的最新中文教程，旨在为初学者提供一个易懂的入门指南。通常，它会涵盖基本的框架安装、环境配置、组件使用、事件处理、页面和组件生命周期等主题。通过阅读这份教程，开发者可以快速...
Tapestry是一个强大的Java Web应用程序框架，由Apache软件基金会维护。它旨在提高开发效率，提供高度模块化和可重用的组件，以及优秀的错误处理和调试能力。在深入探讨Tapestry的知识点之前，让我们先了解一下这个...
"详细的使用手册"可能包含了关于如何设置项目、创建组件、处理用户交互、部署应用等方面的指导，这对于初学者尤其有用。通过“网页形式查询方便”，我们可以推测这个压缩包可能包含了一个在线的API文档或者教程，...
Tapestry 5.2.6 是一个成熟的Java Web开发框架，它提供了一种高效、模块化和可扩展的方式来构建动态、数据驱动的Web应用程序。这个框架的核心理念是将用户界面与业务逻辑分离，通过组件化的思想实现页面的构建，从而...
Apache Tapestry 5 是一个基于Java的Web应用开发框架，其设计目的是为了简化Web应用程序的构建，提供组件化的页面构建、输入验证、本地化、状态管理和URL映射等功能。Tapestry 5 强调易用性，不仅对终端用户友好，...
《Tapestry 5 電子書》是关于Java Web开发框架Tapestry 5的一本详尽指南，由Packt Publishing在2007年出版。这本书旨在帮助开发者深入理解和掌握Tapestry 5的各个方面，从而利用其强大功能构建高效、可维护的Web应用...
Tapestry5.0.16文档和大家一起学习
**Tapestry API 深度解析** Tapestry，作为一个强大的MVC（Model-View-Controller）结合模板技术的Web开发框架，为Java开发者提供了一种高效且灵活的构建Web应用程序的方式。它通过组件化的设计，使得代码更加模块...