使用SiteMesh简化网页布局

Riley2222 2012-04-21

展开全文

在公司项目使用了 Appfuse ，其带有 SiteMesh 对于网页布局简化让我感觉很好用，本文旨在对对 Sitemesh的基本原理和在项目中使用 Sitemesh 的实现流程、使用技巧的介绍。

1. 基本原理

SiteMesh 是以 Servlet 2.3API 为基础。它包含一个引擎，用来解析输出的网页或者网页片段，决定是否需要应用装饰器以及合并合适的装饰器。

SiteMesh 与应用内容无关，适用的内容格式包括 Html 、 JSP 、 Servlet 、 XSL ，甚至 CGI 。

2. 实现流程

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

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

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

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

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

大致流程如下图：

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

3. 在项目中使用 Sitemesh

1. 将 sitemesh_[version].jar 包加到 WEB-INF/lib 下

2. 在 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 >

</ filter-mapping >

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

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

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.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.ConfigDecoratorMapper" >

< param name ="config" value ="${decorators-file}" />

</ mapper >

</ decorator-mappers >

</ sitemesh >

Decorator.xml

< decorators defaultdir ="/decorators" >

< excludes >

< pattern > /demos/* </ pattern >

< pattern > /resources/* </ pattern >

< pattern > /test* </ pattern >

< pattern > /FCKeditor/* </ pattern >

</ excludes >

< decorator name ="printable" page ="decPrintable.jsp" />

< decorator name ="login" page ="decLogin.jsp" >

< pattern > *login* </ pattern > <! —url 映射模式 -- >

</ decorator >

< decorator name ="default" page ="decDefault.jsp" >

< pattern > /* </ pattern > <! — 缺省的装饰器 -- >

</ decorator >

</ decorators >

在 sitemesh.xml 中配置了两个 DecoratorMapper ： PrintableDecoratorMapper 和 ConfigDecoratorMapper 。

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

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