Tapestry3 学习笔记(一) 配置文件介绍

1， 配置文件的简单介绍
       总体说来，Tapestry项目中，有6种配置文件：web.xml文件，application文件，library文件，Engine文件（对象），Global文件（对象）和Visit文件（对象）。

这6种中，只有web.xml文件和application文件是必须。
      在Tapestry框架中，每一个页面被分割为三个部分：html模板，page规范和页面java文件。

1） web.xml文件
      每一个web项目都有一个web.xml文件，Tapestry项目的web.xml文件，其实并没有太特别之处：

    MyTapestry
    
        redirect
        org.apache.tapestry.RedirectFilter
    
    
        MyTapestry
        org.apache.tapestry.ApplicationServlet
        1
    
    
        MyTapestry
        /app
    

这些都是固定的配置，如果希望对session有效时间进行设置，可以添加：
    
        60
    

2） application文件
      application文件是指以项目名称为文件名，以application为后缀的文件，例如：MyTapestry.application。
      application文件放在WEB-INF目录下，该文件定义了整个Tapestry项目的所有文件映射。
      例如在MyTapestry.application文件中：

    
    
    
    com.tapestry.Visit
    com.tapestry.Global
    

        我们实现了如下功能：

第一， application文件定义了Engine对象的映射路径：
    
第二， application文件定义了模板编码和输出编码：
    
    
第三， application文件定义了Visit对象和Global对象的映射路径：
    com.tapestry.Visit
    com.tapestry.Global
第四， application文件定义了页面html模板与page规范之间的映射路径：
    
    
    
第五， application文件定义了组件jwc模板与page规范之间的映射路径：
    
第六， application文件定义了组件包的调用路径：
    

3） Engine文件（对象）
       Engine对象，是指继承于BaseEngine.java的文件。Engine对象是Tapestry的底层对象，是Tapestry框架的核心部分。
4） Global文件（对象）
       Global对象是指在application文件中声明的java文件，Global对象实际上就是普通web应用程序中的application对象。
5） Visit文件（对象）
       Visit对象是指在application文件中声明的java文件，通常实现序列化接口。Visit对象实际上就是普通web应用程序中的session对象。

6） library文件
       library文件很像application文件，用于定义自定义组件的jwc模板到page文件之间的映射。这种映射关系也可以定义在application文件中。如果希望将自己开发的组件打包，那么就会用到以library为后缀的文件。
7） html模板（jwc模板）
       html模板与jwc模板实际上是一样的，均是HTML静态页面，相比于普通的静态HTML页面，仅仅是在Tapestry的html模板和jwc模板中嵌入了一个jwcid属性。因此，Tapestry对美工的干涉非常小。html模板是指页面的静态HTML页面，而jwc是指组件的静态HTML页面。
8） page规范
       page规范是一个XML文件，page文件是html模板与页面（组件）java文件的纽带。对于组件使用的各种参数声明，我们可以放在html模板中，也可以放在page规范中。

9） 页面java文件（组件java文件）
       页面java文件继承于BasePage类，而组件java文件继承于BaseComponent类。页面（组件）java文件均是abstract类。在Tapestry应用程序实际运行时，Tapestry会自动提供一个supclass继承于这个页面（组件）java文件来实现其中页面（组件）逻辑。