SiteMesh参考
作者：kongxx (kongxx@gmail.com)安装
- 首先从sitemesh下载安装包，这里使用的是2.2.1版本。
- 创建一个Web应用程序，这里我创建一个名为myapp的Web应用程序；
- 复制sitemesh-2.2.1.jar文件到{myapp}/WEB-INF/lib目录下；
- 编辑{myapp}/WEB-INF/web.xml文件
| <?xml version="1.0" encoding="UTF-8"?> <web-app xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd" version="2.4"> <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> <session-config> <session-timeout> 30 </session-timeout> </session-config> <welcome-file-list> <welcome-file> index.jsp </welcome-file> </welcome-file-list> </web-app> |
添加蓝色高亮部分。
- 在{myapp}/WEB-INF/目录下创建decorators.xml文件，并且输入一下内容
| <?xml version="1.0" encoding="ISO-8859-1"?> <decorators defaultdir="/decorators"> <decorator name="main" page="main.jsp"> <pattern>/*</pattern> </decorator> <decorator name="panel" page="panel.jsp"/> <decorator name="printable" page="printable.jsp"/> </decorators> |
- 安装完毕。
例子1
- 在{myapp}/WEB-INF/decorators.xml文件中添加以下decorator
| <decorator name="mydecorator1" page="mydecorator1.jsp"> <pattern>/test1.jsp</pattern> </decorator> |
- 在{myapp}/decorators目录下添加mydecorator1.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> <decorator:body /> <p>This message is in /decorators/mydecorator1.jsp</p> </body> </html> |
- 在{myapp}目录下添加test1.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 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 (decorator:getProperty tag)
有时候，我们期望修改页面中某个有固定标记的片段，例如我们的jsp中有一个标记<mytag>...</mytag>，此时可以用如下方法实现：
- 在{myapp}/WEB-INF/decorators.xml文件中添加以下decorator
| <decorator name="mydecorator2" page="mydecorator2.jsp"> <pattern>/test2.jsp</pattern> </decorator> |
- 在{myapp}/decorators目录下添加mydecorator2.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> <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文件，内容如下：
| <%@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 |
例子3 (page:applyDecorator tag)
- 在{myapp}/WEB-INF/decorators.xml文件中添加以下decorator
| <decorator name="mydecorator3" page="mydecorator3.jsp"> <pattern>/test3.jsp</pattern> </decorator> <decorator name="mydecorator31" page="mydecorator31.jsp"> </decorator> |
- 在{myapp}/decorators目录下添加mydecorator3.jsp文件，内容如下:
| <%@ 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文件，内容如下:
| <%@ 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了装饰。
例子4 (page:param tag)
- 在{myapp}/WEB-INF/decorators.xml文件中添加以下decorator
| <decorator name="mydecorator4" page="mydecorator4.jsp"> <pattern>/test4.jsp</pattern> </decorator> <decorator name="mydecorator41" page="mydecorator41.jsp"> </decorator> |
- 在{myapp}/decorators目录下添加mydecorator4.jsp文件，内容如下:
| <%@ 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文件，内容如下:
| <%@ 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文件，内容如下：
| <%@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
”。