BlogJava-刘文涛-随笔分类-SiteMesh 2.2.1http://www.blogjava.net/liuwentao253/category/14247.htmlI am a coderzh-cnThu, 01 Mar 2007 14:22:34 GMTThu, 01 Mar 2007 14:22:34 GMT60decorator:getProperty 用法http://www.blogjava.net/liuwentao253/archive/2007/02/28/101130.html刘文涛刘文涛Wed, 28 Feb 2007 05:52:00 GMThttp://www.blogjava.net/liuwentao253/archive/2007/02/28/101130.html
<meta name="menu" content="AdminMenu"/>

<content tag="heading"><fmt:message key="activeUsers.heading"/></content>

<body id="activeUsers"/>

<body class="main"/>


都可以被default.jsp引到 ：

<decorator:getProperty property="meta.menu"/>

<decorator:getProperty property="page.heading"/>

<decorator:getProperty property="body.id" writeEntireProperty="true"/>

<decorator:getProperty property="body.class" writeEntireProperty="true"/>


刘文涛 2007-02-28 13:52 发表评论
]]>sitemesh 在appfuse中的应用http://www.blogjava.net/liuwentao253/archive/2007/02/01/97325.html刘文涛刘文涛Thu, 01 Feb 2007 09:16:00 GMThttp://www.blogjava.net/liuwentao253/archive/2007/02/01/97325.htmlappfuse的页面是通过sitemesh模板做的。在web.xml里的相关配置：

     < filter >
         < filter - name > sitemesh </ filter - name >
         < filter - class > com.opensymphony.module.sitemesh.filter.PageFilter </ filter - class >
     </ filter >
     < filter - mapping >
         < filter - name > sitemesh </ filter - name >
         < url - pattern > /* </url-pattern>
        <!--dispatcher>REQUEST</dispatcher>
        <dispatcher>FORWARD</dispatcher-->
    </filter-mapping>

    然后它自己有一个配置文件。sitemesh.xml内容如下：

< sitemesh >
     < property name = " decorators-file "  value = " /WEB-INF/decorators.xml " />
     < excludes file = " ${decorators-file} " />  

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

     < decorator - mappers >
        < mapper  class = " com.opensymphony.module.sitemesh.mapper.ConfigDecoratorMapper " >
       < param name = " config "  value = " ${decorators-file} " />  
        </ mapper >
     </ decorator - mappers >
  </ sitemesh >

还有一个配置文件，decorators.xml，内容如下：

< decorators defaultdir = " /decorators " >
     < excludes >
         < pattern >/ demos /* </pattern>
            <pattern>/resources/*</pattern>
    </excludes> 
    <decorator name="default" page="default.jsp">
        <pattern>/*</pattern>
    </decorator>
</decorators>

表示不装饰 /demos 和 /resources下的页面。装饰器的模板为default.jsp。而且此模板网页在文件夹/decorators下。 然后打开 default.jsp.我们会看到有以下几个标签：
 
1 : <decorator:title/> :
导入要装饰的原始页面的title内容 然后是一些导入css和javascript的代码。

2 : <decorator:head />
导入原始页面(被包装页面)的head标签中的内容。

3 : <decorator:getProperty property="body.id" writeEntireProperty="true"/>
在标签处插入原始页面(被包装页面)的原有的标签的属性中的内容



刘文涛 2007-02-01 17:16 发表评论
]]>SiteMesh - 激赏！http://www.blogjava.net/liuwentao253/archive/2006/09/09/68679.html刘文涛刘文涛Sat, 09 Sep 2006 03:01:00 GMThttp://www.blogjava.net/liuwentao253/archive/2006/09/09/68679.html视图模板，我一直用tiles,作为struts插件使用。今天实践了一回SiteMesh,其设计上的灵光让人赞叹不已，记得上回这么激动还是接触spring时吧。tiles好象从“美“的角度就差了一些，www.jboss.org 就是采用了它。

简介：SiteMesh ,出自Opensymphony，和大名鼎鼎的

1 Webwork
 2 OsCaceh
 3 OsWorkflow

同门， 它的思想是Decorator模式，使用servlet2.3的Flitler，截取request和response, 把页面组件

1 head
 2 content
 3 banner

等结合为一个完整的视图。和当下正火的Ioc暗合，即页面不需要知道怎样被装饰，交由容器负责。



以下是几个常用的标签：

1 ：<decorator:title default="default title" />：
      读取被装饰页面的标题，并给出了默认标题。

2 ：<decorator:head />：
      读取被装饰页面的<head>中的内容；

3 ：<decorator:body />：
      读取被装饰页面的<body>中的内容；

4 ：

< page:applyDecorator  page ="/menu.jsp"  name ="panel"   >
     < page:param  name ="myEmail" >  chagezw@hotmail.com  </ page:param >
< page:applyDecorator >  

把menu.jsp文件用panel指定的装饰器装饰，并把结果插入到该位置,并设置一个页参数, 该属性值可以在包装页面中用 <decorator:getProperty property=="myEmail"> 标签访问到 .tiles的大部分功能这一个标签就可以作到了。

  重要的工作就是制作装饰器页面本身(也就是包含结构和规则的页面)，然后把他们描述到decorators.xml中.



刘文涛 2006-09-09 11:01 发表评论
]]>sitemesh技术的应用http://www.blogjava.net/liuwentao253/archive/2006/09/08/68447.html刘文涛刘文涛Fri, 08 Sep 2006 02:21:00 GMThttp://www.blogjava.net/liuwentao253/archive/2006/09/08/68447.html一，基本概念

1，Sitemesh是一种页面装饰技术 ：

1  ：它通过过滤器(filter)来拦截页面访问
 2  ：根据被访问页面的URL找到合适的装饰模板
 3  ：提取被访问页面的内容，放到装饰模板中合适的位置
 4  ：最终将装饰后的页面发送给客户端。

2，在sitemesh中，页面分为两种：装饰模板和普通页面。
1）装饰模板，是指用于修饰其它页面的页面。
2）普通页面，一般指各种应用页面。
3，接下来，我们通过一个简单的例子来说明一下sitemesh修饰网页的基本原理。

二，模板修饰网页的原理







通过Sitemesh的注册机制，告诉Sitemesh，当访问该路径时使用XXX模板（假定使用前面那个模板）来修饰被访问页面。



当用户在左边导航栏点击“戏说长城”（ /ShowGreatWall.do）时，右边的“戏说长城”页面将会被指定的模板修饰



总结上面过程，Sitemesh修饰网页的基本原理，可以通过下面来说明：



三，Sitemesh的配置与使用

1）WEB-INF/web.xml中加入filter定义与sitemesh的taglib定义

     <filter>
          <filter-name>sitemesh</filter-name>
          <filter-class>com.opensymphony.module.sitemesh.filter.PageFilter</filter-class>
     </filter>
     <filter-mapping>
          <filter-name>sitemesh</filter-name>
          <url-pattern>/*</url-pattern>
     </filter-mapping>

     <taglib>
          <taglib-uri>sitemesh-decorator</taglib-uri>
          <taglib-location>/WEB-INF/sitemesh-decorator.tld</taglib-location>
     </taglib>
     <taglib>
          <taglib-uri>sitemesh-page</taglib-uri>
          <taglib-location>/WEB-INF/sitemesh-page.tld</taglib-location>
     </taglib> 

2）创建WEB-INF/decorators.xml，在该文件中配置有哪些模板，以及每个模板具体修饰哪些URL，另外也可以配置哪些URL不需要模板控制 , decorators.xml的一个例子如下：

<excludes>
<pattern>/Login*</pattern>
</excludes>

<decorators defaultdir="/decorators">
    <decorator name="main" page=“DecoratorMainPage.jsp">
        <pattern>/*</pattern> 
    </decorator>

    <decorator name=“pop" page=“PopPage.jsp">
        <pattern>/showinfo.jsp*</pattern>
        <pattern>
              /myModule/GreatWallDetailAction.do*
        </pattern>
    </decorator>
</decorators>

3）我们看一个修饰模板的例子

<%@page contentType="text/html;?charset=GBK"%>
<%@taglib uri="sitemesh-decorator"?prefix="decorator" %>

<html>
    <head>
         <title> <decorator:title/> </title>
         <decorator:head/>
    </head>

    <body>
        Hello World  <hr/>
        <decorator:body/>
    </body>
</html> 

4）我们看一个被修饰的页面的例子：

<%@ page contentType="text/html;?charset=GBK"%>
<html>
    <head>
        <title>Hello World</title>
    </head>

    <body>
        <p>Decorated page goes here.</p
    </body>
</html> 

5）我们看一下装饰模板中可以使用的Sitemesh标签 

<decorator:head />

 取出被装饰页面的head标签中的内容。

<decorator:body />

取出被装饰页面的body标签中的内容。

<decorator:title default=""  />

取出被装饰页面的title标签中的内容。default为默认值

<decorator:getProperty property="" default=""  writeEntireProperty=""/>

取出被装饰页面相关标签的属性值。

writeEntireProperty表明，是显示属性的值还是显示“属性=值”

Html标签的属性
Body标签的属性
Meta标签的属性

注意如果其content值中包含“>或<”会报错，需转码，例如&lt;等等

default是默认值

<decorator:usePage id="" />

 将被装饰页面构造为一个对象，可以在装饰页面的JSP中直接引用。

6）看一个在装饰模板中使用标签的例子

<html lang=“ <decorator:getProperty property=‘lang’/> ”>
    <head>
        <title> <decorator:title default=“你好” /> </title>
        <decorator:head />
    </head>
    
    <body <decorator:getProperty property=“body.onload" writeEntireProperty=“1"/> >
         从meta中获取变量company的名称：
             <decorator:getProperty property=“meta.company”/>

            下面是被修饰页面的body中的内容：
             <decorator:body />

         <decorator:usePage id=“myPage" />

         <%=myPage.getRequest().getAttribute(“username”)%>
    </body>
</html>

7）看一下相应的在被修饰页面中的代码：

<html lang=“en”>
    <head>
        <title>我的sitemesh</title>
        <meta name=“company” content=“smartdot”/>
        <meta name=“Author” content=“zhangsan”/>
        <script>
             function count(){return 10;}
        </script>
    </head>

    <body onload=“count()”>
         <p>这是一个被修饰页面</p>
    </body>
</html>

四，总结

1，Sitemesh最为重要的就是做用于修饰的模板，并在decorators.xml中配置这些模板用于修饰哪些页面。因此使用Sitemesh的主要过程就是：做装饰模板，然后在decorators.xml中配置URL Pattern

2，分析整个工程，看哪些页面需要抽象成模板，例如二级页面、三级页面、弹出窗口等等可能都需要做成相应的模板，一般来说，一个大型的OA系统，模板不会超过8个。



刘文涛 2006-09-08 10:21 发表评论
]]>SiteMesh介绍http://www.blogjava.net/liuwentao253/archive/2006/09/08/68420.html刘文涛刘文涛Fri, 08 Sep 2006 00:50:00 GMThttp://www.blogjava.net/liuwentao253/archive/2006/09/08/68420.html阅读全文

刘文涛 2006-09-08 08:50 发表评论
]]>readAppfuse-4-Sitemesh使用http://www.blogjava.net/liuwentao253/archive/2006/09/07/68323.html刘文涛刘文涛Thu, 07 Sep 2006 09:14:00 GMThttp://www.blogjava.net/liuwentao253/archive/2006/09/07/68323.html一 ： 作用：sitemesh应用Decorator模式，用filter截取request和response,把页面组件

1 head
 2 content
 3 banner

结合为一个完整的视图。


二 ： appfuse的使用：

（1）在WEB-INF/web.xml中的过滤器的定义

1 < filter >
2      < filter - name > sitemesh </ filter - name >
3      < filter - class >
4         com.opensymphony.module.sitemesh.filter.PageFilter
 5      </ filter - class >
6 </ filter >

1 < filter - mapping >
2      < filter - name > sitemesh </ filter - name >
3      < url - pattern > /* </url-pattern>
 4
5     <dispatcher>REQUEST</dispatcher>
 6     <dispatcher>FORWARD</dispatcher>
 7  </filter-mapping>


（2）common/taglibs.jsp中的标签申明，只是命名说明，具体调用时，应用会在WEB-INF/lib中的对应的sitemesh-x.x.jar中定位。

1 <% @ taglib uri = " http://www.opensymphony.com/sitemesh/decorator "  prefix = " decorator " %>
2 <% @ taglib uri = " http://www.opensymphony.com/sitemesh/page "  prefix = " page " %>


（3）WEB-INF/sitemesh.xml文件（可选），进行sitemesh配置

 1 < sitemesh >
 2      < property name = " decorators-file "  value = " /WEB-INF/decorators.xml " />
 3      < excludes file = " ${decorators-file} " />  
  4      < page - parsers >
 5          < parser  default = " true "   class = " com.opensymphony.module.sitemesh.parser.HTMLPageParser " />
 6          < parser content - type = " text/html "   class = " com.opensymphony.module.sitemesh.parser.HTMLPageParser " />
 7          < parser content - type = " text/html;charset=ISO-8859-1 "   class = " com.opensymphony.module.sitemesh.parser.HTMLPageParser " />
 8      </ page - parsers >
 9
10      < decorator - mappers >
11          < mapper  class = " com.opensymphony.module.sitemesh.mapper.ConfigDecoratorMapper " >
12              < param name = " config "  value = " ${decorators-file} " />  
 13          </ mapper >
14      </ decorator - mappers >
15 </ sitemesh >

（4）WEB-INF/decorators.xml文件，指定具体的装饰页。

< decorators defaultdir = " /decorators " >
     < excludes >
         < pattern >/ resources /* </pattern>
    </excludes> 
    <decorator name="default" page="default.jsp">
        <pattern>/*</pattern>
    </decorator>
</decorators>


（5）装饰页/decorators/default.jsp的主要内容。

<! DOCTYPE html PUBLIC  " -//W3C//DTD XHTML 1.0 Transitional//EN "
     " http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd " >

<% @ include file = " /common/taglibs.jsp " %>
< html xmlns = " http://www.w3.org/1999/xhtml "  xml:lang = " en " >
     < head >
         <% @ include file = " /common/meta.jsp "   %>

         < title >< decorator:title />   |   < fmt:message key = " webapp.name " /></ title >

         < link rel = " stylesheet "  type = " text/css "  media = " all "  href = " <c:url value='/styles/${appConfig[ " theme " ]}/theme.css'/> "   />
         < link rel = " stylesheet "  type = " text/css "  media = " print "  href = " <c:url value='/styles/${appConfig[ " theme " ]}/print.css'/> "   />

         < script type = " text/javascript "  src = " <c:url value='/scripts/prototype.js'/> " ></ script >
         < script type = " text/javascript "  src = " <c:url value='/scripts/scriptaculous.js'/> " ></ script >
         < script type = " text/javascript "  src = " <c:url value='/scripts/global.js'/> " ></ script >
         < decorator:head />
     </ head >
< body < decorator:getProperty property = " body.id "  writeEntireProperty = " true " />< decorator:getProperty property = " body.class "  writeEntireProperty = " true " />>

     < div id = " page " >
         < div id = " header "   class = " clearfix " >
             < jsp:include page = " /common/header.jsp " />
         </ div >

         < div id = " content "   class = " clearfix " >
             < div id = " main " >
                 <% @ include file = " /common/messages.jsp "   %>
                 < h1 >< decorator:getProperty property = " page.heading " /></ h1 >
                 < decorator:body />
             </ div >

             < c:set var = " currentMenu "  scope = " request " >< decorator:getProperty property = " meta.menu " /></ c:set >
             < c: if  test = " ${currentMenu == 'AdminMenu'} " >
             < div id = " sub " >
                 < menu:useMenuDisplayer name = " Velocity "  config = " WEB-INF/classes/cssVerticalMenu.vm "  permissions = " rolesAdapter " >
                     < menu:displayMenu name = " AdminMenu " />
                 </ menu:useMenuDisplayer >
             </ div >
             </ c: if >

             < div id = " nav " >
                 < div  class = " wrapper " >
                     < h2  class = " accessibility " > Navigation </ h2 >
                     < jsp:include page = " /WEB-INF/pages/menu.jsp " />
                 </ div >
                 < hr  />
             </ div ><!--  end nav  -->
         </ div >

         < div id = " footer "   class = " clearfix " >
             < jsp:include page = " /common/footer.jsp " />
         </ div >
     </ div >
</ body >
</ html >


刘文涛 2006-09-07 17:14 发表评论
]]>AppFuse中的SiteMesh问题 http://www.blogjava.net/liuwentao253/archive/2006/08/18/64404.html刘文涛刘文涛Fri, 18 Aug 2006 09:13:00 GMThttp://www.blogjava.net/liuwentao253/archive/2006/08/18/64404.html       因为AppFuse中使用的默认的JSP模板为SiteMesh，默认情况下，所有的请求都会被SiteMesh所装饰，所以我要实现点击文件链接，直接下载文件时却得不到正确格式的文件，得到的是一个html文件，即使制定了下载文件的类型：如：application/msexcel或者其他的类型都不行，我分析是因为，我首先向输出流中写了些东西，后来被SiteMesh使用getWriter方法给冲掉了，所以得到的是默认的网页文件，我折腾了2天，痛不欲生，刚刚解决掉这个问题，解决方法如下：

1.将下载文件的jsp放到一个特殊的目录下，我的放在download目录，这样可以区分需要被sitemesh装饰和不需要被它装饰的文件。

2.配置sitemesh的decorators.xml:

1<decorators defaultdir="/decorators">
2    <excludes>
3        <pattern>/download/*</pattern>
4    </excludes> 
5</decorators>


这个配置指明download下的文件不需要被sitemesh装饰。


我的下载文件的页面代码是试验代码，稍加修改就可以正式使用，代码如下：
 1<%@ page import= "java.io.*,java.net.*" %>
 2<%
 3    try{
 4        //取得虚拟的路径
 5        String fn = "attachment; filename=a.xls";  //必须改为UniCode编码的字符串
 6        System.out.println(fn);
 7        //把标题、内容写到输出流中
 8        response.setHeader("Content-Disposition", new String(fn.getBytes("GB2312"),
 9                                        "ISO-8859-1"));
10        createOutput( response.getOutputStream(),"c:\\ltf.xls");
11    }catch( Exception ee ){
12        ee.printStackTrace();
13    }
14%>
15<%!
16public void createOutput( OutputStream out,String realpath ) throws IOException {
17    int b;
18    BufferedInputStream  m_input =
19                new BufferedInputStream( new  FileInputStream(realpath) );
20    while( (b = m_input.read()) != -1 ){
21        out.write(b);
22    }
23    m_input.close();
24    out.flush();
25    out.close();
26}
27%>
28<%--
29  // 得到文件名字和路径
30  String filename = request.getParameter("zipfilename");
31  //String jsppath = "";             getServletConfig().getServletContext().getRealPath("") + 
32   String filepath = "c:\\ltf.xls";        //jsppath.substring(0,jsppath.lastIndexOf("")) + "reports\\";
33  System.out.println("---------------=================" + filepath);
34  java.io.FileInputStream fileInputStream = null;
35  //out.println(filepath);
36  // 设置响应头和下载保存的文件名
37  response.setHeader("Content-Disposition",
38  "attachment; filename=" + "a.xls");
39  response.setContentType("application/msexcel");
40 
41  // 打开指定文件的流信息
42  try{
43  fileInputStream =
44   new java.io.FileInputStream(filepath);
45  
46  // 写出流信息
47  int i;
48  while ((i=fileInputStream.read()) != -1) {
49   out.write(i);
50  }
51  fileInputStream.close();
52  out.close();
53  System.out.println("---OK---------------");
54  
55  }catch(Exception ee){
56    ee.printStackTrace();
57  }
58--%>


刘文涛 2006-08-18 17:13 发表评论
]]>使用SiteMesh简化网页布局 http://www.blogjava.net/liuwentao253/archive/2006/08/18/64356.html刘文涛刘文涛Fri, 18 Aug 2006 07:16:00 GMThttp://www.blogjava.net/liuwentao253/archive/2006/08/18/64356.html在公司项目使用了 Appfuse ，其带有 SiteMesh 对于网页布局简化让我感觉很好用，本文旨在对对 Sitemesh 的基本原理和在项目中使用 Sitemesh 的实现流程、使用技巧的介绍。

1.   基本原理
SiteMesh 是以 Servlet 2.3 API 为基础(没记错的话tomcat支持最新版本servlet2.5)。
它包含一个引擎，用来解析输出的网页或者网页片段，决定是否需要应用装饰器以及合并合适的装饰器。

       SiteMesh 与应用内容无关，适用的内容格式包括 :

1 Html 
 2 JSP
 3 Servlet
 4 XSL
 5 甚至 CGI 

2.   实现流程
1）  当为 Servlet 容器指定一个 Http 请求时， SiteMesh 截取请求，使用一个 Servlet Filter ，然后捕捉 Html 结果。

2）  然后这个 Html 被解析，并且任何相关的内容都被提取到一个 Page 对象中。

3）  询问 DecoratorMapper 来确定那一个装饰器需要被应用。

4）  Servlet 向包含装饰器的 JSP 发送请求。

5 ）装饰器生成带有从 page 对象中获得的内容的 Html 布局。

大致流程如下图：



 Sitemesh 这样的好处是: 

1 所有具体业务页面的开发者无需考虑该页面将处在最终输出页面的那个位置。
 2 无需 include 一大堆页面，
 3 以后如果系统整体改版，那么只需要改写装饰器页面及重新配置装饰规则即可完成
 4 方便快捷，可维护性极好。


3.   在项目中使用 Sitemesh
1.         将 sitemesh_[version].jar 包加到 WEB-INF\lib 下

2.         在 web.xml 中增加

 1 < filter >   
  2      < filter - name >  sitemesh  </ filter - name >   
  3      < filter - class >  com.opensymphony.module.sitemesh.filter.PageFilter  </ filter - class >   
  4   </ filter >   
  5
 6
 7 < filter - mapping >   
  8      < filter - name >  sitemesh  </ filter - name >   
  9      < url - pattern >   /*  </url-pattern>  
 10 </filter-mapping>  

      
表示对系统中所有 url 请求均使用 sitemesh Filter 进行拦截。

3.  在 WEB-INF 下配置 sitemesh.xml 和 decorator.xml 配置文件。

Sitemesh.xml

 1 < sitemesh >   
  2      < property  name  = " decorators-file "   value  = " /WEB-INF/decorators.xml "   />   
  3      < excludes  file  = " ${decorators-file} "   />   
  4
 5      < page - parsers >   
  6          < parser   default = " true " class ="com.opensymphony.module.sitemesh.parser.HTMLPageParser" />  
 7        <parser  content-type ="text/html" 
 8                    class ="com.opensymphony.module.sitemesh.parser.HTMLPageParser"/>  
 9        <parser  content-type ="text/html;charset=ISO-8859-1"  
10                    class ="com.opensymphony.module.sitemesh.parser.HTMLPageParser"/>  
11    </page-parsers>  
12
13    <decorator-mappers>  
14        <!--  for print  -->  
15        <mapper  class ="com.opensymphony.module.sitemesh.mapper.PrintableDecoratorMapper">  
16                  <param  name ="decorator"  value ="printable"/>  
17                 <param  name ="parameter.name"  value ="printable"/>  
18                 <param  name ="parameter.value"  value ="true"/>  
19        </mapper>  
20        <mapper  class ="com.opensymphony.module.sitemesh.mapper.ConfigDecoratorMapper">  
21                 <param  name ="config"  value ="${decorators-file}" />  
22        </mapper>  
23    </decorator-mappers>  
24
25</sitemesh>  

 在 sitemesh.xml 中配置了两个 DecoratorMapper ：

1 PrintableDecoratorMapper
 2 ConfigDecoratorMapper 

PrintableDecoratorMapper 是供打印专用，在 url 后加上 printable=true 即会使用 decorator.xml 中指定的 printable 装饰器来对页面进行装饰，一般来说打印页面是只需要打印本页面的内容，其余的如头、脚、导航栏、左右菜单等是不需要打印的，通过装饰器可以轻松实现打印页面的过滤。


Decorator.xml

 1 < decorators  defaultdir  = " /decorators " >  
  2      < excludes >  
  3          < pattern >/ demos /*  </pattern> 
  4         <pattern>/resources/* </pattern> 
  5         <pattern>/test* </pattern> 
  6         <pattern>/FCKeditor/* </pattern> 
  7     </excludes> 
  8
 9     <!--  decorator for print(has parameter: printable=true) --> 
 10     <decorator  name ="printable"  page ="decPrintable.jsp" /> 
 11
12     <decorator  name ="login"  page ="decLogin.jsp"> 
 13         <pattern>*login* </pattern> <! —url 映射模式 --> 
 14     </decorator> 
 15
16     <decorator  name ="default"  page ="decDefault.jsp"> 
 17         <pattern>/* </pattern>  <! — 缺省的装饰器 --> 
 18     </decorator> 
 19
20 </decorators> 


4.  创建一个装饰器 JSP 页面，我建议所有装饰器页面放到 decorators 目录，并且以 dec[ 功能 ].jsp 作为命名方式，如 

1 decPrintable.jsp
 2 decDefault.jsp 

下面是一个装饰器的代码：

 1   <!  DOCTYPE html PUBLIC   "  -//W3C//DTD XHTML 1.0 Transitional//EN  "  
  2       "  http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd  " >  
  3         
  4   <%--   Include common set of tag library declarations   for   each layout   --%>  
  5   <%  @ include file  =   "  /common/taglibs.jsp  "   %>  
  6  
  7   < html xmlns  =   "  http://www.w3.org/1999/xhtml  "   xml:lang  =   "  en  " >  
  8       < head >
 9           < decorator:head />  
 10       </ head >  
 11   < body
 12   < decorator:getProperty property  =   "  body.id  "   writeEntireProperty  =   "  true  " />  
 13   < decorator:getProperty property  =   "  body.onload  "   writeEntireProperty  =   "  true  " />  
 14   < decorator:getProperty property  =   "  body.onunload  "   writeEntireProperty  =   "  true  " />  
 15 >        
 16           <%  @ include file  =   "  /common/header.jsp  "   %>   
 17           < h1 >< decorator:getProperty property  =   "  page.heading  " /></ h1 >    
 18           <%  @ include file  =   "  /common/messages.jsp  "     %>  
 19           < decorator:body />  
 20           < jsp:include page  =   "  /common/footer.jsp  " />  
 21   </ body >  
 22   </ html >  

注意其 <decorator:…> 标签,如 ：<decorator:head/> ，这些标签将被装饰的 page 页面的相应内容作为属性传入。 Page 页面的相关内容将放在 decorator 标签所指定的位置。

1 Title ：标题 
 2 Head ：头部，一般是公共的 js 、 css 及 meta 
 3 Body ：被装饰的 page 的主体内容

 5 、 Sitemesh 通过 ：

1 在 sitemesh.xml 中配置 DecoratorMapper 配置映射器
 2 在 decorator.xml 中配置装饰器文件及其匹配方式

当有页面需要输出到客户端时，将根据这些配置选择相应的装饰器来进行装饰，将装饰结果返回给客户界面。

4.   参考资料
关于 Sitemesh 的 api 及详细使用说明可以参看其官方网站

http://www.opensymphony.com/sitemesh

 



刘文涛 2006-08-18 15:16 发表评论
]]>