mesh-site 例子
例子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”。
SiteMesh的一个重要特性是使用原始HTML的meta标签（例如<meta name="foo" content="bar">）从基础页面传递信息到装饰器。作为一个例子，下面我们使用一个meta标签来定义HTML页面的作者。
<
html
>
< meta name = " author " content = " [email protected] " >
< head >
< title > Simple Document </ title >
</ head >
< body >
Hello World ! < br />
<%= 1 + 1 %>
</ body >
</ html >
< meta name = " author " content = " [email protected] " >
< head >
< title > Simple Document </ title >
</ head >
< body >
Hello World ! < br />
<%= 1 + 1 %>
</ body >
</ html >
我们定义一个“smart”装饰器来研究meta标签，如果出现这个标签，则可以得到一个相应的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= " [email protected] " /> " >
< decorator:getProperty property = " meta.author " default = " [email protected] " />
</ 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标签来通过页面节点转到装饰器。
< 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= " [email protected] " /> " >
< decorator:getProperty property = " meta.author " default = " [email protected] " />
</ a >
</ h3 >
< hr />
< decorator:body />
< p >
< small > ( < a href = " /?printable=true " > printable version </ a > ) </ small >
</ p >
</ body >
</ html >