简单来讲SiteMesh就是用来做网页母版 Layout分层的。
SiteMesh官方网站给出的最新版本是SiteMesh Version 2.4.1,但是下载不下来!!下载页面NOT FOUND!很囧有木有!无奈只能在findjar.com下载2.4.1的jar包。 或者使用Struts2的sitemesh包2.4.2,这个包是插件struts2-sitemesh-plugin-2.2.1.1.jar所依赖的。
安装使用过程记录:
1.把包扔到WEB-INF/lib下面。
2.修改web.xml文档:
之前:注意filter-class是StrutsPrepareAndExecuteFilter
- <filter>
- <filter-name>struts2</filter-name>
- <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
- </filter>
- <filter-mapping>
- <filter-name>struts2</filter-name>
- <url-pattern>/*</url-pattern>
- </filter-mapping>
- <filter>
- <filter-name>struts-prepare</filter-name>
- <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareFilter</filter-class>
- </filter>
- <filter>
- <filter-name>struts-execute</filter-name>
- <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsExecuteFilter</filter-class>
- </filter>
- <filter>
- <filter-name>sitemesh</filter-name>
- <filter-class>com.opensymphony.sitemesh.webapp.SiteMeshFilter</filter-class>
- </filter>
- <!--sitemesh in the middle and after struts-prepare -->
- <filter-mapping>
- <filter-name>struts-prepare</filter-name>
- <url-pattern>/*</url-pattern>
- </filter-mapping>
- <filter-mapping>
- <filter-name>sitemesh</filter-name>
- <url-pattern>/*</url-pattern>
- </filter-mapping>
- <filter-mapping>
- <filter-name>struts-execute</filter-name>
- <url-pattern>/*</url-pattern>
- </filter-mapping>
注释下面的代码顺序很重要sitemesh的过滤器要在prepare和execute之间。
3. 在WEB-INF下添加decorators.xml文档:
- <?xml version="1.0" encoding="utf-8"?>
- <!-- defaultdir指定装饰器文件所在的路径 -->
- <decorators defaultdir="/layout">
- <!--excludes结点则指定了哪些路径的请求不使用任何模板 -->
- <excludes>
- <pattern>/entpLogin.jsp</pattern>
- <pattern>/entpRegister.jsp*</pattern>
- <pattern>/messageDiv*</pattern>
- <pattern>/registerServiceDetail*</pattern>
- </excludes>
- <!--decorator结点指定了模板的位置和文件名,通过pattern来指定哪些路径引用哪个模板 -->
- <decorator name="main" page="mode.jsp">
- <pattern>/*</pattern>
- </decorator>
- </decorators
decorator标签的page指定的是装饰母版页。至于<pattern>/messageDiv*</pattern>和<pattern>/registerServiceDetail*</pattern> 是我在页面中使用Struts Ajax主题是指定的action(用来局部刷新的),这样sitemesh就不对这些ajax返回的response进行装饰
4.编写母版mode.jsp
- <%@ page language="java" contentType="text/html; charset=UTF-8"
- pageEncoding="UTF-8"%>
- <%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator"
- prefix="decorator"%>
- <%@ taglib uri="http://www.opensymphony.com/sitemesh/page" prefix="page"%>
- <%@ taglib prefix="s" uri="/struts-tags"%>
- <%@ taglib prefix="sx" uri="/struts-dojo-tags"%>
- <!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">
- <link rel="stylesheet" type="text/css" href="css/style.css"
- media="screen">
- <title>
- <decorator:title default="Welcome" /> <!--被装饰页面的Title-->
- </title>
- <sx:head />
- <decorator:head /><!--被装饰页面的head-->
- </head>
- <body>
- <decorator:body /><!--被装饰页面的body-->
- </body>
- </html>
Ok啦 这样除了在decorator.xml中exclude的请求之外,所有的请求页面都会被装饰了,可以在<decorator:body /> 之前增加header,导航条,之后增加footer之类的东西啦!
注意:如果在页面中增加了ajax主题的标签(局部刷新),则一定要在exclude pattern中添加请求的action名,否则局部刷新得到的innerHtml也会被添加上header导航条footer等装饰元素