Tapestry4.1.2入门

作者：Kenny Lee | 来源：http://www.topxp.org |

简单介绍

  不必关心链接！不必关心请求 (http request) 到了哪里！不必关心响应 (http response) 要转向哪里！ Tapestry 构建于底层的 request-resonse 模式，基于 Servlet 技术，抽象出面向组件开发的模型。 Tapestry 关心的是：页面、组件、事件、对象、方法、属性 !

安装 jar 包

1 、

将 Tapestry 解压目录下的 lib 目录中的 jar 包拷贝到 WEB-INF/lib 目录。

并将重复的包删除（ commons-logging.jar/javassist.jar/ognl-2.6.11.jar ）

2 、

在 web.xml 中添加：

< servlet >     < servlet-name > app </ servlet-name >     < servlet-class > org.apache.tapestry.ApplicationServlet </ servlet-class >     < load-on-startup > 0 </ load-on-startup >   </ servlet >   < servlet-mapping >     < servlet-name > app </ servlet-name >     < url-pattern > /app </ url-pattern >   </ servlet-mapping >

 

这是 Tapestry 的中央控制器。 Tapestry 页面的显示，所有的请求，都会被发送到这个 Servlet 上。

 

 

实例 1 ：最简单的 Tapestry 程序

在 WebRoot 下添加 Home.html

<! DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" > < html > < head > < meta http-equiv = "Content-Type" content = "text/html; charset=GB18030" > < title > Insert title here </ title > </ head > < body > 第一个 Tapestry 程序 </ body > </ html >

 

并访问网址：

http://localhost:8088/[context path]/app

 

结果页面显示 Home.html 里面的内容。

 

这是因为 Tapestry 总是会包含一个名字叫 ”Home” 的页面，默认情况下就是根路径下的 Home.html

 

实例 2 ：添加简单的动态内容

 

Home.html 改为：

<! DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" > < html > < head > < meta http-equiv = "Content-Type" content = "text/html; charset=GB18030" > < title > Insert title here </ title > </ head > < body > 第一个 Tapestry 程序 现在时间是： <span jwcid="@Insert" value="ognl:new java.util.Date()"> </span> </ body > </ html >

 

重新访问网址： http://localhost:8088/[context path]/app

 

在这个页面上，用到了 Tapestry 的 Insert 组件（ Component ）。它带一个参数，通过一个 ognl 表达式来传递。

 

在应用服务器的启动参数中添加： -Dorg.apache.tapestry.disable-caching=true ，可以避免每次修改页面模板的时候重启服务器。

 

jwc = Java Web Component

 

实例 3 ：创建链接，指向某个页面

 

<! DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" > < html > < head > < meta http-equiv = "Content-Type" content = "text/html; charset=GB18030" > < title > Insert title here </ title > </ head > < body > 第一个 Tapestry 程序 现在时间是： < span jwcid = "@Insert" value = "ognl:new java.util.Date()" ></ span > < p > <a href="#" jwcid="@PageLink" page="Home"> 刷新 </a> </ body > </ html >

 

这次，通过一个 PageLink 组件，指向 Home 页面， PageLink 组件会自动产生指向 Home 页面的链接（我们不必关心这个链接！）。

 

实例 4 ：简单的计数器

直到现在为止，我们还没有涉及到 java 类，但是已经让 Tapestry 成功运行起来了！该是写点 java 代码的时候了。我们想要创建一个计数器，每当用户点击“计数器增 1 ”的时候，我们将这个计数器加 1 ，然后在页面上显示出这个结果。

 

在传统的请求 - 响应模式中，我们针对这个问题，需要考虑的是：递交一个请求，创建相应的 Action 来接收这个请求，并维护计数器的值，然后决定成功转向的页面，将结果显示在页面上。

 

在 Tapestry 中，我们需要考虑的是：在哪个页面处理这个事件，结果如何显示在页面上？

下面是 Home.html

<! DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" > < html > < head > < meta http-equiv = "Content-Type" content = "text/html; charset=GB18030" > < title > Insert title here </ title > </ head > < body > 第一个 Tapestry 程序 现在时间是： < span jwcid = "@Insert" value = "ognl:new java.util.Date()" ></ span > < p > < a href = "#" jwcid = "@PageLink" page = "Home" > 刷新 </ a > < p > 计数器当前的值是： <span jwcid="@Insert" value="ognl:counter"></span> <a href="#" jwcid="@DirectLink" listener="listener:doClick"> 计数器增 1</a> </ body > </ html >

 

DirectLink 指定的 listener 为： doClick ，这将触发一个事件，实际上就是将要调用 doClick() 方法。

 

doClick() 方法将要写在哪里？因为现在的页面，其动态数据无法简单获得，所以，必须给当前页面创建一个对应的类，我们的方法将创建在这个类里面。

package com.bjsxt.crm.web.tapestry.test;   import org.apache.tapestry.annotations.Persist; import org.apache.tapestry.html.BasePage;   public abstract class Home extends BasePage {          @Persist        public abstract int getCounter();        public abstract void setCounter(int count);          public void doClick(){               int counter = getCounter();               counter = counter + 1;               setCounter(counter);        } }

 

 

注意 ：在这个例子中，类名需定义为 Home ； listener 的名字为 doClick ，而不是 doClick()

 

另外，需要在 web-inf 目录下添加配置文件： app.application

<?xml version="1.0"?>   <!DOCTYPE application PUBLIC   "-//Apache Software Foundation//Tapestry Specification 4.0//EN"   "http://tapestry.apache.org/dtd/Tapestry_4_0.dtd" >     <application>     <meta key = "org.apache.tapestry.page-class-packages" value = "com.bjsxt.crm.web.tapestry.test" /> </application>

配置的主要目的是让 Tapestry 了解如何关联页面和页面类。

 

实例 5 ：带一个参数的计数器

 

Home.html 改为：

<! DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" > < html > < head > < meta http-equiv = "Content-Type" content = "text/html; charset=GB18030" > < title > Insert title here </ title > </