Tapestry

＜servlet＞ ＜servlet-name＞Registration＜/servlet-name＞ ＜servlet-class＞org.apache.tapestry.ApplicationServlet＜/servlet-class＞ ＜load-on-startup＞0＜/load-on-startup＞ ＜/servlet＞

　　那么Tapestry会自动寻找一个名为Registration.application的配置文件，如果用户没有定义此文件，那么Tapestry将不能正常启动。

　　为了便于理解，我举一个大家都熟知的例子：用户注册模块。首先生成一个注册页面，等待用户的输入，然后进行合法性检查，如果通过，就显示下一个页面。如下所示

　　也许你会说，咦，这不是和JSP的表单差不多的吗？是的，虽然看上去差不多，但原理大不一样，由于它是基于组件的，所以Name、DOB、Address、City、State、Zip和Register按钮都是单独的组件，而不是普通的表单了。

　　这时你肯定会说：唉，也不过如此嘛，就算是基于组件的思想设计出来的东西也不过尔尔，这几个文本框这么简单，何必费这么大的劲把它们包装成组件呢？呵呵，不知你注意到DOB这个文本框没有？它和其它几个有些不一样，它的右边多了一个小按钮，如果点击此按钮，出现的结果会让你瞠目结舌!

　　酷吧？如果你曾经是一个JSP程序员，你的脑海里马上会闪过这样一个念头：一定是用javascript做的! 如果你这样想的话，那你就大错特错了，因为本人的javascript还没达到这种水平，如果我告诉你完成这样一个组件，只需要在配置文件中加入通俗易懂的几个xml元素的时候，你是否会觉得这真的很神奇呢？

　　是的，这就是Tapestry的魅力所在，Tapestry主要设计者Howard Lewis Ship的目的就是最大限度地解放JSP程序员的劳动量，让他们有更多的时间花在客户的需求和程序的逻辑设计上，而不是花在和美工人员互相解决矛盾冲突上，你可能会急不可待的问：那我们是否可以动手试一试了呢？是的，当然可以，但在动手之前，我要先介绍一些关于tapestry的概念，并试着开发一个最简单的“hello,world”程序来让你熟悉一下它的配置。因为它是一个framework，如果你对它的结构不是很清楚的话，我想你肯定无法充分地利用它的。

　　一个Tapestry组件一般称作JWC(Java Web Component)，它能与其它JWC一起组合，生成实例，进行配置。比如你刚才看到的那个不可思议的组件就是一个DatePicker组件，刚才的那个页面是一个Page组件，Tapestry自带了很多的JWC组件，这些组件不仅仅只是GUI组件，还有可能是带控制功能的组件，比如foreach组件能够提供循环的功能，同时tapestry还提供了一个简单的方法来制作用户自定义的组件，所有的Tapestry应用的表示层都是由这些JWC构成的。

三、一个简单的Hello,world程序

　　为了清楚地弄清tapestry的framwork构架，我们从最简单的”hello,world”开如，打开组件的暗箱来看一看JWC的内部结构。一个典型的JWC包括3个部分----一个HTML模板，一个XML格式的定义文件和一个或多个JAVA类，尽管一个简单的JWC可以仅仅是一个HTML模板，但在本例中我们还是使用这三个部分来展示它的内部结构。

　　先让我们看一下演示的结果：

　　由于我们知道Page也是一种JWC组件，因此让我们看一下这个Page组件是怎样构成的，首先，我们看一下它的HTML模板结构：

　　Home.html

＜html＞ ＜head＞ ＜title＞Welcome to Tapestry!＜/title＞ ＜/head＞ ＜body＞ Hello ＜span jwcid="user"＞User Name＜/span＞! Welcome to Tapestry! ＜/body＞ ＜/html＞

　　这里你可能看上去觉得非常眼熟，这不就是一个普通的HTML网页吗？且慢，如果你仔细观察，会发现span标签多了一个新的属性jwcid，这正是tapestry设计的精妙之处，它的表现层可以说几乎是99%的纯HTML，只是增加了一个jwcid属性，jwcid=”user”在这里的意思是在＜span＞ … ＜/span＞之间放置一个名为user的组件。这里要指出的是jwcid属性不仅仅可以放在span标签内，它可以放在任何的HTML标签内，比如＜title＞、＜body＞、＜form＞等等，至于为什么要选＜span＞的原因是＜span＞标签不影响网页的输出效果，这就大大方便了美工人员，他们可以直接使用frontpage或dreamwaver来进行设计，而不像JSP那样无法在frontpage或dreamwaver中正常显示。

　　也许你会问，网页上输出的用户名明明是Jack嘛，为什么HTML模板中是User name呢？这是因为当tapestry一旦发现某个HTML标签有jwcid的属性后，它就会把这个标签当做一个组件来看待，至于标签里面的东西到底是原样输出或忽略就要依照那个组件的类型而定了，在这里我们的user组件实际上是一种Insert类型的组件，因此会把＜span＞标签内的内容忽略掉，其实也可以直接写成＜span jwcid=”user”＞＜/span＞，效果也是一样的，只不过加了User name后就方便了美工人员的排版设计。

　　请注意，HTML模板有它自己的命名规范，它的文件名应该与Page组件的定义文件相同，只不过是扩展名为.html，与普通的web服务器一般都有一个index.html类似，tapestry也有自己的”index.html”，只不过它的名字不是”index.html”，而是Home.html，那么这些模板文件究竟应该放在哪儿呢？很简单，放在当前应用的目录下面就行了，比如我们的应用是Welcome，那把它放在webapps/Welcome目录下面就行了。

　　Home.page

＜?xml version="1.0" encoding="UTF-8"?＞ ＜!DOCTYPE page-specification PUBLIC "-//Apache Software Foundation//Tapestry Specification 3.0//EN" "http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd"＞ ＜page-specification class="demo.Home"＞ ＜component id="user" type="Insert"＞ ＜binding name="value" expression="userName"/＞ ＜/component＞ ＜context-asset name="$template" path="Home.html"/＞ ＜/page-specification＞

　　以上这个文件便是这个名为”Home”的Page组件的页面定义文件，它好像是一座桥，联系着HTML模板和JAVA类进行协同工作。这个定义文件“Home.page”实际上就是一个xml文件，它的根元素是page-specification，它有一个名为class的属性，用来指示HTML模板与哪个java类协同工作，在本例中为demo.Home这个类。

　　Component元素是对HTML模板中引用的组件的定义，id属性名一定要与HTML模板中的jwcid一样，type指定了这个组件属于哪种类型，在本例中为Insert组件，Insert组件是Tapestry中的一个基本组件，它的作用是在HTML模板中插入指定的文本，待插入的文本的值由Insert的value属性来决定，在本例中，value属性的表达式值是userName。你这时候可能会觉得越看越糊涂：那为什么最后运行结果会是Jack呢？不要着急，关于这个我们马上就要详细地进行讲解。我们还是先看一下最后一个元素context-asset，这个元素是定义这个Page组件要用到的一些附加资源，比如图像、css格式文件等等之类的东西

　　现在我们开始认真地讲一下＜binding name="value" expression="userName"/＞这个元素的含义，由于HTML模板嵌入的是一个Insert类型的组件，而Insert组件的功能是插入一段文本到HTML模板中去，对于本例而言，或许可以直接地指定要插入文本的内容为“Jack”，但对一个实际的应用来说，往往是要从数据库从取出用户的名称，然后将该名称插入到HTML模板中去，那么就不能直接指定文本的内容了，怎么办呢？我们马上想到的办法是：指定一个JAVA类，通过javaBean的属性方法来获得数据库中的用户名，就像jsp中的＜jsp getProperty … /＞标签一样，不错，这的确是一个好方法，tapestry正是这样做的，因此＜binding name="value" expression="userName"/＞这个元素中的expression的值正是demo.Home这个JAVA类的一个属性，也就是说将demo.Home这个类的userName属性绑定到Insert组件的value属性中去，而我们的创始人Howard Lewis Ship先生并没有重头对这个绑定的功能进行设计，因为在软件开发中有一句著名的话：”不要重复地发明同一个轮子“，这个绑定功能是由另一个开放源码的工具完成地---- Object Graph Navigation Library，简称OGNL(关于OGNL具体可以参考http://www.ognl.org )。其内部真正的转换如下图所示：

　　其中，Insert这个JWC组件有一个名为value的属性，而我们在Home.page中将它与一个外部对像userName进行绑定，在程序真正运行的时候，HTML模板中的user组件读取demo.Home这个JAVA类的userName属性，然后通过OGNL工具对Insert组件的value属性进行更新，最后user组件将更新后的值插入到模板当中。好了，这时候你应该明白了Insert组件是怎样取值的吧。

　　需要强调的是Page组件是一种特殊的JWC组件，它可以包含其它的JWC组件，但不能被其它的JWC组件所包含。除此之外，Page组件还有一些特殊的属性和功能，它也不能和其它组件进行组合而生成新的组件。

　　组件的命名方式和HTML模板的命名方式有些不同，它可以以.page作为扩展名(如果是Page组件)，或者以.jwc作为扩展名(如果是非Page组件)。组件一般放在当前web应用的WEB-INF目录下面，以本例来说，我们的Home.page这个文件就应该放在webapps/Welcom/WEB-INF目录下面。

　　Home.java

package demo; import org.apache.tapestry.html.BasePage; public class Home extends BasePage { private String userName = "Jack"; public String getUserName() { return this.userName; } }

　　最后一部分便是我们的demo.Home这个JAVA类，它实际上就是一个普通的javaBean，唯一不同的就是它必须从BasePage类中继承。它的作用就是为HTML模板中的user组件提供文本信息的来源，在本例中我们简单的返回”Jack”，但实际上getUserName方法还可以从JNDI、数据库、EJB中取得用户名。

　　其实demo.Home不仅仅只是提供数据来源，它还可以实现表单组件的提交。Tapestry提供了2个基本类方便用户进行扩充，一个是BasePage类(专用于Page组件)，另一个是BaseComponent类(用于用户自定义组件)。通过继承这些组件，可以大大地减轻用户的编程量，从而把精力放到程序流程设计上去。

　　demo.Home组件类的名称应该与Home.page中定义的名称一致，它一般放在当前web应用的WEB-INF/classes目录下，以本例来说，Home.class这个类应该放在webapps/Welcome/WEB-INF/classes/demo目录下面。

　　Welcome.application

＜?xml version="1.0" encoding="UTF-8"?＞ ＜!DOCTYPE application PUBLIC "-//Apache Software Foundation//Tapestry Specification 3.0//EN" "http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd"＞ ＜page name="Home" specification-path="Home.page"/＞ ＜/application＞

　　以上这个文件是这个Tapestry应用的配置文件，它是以application作为根元素的，其中page元素指定了一个名为Home的Page组件，它的文件名为Home.page，当然你也可以指定更多的page组件，这个配置文件就像是一个总装车间，把一个个page组件或其它的组件装配起来。

　　关于这个配置文件的命名规范我们在前面已经讲过了，它一般放在WEB-INF目录下，在本例中它放在了webapps/Welcome/WEB-INF目录下面。

　　web.xml

＜?xml version="1.0"?＞ ＜!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN" "http://java.sun.com/j2ee/dtds/web-app_2_2.dtd"＞ ＜web-app＞ ＜display-name＞Tapestry Welcome Application＜/display-name＞ ＜servlet＞ ＜servlet-name＞Welcome＜/servlet-name＞ ＜servlet-class＞org.apache.tapestry.ApplicationServlet＜/servlet-class＞ ＜load-on-startup＞0＜/load-on-startup＞ ＜/servlet＞ ＜servlet-mapping＞ ＜servlet-name＞Welcome＜/servlet-name＞ ＜url-pattern＞/app＜/url-pattern＞ ＜/servlet-mapping＞ ＜session-config＞ ＜session-timeout＞15＜/session-timeout＞ ＜/session-config＞ ＜welcome-file-list＞ ＜welcome-file＞index.html＜/welcome-file＞ ＜/welcome-file-list＞ ＜/web-app＞

Listing 5. web.xml

　　这个文件相信所有的JSP/servlet开发员都非常熟悉了吧？在这个文件中我们定义了一个名为Welcome的servlet，它实际上就是org.apache.tapestry.ApplicationServlet这个类，它的主要作用是对客户的请求进行包装，然后转发到各个page组件进行处理，当然如果你有特殊需要，也可以继承ApplicationServlet类(当然这种情况很少出现)。

　　其中＜servlet-mapping＞用来进行地址映射，相信servlet开发员应该都知道它的作用吧？我们把所有对于/app的请求全部转发给Welcome这个servlet进行处理，当然你也可以将/app换成其你自己的定义。最后我们打开一个IE浏览器，在地址栏中输入http://localhost:8080/Welcome/app 就会看到结果。

　　好了，现在我们就讲一下关于上面那个用户注册的例子吧。由于篇幅的关系，我就不把所有的配置文件一一罗列了，只摘录一些关键的配置。

　　CustInfo.html

＜html jwcid="@Shell" title="Welcome Page"＞ ＜body jwcid="@Body"＞ ＜form jwcid="@Form" listener="ognl:listeners.submit"＞ Customer Name: ＜input jwcid="custName" type="text"/＞＜br/＞ Date-of-Birth: ＜input jwcid="dob" type="text" format="MMM dd, yyyy"/＞ (Month DD, YYYY)＜br/＞ ＜input type="submit" value="Submit"/＞ ＜/form＞ ＜/body＞ ＜/html＞

　　也许你看了上面这个文件不禁会问：为什么有的组件名称前面加了一个“＠”？原因如下：tapestry由于是由众多组件组成的，其中一般的组件都要在其Page组件中用＜component＞元素进行定义，对于一些简单的或者无其它附加参数的组件来说就显得比较麻烦，因此tapestry提出了显式定义组件和隐式定义组件这个概念，显式定义是指明确地在Page组件中定义过的组件，隐式定义是指没有明确地在Page组件中定义的组件，都要在组件名字前加一个“＠”。

　　这里有一个组件显得很特别：＠Form组件，这个组件由于是隐式定义地，因此它的参数就直接在HTML模板中进行定义：listener="ognl:listeners.submit"，它表示当用户按下submit按钮后页面流程会交给当前Page组件类（即Welcome这个类）的submit函数进行管理。

　　下面我们再看一下它的Page组件的定义：

　　CustInfo.page

＜?xml version="1.0" encoding="UTF-8"?＞ ＜!DOCTYPE page-specification PUBLIC "-//Apache Software Foundation//Tapestry Specification 3.0//EN"  "http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd"＞ ＜page-specification class="demo.Welcome"＞ ＜property-specification name="custName" type="java.lang.String"/＞ ＜property-specification name="dob" type="java.util.Date"/＞ ＜component id="custName" type="TextField"＞ ＜binding name="value" expression="custName"/＞ ＜/component＞ ＜component id="dob" type="DatePicker"＞ ＜binding name="value" expression="dob"/＞ ＜/component＞ ＜/page-specification＞

 

　　其中值得关注的是dob这个组件，它的类型是tapestry核心组件库中的DatePicker组件，有了它，我们就可以生成先前那个不可思义的选择日期的界面了。

　　这里出现了一个新面孔：property-specification元素，它是干什么用的呢？还是先让我们看一下那个“hello,world”例子中的组件类的定义吧：

　　Home.java

package demo; import org.apache.tapestry.html.BasePage; public class Home extends BasePage { private String userName = "Jack"; public String getUserName() { return this.userName; } }

　　其中userName这个属性是一个javaBean属性，通过get或set方法来存取userName的值，当然对于本例，property-specification这个元素和它一样，就是定义了一个javaBean的属性，其实你也可以像上例那样进行存取，而不需在CustInfo.page中进行定义。定义property-specification元素的根本原因其实很可笑：为了偷一点懒！　为什么这么说呢？因为如果你用property-specification元素来定义javaBean的属性的话，那你在组件类中就不必实现其get或set方法了，只需用一个抽像方法来完成，至于真正的get或set方法的实现就由tapestry来代劳了，其中，Welcome这个类的代码如下：

Welcome.java

package demo; import java.util.Date; import org.apache.tapestry.IRequestCycle; import org.apache.tapestry.html.BasePage; public abstract class Welcome extends BasePage { public abstract void setCustName(String custName); public abstract void setDob(Date dob); public abstract String getCustName(); public abstract Date getDob(); public void submit(IRequestCycle cycle) { if (getCustName() != null && !getCustName().trim().equals("") && getDob() != null) { Welcome welcome = (Welcome) cycle.getPage("Welcome"); welcome.setCustName(getCustName()); welcome.setDob(getDob()); cycle.activate(welcome); } } }

　　前面的几个抽像方法就不多说了，Welcome类的submit方法和在HTML模板中定义的@Form组件中的listener参数正好对应，也就是说，当用户按下提交按钮后，这个submit方法就会被激活，它进一步地引导着页面下一步的动作。在本例中它先检查用户名和用户出生日期(DOB，date of birthday的简称)是否为空，如果不为空，就将用户在页面中输入的值赋予Welocome这个类的custName和dob这两个属性，然后激活welcome这个Page组件，也就是将页面跳转到welcome这个Page上去。

　　需要注意的是，Form组件定义的监听类方法必须为public，并且要带一个IRequestCycle 的参数，IrequestCycle是一个接口，它是由tapestry提供的一个对于用户而言，当前会话的一个管理工具。

四、总结

　　到目前为止，你大概明白了Tapestry的原理了，但是一个复杂的Tapestry应用还是要考虑到很多问题的，比如页面的定义，页面之间的流程，组件元素的持久性设计，与EJB或原有的JSP系统的集成等等问题，但是Tapestry都已经为你考虑好了，你甚至可以把它的源码下载下来仔细研究，也可以到它的邮件列表上发表自己的观点，这正是我所喜爱的----open source ! 它代表着自由! 
（来源：天极网；http://www.shineblog.com/user1/10716/archives/2005/82407.shtml）