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的官方目錄結構，省去很多麻煩。