sitemesh 了解

sitemesh2.4

Sitemesh 是由一个基于 Web 页面布局、装饰及与现存 Web 应用整合的框架。它能帮助我们由大量页面工程的项目中创建一致的页面布局和外观，如一致的导航条、一致的 banner 、一致的版权等。它不仅能处理动态的内容，如 JSP 、 PHP 、 ASP 、 CGI 等产生的内容，还能处理静态的内容，比如 HTML 的内容，使得它的内容也符合你的页面结构的要求。甚至它能像 include 那样将 HTML 文件作为一个面板的形式嵌入到别的文件中去。它的主要思想是装饰模式。

前提：依赖于 >=Servlet 2.3 版本里引入的新功能 —— 过滤器 (Filters) 。

好处：

使用 sitemesh 给我们带来的是不仅仅是页面结构问题，它的出现让我们有更多的时间去关注底层业务逻辑，而不是整个页面的风格和结构。它让我们摆脱了大量用 include 方式复用页面尴尬局面，它也提供了很大的灵活性以及给我们提供了整合异构 Web 系统页面的一种方案。

部署：

首先需要导入 sitemesh-2.4.2.jar 由于是 struts2.1.8 整合 sitemesh 的所以还需要导入 struts2-sitemesh-plugin-2.1.6.jar( 目前还没有 struts2-sitemesh-plugin-2.1.8.jar 的 ).

Web.xml 文件中的配置：

< filter >

< filter-name > struts2 </ filter-name >

< filter-class > org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter </ filter-class >

</ filter >

< filter >

< filter-name > struts-cleanup </ filter-name >

< filter-class > org.apache.struts2.dispatcher.ActionContextCleanUp </ filter-class >

</ filter >

< filter >

< filter-name > sitemesh </ filter-name >

< filter-class > com.opensymphony.module.sitemesh.filter.PageFilter </ filter-class >

</ filter >

< filter-mapping >

< filter-name > struts-cleanup </ filter-name >

< url-pattern > /* </ url-pattern >

< dispatcher > REQUEST </ dispatcher >

< dispatcher > FORWARD </ dispatcher >

</ filter-mapping >

< filter-mapping >

< filter-name > sitemesh </ filter-name >

< url-pattern > /* </ url-pattern >

< dispatcher > REQUEST </ dispatcher >

< dispatcher > FORWARD </ dispatcher >

</ filter-mapping >

< filter-mapping >

< filter-name > struts2 </ filter-name >

< url-pattern > /* </ url-pattern >

< dispatcher > REQUEST </ dispatcher >

< dispatcher > FORWARD </ dispatcher >

</ filter-mapping >

以上的配置是根据 url 进行装饰的。如果想根据物理路径来进行装饰，就把 sitemesh 和 struts2 位置换一下就 ok 了。

Sitemesh 自己也需要配置文件：比如 decorators.xml ， sitemesh.xml ， sitemesh-decorator.tld ， sitemesh-page.tld 。 decorators.xml 是必须要的，其它的可要可不要，主要取决于项目的复杂性。

decorators.xml 配置文件的讲解：

<? xml version = "1.0" encoding = "utf-8" ?>

< decorators defaultdir = "/WEB-INF/decorators" ><!—- 定义一个绝对路径 —>

<!-- excludes 标签标示不需要进行装饰的 url -- >

< excludes >

< pattern > /css /* </ pattern >

< pattern > /js /* </ pattern >

< pattern > /images/* </ pattern >

< pattern > /buyer/viewmerchantproduct * </ pattern >

< pattern > /buyer/toindex.do* </ pattern >

< pattern > /buyer/buyerlogout.do </ pattern >

< pattern > */admin -ajax /* </ pattern >

< pattern > */merchant/tomerchantlogin.do* </ pattern >

< pattern > */admin /toadminlogin.do* </ pattern >

< pattern > */admin /adminlogin.do* </ pattern >

< pattern > /merchant/info/login.do* </ pattern >

< pattern > /merchant/report/* </ pattern >

</ excludes >

<!—- 以下是定义一些模板主要包括模板的 name 和 page -->

< decorator name = "adminmain" page = "adminmain.jsp" >

< pattern > /admin /* </ pattern >

</ decorator >

< decorator name = "buyerbackstagemain" page = "buyerbacktage.jsp" >

< pattern > /buyer/backstage/* </ pattern >

</ decorator >

< decorator name = "seobuyermain" page = "seobuyermain.jsp" >

< pattern > /buyer/viewcategoryproduct.do* </ pattern >

< pattern > /buyer/viewrootcategory.do* </ pattern >

< pattern > /buyer/viewstandproductdetail.do* </ pattern >

< pattern > /buyer/viewproductreview.do* </ pattern >

</ decorator >

< decorator name = "buyermain" page = "buyermain.jsp" >

< pattern > /admin /previewproduct /* </ pattern >

< pattern > /buyer/* </ pattern >

< pattern > /adminpreview /previewbuyerhelpatricle.do </ pattern >

< pattern > /adminpreview /previewbuyerupdateatricle.do </ pattern >

</ decorator >

</ decorators >

注意：模板的名字不要相同 , 如果相同错是不会报，只会被最后的那个相同名字的模板装饰。

url 拦截优先级：主要是配备的越精确优先级就高，不是谁在前面谁的优先级就高。

sitemesh 标签讲解：

<decorator:title default="Welcome to test sitemesh!" /> ：读取被装饰页面的标题，并给出了默认标题。
<decorator:head /> ：读取被装饰页面的 <head> 中的内容；
<decorator:body /> ：读取被装饰页面的 <body> 中的内容；
当然还有很多的标签，这里不再详细描述。

SiteMesh基本用法及示例

SiteMesh是基于Servlet的filter的，即过滤流。它是通过截取reponse，并进行装饰后再交付给客户。

其中涉及到两个名词：装饰页面(decorator page)和 “被装饰页面(Content page)" , 即 SiteMesh通过对Content Page的装饰，最终得到页面布局和外观一直的页面，

并返回给客户

运行环境需要：servlet2.3 , JDK1.4 以上。

正常模式下的web访问流程

加入SiteMesh装饰的web访问流程

一：搭建SiteMesh环境及简单使用

1.1：准备资源

siteMesh2.4.jar, sitemesh-page.tld , sitemesh-decorator.tld 这个三个必要文件

将jar包复制进/WEB-INF/lib目录下，两个tld文件导入/WEB-INF下即可

在web.xml中加入siteMesh的filter和taglib

[html] view plain copy print ?

<filter>
<filter-name>sitemesh</filter-name>
<filter-class>com.opensymphony.sitemesh.webapp.SiteMeshFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>sitemesh</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<taglib>
<taglib-uri>sitemesh-page</taglib-uri>
<taglib-location>/WEB-INF/lib/sitemesh-page.tld</taglib-location>
</taglib>
<taglib>
<taglib-uri>sitemesh-decorator</taglib-uri>
<taglib-location>/WEB-INF/lib/sitemesh-decorator.tld</taglib-location>
</taglib>

 <filter>
<filter-name>sitemesh</filter-name>
<filter-class>com.opensymphony.sitemesh.webapp.SiteMeshFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>sitemesh</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<!-- not required for containers that fully support JSP 1.2 -->
<taglib>
<taglib-uri>sitemesh-page</taglib-uri>
<taglib-location>/WEB-INF/lib/sitemesh-page.tld</taglib-location>
</taglib>
<taglib>
<taglib-uri>sitemesh-decorator</taglib-uri>
<taglib-location>/WEB-INF/lib/sitemesh-decorator.tld</taglib-location>
</taglib>

1.2 建立decorators.xml

在/WEB-INF下创建decorators.xml文件，siteMesh通过该文件来获知"装饰页面"和"被装饰页面"的映射

decorators.xml

[html] view plain copy print ?

<?xml version="1.0" encoding="UTF-8"?>
<decorators defaultdir="/decorators">
<decorator name="main" page="main.jsp">
<pattern>/*</pattern>
</decorator>
<decorator name="mai" page="mai.jsp">
<pattern>/mai.html</pattern>
</decorator>
<decorator name="panel" page="panel.jsp"/>
<decorator name="velocity" page="velocity.vm">
<pattern>/velocity.html</pattern>
</decorator>
<decorator name="freemarker" page="freemarker.ftl">
<pattern>/freemarker.html</pattern>
</decorator>
<decorator name="test" page="test.jsp">
<pattern>/agent.jsp</pattern>
</decorator>
</decorators>

<?xml version="1.0" encoding="UTF-8"?>
<!-- 默认目录 -->
<decorators defaultdir="/decorators">
<!-- 缺省装饰页 -->
<decorator name="main" page="main.jsp">
<pattern>/*</pattern>
</decorator>
<!-- 自定义装饰页,我们下面实例就是这部分起作用 -->
<decorator name="mai" page="mai.jsp">
<pattern>/mai.html</pattern>
</decorator>
<!-- 只装饰一个页面也可用这种方式定义 -->
<decorator name="panel" page="panel.jsp"/>
<!-- 装饰velocity模板 -->
<decorator name="velocity" page="velocity.vm">
<pattern>/velocity.html</pattern>
</decorator>
<!-- 装饰freeMarker模板 -->
<decorator name="freemarker" page="freemarker.ftl">
<pattern>/freemarker.html</pattern>
</decorator>
<decorator name="test" page="test.jsp">
<pattern>/agent.jsp</pattern>
</decorator>
</decorators>

下边是对上边中所缺少的一些补充

[html] view plain copy print ?

<?xml version="1.0" encoding="utf-8"?>
<decorators defaultdir="/decorators">
<excludes>
</excludes>
<decorator name="main" page="main.jsp">
<pattern>/*</pattern>
</decorator>
</decorators>

<?xml version="1.0" encoding="utf-8"?>
<decorators defaultdir="/decorators">
<!-- 此处用来定义不需要过滤的页面 -->
<excludes>
</excludes>
<!-- 用来定义装饰器要过滤的页面 -->
<decorator name="main" page="main.jsp">
<pattern>/*</pattern>
</decorator>
</decorators>

1.3 装饰页的创建

在web目录(或者webContent)下创建文件夹decorators，在文件夹中建立mai.jsp文件

[html] view plain copy print ?

<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
/*这里导入了SiteMesh的标签库 */
<%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator" %>
<%@ taglib uri="http://www.opensymphony.com/sitemesh/page" prefix="page" %>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
OK,there is a decorator begin!<hr />
/*这里的意思是，被装饰页的title内容将会在这里插入 */
<decorator:title></decorator:title>
</head>
<body>
/*被修饰页的body内容将在这里插入
<decorator:body></decorator:body>
<hr />Yse,there is a decorator end !
</body>
</html>

<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
/*这里导入了SiteMesh的标签库 */
<%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator" %>
<%@ taglib uri="http://www.opensymphony.com/sitemesh/page" prefix="page" %>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
OK,there is a decorator begin!<hr />
/*这里的意思是，被装饰页的title内容将会在这里插入 */
<decorator:title></decorator:title>
</head>
<body>
/*被修饰页的body内容将在这里插入
<decorator:body></decorator:body>
<hr />Yse,there is a decorator end !
</body>
</html>

1.4 被修饰页的创建

在web目录(或webContent)下创建mai.html

[html] view plain copy print ?

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
this is the Content Page !!!
</body>
</html>

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
this is the Content Page !!!
</body>
</html>

1.5 使用tomcat进行示例运行，访问http://localhost:8080/{your project name}/mai.html ，运行结果如下：

1.6 sitemesh.xml的配置(可选, 示例中没有用到该文件)

该配置文件用于高级元素的配置，有具体需要的可以配置

[html] view plain copy print ?

<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.HTMLPageParser" />
</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 class="com.opensymphony.module.sitemesh.mapper.FrameSetDecoratorMapper">
</mapper>
<mapper class="com.opensymphony.module.sitemesh.mapper.AgentDecoratorMapper">
<param name="match.MSIE" value="ie" />
<param name="match.Mozilla [" value="ns" />
<param name="match.Opera" value="opera" />
<param name="match.Lynx" value="lynx" />
</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.RobotDecoratorMapper">
<param name="decorator" value="robot" />
</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.FileDecoratorMapper">
</mapper>
<mapper class="com.opensymphony.module.sitemesh.mapper.ConfigDecoratorMapper">
<param name="config" value="${decorators-file}" />
</mapper>
</decorator-mappers>
</sitemesh>

<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.HTMLPageParser" />
</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 class="com.opensymphony.module.sitemesh.mapper.FrameSetDecoratorMapper">
</mapper>
<mapper class="com.opensymphony.module.sitemesh.mapper.AgentDecoratorMapper">
<param name="match.MSIE" value="ie" />
<param name="match.Mozilla [" value="ns" />
<param name="match.Opera" value="opera" />
<param name="match.Lynx" value="lynx" />
</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.RobotDecoratorMapper">
<param name="decorator" value="robot" />
</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.FileDecoratorMapper">
</mapper>
<mapper class="com.opensymphony.module.sitemesh.mapper.ConfigDecoratorMapper">
<param name="config" value="${decorators-file}" />
</mapper>
</decorator-mappers>
</sitemesh>

使用总结：整个过程配置是相对简单的，先导入所需资源，然后再配置filter，之后是derator page和content page的创建以及他们之间的映射关系，配置命令是相对简单的，简单的需求上面这些已经足矣。

二：使用示例

2.1 例子1

在{myapp}/WEB-INF/decorators.xml文件中添加以下decorator

[html] view plain copy print ?

<decorator name="mydecorator1" page="mydecorator1.jsp">
<pattern>/test1.jsp</pattern>
</decorator>

<decorator name="mydecorator1" page="mydecorator1.jsp">
<pattern>/test1.jsp</pattern>
</decorator>

在{myapp}/decorators目录下添加mydecorator1.jsp文件，内容如下:

[html] view plain copy print ?

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

<%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator" %>
<html>
<head>
<title>My Site - <decorator:title default="Welcome!" /></title>
<decorator:head />
</head>
<body>
<decorator:body />
<p>This message is in /decorators/mydecorator1.jsp</p>
</body>
</html>

在{myapp}目录下添加test1.jsp文件，内容如下：

[html] view plain copy print ?

<%@page contentType="text/html"%>
<%@page pageEncoding="UTF-8"%>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>This is test1</title>
</head>
<body>
This is test1
</body>
</html>

<%@page contentType="text/html"%>
<%@page pageEncoding="UTF-8"%>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>This is test1</title>
</head>
<body>
<b>This is test1</b>
</body>
</html>

打开浏览器，访问http://localhost:8080/myapp/test1.jsp，将会出现一下内容：

This is test1

This message is in /decorators/mydecorator1.jsp

2.2 例子2（decorator:getProperty）

有时候，我们期望修改页面中某个有固定标记的片段，例如我们的jsp中有一个标记<mytag>...</mytag>，此时可以用如下方法实现：

在{myapp}/WEB-INF/decorators.xml文件中添加以下decorator

[html] view plain copy print ?

<decorator name="mydecorator2" page="mydecorator2.jsp">
<pattern>/test2.jsp</pattern>
</decorator>

<decorator name="mydecorator2" page="mydecorator2.jsp">
<pattern>/test2.jsp</pattern>
</decorator>

在{myapp}/decorators目录下添加mydecorator2.jsp文件，内容如下:

[html] view plain copy print ?

<%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator" %>
<html>
<head>
<title>My Site - <decorator:title default="Welcome!" /></title>
<decorator:head />
</head>
<body>
<decorator:body />
<decorator:getProperty property="page.content1"/>
<decorator:getProperty property="page.content2"/>
<decorator:getProperty property="page.content3"/>
This message is in /decorators/mydecorator2.jsp
</body>
</html>

<%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator" %>
<html>
<head>
<title>My Site - <decorator:title default="Welcome!" /></title>
<decorator:head />
</head>
<body>
<decorator:body />
<decorator:getProperty property="page.content1"/>
<decorator:getProperty property="page.content2"/>
<!-- do nothing -->
<decorator:getProperty property="page.content3"/>
<p>This message is in /decorators/mydecorator2.jsp</p>
</body>
</html>

在{myapp}目录下添加test2.jsp文件，内容如下：

[html] view plain copy print ?

<%@page contentType="text/html"%>
<%@page pageEncoding="UTF-8"%>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>This is test2</title>
</head>
<body>
This is test2
Use <decorator:getProperty> tag
<content tag="content1">This is content1</content>
<content tag="content2">This is content2</content>
<content tag="content4">This is content4, it shouldn't be display</content>
</body>
</html>

<%@page contentType="text/html"%>
<%@page pageEncoding="UTF-8"%>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>This is test2</title>
</head>
<body>
<b>This is test2</b>
<b>Use <decorator:getProperty> tag</b>
<content tag="content1"><p>This is content1</p></content>
<content tag="content2"><p>This is content2</p></content>
<content tag="content4"><p>This is content4, it shouldn't be display</p></content>
</body>
</html>

打开浏览器，访问http://localhost:8080/myapp/test2.jsp，将会出现一下内容：

This is test2

Use <decorator:getProperty> tag

This is content1

This is content2

This message is in /decorators/mydecorator2.jsp

2.3 例子3 （page:applyDecorator tag）

在{myapp}/WEB-INF/decorators.xml文件中添加以下decorator：

[html] view plain copy print ?

<decorator name="mydecorator3" page="mydecorator3.jsp">
<pattern>/test3.jsp</pattern>
</decorator>
<decorator name="mydecorator31" page="mydecorator31.jsp">
</decorator>

<decorator name="mydecorator3" page="mydecorator3.jsp">
<pattern>/test3.jsp</pattern>
</decorator>
<decorator name="mydecorator31" page="mydecorator31.jsp">
</decorator>

在{myapp}/decorators目录下添加mydecorator3.jsp文件，内容如下:

[html] view plain copy print ?

<%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator" %>
<%@ taglib uri="http://www.opensymphony.com/sitemesh/page" prefix="page" %>
<html>
<head>
<title>My Site - <decorator:title default="Welcome!" /></title>
<decorator:head />
</head>
<body>
<decorator:body />
<page:applyDecorator name="mydecorator31">
<content tag="content1">This is content1</content>
<content tag="content2">This is content2</content>
</page:applyDecorator>
</body>
</html>

<%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator" %>
<%@ taglib uri="http://www.opensymphony.com/sitemesh/page" prefix="page" %>
<html>
<head>
<title>My Site - <decorator:title default="Welcome!" /></title>
<decorator:head />
</head>
<body>
<decorator:body />
<page:applyDecorator name="mydecorator31">
<content tag="content1"><p>This is content1</p></content>
<content tag="content2"><p>This is content2</p></content>
</page:applyDecorator>
</body>
</html>

在{myapp}/decorators目录下添加mydecorator31.jsp文件，内容如下:

[html] view plain copy print ?

<%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator" %>
<%@ taglib uri="http://www.opensymphony.com/sitemesh/page" prefix="page" %>
begin</>
<decorator:getProperty property="page.content1"/>
<decorator:getProperty property="page.content2"/>
end</>
在{myapp}目录下添加test3.jsp文件，内容如下：
<%@page contentType="text/html"%>
<%@page pageEncoding="UTF-8"%>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>This is test3</title>
</head>
<body>
This is test3
Use <page:applyDecorator> tag
</body>
</html>

<%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator" %>
<%@ taglib uri="http://www.opensymphony.com/sitemesh/page" prefix="page" %>
<p><i>begin</i></>
<decorator:getProperty property="page.content1"/>
<decorator:getProperty property="page.content2"/>
<p><i>end</i></>
在{myapp}目录下添加test3.jsp文件，内容如下：
<%@page contentType="text/html"%>
<%@page pageEncoding="UTF-8"%>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>This is test3</title>
</head>
<body>
<b>This is test3</b>
<b>Use <page:applyDecorator> tag</b>
</body>
</html>

注意：相对于例子2，这里已经没有了<content tag="XXX"/>标签。

打开浏览器，访问http://localhost:8080/myapp/test3.jsp，将会出现一下内容：

This is test3

Use <page:applyDecorator> tag

begin

This is content1

This is content2

end

这里，我在mydecorator3.jsp中应用了mydecorator31.jsp的的decorator，并且将原来在test2.jsp中的 <content />标签复制到mydecorator3.jsp中，此时对于<content tag="xxx"/>的标签将会由mydecorator31.jsp了装饰。

2.4 例子4（page:parm tag）

在{myapp}/WEB-INF/decorators.xml文件中添加以下decorator:

[html] view plain copy print ?

<decorator name="mydecorator4" page="mydecorator4.jsp">
<pattern>/test4.jsp</pattern>
</decorator>
<decorator name="mydecorator41" page="mydecorator41.jsp">
</decorator>

<decorator name="mydecorator4" page="mydecorator4.jsp">
<pattern>/test4.jsp</pattern>
</decorator>
<decorator name="mydecorator41" page="mydecorator41.jsp">
</decorator>

在{myapp}/decorators目录下添加mydecorator4.jsp文件，内容如下:

[html] view plain copy print ?

<%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator" %>
<%@ taglib uri="http://www.opensymphony.com/sitemesh/page" prefix="page" %>
<html>
<head>
<title>My Site - <decorator:title default="Welcome!" /></title>
<decorator:head />
</head>
<body>
<decorator:body />
<page:applyDecorator name="mydecorator41" >
<content tag="content1">This is content1</content>
<content tag="content2">This is content2</content>
<page:param name="page.content1">This content1 has been replaced</page:param>
</page:applyDecorator>
</body>
</html>

<%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator" %>
<%@ taglib uri="http://www.opensymphony.com/sitemesh/page" prefix="page" %>
<html>
<head>
<title>My Site - <decorator:title default="Welcome!" /></title>
<decorator:head />
</head>
<body>
<decorator:body />
<page:applyDecorator name="mydecorator41" >
<content tag="content1"><p>This is content1</p></content>
<content tag="content2"><p>This is content2</p></content>
<page:param name="page.content1"><p>This content1 has been replaced</p></page:param>
</page:applyDecorator>
</body>
</html>

在{myapp}/decorators目录下添加mydecorator41.jsp文件，内容如下:

[html] view plain copy print ?

<%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator" %>
<%@ taglib uri="http://www.opensymphony.com/sitemesh/page" prefix="page" %>
begin</>
<decorator:getProperty property="page.content1"/>
<decorator:getProperty property="page.content2"/>
end</>

<%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator" %>
<%@ taglib uri="http://www.opensymphony.com/sitemesh/page" prefix="page" %>
<p><i>begin</i></>
<decorator:getProperty property="page.content1"/>
<decorator:getProperty property="page.content2"/>
<p><i>end</i></>

在{myapp}目录下添加test4.jsp文件，内容如下：

[html] view plain copy print ?

<%@page contentType="text/html"%>
<%@page pageEncoding="UTF-8"%>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>This is test4</title>
</head>
<body>
This is test4
Use <page:param> tag
</body>
</html>

<%@page contentType="text/html"%>
<%@page pageEncoding="UTF-8"%>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>This is test4</title>
</head>
<body>
<b>This is test4</b>
<b>Use <page:param> tag</b>
</body>
</html>

打开浏览器，访问http://localhost:8080/myapp/test4.jsp，将会出现一下内容：

This is test4

Use <page:param> tag

begin

This content1 has been replaced

This is content2

end

这里，我在mydecorator4.jsp中应用了mydecorator41.jsp的的decorator，并且添加了<page:param name="page.content1">标签，那么此时页面上将会用<page:param>标签中的内容替换原来在<decorator:getProperty property="page.content1"/>中的内容，因此页面将不在“This is content1”而显示“This content1 has been replaced”

SiteMesh的一个重要特性是使用原始HTML的meta标签（例如<meta name="foo" content="bar">）从基础页面传递信息到装饰器。作为一个例子，下面我们使用一个meta标签来定义HTML页面的作者。

[html] view plain copy print ?

< html >
< meta name = " author " content = " test@example.com " >
< head >
< title > Simple Document </ title >
</ head >
< body >
Hello World !
<%= 1 + 1 %>
</ body >
</ html >

< html >
< meta name = " author "  content = " test@example.com " >
< head >
< title > Simple Document </ title >
</ head >
< body >
Hello World !   < br  />
<%=   1 + 1   %>
</ body >
</ html >

我们定义一个“smart”装饰器来研究meta标签，如果出现这个标签，则可以得到一个相应的HTML：

[html] view plain copy print ?

<% @ taglib uri = " sitemesh-decorator " prefix = " decorator " %>
< decorator:usePage id = " myPage " />
< html >
< head >
< title >
My Site - < decorator:title default = " Welcome! " />
</ title >
< decorator:head />
</ head >
< body >
< h1 >< decorator:title default = " Welcome! " /></ h1 >
< h3 >
< a href = " mailto: <decorator:getProperty property= " meta.author " default= " staff@example.com " /> " >
< decorator:getProperty property = " meta.author " default = " staff@example.com " />
</ a >
</ h3 >
< hr />
< decorator:body />
< small > ( < a href = " /?printable=true " > printable version </ a > ) </ small >
</ body >
</ html >

<% @ taglib uri = " sitemesh-decorator "  prefix = " decorator "   %>
< decorator:usePage id = " myPage "   />
< html >
< head >
< title >
My Site  -   < decorator:title  default = " Welcome! "   />
</ title >
< decorator:head  />
</ head >
< body >
< h1 >< decorator:title  default = " Welcome! "   /></ h1 >
< h3 >
< a href = " mailto: <decorator:getProperty property= " meta.author "   default= " staff@example.com "  /> " >
< decorator:getProperty property = " meta.author "   default = " staff@example.com "   />
</ a >
</ h3 >
< hr  />
< decorator:body  />
< p >
< small >   ( < a href = " /?printable=true " > printable version </ a > )   </ small >
</ p >
</ body >
</ html >

可以看到我们使用了 getProperty标签的一个默认属性——如果没有指定author，我们就设定其为staff。如果你决定使用这个模型储存页面的meta数据，你或许需要和你的开发伙伴一起来确定将使用什么标签以及如何使用他们。简单的，你或许想要使用meta标签来描述诸如页面作者及时间戳之类的东西。更复杂一些，你或许会想像XML文件一样标准化的管理你的站点导航，同时使用meta标签来通过页面节点转到装饰器。

sitemesh 配置

使用的sitemesh包是sitemesh-2.4.jar现将这个包加入到WEB-INF/lib下也可以加入sitemesh-page.tld , sitemesh-decorator.tld两个文件（没有也没有影响）然后在web.xml下配置拦截器代码如下

[html] view plain copy print ?

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
<display-name></display-name>
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
<filter>
<filter-name>sitemesh</filter-name>
<filter-class>com.opensymphony.sitemesh.webapp.SiteMeshFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>sitemesh</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
</web-app>

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
<display-name></display-name>
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
<filter>
<filter-name>sitemesh</filter-name>
<filter-class>com.opensymphony.sitemesh.webapp.SiteMeshFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>sitemesh</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
</web-app>

定义一个decorators.xml 放在WEB-INF根目录下，配置内容提供以下示例

[html] view plain copy print ?

<?xml version="1.0" encoding="UTF-8"?>
<decorators defaultdir="/decorators">
<decorator name="mai" page="mai.jsp">
<pattern>/mai.html</pattern>
</decorator>
</decorators>

<?xml version="1.0" encoding="UTF-8"?>
<decorators defaultdir="/decorators">
<decorator name="mai" page="mai.jsp">
<pattern>/mai.html</pattern>
</decorator>
</decorators>

在WebRoot下面新建一个decorators文件夹然后将装饰页面放在该目录如图所示

mai.jsp.内容如下所示

[html] view plain copy print ?

<%@ page language="java" import="java.util.*" pageEncoding="ISO-8859-1"%>
<%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator" %>
<%@ taglib uri="http://www.opensymphony.com/sitemesh/page" prefix="page" %>
<%
String path = request.getContextPath();
String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/";
%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<base href="<%=basePath%>">
<title>My JSP 'mai.jsp' starting page</title>
<meta http-equiv="pragma" content="no-cache">
<meta http-equiv="cache-control" content="no-cache">
<meta http-equiv="expires" content="0">
<meta http-equiv="keywords" content="keyword1,keyword2,keyword3">
<meta http-equiv="description" content="This is my page">
<!--
<link rel="stylesheet" type="text/css" href="styles.css">
-->
<decorator:title></decorator:title>
</head>
<body>
there is a decorator begin!<hr />
<decorator:body></decorator:body>
hello world <hr/>
</body>
</html>

<%@ page language="java" import="java.util.*" pageEncoding="ISO-8859-1"%>
<%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator" %>
<%@ taglib uri="http://www.opensymphony.com/sitemesh/page" prefix="page" %>
<%
String path = request.getContextPath();
String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/";
%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<base href="<%=basePath%>">
<title>My JSP 'mai.jsp' starting page</title>
<meta http-equiv="pragma" content="no-cache">
<meta http-equiv="cache-control" content="no-cache">
<meta http-equiv="expires" content="0">
<meta http-equiv="keywords" content="keyword1,keyword2,keyword3">
<meta http-equiv="description" content="This is my page">
<!--
<link rel="stylesheet" type="text/css" href="styles.css">
-->
<decorator:title></decorator:title>
</head>
<body>
there is a decorator begin!<hr />
<decorator:body></decorator:body>
hello world <hr/>
</body>
</html>

引入了两个标签库<decorator:title></decorator:title>用来将被装饰页面的title放在此处。<decorator:body></decorator:body>用来将被装饰页面的body内容放在此处。

在WebRoot根目录下面新建一个mai.html 示例内容如下

[html] view plain copy print ?

<!DOCTYPE html>
<html>
<head>
<title>maqiang</title>
<meta http-equiv="keywords" content="keyword1,keyword2,keyword3">
<meta http-equiv="description" content="this is my page">
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
</head>
<body>
This is my HTML page.  
</body>
</html>

<!DOCTYPE html>
<html>
<head>
<title>maqiang</title>
<meta http-equiv="keywords" content="keyword1,keyword2,keyword3">
<meta http-equiv="description" content="this is my page">
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<!--<link rel="stylesheet" type="text/css" href="./styles.css">-->
</head>
<body>
This is my HTML page. <br>
</body>
</html>

这样就ok了

sitemesh 了解相关推荐

SiteMesh介绍
1. SiteMesh简介 SiteMesh是由一个基于Web页面布局.装饰以及与现存Web应用整合的框架.它能帮助我们在由大量页面构成的项目中创建一致的页面布局和外观,如一致的导航条,一致的bann ...
Struts和Sitemesh整合,实现多个装饰器
2019独角兽企业重金招聘Python工程师标准>>> web.xml配置 <filter><filter-name>struts-prepare</f ...
sitemesh排除装饰action的心得
sitemesh装饰模式的强大就不用说了,但使用过程中遇到的最郁闷的莫过于排除装饰action的困扰了,例如使用某个ajax请求要求返回不装饰的数据,但sitemesh却死活给你装饰了,以前用了个小技 ...
Sitemesh排除Exclude不装饰特定页面的解决办法
有时候项目中有些文件不需要Sitemesh装饰,例如Error.htm, Error.jsp, OnlineHelp.htm等等.但是用Sitemesh的Exclude不管用,用Printable也不 ...
sitemesh的使用
由于最近项目的原因,接触到了sitemesh. SiteMesh是一个用来在JSP中实现页面布局和装饰(layout and decoration)的框架组件,能够帮助网站开发人员较容易实现页面中动态 ...
sitemesh官网简介，安装配置教程。（非常适合新手）
新手一枚,最近研究openfire,看到网上资料其页面布局用的是sitemesh,第一次听说,上网查了好多资料,也看了好多博客介绍,觉得好神奇的技术(高手勿喷).不过我也很好奇现在和sitemesh类 ...
SiteMesh：一个优于Apache Tiles的Web页面布局、装饰框架
一.SiteMesh项目简介 OS(OpenSymphony)的SiteMesh是一个用来在JSP中实现页面布局和装饰(layout and decoration) 的框架组件,能够帮助网站开发人员较 ...
struts2.2.1关于sitemesh和freemarker整合的细节
http://nighty.iteye.com/blog/788241 有段时间没有使用struts2了,上了官网发现已经更新到2.2.1版本,没有细看note,照着以前老的方式配置web.xml,发 ...
Struts2整合SiteMesh
http://takeme.iteye.com/blog/1716488 1.导入Struts2的jar 和 sitemesh.jar 和 Struts2-sitemesh-plugin.jar c ...
使用sitemesh建立复合视图 - 1.hello
http://docs.huihoo.com/java/sitemesh/ (作者:chen-neu ,提供给 huihoo.com 发布) 使用sitemesh建立复合视图 - 1.hello & ...

sitemesh 了解

sitemesh2.4

SiteMesh基本用法及示例

sitemesh 配置

sitemesh 了解相关推荐

最新文章

热门文章