Tapestry入门(2)

1、TapestryTapestry是一个开源的基于servlet的应用程序框架，它使用组件对象模型来创建动态的，交互的web应用。一个组件就是任意一个带有jwcid属性的html标记。其中jwc的意思是Java Web Component。Tapestry使得java代码与html完全分离，利用这个框架开发大型应用变得轻而易举。并且开发的应用很容易维护和升级。Tapestry支持本地化，其错误报告也很详细。Tapestry主要利用javabean和xml技术进行开发。Tapestry把在建立Web应用程序容易出错的工作交由框架本身来完成，接管了大量手工完成的任务，如分发用户请求，创建和解释URL

2、信息，操作本地化和国际化等等大量的工作。Tapestry也是由“对象、方法、域”这些面像对象元素构成，但是它更关注于开发者关心的Servlet API的请求，回复，会话，属性，参数，URLs等等开销。Tapestry关注的重点在对象（包括页，组件，也包括系统的域对象），和这些对象的方法，这些对象的JavaBean属性。在一个Tapestry应用系统里，用户动作（点击Link，提交表单）的结果是通过用户组合的方法（在应用程序的逻辑里包含了它）改变了对象的属性，Tapestry关心的是如何联系用户的动作和这些动作所引响到的对象。这些可以适合你的使用习惯。你不可以在Tapestry里写Servlet

3、。你可以写你自己的监听方法。你也不可能建立Servlets的URL地址，但你可以使用现有的组件（像DirectLink），配置它的监听参数来调用你自己的监听方法。监听方法能做些什么呢？它可以与另外的系统（经常是无状态，有状态的会话Bean）相联系，或者做与请求相关的动作，或者选择一个新的页来响应用户的请。，一般来说Servlet的核心代码都可以在监听方法中写。在Tapestry里，你只要写很少的代码，因为所有的机械而重复的核心代码（如创建URL，分发请求，管理服务器状态等等）都由框架统一管理了。不是说Servlet API做不到这些管理，只是因为它些东西对Tapestry的用户关联不大。Tap

4、estry当前是3.0版本，它是一个成熟的框架，它一直关注的是产生动态的HTML页面，它也支持了大量的XHTML，WML和其它类型的标签。几乎所有的Tapestry的API都是用接口来描述的，它们提供默认的实现。最后，Tapestry值的夸耀的是它的JavaDoc API文档。相关站点/下载地址：/tapestry/一、概述由于internet技术的广泛流行，越来越多的程序开发模式正在从C/S向B/S转换，由于B/S模式具有瘦客户端的优点无须安装客户端程序，这就大大减轻了软件升级的费用，所有的业务逻辑和数据库存储都放在服务端，从而提高了系统的可维

5、护性。而且由于HTTP协议是一个开放式的标准，因此只要是支持HTTP协议的浏览器都可以运行，再结合目前的XML技术，可以方便地实现跨平台的分布式应用。但B/S架构有其天生的缺点：无状态性。这其实并不是B/S程序的错，而是由于B/S程序是建立在http协议的基础上的，因此程序无法维护各个客户端的状态，不过所幸的是这个问题现在已经解决了。现行的B/S开发的另一大缺陷是：代码和HTML页面揉和在一起了，对程序员和美工非常不利，而且对代码的维护简直是一场恶梦，这相信是许多Web开发者的一种体会。而C/S结构就没有这种缺陷，因为它是基于组件的，比如VB，你有多得数不清的ActiveX控件来完成一些复杂的

6、界面。也许你看到这里，心里在盘算着：还是用C/S算了，省得这么多麻烦，但是一个不敢于尝试新技术的公司往往是一个被新技术淘汰的公司。为了解决上述问题，apache组织开发了一个基于JSP的MVC模式的实现：struts。它将WEB表现层分为model-view-controller几个部分，通过一个servlet来对web的流程进行控件，这与单纯的JSP或ASP相比确实进步了不少，因为利用struts能清楚地界定web的流程，而且不提倡使用% . %语句，转而代之的是taglib技术。但它始终没有摆脱代码和HTML页面揉和的问题，而且它的原理对于JSP初学者来说比较复杂，taglib库不够丰富，

7、而且taglib也不像组件那样能够继承。于是，新一代的WEB开发方法应运而生，它们最典型的就是开发方法是基于组件的，其中最具代表性的就是Tapestry。二、为什么要用Tapestry？ Tapestry现在已经属于Apache的Jakarta项目下了，你可以访问/tapestry 来访问更多的信息。Tapestry是一个强有力、开放源码、基于Java的用于开发高端WEB应用的framework。它是JSP的一种替代方法，使用Tapestry，可以让你的页面看不到一句JSP代码，这使页面看起来非常干净。它可以用很少的代码来构造一个极端复杂的WEB

8、应用。Tapestry使用了类似于传统C/S的开发方法：基于组件的开发。使用tapestry，你就可以得到以下好处：1、非常高的代码复用性，因为在tapestry中，任何事物都可以看作一个可复用的组件。 2、将JSP开发者从繁琐的JSP代码中解脱出来，取而代之的是真正面像对像方法，而不是URL解析。 3、对页面国际化的充分支持 4、精确地错误报告，可以将错误定位到源程序中的行，取代了JSP中那些莫名奇妙地错误提示。充分支持团队开发，美工人员和JAVA开发人员可以融洽地相处，互相都不依赖于对方。你也许会问：如果tapestry是基于组件的，那么它的组件是怎样构成的呢？它是由一个定义文件(以XML

9、的格式)、一个HTML模板、一个JAVA类。Tapestry的组件可以组合在一起形成一个更大的组件或逻辑页面。Tapestry的工作原理如下：在web.xml文件中定义一个名为ApplicationServlet的servlet来进行处理所有的http请求，这和struts有点相似，不过它主要职责是负责引导整个tapestry核心，启动日志功能，读取配置文件，创建工作引擎来指派客户请求。ApplicationServlet主要是通过它的配置文件来进行自身管理的，你可以通过在web.xml中定义一个名为org.apache.tapestry.specification-path的初始参数来指定这

10、个配置文件，当然如果你觉得这样麻烦，那你也可以不指定配置文件，但tapestry会自动寻找与此servlet同名的配置文件，例如在web.xml中的定义如下：servlet servlet-nameRegistration/servlet-name servlet-classorg.apache.tapestry.ApplicationServlet/servlet-class load-on-startup0/load-on-startup /servlet那么Tapestry会自动寻找一个名为Registration.application的配置文件，如果用户没有定义此文件，那么Tapes

11、try将不能正常启动。为了便于理解，我举一个大家都熟知的例子：用户注册模块。首先生成一个注册页面，等待用户的输入，然后进行合法性检查，如果通过，就显示下一个页面。如下所示也许你会说，咦，这不是和JSP的表单差不多的吗？是的，虽然看上去差不多，但原理大不一样，由于它是基于组件的，所以Name、DOB、Address、City、State、Zip和Register按钮都是单独的组件，而不是普通的表单了。这时你肯定会说：唉，也不过如此嘛，就算是基于组件的思想设计出来的东西也不过尔尔，这几个文本框这么简单，何必费这么大的劲把它们包装成组件呢？呵呵，不知你注意到DOB这个文本框没有？它和其它几个有些不一

12、样，它的右边多了一个小按钮，如果点击此按钮，出现的结果会让你瞠目结舌!酷吧？如果你曾经是一个JSP程序员，你的脑海里马上会闪过这样一个念头：一定是用javascript做的! 如果你这样想的话，那你就大错特错了，因为本人的javascript还没达到这种水平，如果我告诉你完成这样一个组件，只需要在配置文件中加入通俗易懂的几个xml元素的时候，你是否会觉得这真的很神奇呢？是的，这就是Tapestry的魅力所在，Tapestry主要设计者Howard Lewis Ship的目的就是最大限度地解放JSP程序员的劳动量，让他们有更多的时间花在客户的需求和程序的逻辑设计上，而不是花在和美工人员互相解决矛

13、盾冲突上，你可能会急不可待的问：那我们是否可以动手试一试了呢？是的，当然可以，但在动手之前，我要先介绍一些关于tapestry的概念，并试着开发一个最简单的“hello,world”程序来让你熟悉一下它的配置。因为它是一个framework，如果你对它的结构不是很清楚的话，我想你肯定无法充分地利用它的。一个Tapestry组件一般称作JWC(Java Web Component)，它能与其它JWC一起组合，生成实例，进行配置。比如你刚才看到的那个不可思议的组件就是一个DatePicker组件，刚才的那个页面是一个Page组件，Tapestry自带了很多的JWC组件，这些组件不仅仅只是GUI组件

14、，还有可能是带控制功能的组件，比如foreach组件能够提供循环的功能，同时tapestry还提供了一个简单的方法来制作用户自定义的组件，所有的Tapestry应用的表示层都是由这些JWC构成的。三、一个简单的Hello,world程序为了清楚地弄清tapestry的framwork构架，我们从最简单的”hello,world”开如，打开组件的暗箱来看一看JWC的内部结构。一个典型的JWC包括3个部分-一个HTML模板，一个XML格式的定义文件和一个或多个JAVA类，尽管一个简单的JWC可以仅仅是一个HTML模板，但在本例中我们还是使用这三个部分来展示它的内部结构。先让我们看一下演示的结果：由

15、于我们知道Page也是一种JWC组件，因此让我们看一下这个Page组件是怎样构成的，首先，我们看一下它的HTML模板结构： Home.htmlhtml head titleWelcometoTapestry!/title /head body Hellospanjwcid=userUserName/span!WelcometoTapestry! /body /html这里你可能看上去觉得非常眼熟，这不就是一个普通的HTML网页吗？且慢，如果你仔细观察，会发现span标签多了一个新的属性jwcid，这正是tapestry设计的精妙之处，它的表现层可以说几乎是99%的纯HTML，只是增加了一个jw

16、cid属性，jwcid=”user”在这里的意思是在span /span之间放置一个名为user的组件。这里要指出的是jwcid属性不仅仅可以放在span标签内，它可以放在任何的HTML标签内，比如title、body、form等等，至于为什么要选span的原因是span标签不影响网页的输出效果，这就大大方便了美工人员，他们可以直接使用frontpage或dreamwaver来进行设计，而不像JSP那样无法在frontpage或dreamwaver中正常显示。也许你会问，网页上输出的用户名明明是Jack嘛，为什么HTML模板中是User name呢？这是因为当tapestry一旦发现某个HTM

17、L标签有jwcid的属性后，它就会把这个标签当做一个组件来看待，至于标签里面的东西到底是原样输出或忽略就要依照那个组件的类型而定了，在这里我们的user组件实际上是一种Insert类型的组件，因此会把span标签内的内容忽略掉，其实也可以直接写成span jwcid=”user”/span，效果也是一样的，只不过加了User name后就方便了美工人员的排版设计。请注意，HTML模板有它自己的命名规范，它的文件名应该与Page组件的定义文件相同，只不过是扩展名为.html，与普通的web服务器一般都有一个index.html类似，tapestry也有自己的”index.html”，只不过它的名

18、字不是”index.html”，而是Home.html，那么这些模板文件究竟应该放在哪儿呢？很简单，放在当前应用的目录下面就行了，比如我们的应用是Welcome，那把它放在webapps/Welcome目录下面就行了。Home.page?xmlversion=1.0encoding=UTF-8? !DOCTYPEpage-specificationPUBLIC -/ApacheSoftwareFoundation/TapestrySpecification3.0/EN /tapestry/dtd/Tapestry_3_0.dtd page-spe

19、cificationclass=demo.Home componentid=usertype=Insert bindingname=valueexpression=userName/ /component context-assetname=$templatepath=Home.html/ /page-specification以上这个文件便是这个名为”Home”的Page组件的页面定义文件，它好像是一座桥，联系着HTML模板和JAVA类进行协同工作。这个定义文件“Home.page”实际上就是一个xml文件，它的根元素是page-specification，它有一个名为class的属性，用来

20、指示HTML模板与哪个java类协同工作，在本例中为demo.Home这个类。Component元素是对HTML模板中引用的组件的定义，id属性名一定要与HTML模板中的jwcid一样，type指定了这个组件属于哪种类型，在本例中为Insert组件，Insert组件是Tapestry中的一个基本组件，它的作用是在HTML模板中插入指定的文本，待插入的文本的值由Insert的value属性来决定，在本例中，value属性的表达式值是userName。你这时候可能会觉得越看越糊涂：那为什么最后运行结果会是Jack呢？不要着急，关于这个我们马上就要详细地进行讲解。我们还是先看一下最后一个元素cont

21、ext-asset，这个元素是定义这个Page组件要用到的一些附加资源，比如图像、css格式文件等等之类的东西现在我们开始认真地讲一下binding name=value expression=userName/这个元素的含义，由于HTML模板嵌入的是一个Insert类型的组件，而Insert组件的功能是插入一段文本到HTML模板中去，对于本例而言，或许可以直接地指定要插入文本的内容为“Jack”，但对一个实际的应用来说，往往是要从数据库从取出用户的名称，然后将该名称插入到HTML模板中去，那么就不能直接指定文本的内容了，怎么办呢？我们马上想到的办法是：指定一个JAVA类，通过javaBean

22、的属性方法来获得数据库中的用户名，就像jsp中的jsp getProperty /标签一样，不错，这的确是一个好方法，tapestry正是这样做的，因此binding name=value expression=userName/这个元素中的expression的值正是demo.Home这个JAVA类的一个属性，也就是说将demo.Home这个类的userName属性绑定到Insert组件的value属性中去，而我们的创始人Howard Lewis Ship先生并没有重头对这个绑定的功能进行设计，因为在软件开发中有一句著名的话：”不要重复地发明同一个轮子“，这个绑定功能是由另一个开放源码的工具

23、完成地- Object Graph Navigation Library，简称OGNL(关于OGNL具体可以参考 )。其内部真正的转换如下图所示：其中，Insert这个JWC组件有一个名为value的属性，而我们在Home.page中将它与一个外部对像userName进行绑定，在程序真正运行的时候，HTML模板中的user组件读取demo.Home这个JAVA类的userName属性，然后通过OGNL工具对Insert组件的value属性进行更新，最后user组件将更新后的值插入到模板当中。好了，这时候你应该明白了Insert组件是怎样取值的吧。需要强调的是

24、Page组件是一种特殊的JWC组件，它可以包含其它的JWC组件，但不能被其它的JWC组件所包含。除此之外，Page组件还有一些特殊的属性和功能，它也不能和其它组件进行组合而生成新的组件。组件的命名方式和HTML模板的命名方式有些不同，它可以以.page作为扩展名(如果是Page组件)，或者以.jwc作为扩展名(如果是非Page组件)。组件一般放在当前web应用的WEB-INF目录下面，以本例来说，我们的Home.page这个文件就应该放在webapps/Welcom/WEB-INF目录下面。Home.java packagedemo; importorg.apache.tapestry.htm

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

26、，它还可以实现表单组件的提交。Tapestry提供了2个基本类方便用户进行扩充，一个是BasePage类(专用于Page组件)，另一个是BaseComponent类(用于用户自定义组件)。通过继承这些组件，可以大大地减轻用户的编程量，从而把精力放到程序流程设计上去。demo.Home组件类的名称应该与Home.page中定义的名称一致，它一般放在当前web应用的WEB-INF/classes目录下，以本例来说，Home.class这个类应该放在webapps/Welcome/WEB-INF/classes/demo目录下面。Welcome.application?xmlversion=1.0e

27、ncoding=UTF-8? !DOCTYPEapplicationPUBLIC -/ApacheSoftwareFoundation/TapestrySpecification3.0/EN /tapestry/dtd/Tapestry_3_0.dtd pagename=Homespecification-path=Home.page/ /application以上这个文件是这个Tapestry应用的配置文件，它是以application作为根元素的，其中page元素指定了一个名为Home的Page组件，它的文件名为Home.page，当然你也可

28、以指定更多的page组件，这个配置文件就像是一个总装车间，把一个个page组件或其它的组件装配起来。关于这个配置文件的命名规范我们在前面已经讲过了，它一般放在WEB-INF目录下，在本例中它放在了webapps/Welcome/WEB-INF目录下面。web.xml ?xmlversion=1.0? !DOCTYPEweb-appPUBLIC -/SunMicrosystems,Inc./DTDWebApplication2.2/EN /j2ee/dtds/web-app_2_2.dtd web-app display-nameTapestryWelcome

29、Application/display-name servlet servlet-nameWelcome/servlet-name servlet-classorg.apache.tapestry.ApplicationServlet/servlet-class load-on-startup0/load-on-startup /servlet servlet-mapping servlet-nameWelcome/servlet-name url-pattern/app/url-pattern /servlet-mapping session-config session-timeout15

30、/session-timeout /session-config welcome-file-list welcome-fileindex.html/welcome-file /welcome-file-list /web-appListing 5. web.xml 这个文件相信所有的JSP/servlet开发员都非常熟悉了吧？在这个文件中我们定义了一个名为Welcome的servlet，它实际上就是org.apache.tapestry.ApplicationServlet这个类，它的主要作用是对客户的请求进行包装，然后转发到各个page组件进行处理，当然如果你有特殊需要，也可以继承Appli

31、cationServlet类(当然这种情况很少出现)。其中servlet-mapping用来进行地址映射，相信servlet开发员应该都知道它的作用吧？我们把所有对于/app的请求全部转发给Welcome这个servlet进行处理，当然你也可以将/app换成其你自己的定义。最后我们打开一个IE浏览器，在地址栏中输入http:/localhost:8080/Welcome/app 就会看到结果。好了，现在我们就讲一下关于上面那个用户注册的例子吧。由于篇幅的关系，我就不把所有的配置文件一一罗列了，只摘录一些关键的配置。CustInfo.htmlhtmljwcid=Shelltitle=Welcom

32、ePage bodyjwcid=Body formjwcid=Formlistener=ognl:listeners.submit CustomerName:inputjwcid=custNametype=text/br/ Date-of-Birth:inputjwcid=dobtype=textformat=MMMdd,yyyy/ (MonthDD,YYYY)br/ inputtype=submitvalue=Submit/ /form /body /html也许你看了上面这个文件不禁会问：为什么有的组件名称前面加了一个“”？原因如下：tapestry由于是由众多组件组成的，其中一般的组件都

33、要在其Page组件中用component元素进行定义，对于一些简单的或者无其它附加参数的组件来说就显得比较麻烦，因此tapestry提出了显式定义组件和隐式定义组件这个概念，显式定义是指明确地在Page组件中定义过的组件，隐式定义是指没有明确地在Page组件中定义的组件，都要在组件名字前加一个“”。这里有一个组件显得很特别：Form组件，这个组件由于是隐式定义地，因此它的参数就直接在HTML模板中进行定义：listener=ognl:listeners.submit，它表示当用户按下submit按钮后页面流程会交给当前Page组件类（即Welcome这个类）的submit函数进行管理。下面我们

34、再看一下它的Page组件的定义：CustInfo.page?xmlversion=1.0encoding=UTF-8? !DOCTYPEpage-specificationPUBLIC -/ApacheSoftwareFoundation/TapestrySpecification3.0/EN /tapestry/dtd/Tapestry_3_0.dtd page-specificationclass=demo.Welcome property-specificationname=custNametype=java.lang.String/ pr

35、operty-specificationname=dobtype=java.util.Date/ componentid=custNametype=TextField bindingname=valueexpression=custName/ /component componentid=dobtype=DatePicker bindingname=valueexpression=dob/ /component /page-specification 其中值得关注的是dob这个组件，它的类型是tapestry核心组件库中的DatePicker组件，有了它，我们就可以生成先前那个不可思义的选择日

36、期的界面了。这里出现了一个新面孔：property-specification元素，它是干什么用的呢？还是先让我们看一下那个“hello,world”例子中的组件类的定义吧：Home.java packagedemo; importorg.apache.tapestry.html.BasePage; publicclassHomeextendsBasePage privateStringuserName=Jack; publicStringgetUserName() returnthis.userName; 其中userName这个属性是一个javaBean属性，通过get或set方法来存取userName的值，当然对于本例，property-specification这个元素和它一样，就是定义了一个javaBean的属性，其实你也可以像上例那样进行存取，而不需在CustInfo.page中进行定义。定义property-specification元素的根本原因其实很可笑：为了偷一点懒！为什么这么说呢？因为如果你用property-specification元素来定义j