SiteMesh

news/2025/3/5 0:18:32/

SiteMesh项目简介

OS(OpenSymphony)的SiteMesh是一个用来在JSP中实现页面布局和装饰(layout and decoration)
的框架组件,能够帮助网站开发人员较容易实现页面中动态内容和静态装饰外观的分离。

Sitemesh是由一个基于Web页面布局、装饰以及与现存Web应用整合的框架。它能帮助我们在由大
量页面构成的项目中创建一致的页面布局和外观,如一致的导航条,一致的banner,一致的版权,等等。
它不仅仅能处理动态的内容,如jsp,php,asp等产生的内容,它也能处理静态的内容,如htm的内容,
使得它的内容也符合你的页面结构的要求。甚至于它能将HTML文件象include那样将该文件作为一个面板
的形式嵌入到别的文件中去。所有的这些,都是GOF的Decorator模式的最生动的实现。尽管它是由java语言来实现的,但它能与其他Web应用很好地集成。

官方:http://www.opensymphony.com/sitemesh/

下载地址:http://www.opensymphony.com/sitemesh/download.action 目前的最新版本是Version 2.3;

为什么要使用SiteMesh?

我们的团队开发J2EE应用的时候,经常会碰到一个比较头疼的问题:

由于Web页面是由不同的人所开发,所以开发出来的界面通常是千奇百怪,通常让项目管理人员苦笑不得。

而实际上,任何一个项目都会要求界面的统一风格和美观,既然风格统一,那就说明UI层肯定有很多可以抽出来
共用的静态或动态部分;如何整合这些通用的静态或动态UI呢?Apache Tiles框架站了出来很好的解决了这一问题,
再加上他与struts的完美集成,导致大小项目都把他作为UI层的首选框架,

但是:

Tiles确实有着它很多的不足之处,下文我会介绍,本文想说的是,除了Apache Tiles框架,其实我们还有更好的解
决方案,那就是:SiteMesh;

本文

介绍了一个基于Web页面的布局、装饰以及应用整合的框架Sitemesh,它能帮助你为你的应用创建一致的外观,
很好的取代Apache Tiles;

SiteMesh VS Apache Tiles

用过struts的朋友应该对Apache Tiles的不会陌生,我曾经有一篇文章介绍过struts中tiles框架的组合与继承,
现在怎么看怎么觉得复杂;

从使用角度来看,Tiles似乎是Sitemesh标签的一个翻版。其实sitemesh最强的
一个特性是sitemesh将decorator模式用在过滤器上。任何需要被装饰的页面都不知道它要被谁装饰,所以它就
可以用来装璜来自php、asp、CGI等产生的页面了。你可以定义若干个装饰器,根据参数动态地选择装饰器,
产生动态的外观以满足你的需求。它也有一套功能强大的属性体系,它能帮助你构建功能强大而灵活的装饰器。
相比较而言,在这方面Tiles就逊色许多。

个人觉得在团队开发里面,Apache Tiles框架会导致所有人不仅仅要了解并且清楚Apache Tiles的存在,
并且要特别熟悉每一个Tiles layout模板的作用,否则就可能出现用错模板的情况;除此之外,每个人涉及到
的所有WEB页面都需要去配置文件里面逐个配置,不仅麻烦出错的几率还高;
而以上所有的不足都是SiteMesh所不存在的;

SiteMesh的基本原理

一个请求到服务器后,如果该请求需要sitemesh装饰,服务器先解释被请求的资源,然后根据配置文件
获得用于该请求的装饰器,最后用装饰器装饰被请求资源,将结果一同返回给客户端浏览器。

如何使用SiteMesh

这里以struts2+spring2+hibernate3构架的系统为例
1、下载SiteMesh
下载地址:http://www.opensymphony.com/sitemesh/download.action 目前的最新版本是Version 2.3;

2、在工程中引入SiteMesh的必要jar包,和struts2-sitemesh-plugin-2.0.8.jar;

3、修改你的web.xml,在里面加入sitemesh的过滤器,示例代码如下:

<!-- sitemesh配置 --><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>

注意过滤器的位置:应该在struts2的org.apache.struts2.dispatcher.ActionContextCleanUp过滤器之后,org.apache.struts2.dispatcher.FilterDispatcher过滤器之前,否则会有问题;

4、在下载的SiteMesh包中找到sitemesh.xml,(\sitemesh-2.3\src\example-webapp\WEB-INF目录下就有)

将其拷贝到/WEB-INF目录下;

5、在sitemesh.xml文件中有一个property结点(如下),该结点指定了decorators.xml在工程中的位置,让sitemesh.xml能找到他;
按照此路径新建decorators.xml文件,当然这个路径你可以任意改变,只要property结点的value值与其匹配就行;
<property name="decorators-file" value="/WEB-INF/sitemesh/decorators.xml"/>

6、在WebRoot目录下新建decorators目录,并在该目录下新建一个模板jsp,根据具体项目风格编辑该模板,
如下示例:我的模板:main.jsp

<%@ page language="java" pageEncoding="UTF-8"%>
<%@taglib prefix="decorator"uri="http://www.opensymphony.com/sitemesh/decorator"%>
<%@taglib prefix="page" uri="http://www.opensymphony.com/sitemesh/page"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<%response.setHeader("Pragma", "no-cache");response.setHeader("Cache-Control", "no-cache");response.setDateHeader("Expires", 0);
%>
<html><head><title><decorator:title default="kangxm test" /></title><!-- 页面Head由引用模板的子页面来替换 --><decorator:head /></head><body id="page-home"><div id="page-total"><div id="page-header"><table width="100%" border="0" cellspacing="0" cellpadding="0"><tr><td><div class="topFunc">我的账户 |退出 </div></td></tr></table></div></div><!-- end header --><!--   Menu Tag begin --><div id="page-menu" style="margin-top: 8px; margin-bottom: 8px;"><div>这里放菜单 </div></div><!--   Menu Tag end --><div id="page-content" class="clearfix"><center><table width="100%" border="0" cellpadding="0" cellspacing="0"><tr><td><decorator:body /><!-- 这里的内容由引用模板的子页面来替换--></td></tr></table></center></div><!-- end content --><div id="page-footer" class="clearfix">这里放页面底部 <!-- end footer --></div><!-- end page --></body>
</html>

这就是个简单的模板,页面的头和脚都由模板里的静态HTML决定了,主页面区域用的是标签;
也就是说凡是能进入过滤器的请求生成的页面都会默认加上模板上的头和脚,然后页面自身的内容将自动放到
<decorator:body />标签所在位置;

<decorator:title default="Welcome to test sitemesh!" />:读取被装饰页面的标题,并给出了默认标题。
<decorator:head />:读取被装饰页面的<head>中的内容;
<decorator:body />:读取被装饰页面的<body>中的内容;

7、说到这里大家就要想了,那如果某个特殊的需求请求路径在过滤器的范围内,但又不想使用模板怎么办?
你总不能这么不讲道理吧!
大家放心吧,SiteMesh早就考虑到这一点了,上面第5步说道的decorators.xml这个时候就起到作用了!

下面是我的decorators.xml:

<?xml version="1.0" encoding="ISO-8859-1"?>
<decorators defaultdir="/decorators"><!-- Any urls that are excluded will never be decorated by Sitemesh --><excludes><pattern>/index.jsp*</pattern><pattern>/login/*</pattern></excludes><decorator name="main" page="main.jsp"><pattern>/*</pattern></decorator>
</decorators>

decorators.xml有两个主要的结点:
decorator结点指定了模板的位置和文件名,通过pattern来指定哪些路径引用哪个模板
excludes结点则指定了哪些路径的请求不使用任何模板

如上面代码,/index.jsp和凡是以/login/开头的请求路径一律不使用模板;

另外还有一点要注意的是:decorators结点的defaultdir属性指定了模板文件存放的目录;

实战感受

刚刚做完一个用到sitemesh的项目,跟以前用tiles框架相比,最大的感受就是简单,系统设计阶段就把模板
文件和sitemesh框架搭好了!哪些页面使用框架哪些不使用,全部都通过UI Demo很快就定义出来了;
在接下来的开发中所有成员几乎感受不到sitemesh的存在,各自仅仅关心自己的模块功能实现。 

七、总结

使用sitemesh给我们带来的是不仅仅是页面结构问题,它的出现让我们有更多的时间去关注底层业务逻辑,
而不是整个页面的风格和结构。它让我们摆脱了大量用include方式复用页面尴尬局面,也避免了tiles
框架在团队开发中的复杂度,它还提供了很大的灵活性以及给我们提供了整合异构Web系统页面的一种方案。

http://www.ppmy.cn/news/464664.html

相关文章

R语言批量裁剪栅格数据

在R语言中&#xff0c;你可以使用raster包来批量裁剪栅格数据。以下是一个简单的示例代码&#xff1a; library(raster) # 设置裁剪区域 clip_area <- extent(xmin, xmax, ymin, ymax) # 根据实际情况设置裁剪区域的坐标范围 # 批量读取栅格数据 files <- list.files(…

计网复习

时延 总时延 排队时延 处理时延 传输时延 传播时延 1. 排队时延分组在路由器的输入队列和输出队列中排队等待的时间&#xff0c;取决于网络当前的通信量&#xff08;输入队列用于排队进入路由器&#xff0c;输出队列用于路由器处理完决定往哪转发后排队发出去&#xff09;。…

2021最常见的网络原理面试题【好文收藏】

推荐视频&#xff1a; 腾讯游戏面试必问的UDP可靠性设计 腾讯T2.3亲身经历分享&#xff0c;腾讯offer的获取之路及linux后台开发学习路线 c/c linux服务器开发学习地址&#xff1a;c/c linux后台服务器高级架构师 1.如何理解 URI&#xff1f; URI, 全称为(Uniform Resourc…

「转发」乡村振兴项目最全实施流程,堪称教科书

值不值得开发&#xff1f; 一、清查开发条件 乡村现有土地、房屋、产业、自然人文等资源&#xff0c;和所在区位、经济、社会等内外部基本条件&#xff0c;决定了项目地开发的核心导向。 乡村项目开发条件6大清查方向 [1]经济发展基础 i 产业基础&#xff1a;现有核心产业及其他…

乡村振兴项目最全实施流程

乡村项目打造的成功关键在于能够创造长足、健康的经济效益&#xff0c;因而具备一定特色产业的村镇&#xff0c;或具备优良的资源、管理、环境、人才、文化、技术等方面的优势的村镇&#xff0c;更加具备发力基础&#xff0c;能够相对容易地通过产业链整合、产业结构升级&#…

摘掉“爆雷”“二房东”的帽子,长租公寓有了新的生存法则

大多数行业的成长轨迹都是一条S型曲线。 启动期被推上风口&#xff0c;然后是资本和创业者的涌入&#xff0c;接下来因为过度疯狂而跌落谷底&#xff0c;最终在洗牌赛后逐渐走向正常的轨道。 按照S型曲线的逻辑&#xff0c;不难将长租公寓进行对号入座&#xff1a; 2016年在…

海外观察丨未来 10 大科技趋势预测全解读(下)

编者按 近年来&#xff0c;世界正经历百年未有之大变局&#xff0c;国际局势深刻演变&#xff0c;世界多极化和经济全球化在曲折中继续发展。 新冠疫情起伏反复&#xff0c;人们比任何时候都期盼依靠科学技术战胜疫情&#xff0c;依靠科技创新来推动经济复苏。随着 5G 进入商…

HTTP 计算机网络笔记

一、HTTP简介 HTTP协议是**Hyper Text Transfer Protocol&#xff08;超文本传输协议&#xff09;**的缩写。HTTP协议工作于客户端-服务端架构为上。浏览器作为HTTP客户端通过URL向HTTP服务端即WEB服务器发送所有请求。Web服务器根据接收到的请求后&#xff0c;向客户端发送响…