使用sitemesh建立復合視圖 - 2.裝飾器 decorator
使用sitemesh建立復合視圖 - 1.hello
使用sitemesh建立復合視圖 - 2.裝飾器 <- now
使用sitemesh建立復合視圖 - 3.其它討論
裝飾器 decorator概念 建立可復用的web應用程序,一個通用的方法是建立一個分層系統，如同下面一個普通的web應用： 前端，front-end:JSP和Servlets，或jakarta的velocity 控制層框架 Controller ： (Struts/Webwork) 業務邏輯 Business ：主要業務邏輯
持久化框架 ：hibernate/jdo
可糟糕的是前端的頁面邏輯很難被復用，當你在每一個頁面中用數之不盡的include來復用公共的header, stylesheet, scripts，footer時，一個問題出現了-重復的代碼，每個頁面必須用copy來復用頁面結構，而當你需要創意性的改變頁面結構時，災難就愛上了你。
sitemesh通過filter截取request和response，並給原始的頁面加入一定的裝飾(可能為header,footer...)，然後把結果返回給客戶端，並且被裝飾的原始頁面並不知道sitemesh的裝飾，這也就達到了脫耦的目的。
據說即將新出台的Portlet規范會幫助我們標准的實現比這些更多更cool的想法，但可憐的我還不懂它到底是一個什末東東，有興趣的人可以研究jetspeed，或JSR (Java Specification Request) 168,但我想sitemesh如此簡單，我們不妨先用著。
讓我們看看怎樣配置環境 除了要copy到WEB-INF/lib中的sitemesh.jar, copy到WEB-INF中的sitemesh-decorator.tld,sitemesh-page.tld文件外，還有2個文件要建立到WEB-INF/： sitemesh.xml (可選) decorators.xml sitemesh.XML 可以設置2種信息:
Page Parsers ：負責讀取stream的數據到一個Page對象中以被SiteMesh解析和操作。(不太常用，默認即可)
Decorator Mappers : 不同的裝飾器種類，我發現2種比較有用都列在下面。一種通用的mapper,可以指定裝飾器的配置文件名，另一種可打印的裝飾器，可以允許你當用http://localhost/aaa/a.Html?printable=true方式訪問時給出原始頁面以供打印(免得把header,footer等的花哨的圖片也搭上)(但一般不用建立它，默認設置足夠了：com/opensymphony/module/sitemesh/factory/sitemesh-default.XML）：
范例：
decorators.XML ：定義構成復合視圖的所有頁面構件的描述(主要結構頁面，header,footer...)，如下例：
defaultdir: 包含裝飾器頁面的目錄 page : 頁面文件名 name : 別名 role : 角色，用於安全 webapp : 可以另外指定此文件存放目錄 Patterns : 匹配的路徑，可以用*,那些被訪問的頁面需要被裝飾。
最重要的是寫出裝飾器本身(也就是那些要復用頁面，和結構頁面)。 其實，重要的工作就是制作裝飾器頁面本身(也就是包含結構和規則的頁面)，然後把他們描述到decorators.XML中。
讓我們來先看一看最簡單的用法：其實最常用也最簡單的用法就是我們的hello例子，面對如此眾多的技術，我想只要達到功能點到為止即可，沒必要去研究太深(除非您有更深的需求)。
<%@ page contentType="text/Html; charset=GBK"%><%@ taglib uri="sitemesh-decorator" prefix="decorator" %>
我們在裝飾器頁面只用了2個標簽：
然後我們在decorator.XML中加入以下描述即可：
這樣，請求的所有頁面都會被重新處理，並按照main.JSP的格式重新展現在你面前。
讓我們看看更多的用法。(抄襲sitemesh文檔) 以下列著全部標簽： Decorator TagsPage Tags被用於建立裝飾器頁面.被用於從原始內容頁面訪問裝飾器.
插入原始頁面(被包裝頁面)的head標簽中的內容(不包括head標簽本身)。
插入原始頁面(被包裝頁面)的body標簽中的內容。
插入原始頁面(被包裝頁面)的title標簽中的內容，還可以添加一個缺省值。
例：
/_decorator/main.JSP中 （裝飾器頁面）:
/aaa.JSP中 (原始頁面)：
訪問/aaa.JSP的結果：
在標簽處插入原始頁面(被包裝頁面)的原有的標簽的屬性中的內容，還可以添加一個缺省值。
sitemesh文檔中的例子很好理解：The decorator: >The undecorated page: The decorated page:
注意，writeEntireProperty="true"會在插入內容前加入一個空格。
例：可用
應用包裝器到指定的頁面上，一般用於被包裝頁面中主動應用包裝器。這個標簽有點不好理解，我們來看一個例子：
包裝器頁面 /_decorators/panel.JSP：
最後會是什末結果呢？除了/page.jsp會被默認的包裝頁面包裝上header,footer外，page.jsp頁面中還內嵌了date.jsp頁面，並且此date.jsp頁面還會被panel.jsp包裝為一個title加body的有2段的頁面，第1段是date.JSp的title，第2段是date.JSP的body內容。
另外，page:applyDecorator中包含的page:param標簽所聲明的屬性值還可以在包裝頁面中用decorator:getProperty標簽訪問到。
