[轉(zhuǎn)]使用sitemesh建立復合視圖2.裝飾器

          裝飾器  decorator概念
          建立可復用的web應用程序,一個通用的方法是建立一個分層系統(tǒng),如同下面一個普通的web應用:
          • 前端,front-end:JSP和Servlets,或jakarta的velocity
          • 控制層框架 Controller : (Struts/Webwork)
          • 業(yè)務邏輯 Business :主要業(yè)務邏輯
          • 持久化框架 :hibernate/jdo

          可糟糕的是前端的頁面邏輯很難被復用,當你在每一個頁面中用數(shù)之不盡的include來復用公共的header, stylesheet, scripts,footer時,一個問題出現(xiàn)了-重復的代碼,每個頁面必須用copy來復用頁面結(jié)構(gòu),而當你需要創(chuàng)意性的改變頁面結(jié)構(gòu)時,災難就愛上了你。

          sitemesh通過filter截取request和response,并給原始的頁面加入一定的裝飾(可能為header,footer...),然后把結(jié)果返回給客戶端,并且被裝飾的原始頁面并不知道sitemesh的裝飾,這也就達到了脫耦的目的。

          據(jù)說即將新出臺的Portlet規(guī)范會幫助我們標準的實現(xiàn)比這些更多更cool的想法,但可憐的我還不懂它到底是一個什末東東,有興趣的人可以研究
          jetspeed,或JSR (Java Specification Request) 168,但我想sitemesh如此簡單,我們不妨先用著。

           

          讓我們看看怎樣配置環(huán)境
          除了要copy到WEB-INF/lib中的sitemesh.jar, copy到WEB-INF中的sitemesh-decorator.tld,sitemesh-page.tld文件外,還有2個文件要建立到WEB-INF/:
          • sitemesh.xml (可選)  
          • decorators.xml 

          sitemesh.xml 可以設(shè)置2種信息:

          Page Parsers :負責讀取stream的數(shù)據(jù)到一個Page對象中以被SiteMesh解析和操作。(不太常用,默認即可)

          Decorator Mappers : 不同的裝飾器種類,我發(fā)現(xiàn)2種比較有用都列在下面。一種通用的mapper,可以指定裝飾器的配置文件名,另一種可打印的裝飾器,可以允許你當用http://localhost/aaa/a.html?printable=true方式訪問時給出原始頁面以供打印(免得把header,footer等的花哨的圖片也搭上)

          (但一般不用建立它,默認設(shè)置足夠了: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 :定義構(gòu)成復合視圖的所有頁面構(gòu)件的描述(主要結(jié)構(gòu)頁面,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 : 匹配的路徑,可以用*,那些被訪問的頁面需要被裝飾。

           

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

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

          <%@ 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內(nèi)容插入到<title></title>中間。

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

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

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

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

           

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

          <decorator:head />

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

          <decorator:body />

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

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

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

          例:

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

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

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

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

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

          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"會在插入內(nèi)容前加入一個空格。

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

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

           

          <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>

          最后會是什末結(jié)果呢?除了/page.jsp會被默認的包裝頁面包裝上header,footer外,page.jsp頁面中還內(nèi)嵌了date.jsp頁面,并且此date.jsp頁面還會被panel.jsp包裝為一個title加body的有2段的頁面,第1段是date.jsp的title,第2段是date.jsp的body內(nèi)容。

          另外,page:applyDecorator中包含的page:param標簽所聲明的屬性值還可以在包裝頁面中用decorator:getProperty標簽訪問到。

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


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


          網(wǎng)站導航:
           
          <2007年9月>
          2627282930311
          2345678
          9101112131415
          16171819202122
          23242526272829
          30123456

          導航

          統(tǒng)計

          常用鏈接

          留言簿(6)

          隨筆檔案(57)

          友情鏈接

          搜索

          最新評論

          閱讀排行榜

          評論排行榜

          主站蜘蛛池模板: 嵊泗县| 伊川县| 伊宁市| 九台市| 易门县| 泽州县| 镇安县| 铜川市| 蓝田县| 类乌齐县| 都江堰市| 南阳市| 顺平县| 专栏| 宜章县| 长春市| 台北县| 镶黄旗| 荔波县| 乌兰察布市| 邵阳县| 霍林郭勒市| 延安市| 普兰店市| 剑阁县| 兴海县| 宁都县| 浦县| 拜城县| 海阳市| 贵港市| 兴宁市| 绥阳县| 永川市| 拜城县| 绵阳市| 井研县| 恩施市| 钟山县| 井冈山市| 灯塔市|