com.opensymphony.module.sitemesh.filter.pagefilter作用?
1.sitemesh简介
sitemesh是由一个基于web页面布局、装饰以及与现存web应用整合的框架。它能帮助我们在由大量页面构成的项目中创建一致的页面布局和外 观,如一致的导航条,一致的banner,一致的版权,等等。它不仅仅能处理动态的内容,如jsp,php,asp等产生的内容,它也能处理静态的内容, 如htm的内容,使得它的内容也符合你的页面结构的要求。甚至于它能将html文件象include那样将该文件作为一个面板的形式嵌入到别的文件中去。 所有的这些,都是gof的decorator模式的最生动的实现。尽管它是由java语言来实现的,但它能与其他web应用很好地集成。
2.与strust tiles比较
从使用角度来看,tiles似乎是sitemesh标签<page:applydecorator>的一个翻版。其实sitemesh 最强的一个特性是sitemesh将decorator模式用在过滤器上。任何需要被装饰的页面都不知道它要被谁装饰,所以它就可以用来装璜来自php、 asp、cgi等产生的页面了。你可以定义若干个装饰器,根据参数动态地选择装饰器,产生动态的外观以满足你的需求。它也有一套功能强大的属性体系,它能 帮助你构建功能强大而灵活的装饰器。相比较而言,在这方面tiles就逊色许多。
3.基本原理
一个请求到服务器后,如果该请求需要sitemesh装饰,服务器先解释被请求的资源,然后根据配置文件获得用于该请求的装饰器,最后用装饰器装饰被请求资源,将结果一同返回给客户端浏览器。
下边是由jsp和cgi产生的两个页面,它们通过sitemesh装饰后,形成了一致的用户界面。
原理图:
![](http://www.189works.com/data/attachment/portal/et2/201208/ET36952110929491.png)
4.简单例子
环境说明:
windows2k+、tomcat4.0+
1.安装:
将sitemesh-2.1.jar复制到lib目录下;修改web.xml文件,也就是在web.xml中加入粗倾体标记的部分;
<?xml version="1.0" encoding="gb2312"?>
<! doctype web-app public "-//sun microsystems, inc.//dtd web application 2.3//en" "http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>
<filter>
<filter-name>sitemesh</filter-name>
<filter-lass>com.opensymphony.module.sitemesh.filter.pagefilter</filter-class></filter>
<filter-mapping>
<filter-name>sitemesh</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
</web-app>
2.建立一个目录,名字叫decorators,当然你也可以取别的,用于放装饰器(也就是一个使用了sitemesh标签的jsp文件)用;
3.定义一个你的模板并把它放到decorators目录下,我的文体名称叫:mymain.jsp文件内容如下:
<%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator" %>
<%@ taglib uri="http://www.opensymphony.com/sitemesh/page" prefix="page" %>
<html>
<head>
<meta http-equiv="content-language" content="zh-cn">
<meta http-equiv="content-type" content="text/html; charset=gb2312">
<meta name="generator" content="microsoft frontpage 4.0">
<meta name="progid" content="frontpage.editor.document">
<title>ap - <decorator:title default="welcome to architecture pub!" />
</title>
<decorator:head />
</head>
< body><table border="0" cellpadding="2" width="100%" height= "151"> <tr> <td width="20%" height="74"> <p align="center"><font color="#000080" size="5">test sitemesh< /font></td> <td width="73%" height="74"></td> </tr> <tr><td width="20%" height="28" bgcolor="#f3f3f3" valign="top" >
<page:applydecorator page="/menu.jsp" name="panel" />
</td> <td width="73%" height="28" bgcolor="#bed6fa">
<decorator:body />
< /td> </tr> <tr> <td width="100%" height="31" colspan="2" bgcolor="#f1f0ed"> <p align="center">powered by gagaghost</td> </tr></table></body>< /html>
说明:
<decorator:title default="welcome to test sitemesh!" />:读取被装饰页面的标题,并给出了默认标题。
<decorator:head />:读取被装饰页面的<head>中的内容;
<page:applydecorator page="/menu.jsp" name="panel" />:把menu.jsp文件用panel指定的装饰器装饰,并把结果插入到该位置;
<decorator:body />:读取被装饰页面的<body>中的内容;
当然还有很多的标签,这里不再详细描述。
4.在docorators.xml文件里配置刚写好的模板mymain.jsp,内容如下:
<?xml version="1.0" encoding="iso-8859-1"?>
<decorators defaultdir="/decorators">
<decorator name="main" page="mymain.jsp">
<pattern>/*</pattern>
</decorator>
<decorator name="panel" page="panel.jsp"/>
<decorator name="printable" page="printable.jsp"/>
</decorators>
这里我是把对所有的请求都用mymail.jsp来装饰。
5.好了,run一下你的“小板凳”!你会看到如下结果:
5.总结
使用sitemesh给我们带来的是不仅仅是页面结构问题,它的出现让我们有更多的时间去关注底层业务逻辑,而不是整个页面的风格和结构。它让我们 摆脱了大量用include方式复用页面尴尬局面,它也提供了很大的灵活性以及给我们提供了整合异构web系统页面的一种方案。我们期望它在未来的版本中 会有更多的特性出现。
6.参考资料
http://www.opensymphony.com/
环境说明:
windows2k+、tomcat4.0+
1.安装:
将sitemesh-2.1.jar复制到lib目录下;修改web.xml文件,也就是在web.xml中加入粗倾体标记的部分;
<?xml version="1.0" encoding="gb2312"?>
<! doctype web-app public "-//sun microsystems, inc.//dtd web application 2.3//en" "http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>
<filter>
<filter-name>sitemesh</filter-name>
<filter-lass>com.opensymphony.module.sitemesh.filter.pagefilter</filter-class></filter>
<filter-mapping>
<filter-name>sitemesh</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
</web-app>
2.建立一个目录,名字叫decorators,当然你也可以取别的,用于放装饰器(也就是一个使用了sitemesh标签的jsp文件)用;
3.定义一个你的模板并把它放到decorators目录下,我的文体名称叫:mymain.jsp文件内容如下:
<%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator" %>
<%@ taglib uri="http://www.opensymphony.com/sitemesh/page" prefix="page" %>
<html>
<head>
<meta http-equiv="content-language" content="zh-cn">
<meta http-equiv="content-type" content="text/html; charset=gb2312">
<meta name="generator" content="microsoft frontpage 4.0">
<meta name="progid" content="frontpage.editor.document">
<title>ap - <decorator:title default="welcome to architecture pub!" />
</title>
<decorator:head />
</head>
< body><table border="0" cellpadding="2" width="100%" height= "151"> <tr> <td width="20%" height="74"> <p align="center"><font color="#000080" size="5">test sitemesh< /font></td> <td width="73%" height="74"></td> </tr> <tr><td width="20%" height="28" bgcolor="#f3f3f3" valign="top" >
<page:applydecorator page="/menu.jsp" name="panel" />
</td> <td width="73%" height="28" bgcolor="#bed6fa">
<decorator:body />
< /td> </tr> <tr> <td width="100%" height="31" colspan="2" bgcolor="#f1f0ed"> <p align="center">powered by gagaghost</td> </tr></table></body>< /html>
说明:
<decorator:title default="welcome to test sitemesh!" />:读取被装饰页面的标题,并给出了默认标题。
<decorator:head />:读取被装饰页面的<head>中的内容;
<page:applydecorator page="/menu.jsp" name="panel" />:把menu.jsp文件用panel指定的装饰器装饰,并把结果插入到该位置;
<decorator:body />:读取被装饰页面的<body>中的内容;
当然还有很多的标签,这里不再详细描述。
4.在docorators.xml文件里配置刚写好的模板mymain.jsp,内容如下:
<?xml version="1.0" encoding="iso-8859-1"?>
<decorators defaultdir="/decorators">
<decorator name="main" page="mymain.jsp">
<pattern>/*</pattern>
</decorator>
<decorator name="panel" page="panel.jsp"/>
<decorator name="printable" page="printable.jsp"/>
</decorators>
这里我是把对所有的请求都用mymail.jsp来装饰。
5.好了,run一下你的“小板凳”!你会看到如下结果:
5.总结
使用sitemesh给我们带来的是不仅仅是页面结构问题,它的出现让我们有更多的时间去关注底层业务逻辑,而不是整个页面的风格和结构。它让我们 摆脱了大量用include方式复用页面尴尬局面,它也提供了很大的灵活性以及给我们提供了整合异构web系统页面的一种方案。我们期望它在未来的版本中 会有更多的特性出现。
6.参考资料
http://www.opensymphony.com/