[轉]使用sitemesh建立復合視圖2.裝飾器

          裝飾器  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):

          范例:

          <sitemesh>
            <page-parsers>
              <parser default="true" class="com.opensymphony.module.sitemesh.parser.DefaultPageParser" />
              <parser content-type="text/html" class="com.opensymphony.module.sitemesh.parser.FastPageParser" />
              <parser content-type="text/html;charset=ISO-8859-1" class="com.opensymphony.module.sitemesh.parser.FastPageParser" />
            </page-parsers>

            <decorator-mappers>
              <mapper class="com.opensymphony.module.sitemesh.mapper.ConfigDecoratorMapper">
                <param name="config" value="/WEB-INF/decorators.xml" />
              </mapper>
                <mapper class="com.opensymphony.module.sitemesh.mapper.PrintableDecoratorMapper">
                   <param name="decorator" value="printable" />
                   <param name="parameter.name" value="printable" />
                           <param name="parameter.value" value="true" />
                </mapper>
            
          </decorator-mappers>
          </sitemesh>

          decorators.xml :定義構成復合視圖的所有頁面構件的描述(主要結構頁面,header,footer...),如下例:

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

           

          • defaultdir: 包含裝飾器頁面的目錄
          • page : 頁面文件名
          • name : 別名
          • role : 角色,用于安全
          • webapp : 可以另外指定此文件存放目錄
          • Patterns : 匹配的路徑,可以用*,那些被訪問的頁面需要被裝飾。

           

          最重要的是寫出裝飾器本身(也就是那些要復用頁面,和結構頁面)。
          其實,重要的工作就是制作裝飾器頁面本身(也就是包含結構和規則的頁面),然后把他們描述到decorators.xml中。

          讓我們來先看一看最簡單的用法:其實最常用也最簡單的用法就是我們的hello例子,面對如此眾多的技術,我想只要達到功能點到為止即可,沒必要去研究太深(除非您有更深的需求)。

          <%@ page contentType="text/html; charset=GBK"%>
                                  <%@ taglib uri="sitemesh-decorator" prefix="decorator" %>
                                  <html>
                                  <head>
                                  <title><decorator:title default="裝飾器頁面..." /></title>
                                  <decorator:head />
                                  </head>
                                  <body>
                                  sitemesh的例子<hr>
                                  <decorator:body />
                                  <hr>chen56@msn.com
                                  </body>
                                  </html>
                                  

          我們在裝飾器頁面只用了2個標簽:

          <decorator:title default="裝飾器頁面..." />    : 把請求的原始頁面的title內容插入到<title></title>中間。

          <decorator:body /> : 把請求的原始頁面的body內的全部內容插入到相應位置。

          然后我們在decorator.xml中加入以下描述即可:

          <decorator name="main" page="main.jsp">
              <pattern>*</pattern>
          </decorator>

          這樣,請求的所有頁面都會被重新處理,并按照main.jsp的格式重新展現在你面前。

           

          讓我們看看更多的用法。(抄襲sitemesh文檔)
          以下列著全部標簽:
          Decorator Tags Page Tags
          被用于建立裝飾器頁面. 被用于從原始內容頁面訪問裝飾器.
          <decorator:head />
          <decorator:body />
          <decorator:title />
          <decorator:getProperty />
          <decorator:usePage />
          <page:applyDecorator />
          <page:param
           

          <decorator:head />

          插入原始頁面(被包裝頁面)的head標簽中的內容(不包括head標簽本身)。

          <decorator:body />

          插入原始頁面(被包裝頁面)的body標簽中的內容。

          <decorator:title [ default="..." ] />

          插入原始頁面(被包裝頁面)的title標簽中的內容,還可以添加一個缺省值。

          例:

          /_decorator/main.jsp中 (裝飾器頁面): <title><decorator:title default="卻省title-hello"  /> - 附加標題</title>

          /aaa.jsp中 (原始頁面):<title>aaa頁面</title>

          訪問/aaa.jsp的結果:<title>aaa頁面 - 附加標題</title>

          <decorator:getProperty property="..." [ default="..." ] [ writeEntireProperty="..." ]/>

          在標簽處插入原始頁面(被包裝頁面)的原有的標簽的屬性中的內容,還可以添加一個缺省值。

          sitemesh文檔中的例子很好理解:
          The decorator: <body bgcolor="white"<decorator:getProperty property="body.onload" writeEntireProperty="true" />>
          The undecorated page: <body onload="document.someform.somefield.focus();">
          The decorated page: <body bgcolor="white" onload="document.someform.somefield.focus();">

          注意,writeEntireProperty="true"會在插入內容前加入一個空格。

          <decorator:usePage id="..." />
          象jsp頁面中的<jsp:useBean>標簽一樣,可以使用被包裝為一個Page對象的頁面。 (懶的用)

          例:可用<decorator:usePage id="page" /><%=page.getTitle()%>達到<decorator:title/>的訪問結果。

           

          <page:applyDecorator name="..." [ page="..." title="..." ] >
          <page:param name="..."> ... </page:param>
          <page:param name="..."> ... </page:param>
          </page:applyDecorator>

          應用包裝器到指定的頁面上,一般用于被包裝頁面中主動應用包裝器。這個標簽有點不好理解,我們來看一個例子:

          包裝器頁面 /_decorators/panel.jsp:<p><decorator:title /></p>  ... <p><decorator:body /></p>
            并且在decorators.xml中有<decorator name="panel" page="panel.jsp"/>

          一個公共頁面,即將被panel包裝:/_public/date.jsp:  
            ... <%=new java.util.Date()%>  ...<decorator:getProperty property="myEmail" />

          被包裝頁面 /page.jsp : 
            <title>page的應用</title> 
            .....  

            <page:applyDecorator name="panel" page="/_public/date.jsp" >
              <page:param name="myEmail"> chen_p@neusoft.com </page:param>
            </page:applyDecorator>

          最后會是什末結果呢?除了/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標簽訪問到。

          posted on 2007-09-17 20:42 hijackwust 閱讀(244) 評論(0)  編輯  收藏


          只有注冊用戶登錄后才能發表評論。


          網站導航:
           
          <2007年9月>
          2627282930311
          2345678
          9101112131415
          16171819202122
          23242526272829
          30123456

          導航

          統計

          常用鏈接

          留言簿(6)

          隨筆檔案(57)

          友情鏈接

          搜索

          最新評論

          閱讀排行榜

          評論排行榜

          主站蜘蛛池模板: 邳州市| 磴口县| 恭城| 苗栗县| 荣成市| 普兰县| 临沧市| 盈江县| 华池县| 德格县| 左贡县| 烟台市| 巴彦淖尔市| 黄龙县| 腾冲县| 滨海县| 陇南市| 烟台市| 黄浦区| 霍城县| 新干县| 榆中县| 榆树市| 鱼台县| 拜城县| 陈巴尔虎旗| 仁寿县| 阳山县| 广元市| 博乐市| 广河县| 东光县| 瓦房店市| 岳西县| 原阳县| 大余县| 如东县| 曲麻莱县| 海淀区| 香格里拉县| 册亨县|