Sitemesh 進階教學 (二)：裝飾器配置與多重裝飾技巧

裝飾器在分層架構中的定位

典型 Web 分層：前端 (JSP/Velocity) → 控制層 → 業務層 → 持久層。前端頁面邏輯難以複用，Sitemesh 透過 Filter 在輸出端統一裝飾，達成解耦。

環境配置補充

除 sitemesh.jar、兩個 .tld 外，WEB-INF 可選放置：

• sitemesh.xml：配置 Page Parsers 與 Decorator Mappers（通常用預設值即可）。
• decorators.xml：核心映射配置。

sitemesh.xml 範例

<sitemesh>
  <page-parsers>
    <parser class="com.opensymphony.module.sitemesh.parser.DefaultPageParser" default="true"/>
    <parser class="com.opensymphony.module.sitemesh.parser.FastPageParser" content-type="text/html"/>
  </page-parsers>
  <decorator-mappers>
    <mapper class="com.opensymphony.module.sitemesh.mapper.ConfigDecoratorMapper"/>
    <mapper class="com.opensymphony.module.sitemesh.mapper.PrintableDecoratorMapper"/>
  </decorator-mappers>
</sitemesh>

PrintableDecoratorMapper 支援 ?printable=true 參數輸出無裝飾原始頁面，方便列印。

decorators.xml 完整屬性

<decorators defaultdir="/_decorators">
  <decorator name="main" page="main.jsp">
    <pattern>*</pattern>
  </decorator>
  <decorator role="customer" name="printable" page="printable.jsp" webapp="otherApp">
    <pattern>/reports/*</pattern>
  </decorator>
</decorators>

• defaultdir：裝飾器頁面根目錄
• role：角色型安全控制
• webapp：跨應用引用裝飾器
• pattern：URL 匹配模式 (Ant 風格)

裝飾器標籤完整參考

頁面主動套用裝飾器：<page:applyDecorator>

在內容頁面主動指定裝飾器，實現區塊級嵌套裝飾。

範例：面板元件

裝飾器 _decorators/panel.jsp：

<%@ taglib uri="sitemesh-decorator" prefix="decorator" %>
<div class="panel">
  <h3><decorator:title/></h3>
  <div class="body"><decorator:body/></div>
</div>

被嵌入頁面 _public/date.jsp：

<%= new java.util.Date() %>

主內容頁 page.jsp：

<%@ taglib uri="sitemesh-page" prefix="page" %>
...
<page:applyDecorator name="panel" page="/_public/date.jsp">
  <page:param name="myEmail" value="chen_p@neusoft.com"/>
</page:applyDecorator>

結果：page.jsp 先被全域裝飾器包裝，內部 date.jsp 又被 panel.jsp 二次裝飾，並可在 panel.jsp 中透過 <decorator:getProperty property="myEmail"/> 取得參數。

最佳實踐建議

• 優先使用全域 ConfigDecoratorMapper + decorators.xml 統一管理。
• 區塊級裝飾僅用於可複用 UI 元件（面板、表格、表單區塊）。
• 善用 PrintableDecoratorMapper 提供列印友善版本。