Tapestry 5 Training Course 中文学习笔记二

安装和配置
目标
    不使用XML
    尽量减少冗余
    最大限度的使用命名标准
    使用“系统”变量

Configuring the J2EE application
1.定义应用程序的根目录（root package）

            <context-param>
                <param-name>tapestry.app-package</param-name>
                <param-value>net.atos.mm.formation.tapestry</param-value>
            </context-param>

2. 定义Tapestry filter
     说明：filter-name也是应用程序名字

            <filter>
                <filter-name>app</filter-name>
                <filter-class>org.apache.tapestry.TapestryFilter</filter-class>
            </filter>

            <filter-mapping>
                <filter-name>app</filter-name>
                <url-pattern>/*</url-pattern>
            </filter-mapping>
目录结构
    目录结构推荐使用WTP项目结构
    两个资源目录
    "src/main/java" 目录存放所有应用程序的java文件 
    "src/main/resources"目录存放应用程序包含的所有资源文件（*.tml html 模板  内嵌资源文件等）
在web文档的根目录下放置一个static文件夹用来存放应用的所有纯静态文件。比如 css  js文件 图片等。
建立的根目录后加入如下子目录
“root.package”.pages 存放应用的所有页面（java文件 * .Tml  html 模板）
“root.package”.components 存放用户定义组件
“root.package”.mixins 存放一些能自定义行为（behaviours）的组件
“root.package”.base 存放一些不能直接使用的基础组件
“root.package”.data  convention, not mandatory(这里不太理解)
 “root.package”.services 存放用户服务
 在“root.package”.services中加入 AppModule来配置你的应用程序。
AppModule文件
    通过预先定义的方法可以转载和配置你的应用程序。
    可以装在第三方的组件类库
    “App”代表应用程序的名字，在我们定义 tapestry-filter的时候也使用这个名字
例如我们创建应用程序的目录结构如下："net.atos.mm.formation.tapestry" filter命名为TapestryApp 那么系统会默认寻找
"net.atos.mm.formation.tapestry.services.TapestryAppModule"这个配置文件
    << contributeApplicationDefaults >> 方法允许我们给些参数的调用
<< ApplicationDefaults >> 服务。例如：
       tapestry.start-page-name : 应用的默认页面

      tapestry.supported-locales : 用逗号分割的locales支持

      tapestry.file-check-interval : 文件系统修改检查的间隔时间
更多的详细信息查看
http://tapestry.apache.org/tapestry5/tapestry-core/guide/conf.html

tapestry的目录结构我们可以自己手工建立。也可以使用quickstart
http://tapestry.apache.org/tapestry5/quickstart/，利用maven可以很轻松的下载到tapestry的官方目录结构，省去很多麻烦。