`

高级Sitemesh(Advanced Sitemesh)

JSP应用服务器freemarkerServletvelocity 
阅读更多

1.序言

假设你打算结合多种技术来构建一个企业级web站点。比如，你准备采用J2EE技术往你的web站点里添加新内容，而这个系统的其他部分是用CGI或者微软的IIS Server搭建的。
在这种情况下，怎样让你的应用系统从外观和感受(look and feel)上保持一致呢？一种办案就是采用J2EE技术全部重写，然后选用一种框架，比如Struts-Tiles，但这种办案的开发成本太高，不太现实。另一种可选方案是在你的应用系统的各个部分采用相同的Look and Feel。但这种方案会使维护站点变成噩梦，因为每当一个应用系统里面的Look and Feel需要改变的时候，你就需要让系统里的其他web应用保持同样的改变。
大多数用于解决这种商务需求的可用框架都有一个共同的缺点，他们不是平台相关就是框架相关。当你决定采用Tiles作为struts修饰器的时候，需要创建tiles定义文件tiles-defs.xml，然后在 struts-config.xml里面声明forwards，引用这些tiles以修饰原始的JSP。

最简单的一种可能的解决方案是，全部采用纯html方式来生成你的web应用，每一个html页面都不需要知道自己将会被如何修饰，而是在外部采用某种机制来选择合适的修饰器修饰它们。这就是SiteMesh的功能。
SiteMesh是基于Java、J2EE和XML的开源框架，依赖于从Servlet 2.3版本里引入的新功能——过滤器(Filters)

2.安装和设置
按照以往的经验，学习任何新技术或新框架最好的办法，就是使用它来创建一个简单的应用程序。所以，我们将使用SiteMesh来创建一个简单的Struts应用程序。我们的应用程序包括三个页面：
•一个登录页面
•一个帮助页面，包括页头和页脚
•一个主页面，包括页头、页脚和页边菜单

3.下面是创建这个简单web应用程序的步骤：

（1）SiteMesh基于过滤器，所以我们需要把SiteMesh过滤器通知给我们的web应用程序。在web.xml文件里加入如下几行：



<filter>
  <filter-name>sitemesh</filter-name>
  <filter-class>
      com.opensymphony.module.sitemesh.filter.PageFilter
  </filter-class>
  <init-param>
    <param-name>debug.pagewriter</param-name>
    <param-value>true</param-value>
  </init-param>
</filter>
<filter-mapping>
  <filter-name>sitemesh</filter-name>
  <url-pattern>/*</url-pattern>
</filter-mapping>

这几行是告诉web容器，所有对web应用的请求都会经由PageFilter“过滤”一下。PageFilter是sitemesh-2.1.jar里的
一个类，你可以从http://www.opensymphony.com/sitemesh/download.html下载该jar包。
（2）在WEB-INF目录下生成一个decorators.xml文件，内容如下：
<decorators defaultdir="/decorators">
  <!— 给需要页边菜单的页面配置页边菜单修饰器 -->



 <decorator name="sidemenu" page="sidemenu.jsp">
    <pattern>/home.jsp</pattern>
  </decorator>
  <!— 给需要页头和页脚的页面配置页头页脚修饰器 -->


  <decorator name="headerfooter" page="headerfooter.jsp">
    <pattern>/help.jsp</pattern>
  </decorator>
</decorators>

另外，过滤器只有在使用浏览器请求一个页面的时候才能生效。所以，如果你通过浏览器访问home.jsp，它将被修饰，但如
果你使用Servlet的RequestDispatcher.include()或者forward()来控制home.jsp，修饰器就不起作用了。
但是不用担心，从Servlet 2.4版本开始，你可以配置过滤器适用的环境，包括forward和include的情况下都可以使用了。
decorators.xml 文件用来在你的应用程序里定义修饰器(decorators)。在这个文件里，每个<decorator>元素定义一个修饰器，name指定修饰器名，page指定修饰器所使用的JSP页面。<pattern>子元素指定这些修饰器如何应用到实际的页面上去。

在我们的示例web应用里，定义了两个修饰器：追加页头和页脚的headerfooter.jsp和追加页边菜单的sidemenu.jsp。我们想修饰 help页面追加页头和页脚，所以我们追加了一个/help.jsp路径子元素给headerfooter.jsp修饰器。

（3）在WebContent/decorators目录下创建headerfooter.jsp：






<%@ taglib
    uri="http://www.opensymphony.com/sitemesh/decorator"
    prefix="decorator" %>
<html>
  <head>
    <title>
      My Site - <decorator:title default="Welcome!" />
    </title>
    <decorator:head />
  </head>
  <body>

    <table>
      <tr>
        <td>
          <H1>
            SiteMesh Corporation
          <H1>
        </td>
      </tr>
      <tr>
        <td><decorator:body /></td>
      </tr>
      <tr>
        <td> SiteMesh copyright</td>
      </tr>
    </table>
  </body>
</html>
一个SiteMesh修饰器其实就是一个使用SiteMesh自定义标签的JSP页面。在我们的web应用里，当用户请求help页面的时候，SiteMesh会拦截这个请求，然后再把它发送给web应用。而当应用返回响应的时候，SiteMesh会结合headerfooter.jsp文件解析这个响应，遇到<decorator:head/>就插入响应文件的<head>，遇到<decorator:body/>就插入响应文件的<body>。最后，被headerfooter.jsp修饰过的文件会被返回给客户端。

（4）在WebContent目录下创建help.jsp：

<HTML>
<HEAD>
<%@ page language="java"
contentType="text/html; charset=ISO-8859-1"
pageEncoding="ISO-8859-1" %>
<TITLE>Help Page</TITLE>
</HEAD>
<BODY>
  Help Page
</BODY>
</HTML>
这是一个在web应用里很常见的help页面。

（5）在浏览器里请求help.jsp页面，测试SiteMesh安装是否正常。浏览器将会返回一个包含页头和页脚的help页面。

4.SiteMesh架构

SiteMesh 架构基于PageFilter——一个Servlet过滤器。容器接收到页面请求时，会把请求传递给PageFilter，PageFilter收集应用程序的响应细节，生成自定义的响应对象，然后连同请求一起传递给web应用程序。web应用程序把响应资源写入到自定义响应对象里，再返回给 PageFilter。

（1）解析阶段
当控制返回给PageFilter的时候，它会检查web应用生成响应的内容类型 (content type)，然后基于响应类型，生成不同的解析器来解析响应。比如，如果应用返回text/html类型的内容，SiteMesh会生成一个 FastPageParser实例，并把web应用生成的页面传递给它。FastPageParser会解析这个页面，提取出这个页面的header、 footer、title 等内容。

（2）修饰阶段

解析结束后，SiteMesh开始修饰页面。这一阶段分成两部分：

a．决定如何修饰

SiteMesh 有一个概念，叫做修饰器映射，实现这个概念的接口是DecoratorMapper(有init()和getDecorator()方法)。映射器在 sitemesh.xml里声明。在sitemesh.xml文件里，每一个映射器都是它上一个映射器的父映射。当SiteMesh需要一个修饰器来修饰页面的时候，会在sitemesh.xml里查找映射器，生成找到的第一个映射器的实例并调用getDecorator()方法，在这个方法里尝试查找针对那个页面的修饰器。如果找到了就返回；否则，调用父映射器的getDecorator()方法，反复进行这个过程，直到找到正确的修饰器。

b．应用修饰

找到修饰器后，SiteMesh会把请求分发给它。修饰器JSP页面会访问在前阶段里解析出来的页面信息。使用各种SiteMesh自定义标签来提取页面信息不同的部分(比如header、footer和title)并把它们插入到输出文件合适的位置上去。
你可以在sitemesh.xml文件里自定义使用哪个页面解析器来解析指定的内容类型或者使用哪种修饰器映射方案，比如：

<?xml version="1.0" encoding="UTF-8"?>
<sitemesh>
  <property name="decorators-file" value="/WEB-INF/decorators.xml"/>
  <excludes file="${decorators-file}"/>
  <page-parsers>
    <parser content-type="text/html"
        class="com.opensymphony.module.sitemesh.parser.FastPageParser" />
  </page-parsers>
  <decorator-mappers>
    <mapper
        class="com.opensymphony.module.sitemesh.mapper.PageDecoratorMapper">
      <param name="property.1" value="meta.decorator" />
      <param name="property.2" value="decorator" />
    </mapper>
    <!-- Mapper for localization -->


    <mapper
        class="com.opensymphony.module.sitemesh.mapper.LanguageDecoratorMapper">
      <param name="match.en" value="en" />
      <param name="match.zh" value="zh" />
    </mapper>
    <!-- Mapper for browser compatibility -->


    <mapper
        class="com.opensymphony.module.sitemesh.mapper.AgentDecoratorMapper">
      <param name="match.MSIE" value="ie" />
      <param name="match.Mozilla/" value="ns" />    </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>
    <mapper
        class="com.opensymphony.module.sitemesh.mapper.ParameterDecoratorMapper">
      <param name="decorator.parameter" value="decorator" />
      <param name="parameter.name" value="confirm" />
      <param name="parameter.value" value="true" />
    </mapper>
    <mapper
        class="com.opensymphony.module.sitemesh.mapper.ConfigDecoratorMapper">
      <param name="config" value="${decorators-file}" />
    </mapper>
  </decorator-mappers>
</sitemesh>
在这个列表里，<property name="decorators-file">指定了用于定义修饰器的文件。<page-parsers>定义了SiteMesh可以处理的内容类型。每一个<parser>子元素指定哪一个解析器解析哪一种特定的内容类型。在我们的示例sitemesh.xml文件里，我们告诉SiteMesh使用FastPageParser解析text/html类型的内容。默认地，SiteMesh只可以处理HTML，但我们可以创建自己的解析器来处理其他的内容类型。

<decorator-mappers>子元素定义了映射方案，SiteMesh使用这个映射方案来查找修饰指定页面的修饰器。你可以使用<param>子元素来配置每一个映射器。SiteMesh会把这些配置信息包装成 java.util.Properties对象传递给映射器的init()方法。

（3）区域相关的修饰器

在我们的示例sitemesh.xml文件里，有下面几行标签：

<mapper class="com.opensymphony.module.sitemesh.mapper.LanguageDecoratorMapper">
  <param name="match.en" value="en" />
  <param name="match.zh" value="zh" />
</mapper>
当查找一个应用于页面的修饰器时，SiteMesh会首先读取请求头部的Accept-Language信息。如果匹配en区域，SiteMesh会在修饰器JSP文件名末尾追加-en。在我们的例子里，如果请求定义了修饰器headerfooter.jsp的help.jsp页面，并且使用的是区域是英国，SiteMesh会首先查找并应用headerfooter-en.jsp修饰器，如果找不到再去应用headerfooter.jsp。

（4）浏览器相关的修饰器

可以使用AgentDecoratorMapper来保证浏览器的兼容性：

<mapper
class="com.opensymphony.module.sitemesh.mapper.AgentDecoratorMapper">
  <param name="match.MSIE" value="ie" />
  <param name="match.Mozilla/" value="ns" />
</mapper>
这意味着当SiteMesh查找一个修饰器来修饰页面的时候，会首先提取出请求头部的User-Agent信息。如果是IE，就加上-ie到修饰器的文件名末尾，并查找和应用这个修饰器。如果找不到这样的修饰器，则继续应用headerfooter.jsp。

5.高级SiteMesh

SiteMesh提供映射器，让每一个页面参与到寻找自己修饰器的过程中去。

（1）PrintableDecoratorMapper

大多数的web站点都提供了一个获得可打印版本页面的功能。所谓可打印版本，一般是指去除了页头、页尾和页边菜单，并使用了另一套样式表的页面。在 SiteMesh里，我们可以使用PrintableDecoratorMapper来提供这个功能。要使用这个映射器，需要在sitemesh.xml 里追加如下几行：

<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>
传递给PrintableDecoratorMapper的三个配置参数会被包装成java.util.Properties对象传递给init()方法。

•decorator
用来生成可打印版本页面的修饰器名。

•parameter.name
用来通知SiteMesh我们需要一个可打印版本的请求参数名。比如在我们的例子里，通过在查询字符串里追加printable=true参数传递

•parameter.value
设置可打印参数为何值时SiteMesh提供可打印版本的页面。

（2）PageDecoratorMapper

页面可以通过定义META属性来重载指定修饰自己的修饰器名。
要使用这个映射器，需要在sitemesh.xml文件里加入如下几行：

class="com.opensymphony.module.sitemesh.mapper.PageDecoratorMapper">
  <param name="property.1" value="meta.decorator" />
</mapper>
<filter-mapping>
  <filter-name>sitemesh</filter-name>
  <url-pattern>/*</url-pattern>
</filter-mapping>
PageDecoratorMapper可以获取一个参数列表。在我们的例子里，提供了一个参数名，指定了通过META属性来取得修饰器名。所以如果我们希望使用test修饰器来修饰页面，则在该页头部加入：

<META name="decorator" content="test">

PageDecoratorMapper提供了一种静态的方法来让页面选择自己想要使用的修饰器。另外，页面还可以通过使用ParameterDecoratorMapper在运行时指定要使用的修饰器。

（3）ParameterDecoratorMapper

要使用ParameterDecoratorMapper，在sitemesh.xml里追加如下几行：

<mapper
class= "com.opensymphony.module.sitemesh.mapper.ParameterDecoratorMapper">
  <param name="decorator.parameter" value="decorator" />
  <param name="parameter.name" value="confirm" />
  <param name="parameter.value" value="true" />
</mapper>
三个参数的意义分别如下：

•decorator.parameter
指定修饰器所使用的请求参数名。

•parameter.name
确定使用请求修饰器的确认参数名。

•parameter.value
确定使用请求修饰器的确认参数值。
比如，如果你想使用test修饰器来修饰help.jsp，可以像下面这样访问help.jsp
help.jsp?decorator=test&confirm=true
除了以上这些映射器以外，SiteMesh还提供了更多有用的映射器，比如：

（4）FrameSetDecoratorMapper
当页面是Frame的时候使用。

（5）CookieDecoratorMapper
可以通过cookie来指定想要使用的修饰器。

（6）RobotDecoratorMapper
当请求者被确人为robot的时候使用指定的修饰器。你可以手动的在请求头部追加robot关键字，或者通过修饰器来做。

（7）Velocity 和 Freemarker 修饰器

SiteMesh 并没有限制你只能修饰JSP页面。你可以自由的选择想要修饰的对象，比如Velocity或者Freemarker。Velocity和 Freemarker是一种可被用于生成web页面的模板语言。这些语言比JSP更加的简单易用，但在可编程性方面不如JSP灵活。
SiteMesh通过两个servlet支持这两种模板语言，这两个servlet也被定义在SiteMesh.jar文件里。我们可以像这样在web.xml里声明这两个servlet：

<servlet>
  <servlet-name>sitemesh-velocity</servlet-name>
  <servlet-class>
    com.opensymphony.module.sitemesh.velocity.VelocityDecoratorServlet
  </servlet-class>
</servlet>
<!--Declare servlet for handling freemarker requests -->


<servlet>
  <servlet-name>sitemesh-freemarker</servlet-name>
  <servlet-class>
    com.opensymphony.module.sitemesh.freemarker.FreemarkerDecoratorServlet
  </servlet-class>
  <init-param>
    <param-name>TemplatePath</param-name>
    <param-value>/</param-value>
  </init-param>
  <init-param>
    <param-name>default_encoding</param-name>
    <param-value>ISO-8859-1</param-value>
  </init-param>
</servlet>
<!-- Velocity servlet should serve all requests with .vm extension-->


<servlet-mapping>
  <servlet-name>sitemesh-velocity</servlet-name>
  <url-pattern>*.vm</url-pattern>
</servlet-mapping>
<!-- FreeMarker servlet should serve all requests with .dec extension-->


<servlet-mapping>
  <servlet-name>sitemesh-freemarker</servlet-name>
  <url-pattern>*.dec</url-pattern>
</servlet-mapping>
当然，我们还需要在lib文件夹里引入freemarker.jar、velocity-dep.jar和velocity-tools- view.jar。这些jar文件已经包含在SiteMesh的发布包里了。下面让我们修改第一个示例应用，使用Velocity和Freemarker 修饰器来取代JSP。在我们第一个示例应用里定义了两个修饰器：headerfooter和sidemenu。下面我们创建一个 headerfooter.dec：

<html>
  <head>
    <title>My Site - $Advanced SiteMesh</title>
      ${head}
  </head>
  <body>
    <table border="1">
      <tr>
        <td>SiteMesh Corporation</td>
      </tr>
      <tr>
        <td>${body}</td>
      </tr>
      <tr>
        <td>SiteMesh copyright</td>
      </tr>
    </table>
  </body>
</html>
在这个页面里，我们使用Freemarker模板来请求header、footer和title，而不是使用JSP自定义标签，但页面布局是一样的。当容器接收到一个.dec扩展名的页面请求时，会把这个请求传递给FreemarkerDecoratorServlet，后者将会调用 FreemarkerDecorator修饰生成的HTML页面。我们使用$Advanced SiteMesh模板来访问应用生成的web页面的title，${head}访问head，${body}访问body。Freemarker提供了非常丰富的模板，想深入研究的话可以参考http://www.javaworld.com/jw-01-2001/jw-0119- freemarker.html。

相似的，在decorators目录下创建sidemenu.vm文件，这是Velocity修饰器文件：
<html>
  <head>
    <title>My Site - $title</title>
      $head
  </head>
  <body>
    <table border="1">
      <tr>
        <td> SiteMesh Header </td>
      </tr>
      <tr>
        <td> Sidemenu </td>
        <td> $body </td>
      </tr>
      <tr>
        <td> SiteMesh Footer </td>
      </tr>
    </table>
  </body>
</html>
使用$title模板取代<decorator:title/>，使用$head和$body Velocity模板来取代相应的JSP自定义标签。

6.结论

基于过滤器的SiteMesh是一个非常灵活和简单易用的修饰器框架。但它还是存在着一些问题。首先，从Servlet 2.3版本才开始支持过滤器，所以一些早期版本的应用服务器无法支持SiteMesh。在使用SiteMesh之前请先检查一下您想使用的应用服务器是否支持过滤器。


本文来自CSDN博客，转载请标明出处：http://blog.csdn.net/csuliky/archive/2009/06/08/4251317.aspx

分享到：
| FreeMarker作为Struts2的视图
评论
发表评论

您还没有登录,请您登录后再发表评论

相关推荐

    SiteMesh教程及SiteMesh官方文档翻译

    ### SiteMesh教程及SiteMesh官方文档翻译 #### 使用SiteMesh简化网页布局 SiteMesh是一款用于Web应用程序中的页面布局和装饰的框架。它采用Decorator模式，通过过滤器（filter）拦截请求和响应，将不同的页面组件...

    siteMesh demo+文档

    SiteMesh 是一个开源的Web应用程序布局和装饰框架，主要用于解决Web应用中的页面布局问题。它通过拦截HTTP请求，将页面内容与预定义的布局模板相结合，实现统一的页面头部、底部和侧边栏等元素，从而提高网站的整体...

    sitemesh框架简单例子

    Sitemesh是一款强大的Web页面布局和装饰框架，它主要用于帮助开发者实现网站的统一外观和感觉。这个框架的主要功能是将页面的主体内容与页眉、页脚、侧边栏等通用部分分离，使得在大量网页中保持一致的设计风格变得...

    sitemesh

    **Sitemesh** 是一个广泛使用的开源Web应用框架，它主要功能是提供页面布局和装饰功能，用于统一网站的外观和感觉。Sitemesh通过在Web应用中引入“母版”（Master Page）的概念，使得开发者可以轻松地创建一致性的...

    java sitemesh 页面框架

    Java Sitemesh是一个开源的页面布局和装饰框架，它的主要目标是帮助开发者统一网站的外观和感觉，提高代码复用性，并简化页面的复杂性。Sitemesh通过将页面分为内容区域和装饰模板来实现这一目标，使得开发者可以...

    SiteMesh

    SiteMesh 是一个开源的Web应用程序框架，主要用于帮助开发者实现页面布局和装饰功能。它通过拦截HTTP请求，将页面内容与布局模板相结合，从而提供了一种简单有效的方式来管理和控制Web应用的外观和感觉。在Web开发中...

    sitemesh-2.2.1.jar sitemesh-2.2.1.jar

    **sitemesh-2.2.1.jar** 是一个用于Web应用程序界面布局的开源框架，由OpenSymphony团队开发。Sitemesh的主要功能是提供页面装饰能力，它可以帮助开发者统一网站的外观和感觉，实现页面模板和内容的分离。通过在...

    页面装饰器(sitemesh)实例源代码

    页面装饰器（Sitemesh）是一种广泛用于Web应用的开源框架，它的主要功能是提供页面布局和装饰功能，使得开发者可以方便地实现统一的页面头部、尾部、侧边栏等元素，从而提高网站的整体风格一致性。在本实例中，我们...

    sitemesh3-demo

    【sitemesh3-demo】是一个基于Sitemesh3框架的示例项目，旨在展示如何在Web应用程序中有效地实现页面布局和装饰功能。Sitemesh是一个开源的Java Web应用框架，主要用于增强网页的外观和结构，通过定义装饰模板，可以...

    sitemesh3官方下载包

    **Sitemesh3** 是一个开源的网页布局和装饰框架，用于Java Web应用程序。它主要目的是帮助开发者统一网站的外观和感觉，通过提供一种简单的方式来装饰（或模板化）整个Web应用中的页面。Sitemesh3是Sitemesh项目的第...

    sitemesh jar包机tld文件

    在Java Web开发中，SiteMesh是一个非常流行的页面布局框架，它可以帮助开发者轻松地实现网站的统一外观和感觉，以及提供页面装饰功能。标题中的“sitemesh jar包”指的是SiteMesh框架的核心库文件，它是SiteMesh功能...

    springMVC与sitemesh的结合

    而Sitemesh则是一个页面布局和装饰框架，主要用于处理Web应用中的页面布局问题，比如统一头部、底部和侧边栏，提升用户体验并简化开发。 将Spring MVC与Sitemesh结合使用，可以实现更高效的Web应用开发。以下是对这...

    Sitemesh 3 的使用及配置

    ### Sitemesh 3 的使用及配置 #### 一、Sitemesh 3 简介 Sitemesh 是一个非常实用的Web页面布局与修饰框架，它通过Servlet中的Filter来实现网页的装饰功能，类似于ASP.NET中的“母版页”技术。这种技术允许开发者...

    sitemesh装饰器入门

    此外，Sitemesh 还支持自定义过滤器，可以根据需要扩展其功能，例如实现权限控制、动态装饰等高级特性。 在实际项目中，Sitemesh 可以与其他 Web 框架（如 Struts、Spring MVC 等）很好地集成，进一步提升开发效率...

    SiteMesh教程.pdf

    SiteMesh是一种用于Java Web应用的装饰器设计模式框架，主要通过拦截Web页面请求，动态地将装饰页面如头部（header）、底部（footer）、样式表（stylesheet）和脚本文件（scripts）等页面元素与实际页面组合在一起，...

    sitemesh.jar包

    sitemesh.jar包 sitemesh.jar 包sitemesh.jar 包sitemesh.jar包

    sitemesh入门demo

    Sitemesh 是一个开源的网页布局和装饰框架，它主要负责处理Web应用程序的页面布局，使得开发者可以集中精力于应用的核心功能，而不用过多关注页面样式的一致性和美观性。Sitemesh 提供了一种优雅的方式来组织和装饰...

    sitemesh布局知识点汇总

    ### Sitemesh布局知识点汇总 #### 一、Sitemesh简介 Sitemesh是一个非常实用且功能强大的Web页面布局和装饰框架，适用于多种Web应用程序，包括但不限于Java（JSP）、PHP、ASP等技术栈下的应用。它能够有效地帮助...

    sitemesh教程

    除了基本的装饰器定义外，SiteMesh还提供了许多高级功能，例如： - **条件渲染**：根据不同的条件渲染不同的内容。 - **多级嵌套**：支持多层嵌套的装饰器，使得布局更加复杂多样。 - **自定义装饰器标签**：可以...

Magicbox
Global site tag (gtag.js) - Google Analytics