sitemesh教程-页面装饰技术原理及应用

转载 2015年10月20日 16:57:18
本文介绍的是2.4的配置,sitemesh3的配置可参考http://www.cnblogs.com/luotaoyeah/p/3776879.html

转自http://www.jb51.net/web/70208.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个。

— — —— — — — — — — — — — — — — — — — — — — — — —

如果某个特殊的需求请求路径在过滤器的范围内,但又不想使用模板怎么办?
你总不能这么不讲道理吧!

大家放心吧,SiteMesh早就考虑到这一点了,上面第5步说道的decorators.xml这个时候就起到作用了!       
下面是我的decorators.xml

复制代码
代码如下:

<?xml version="1.0" encoding="ISO-8859-1"?>
<decorators defaultdir="/decorators">
<!-- Any urls that are excluded will never be decorated by Sitemesh -->
<excludes>
<pattern>/index.jsp*</pattern>
<pattern>/login/*</pattern>
</excludes>
<decorator name="main" page="main.jsp">
<pattern>/*</pattern>
</decorator>
</decorators>

decorators.xml有两个主要的结点
      decorator结点指定了模板的位置和文件名,通过pattern来指定哪些路径引用哪个模板
      excludes结点则指定了哪些路径的请求不使用任何模板

如上面代码,/index.jsp和凡是以/login/开头的请求路径一律不使用模板;

另外还有一点要注意的是:decorators结点的defaultdir属性指定了模板文件存放的目录;



SiteMesh 过滤不装饰的页面

SiteMesh 过滤不装饰的页面
  • educast
  • educast
  • 2015-11-01 10:37:17
  • 2300

SiteMesh页面装饰器的使用步骤

1、往j2
  • kpchen_0508
  • kpchen_0508
  • 2014-11-19 14:40:34
  • 4803

SiteMesh在JSP中的页面装饰

SiteMesh装饰页面,使得代码更加简洁,可维护性更好。 decorator的原理: sitemesh应用Decorator模式,用filter截取request和response,把...
  • xuanfengling
  • xuanfengling
  • 2015-07-29 10:41:05
  • 1543

使用SiteMesh(2.4.2) ,被装饰页面导入的外部js文件无法调用的问题

写在前面的废话: 自从大学毕业后,10年间几乎没写过什么代码,最新的技术也没研究过,更不要说前端开发这种软件工程师一般不怎么关注的部分。 近期心血来潮,准备自己写个管理系统,前端后端全部一个人搞。结果...
  • Jackin_Zhang
  • Jackin_Zhang
  • 2018-01-03 01:33:03
  • 105

如何用sitemesh---------- 装饰模式

第一步:web.xml配置 第二部:decorate.xml配置 第三部:装饰页面 操作:第一步:web.xml sitemeshFilter com.opensymphony.si...
  • u014236541
  • u014236541
  • 2016-04-22 10:50:00
  • 3768

使用sitemesh3装饰页面

一、使用maven引包 org.sitemesh sitemesh ${org.sitemesh.version} 二、项目结构,在WEB-INF中新建sitemesh3.xm...
  • ihchenchen
  • ihchenchen
  • 2017-03-17 20:12:38
  • 499

使用SiteMesh分割、装饰jsp页面

1. 在WEB-INF下添加decorators.xml文件: xml version="1.0" encoding="UTF-8"?>   decorators defaultdi...
  • torrytang
  • torrytang
  • 2015-12-31 14:43:06
  • 1004

sitemesh排除装饰action的心得

sitemesh装饰模式的强大就不用说了,但使用过程中遇到的最郁闷的莫过于排除装饰action的困扰了,例如使用某个ajax请求要求返回不装饰的数据,但sitemesh却死活给你装饰了,以前用了个小技...
  • jueshengtianya
  • jueshengtianya
  • 2013-12-05 12:28:06
  • 950

sitemesh框架对页面进行布局和装饰

在实际看法中每写出的页面都需要页头和页脚,我们之前使用include将页面引用过来,这样如果页面一多得话,引用起来非常麻烦,所以这里使用sitemesh框架可以在页面中不用任何引入就可以加上页头页脚,...
  • furongkang
  • furongkang
  • 2011-09-11 23:30:41
  • 1737

SiteMesh2.4装饰器

一,SiteMesh的工作原理 SiteMesh是基于Servlet的filter的,即过滤流。它是通过截取reponse,并进行装饰后再交付给客户。 其中涉及到两个名词: 装饰页面(decora...
  • hwt_211
  • hwt_211
  • 2013-09-26 09:56:12
  • 1084
收藏助手
不良信息举报
您举报文章:sitemesh教程-页面装饰技术原理及应用
举报原因:
原因补充:

(最多只允许输入30个字)