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> |
<%@ 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> |
- 打開瀏覽器,訪問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> |
<%@ 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 |