Tapestry3.0开发概论

2022-10-25 09:09:08

一、TAPESTRY技术的综述。

tapestry是平行于struts/Spring MVC/webwork /jsf等开发工具的语言。tapestry是基于组件的开发工具。它具有组件的可重用性。因为大量重复使用的Tapestry组件，以及高度复用的表现层逻辑，使得工作效率大幅度提升。Tapestry组件是一个“黑盒子”，用于表现HTML响应，以及响应HTTP请求。

Tapestry组件通过其规范定义。规范是一个XML文档，其中定义了组件类型，参数，组件模板，包含的组件以及被包含组件之间的联系，还有所有的assets。

Tapestryde：优点：

1） 能够保证对HTML最少限度的干扰，Tapestry对HTML页面的介入可以仅仅是增加一个jwcid(Java Web Component ID)属性。这个明确地划分了美工和程序员之间的界限。

2） 页面的描述基于组件， Page规范描述了组件之间的联系，而java文件负责处理逻辑。

3）由于表现层逻辑全部放在了java文件里面，相比JAVA SCRIPT描述更加灵活。

　4）随着我们项目的深入开展，可复用的组件逻辑越来越多，开发的效率大大提高。

Tapestry框架是标准Servlet API的一种扩展。它需要J2SDK1.2或更高版本的J2SDK和一个与Servlet API2.2(或更高)兼容的应用服务器/Servlet容器。

一个Tapestry应用由许多拥有唯一名称的页面组成。一个页面由一个模板和一些可复用的控件构成。模板由标准的HTML标签和一些额外的属性和标签构成，这些额外的属性和标签是为了告诉Tapestry框架这个页面的那些部分是由Tapestry控件组成。

Tapestry应用拥有高度的可升级性，它利用缓存和对象池使每个请求的处理时间最小化。Tapestry应用拥有跟传统Servlet应用相仿的性能。

Tapestry的学习曲线会长一点，因为它与流行的Web应用框架不太相同。

注意我们需要三个文件：*.html/ *.page/ *.java，分别表示了HTML的模板，页面属性，逻辑属性。

首先简介一下web.xml，这可以使我们了解TAPESTRY是怎么工作的。

web.xml的描述：

<?xml version="1.0"?>

<!DOCTYPE web-app PUBLIC

  "-//Sun Microsystems， Inc.//DTD Web Application 2.3//EN"

  "http://java.sun.com/dtd/web-app_2_3.dtd>

<web-app>

     <display-name>test</display-name>

     <servlet>

        <servlet-name>tapestry</servlet-name>

        <servlet-class>org.apache.tapestry.ApplicationServlet</servlet-class>

        <load-on-startup>1</load-on-startup>

     </servlet>

     <servlet-mapping>

        <servlet-name>tapestry</servlet-name>

        <url-pattern>/app</url-pattern>

     </servlet-mapping>

</web-app>

因为Tapestry框架是标准Servlet API的一种扩展，它实际上是建立在J2EE框架上的。这个从WEB.XML的描述中可以看出.j2ee从URL的请求中分离出/app=>tapestry这个servlet名=>servlet-class org.apache.tapestry.ApplicationServlet处理类.下面就与J2EE SERVLET处理的差不多了。

可以猜测org.apache.tapestry.ApplicationServlet做了以下工作:

1)拦截HTML文件，找到页面描述，创建类A，将其中的jwcid属性变换为对A的调用，从而获取属性值.进而获得页面实例.A可能在创建之后放入对象缓冲池，以备后来使用。

2)当提交表单时，处理listener，处理页面表单逻辑.

3)其他工作同Struts Servlet类似.

二、在Windows下如何使用Tapestry

1. 从官方网站：http://tapestry.apache.org/download.html下载tapestry-bin-5.1.0.5.zip并解压到：D:\tapestry\tapestry-project-5.1.0.5 ，需要指出的是D:\tapestry\tapestry-project-5.1.0.5\lib下包含了开发一个Tapestry应用的全部jar包

2. 安装myeclipse6.0。

3. 下面介绍如何创建一个简单的tapestry应用启动 myeclipse ，新建 java web project.展开工程（test）右键点击JRE System library 选择 build path >> configure build path. 新对话框中选择 libraries 选项卡，点击 add library>>user library>>user libraries>>new ，起一个名字本文中为T5-lib 然后点击 add JARs 将 D:\env\tapestry-project-5.1.0.5\lib 目录下的全部jar文件导入. 然后选中T5-lib 点击finish 。修改web-inf下web.xml文件，同前面例子。

4. 在WebRoot目录下（web-inf同级目录），创建Home.html。（Tapestry程序入口，名字在.appliaction文件中定义）代码如下：

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

<html>

<head>

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

<title>Insert title here</title>

</head>

<body>

    <span jwcid="@Insert" value="ognl:HelloWorld" />

</body>

</html>

5. 在web-inf目录下创建名为 Home.page 的xml文件。如下：

<?xml version="1.0" encoding="GBK"?>

<!DOCTYPE page-specification PUBLIC

"-//Apache Software Foundation//Tapestry Specification 4.0//EN"

"http://jakarta.apache.org/tapestry/dtd/Tapestry_4_0.dtd">

<page-specification class="com.kevin.tapestry.Home">

</page-specification>

6. 最后在 mytapestry 包下写一个java类：

package com.kevin.tapestry;

import org.apache.tapestry.html.BasePage;

public abstract class Home extends BasePage{

     public String getHelloWorld(){

        return "Hello World!";

     }

}

7. 启动tomcat 在浏览器输入 http://localhost:8080/test/app 应该看到如下页面

Hello World!

三.Tapestry框架的简介

一个基于Tapestry的web应用可能包含了以下几种文件：应用规范文件，hivemind配置文件，HTML模板文件，页面规范文件，页面类文件，组件包规范文件，组件规范文件，组件类文件，动态脚本文件。下面一个一个来详细讲述。

1. 三种配置文件（应用程序规范文件，hivemodule配置文件，组件包规范文件）

1.1 应用程序规范文件：是一个以应用程序servlet名称命名的，以“.application”为扩展名的xml文件。一个web应用只能有一个应用程序规范文件。他制定了应用程序的各种细节配置，页面和组件配置，组件包配置等等。如果我们不为应用程序配置应用程序规范文件，Tapestry会为我们提供一个默认的。

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

<!DOCTYPE application PUBLIC

 "-//Apache Software Foundation//Tapestry Specification 4.0//EN"

 "http://jakarta.apache.org/tapestry/dtd/Tapestry_4_0.dtd">

      <application name="test">

         <meta key="org.apache.tapestry.page-class-packages" value="test_path"/>

         <library id="contrib" specification-path="/org/apache/tapestry/contrib/Contrib.library"/>

         <page name="Home" specification-path="Home.page"/>

      </application>

　　<application>为根标签元素，name制定了serlvet名称。

　　<meta>用于配置应用程序细节。在此我们为应用程序配置页面类的默认定义包路径。那么Tapestry将自动在test_path路径下寻找页面类。

　　<library>导入了外部组件包.

1.2 hivemind配置文件：HiveMind框架是一个依赖注入微核心框架，Tapestry框架构建在HiveMind之上。如果你的程序业务层没有用到hivemind，不必配置hivemodule文件。下面给了一个为应用程序配置Friendly

URL的例子：

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

    <module id="test" version="1.0.0">

        <contribution configiration-id="tapestry.url.ServiceEncoders" />

            <direct-service-encoder id ="direct" stateless-extension="direct" stateful-extension="sdirect" />

            <direct-service-encoder id ="action" stateless-extension="action" stateful-extension="saction" />

            <page-service-encoder id="page" extension="page" service="page" />

            <page-service-encoder id="external" extension="external" service="external" />

            <asset-encoder id="asset" path="/assets" />

            <extension-encoder id="ext" id="ext" extension="svc" after="*"/>

    </contribution>

</module>

1.3 组件包规范文件: 为了跨项目积累组件，我们可以将组件打成jar包，然后通过在应用程序规范文件中引入组件包的方式，调用组件包中的自定义组件。组件包规范文件的后缀为“.library”的XML文件，命名任意。

2. Tapestry页面的组成

2.1 HTML模板：HTML模板就是标准的静态HTML页面，在HTML模板中我们通过jwcid(Java Web Component ID)标签属性调用Tapestry组件。例如上例中的 <span jwcid="@Insert" value="ognl:HelloWorld" />

在上面的代码中，调用了Tapestry的官方组件Insert，value属性是Insert组件的参数之一。"@"符号用于区分jwcid是一个组件类型还是一个组件ID，如果是一个组件ID，tapestry将在HTML模板对应的页面规范中寻找对应该组件ID的组件调用配置。（亦可这样理解，"@"为官方组件，无"@"为自定义组件，自定义组件需要在“.page”文件中详细配置该组件的用法。）

2.2 页面规范：是以页面名称命名且后缀是.page的XML文件，这个后缀为.page的XML文件必须声明Tapestry的页面规范DOCTYPE。

例如在上例中：

<span jwcid="@Insert" value="ognl:HelloWorld" />

也可以这样来表示：

HTML模板：

 <span jwcid="@Insert" value="ognl:HelloWorld" />

页面规范：

<?xml version="1.0" encoding="GBK"?>

<!DOCTYPE page-specification PUBLIC

 "-//Apache Software Foundation//Tapestry Specification 4.0//EN"

 "http://jakarta.apache.org/tapestry/dtd/Tapestry_4_0.dtd">

<page-specification class="com.kevin.tapestry.Home">

    <component id="test" type="Insert">

        <binding name="value" value="HelloWorld" />

    </component>

</page-specification>

2.3 页面类：必须继承org.apache.tapestry.html.BasePage类，如：

package com.kevin.tapestry;

import org.apache.tapestry.html.BasePage;   

    public abstract class Home extends BasePage{

    public String getHelloWorld(){

        return "Hello World!";

    }

}

3. Tapestry组件的组成

　　在Tapestry中，一个组件通常由HTML模板，组件规范，组件类，动态脚本文件4个文件组成，除了组件规范以外，其他三个文件都不是必须的。

4. ognl

　　OGNL是 Object Graph Navigation Language 的简称，是一种绑定方式的表达式语言。

　　OGNL是OpenSymphony的一个开源项目。OGNL最重要的也是最根本的作用是简化调用Java类中的getter/setter方法，同时，他也是一种功能单一且易于使用的表达式语言，OGNL表达式就式该语言的全部。对于OGNL如何与模板对象绑定，Tapestry已经实现，我们不需要关心。同时，虽然OGNL表达式带有运算功能，但是Tapestry框架将页面逻辑全部放到了页面类中，因此根本没必要使用OGNL表达式来处理页面逻辑。

Tapestry框架的整个调用过程：Home.html -> Home.page -> Home.class

四、各种组件的使用（只列举了一些常用的，更多请参见TAPESTRY官方网站）

1、Foreach

source:是对应的java类里的List 对象或者是个数组需要抽象或者提供set get方法

value:是循环这个source对象代表当前的一个，需要在page文件中设置问一个属性，可以不在对应的java类里有这个属性

index:是循环的索引值同value一样在page文件中设置一个属性即可 <property name="index"/>

在循环的时候会自动为vlaue和index赋当前的值

<table cellspacing="6">

  <tr>

   <td>ID</td>

   <td> </td>

   <td>Name</td>

   <td> </td>

   <td>Level</td>

  </tr>

  <tr>

   <td colspan="5"><hr></td>

  </tr>

  <tr jwcid="@Foreach" source="ognl:customerList" value="ognl:customer" element="tr">

   <td><span jwcid="@Insert" value="ognl:customer.id"/></td>

   <td> </td>

   <td><span jwcid="@Insert" value="ognl:customer.fullName"/></td>

   <td> </td>

   <td><span jwcid="@Insert" value="ognl:customer.memberLevel"/></td>

  </tr>

</table>

<property-specification name="customerList" type="java.util.List" persistent="yes"/><property-specification name="customer" type="Customer"/>

public abstract class SalesPage extends BasePage {

    public abstract List getCustomerList();

    public abstract List setCustomerList(List value);

}

public class Customer implements Serializable {

    private Integer id;

    private String fullName;

    private String memberLevel;

    public Customer(Integer id， String fullName， String memberLevel) {

        this.id = id;

        this.fullName = fullName;

        this.memberLevel = memberLevel;

    }

    public Integer getId() { return id; }

    public String getFullName() { return fullName; }

    public String getMemberLevel() { return memberLevel; }

}

调用过程如下：source="ognl:customerList"==》getCustomerList()==》得到一LIST。

该LIST在FOREACH每次循环LIST中顺序取出一对象A（类型为ognl:customer），该对象A在FOREACH循环中它的属性被引用（调用：getId() ，getFullName（）， getMemberLevel() ）。

2、Hidden组件总是多余的处理

 <input jwcid="@Hidden" type="hidden" value="ognl:blahblah" encode="false"/>

　　用来存储一些页面的状态变量。

3、 Insert 组件

<input type="text" jwcid="name@Insert" value="ognl:user.name"/>

页面表现时，将会到页面类中寻找getUser().getName()方法获取初值并输出相当于在页面上显示数据.

4、 TextField 组件

<input type="text" jwcid="username@TextField" value="ognl:username"/>

　　页面表现时，将会到页面类中寻找getUsername()方法获取初值。

*如果是修改信息页面，通常初始值要在页面表现之前由setUsername()手动设置从数据库中读取出来的值表单提交时，通过setUsername()写入新值(即用户输入值)，在类中通过getUsername()获取新值相当于在修改个人信息时，首先读出用户名赋予文本框(用户名)初值，用户修改时填入新值，后台获取之后，*Hidden属性区分是普通文本输入框(默认false)和密码输入框(hidden="ognl:true")

　　readonly属性设置只读 readonly="true"为只读(后台可读取)

　　*disabled属性设置是否可写 diabled="true"为不可写(后台也不可读取)

6、 TextArea 组件

<textarea jwcid="content@TextArea" value="ognl:content" cols="40" rows="10"></textarea>

　　页面表现时，将会到页面类中寻找getContent()方法获取初值，工作原理同TextField。

7、 RadioGroup/Radio 组件

 <span jwcid="headImage@RadioGroup" selected="ognl:headImage">

      <input jwcid="@Radio" type="radio" value="1"/>头像1

      <input jwcid="@Radio" type="radio" value="2"/>头像2

      <input jwcid="@Radio" type="radio" value="3"/>头像3

      <input jwcid="@Radio" type="radio" value="4"/>头像4

      <input jwcid="@Radio" type="radio" value="5"/>头像5

      <input jwcid="@Radio" type="radio" value="6"/>头像6

    </span>

RadioGroup为每一个Radio提供一个唯一的ID。RadioGroup跟踪当前被选中的属性值，并且只有一个Radio能够被选中。

页面提交时，RadioGroup组件就利用OGNL表达式向headImage字段写入被选中的Radio组件的value参数值。

页面表现时(修改页面)，将会到页面类中寻找getHeadImage()方法获取初值，然后寻找@Radio组件中与其相同的组件并勾选上。

8、 PropertySelection 组件

　　使用PropertySelection组件必须要构造一个类来实现IPropertySelectionModel接口，并且重写该接口的5个方法。

　　public int getOptionCount() //提供下拉菜单的长度

    public Object getOption(int index) //提供select标签的option

    public String getLabel(int index) //提供select标签的Label值，也就是下拉菜单显示的内容

    public String getValue(int index) //提供select标签的value值

    public Object translatue(String value) //selected后的返回值，value值未必就是我们需要的返回值，可以在这个方法里面对返回的value做对应的转换或修改.

8.1属性下拉框

<select jwcid="gender@ProPertySelection" name="genderSelect" value="ognl:gender" model="supportedGender">

      <option selected>先生</option>

      <option>女士</option>

</select>

代码：GenderSelectionModel.java

public class GenderSelectionModel implements IPropertySelectionModel {

    public static final String male = "先生";

    public static final String female = "女士";

    public static final String[] genderOptions = { male， female };  

    public int getOptionCount() {

        return genderOptions.length;

    }  

    public Object getOption(int index) {

        return this.translatue(genderOptions[index]);

    }  

    public String getLabel(int index) {

        return genderOptions[index].toString();

    }  

    public String getValue(int index) {

        return genderOptions[index];

    }

    public Object translatue(String value) {

        if (value.equals("先生")) {

            return "1";

        } else {

            return "0";

        }

    }

}

代码：ModUserInfo.java

public IPropertySelectionModel getSupportedGender() {

    return new GenderSelectionModel();

}

　　存入数据库中"1"代表先生，"0"代表女士，通过translatue(String value)方法转换页面表现时，通过model属性给出的IPropertySelectionModel获取下拉选项，即getSupportedGender()。

　　然后通过getGender()方法获取初值，比如获取"0"，则在页面显示时寻找value值为"0"的选项即为"女士"，并选择之作为初始选择项。

8.2日志类型下拉框

<select jwcid="logType@PropertySelection" name="typeSelect" value="ognl:logType" model="supportedType">

      <option>心情日记</option>

      <option>情感天地</option>

      <option>生活感触</option>

</select>

代码：TypeSelectionModel.java

public class TypeSelectionModel implements IPropertySelectionModel {  

    private List typeList = new ArrayList();  

    public TypeSelectionModel(List typeList) {

        this.typeList = typeList;

    }  

    public int getOptionCount() {

        return typeList.size();

    }  

    public Object getOption(int index) {

        return ((LogType)typeList.get(index)).getValue();

    }  

    public String getLabel(int index) {

        return ((LogType) typeList.get(index)).getName();

    }  

    public String getValue(int index) {

        return ((LogType) typeList.get(index)).getValue();

    }  

    public Object translatue(String value) {

        return value;

    }

}

代码：ModLog.java

public IPropertySelectionModel getSupportedType() {  

    TypeSelectionModel typeSelectionModel = new TypeSelectionModel(loadType(getUser().getUserId()));

    return typeSelectionModel;

}  

private List loadType(int userid) {

    ...//从数据库载入该用户的日志类型列表

}

　　页面表现时，通过model属性给出的IPropertySelectionModel获取下拉选项，即getSupportedType()，然后通过value属性给出的初始值即，getLogType()方法获取初值，比如获取"2"，则在页面显示时寻找value值为"2"的选项即为"生活感触"，并选择之作为初始选择项。

9、 Form组件

 <form jwcid="logForm@Form">

      ...

    </form>

Form的监听(listener)方法可以有两种方式：

9.1. 在Form组件中声明

 <form jwcid="logForm@Form" listener="ognl:listener:onLogin">

          ...

        </form>

9.2. 在submit类型组件中声明

<input type="submit" jwcid="onLogin@Submit" listener="listener:onLogin" value="发表"/>

或者

<span jwcid="@ImageSubmit" image="..." listener="listener:onLogin"><img src="..." width="" height=""/></span>

　　前一种方式当Form中只要有submit就会触发监听方法，后一种方式是Form中有多个submit，各自实现不同的监听方法。

10、 Conditional 组件

 <span jwcid="@Conditional" condition='ognl:item.sex.equals("1")'>先生</span>

    <span jwcid="@Conditional" condition='ognl:item.sex.equals("0")'>女士</span>

conditional参数为true时运行Conditional组件中的HTML模板内容.

在Tapestry4.0以后就不支持该组件了，可以使用其他组件来实现:

10.1. Contrib:Choose和Contrib

When （contrib:外围爱好者根据需要自行编译并贡献的软件）

<library id="contrib" specification-

path="classpath:/org/apache/tapestry/contrib/Contrib.library"/>(.application文件中引入Contrib类包)

    <span jwcid="@contrib:Choose">

      <span jwcid="@contrib:When" condition='ognl:user.gender.equals("1")'>先生</span>

      <span jwcid="@contrib:When" condition='ognl:user.gender.equals("0")'>女士</span>

    </span>

10.2. If组件

<span jwcid="@If" condition='ognl:item.sex.equals("1")'>先生</span>

    <span jwcid="@If" condition='ognl:item.sex.equals("0")'>女士</span>

10.3. Else组件

  <span jwcid="@Else">man</span>

码农公寓