SiteMesh使用


什么是SiteMesh?
    SiteMesh是OpenSymphony下的一个项目,是基于PageFilter,Servlet过滤器的通用组件.



SiteMesh为我们带来什么?
    我們可以想像一下,当我们的应用程序有大量的页面时候,为每个页面include我们各种各样的标签库,引入的js和css等样式,这将会成为重复性的工作,而且只要其中一个标签库进行了更新升级,所有页面的标签声明都需要重新更改,这项工作无疑是恐怖而且毫无技术含量的,SiteMesh就是为了帮助我们解决这个问题,把共有的标签例如js,css,struts-tags等重复性的声明抽象到一个页面当中,从而实现集中处理,增加维护性和解除页面间的耦合.



SiteMesh原理:
    SiteMesh应用了Decorator模式,用filter截取request和response,把页面组件head,content,banner结合为一个完整的视图。通常我们都是用include标签在每个jsp页面中来不断的包含各种header, stylesheet, scripts and footer,现在,在SiteMesh的帮助下,我們可以不再编写那些重复性的代码,从而集中在一个地方进行管理.容器接收到页面请求时,会把请求传递给PageFilter,PageFilter收集应用程序的响应细节,生成自定义的响应对象,然后连同请求一起传递给web应用程序.web应用程序把响应资源写入到自定义响应对象里,再返回给PageFilter.



SiteMesh使用:
    本事例使用基于Struts2来进行编写
    1.首先在我们的项目当中添加Maven的依赖

<dependency>
	<groupId>opensymphony</groupId>
	<artifactId>sitemesh</artifactId>
	<version>2.4.2</version>
	<type>jar</type>
	<scope>compile</scope>
</dependency>

<dependency>
	<groupId>org.apache.struts</groupId>
	<artifactId>struts2-sitemesh-plugin</artifactId>
	<version>2.2.3</version>
	<type>jar</type>
	<scope>compile</scope>
</dependency>


    2.在web.xml文件中增加如下配置
<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>*.action</url-pattern>
	<dispatcher>REQUEST</dispatcher>
	<dispatcher>FORWARD</dispatcher>
	<dispatcher>INCLUDE</dispatcher>
</filter-mapping>


    3.在WEB-INF建立decorators.xml,该文件描述各个装饰器页面和如何过滤页面
<?xml version="1.0" encoding="UTF-8"?>


<!-- defaultdir 属性为通用页面存放的路径 -->
<decorators defaultdir="/WEB-INF/content/base">
	
	<!-- excludes 为哪些页面不需要进行装饰,这通常结合popup来使用 -->
	<excludes>
		<pattern>*no-decorate*</pattern>
		<pattern>/login*</pattern>
	</excludes>
	
	<!-- decorator为指定装饰页面的名称和路径 -->
	<decorator name="main" page="main.jsp">
		<!-- pattern 为要过滤哪些页面? * 代表所有页面都进行过滤-->
		<pattern>*</pattern>
	</decorator>
	
	<decorator name="printable" page="printable.jsp"/>
</decorators>

     以下为main.jsp代码
<!-- 
	当使用了SiteMesh后,本页面main.jsp就会变成所有页面的模板
	我们可以在这个页面中引入各种的css,js和其他的页面,
	亦可以在这里使用jsp的include标签引入其他的页面,
	更甚者可以在这里设定全局的js,例如jQuery的$.(document).ajaxStart(function(){})
 -->
<html>
<head>
	<!-- decorator:title可以将被过滤的页面的title填充到这里 -->
	<title><decorator:title/></title>
	<!-- decorator:head 可以将被过滤的页面中的head填充到这里 -->
	<decorator:head />
</head>
<body>
<div class="content">
	<!-- decorator:head 可以将被过滤的页面中的body填充到这里 -->
	<decorator:body /> 
</div>


总结:
    使用了SiteMesh后,更集中的管理了各個頁面的标签,css,js的引入,虽然在实际开发当中一般会首先固定各个技术使用的版本,但由于需求的变更和技术的更新发展,有时候不得不更新所使用的版本,大量分散在不同页面的引入标签修改起来简直就是噩梦般的事情,而且SiteMesh的简单易用,我们何乐而不为的去使用SiteMesh呢?

   

你可能感兴趣的:(Web,sitemesh)