简单介绍
不必关心链接!不必关心请求 (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 程序 现在时间是: 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 > 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 > 计数器当前的值是: 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
application PUBLIC "-//Apache Software Foundation//Tapestry Specification 4.0//EN" "http://tapestry.apache.org/dtd/Tapestry_4_0.dtd" >
key = "org.apache.tapestry.page-class-packages" value = "com.bjsxt.crm.web.tapestry.test" />
|
配置的主要目的是让 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 >
|