Tapestry 学习总结

[请注意，由于Javaeye博客有很多bug，插入文章的代码段的显示有很多的错误，注意自己正确辨别]

Tapestry给我得第一感觉是想法非常不错，把界面的渲染和界面的数据、逻辑分离的很彻底，但是对于程序员来说写程序并不是很直观。而且有关文档、资料和书籍都不多。特别是一些复杂点的需求不知从何下手。经过一段时间的学习，我也总结了一些，以下所有内容都是基于Tapestry 4.1.3版本的。

基础

---

实现一个页面需要有三个文件：*.html, *.page, *.java（好象有点麻烦哦，不过在某些简单、极端的情况下page文件和java文件可以省略掉），html模板和page文件名字需要相同，Java类的名字不强制，他是在page文件里显式关联的。这样有个好处，多个page可以共用一个java类，不过这样做法可能有点乱。

模板（html）的搜索路径
Tapestry会首先page定义的路径下搜索html模板，然后在Web应用Context的根路径下搜索--也就是说在WebRoot/下搜索。这样我们可以选择把html模板和page放在一起或者放在WebRoot下。

把html模板放在WebRoot下有个好处，可以不需要page文件（如果有必要的话），反过来说，如果你没有定义page文件，那就只能放在WebRoot下了。

为了便于分类，我们可以把html模板和page文件放到子目录下面，如 WebRoot/Pages/User/UserReg.*。 但是这样需要在相应的地方把完整的路径都写上。可能会有以下几处：
1. Java类的listener方法处理后跳转的页面：如

java 代码

@InjectPage
(
"Pages/User/UserList"
)
public
 
abstract
 IPage getUserListPage();

2. 链接：

组件搜索路径
有以下几个：

 

1. 根据在*.application中用 显式定义的组件类型的路径
2. *.application所在的目录，通常是WEB-INF
3. WEB-INF/ servlet-name 目录， servlet-name 也就是在web.xml中配置的名字。
4. Web项目根目录，也就是/WebRoot

一般情况可以使用第三种，这样比较不乱，可以将所有组件放在一起，通常自定义组件都不会太多。

链接

---

链接在Tapestry里似乎不是问题，因为它变的非常的对象化；但是用起来又好像有很多的问题。比较常用的链接组件是DirectLink和PageLink，下面是他们的用法：

DirectLink
用法一：可以这样用：

HTML

<
a
 
jwcid
=
"@DirectLink"
 
listener
=
"listener:prepareUserEdit"
 
parameters
=
"ognl:user.id"
 
href
=
"#"
>
Edit
<!-- -->a
>

listener是处理链接点击的方法名，parameters是参数，对应的的方法是

java 代码

public
 IPage prepareUserEdit(String id){

}

注意这里的参数，如果这个参数如果不是String的而是int话，这个listener方法要这么：

java 代码

public
 IPage prepareUserEdit(
int
 id){

}

Tapestry会自动判断数据类型。

用法二：
将用法一中的HTML模板内的绑定信息搬到page文件中：

HTML

<
a
 
jwcid
=
"menuItem"
 
href
=
"#"
>
xxx
<!-- -->a
>

page

<
component
 
id
=
"menuItem"
 
type
=
"DirectLink"
>
  <
binding
 
name
=
"listener"
 
value
=
"listener:doClickMenuItem"
/>
  <
binding
 
name
=
"parameters"
 
value
=
"ongl:xxx"
/>
  <
binding
 
name
=
"target"
 
value
=
"literal:Content"
/>
<!-- -->component
>

怎么样，HTML模板现在看上很简洁吧。
个人觉得第二种方式好一些，虽然要多写一些，但是它使得HTML代码很“干净”，特别是页面比较复杂的时候，即便不复杂，HTML里面也不应该有太多与显示无关的东西。当然，如果是特别简单的情况，那就无所谓了。

技巧：
如果要给链接传多个参数，两种方法的parameters这么写：
HTML

parameters
="
ognl
:{userName, id}"

Page

<
binding
 
name
=
"parameters"
 
value
=
"ognl:{userName, id}"
/>

PageLink
方法一：

HTML

<
a
 
jwcid
=
"@PageLink"
 
page
=
"Page1"
>
go to Page1
<
a
>

点击这个链接会直接跳转到名为Page1的页面。

方法二：

HTML

<
a
 
jwcid
=
"page2"
>
go to Page2
<
a
>

page

<
component
 
id
=
"page2"
 
type
=
"PageLink"
>
<
binding
 
name
=
"page"
 
value
=
"literal:Page2"
/>
<
component
>

PageLink一般比较简单，只是页面的跳转，两个方法都可以。



硬编码超链接：
如果我们不使用链接组件，要自己动态生成一个对某个页面的超链接该怎么办呢？这个URL该如何写呢？参数如何传递呢？
在文档里我只找到了诸如 "/app?service=page&page=xxx"的URL写法，但是这样的链接只能页面间跳转，无法绑定listener方法并传递参数，似乎作者不希望人们这么做。但是我观察带参数的DirectLink生成的网页链接，如：

/Users,$DirectLink.direct?
sp
=
l1

看起来Users就是当前页面，$DirectLink是链接组件的名字，如果没有显式的指定的话就自动采用组件的名字加上$前缀，如果有其他无名链接就会出现类似$DirectLink_0, $DirectLink_1的链接， sp=l1看起来就是参数了。这样我们不用链接组件也可以自己生成网页超链接了。
当然，我们还是要在page文件里写上对应的组件声明进行绑定--我们还没告诉它要如何处理这个链接的点击操作呢。如下面的例子：

HTML

/TreeMenuPage,menuItem.direct?
sp
=
item_01
&
sp
=
doSomthing

xml 代码

<

component

 

id

=

"menuItem"

 

type

=

"DirectLink"

>
<

binding

 

name

=

"listener"

 

value

=

"listener:doClickMenuItem"

/>
<

binding

 

name

=

"target"

 

value

=

"literal:Menu"

/>
<

component

>

 

java 代码

public
 IPage doClickMenuItem(String itemId, String itemName) {

}

链接的名字不是什么$DirectLink了，必须和page里声明的组件的名字一致。注意链接参数的顺序和Java类listener方法的参数顺序应该也是一致的。


Form相关组件

---

Form相关组件的使用应该算是比较简单的。但是有几个点要说一下：


Hidden组件
Hidden组件和TextField组件有些不一样，废话，一个显示一个不显示，不过我要说的不是这个。Hidden和TextFiled组件在渲染页面的的时候经常要给一个初始化值（如果有的话），不同的是Hidden组件会在值的前面加一个前缀，如果是String类型就加S，如果是long型的就加l，以此类推。不过好像Tapestry在提交Hidden的时候会自动处理这个前缀，所以无需担心类型转换错误。


与For组件一起使用
如果将Form的组件于For组件一起使用的话，For组件会将数据转换成字符串并存储在Hidden组件内。也就是说，如果For组件使用的数据无法被序列化的话，Tapestry就会报错，抛出ApplicationRuntimeException异常。例如，如果你要循环输出若干了User对象给Select组件，形成的话一个User列表框的话，你的User对象必须序列化：


java 代码

public
 
class
 User 
implements
 Serializable

多个Submit按钮
当需要多个Sumit按钮来提交同一个Form，用不同的listener方法来处理的时候，可以在默认的submit组件后添加另外一个submit组件，指定listner 方法，如：

xml 代码

<
input
 
type
=
"submit"
 
jwcid
=
"help@Submit"
 
action
=
"listener:doHelp"
 
value
=
"Help"
/>

自定义组件

---

自定义组件也和定义Page一样需要三个文件，一个组件的模板，也是一个html文件，一个*.jwc文件和一个Java类。其实自定义组件的方法和定义Page几乎完全一样，除了实现的接口不一样之外。要注意的是一下几点：

body
如果需要自定义组件包含其他组件或者html元素的话，需要在组件模板内使用@RenderBody组件，如：

<
span
 
jwcid
=
"@RenderBody"
>
Unique content goes here.
<!-- -->span
>

那么用自定义组件包含的内容都会被渲染，如：

<
span
 
jwcid
=
"@UserComponent"
>
<
a
 
href
=
"#"
>
Hello World
<!-- -->a
>
<!-- -->span
>

如果组件内有数据提交，要处理提交的数据的话，要在renderComponent()里做

java 代码

if
(cycle.isRewinding()){
                  ......
}

JavaScript

---

可以把JavaScript代码从html模板中分离出来实现代码重用，在Tapestry下可以用传统的方式引入js文件，但是如果你需要在Tapestry处理JavaScript里的某些数据的话，就需要使用Tapestry的方式，把JavaScript代码放到后缀为×.script的XML文件中，如：

xml 代码

xml
 
version
=
"1.0"
 
encoding
=
"UTF-8"
?>

"-//Apache Software Foundation//Tapestry Script Specification 3.0//EN"
"http://jakarta.apache.org/tapestry/dtd/Script_3_0.dtd">
<
script
>
<
input-symbol
 
key
=
"symbol"
 
required
=
"yes"
/>
<
body
>
<!-- -->
<!-- -->body
>
<!-- -->script
>

注意JavaScript代码段的body部分要加

xml 代码

<!-- -->

标签，很显然，JavaScript不符合XML格式。
使用的时候在html模板内直接引用：

 

<
span
 
jwcid
=
"myScript"
/>

给script传递参数：
上面代码段中的< input-symbol key = "symbol" required = "yes" />就是script的参数




StyleSheet

---

StyleSheet不是在html模板中直接定义的，也是通过Tapestry作为asset来实现的。当然你完全可以在html模板中指定css文件路径，不过那通常是给模板的编辑人员使用的。那么在Tapestry中应该怎么样使用呢？

假如你的css文件在WebRoot/css下面。那么在你的xxx.page里加上

<
asset
 
name
=
"stylesheet"
 
path
=
"css/style.css"
/>

在你的xxx.html模板中用Shell组件包裹你的body标签，把你在page里声明的stylesheet赋给Shell组件

xml 代码

<
span
 
jwcid
=
"@Shell"
 
stylesheet
=
"asset:stylesheet"
>
<
body
 
jwcid
=
"@Body"
>

......

</
body
>
</
span
>

这样的话整个页面就应用了这个css/style.css了。