无线&移动互联网技术研发

换位思考·····
posts - 19, comments - 53, trackbacks - 0, articles - 283
  BlogJava :: 首页 :: 新随笔 :: 联系 :: 聚合  :: 管理

SiteMesh 入门实例

Posted on 2010-05-11 21:45 Gavin.lee 阅读(1164) 评论(0)  编辑  收藏 所属分类: SiteMesh 页面装饰组件

一、SiteMesh设计思想

用户发送request至服务器,服务器根据此request生成动态数据,生成网页,准备返回给客户端。就在返回前,SiteMesh进行拦截,对此网页进行解析,将title、body等部分拆解出来,套上模板后,再返回给客户端。由于SiteMesh在返回客户端的最后一步工作,此时的网页已经具备了标准的html网页格式,因此SiteMesh只需解析标准的html网页,无需考虑各个Web应用是应用了JSP、ASP,还是Velocity技术,相当灵活。
    SiteMesh官方地址:http://www.opensymphony.com/sitemesh/index.html
    SiteMesh官方下载:http://www.opensymphony.com/sitemesh/download.html
    SiteMesh 2.3下载:http://www.javauu.com/downloads/resource/sitemesh-2.3.zip

二、SiteMesh简单部署到实现

配置:
除了要copy到WEB-INF/lib中的sitemesh.jar外,还有2个文件要建立到WEB-INF/:
sitemesh.xml (可选)  
decorators.xml
sitemesh.xml 可以设置2种信息:
1.Page Parsers :负责读取stream的数据到一个Page对象中以被SiteMesh解析和操作。(不太常用,默认即可)
2.Decorator Mappers : 不同的装饰器种类,我发现2种比较有用都列在下面。一种通用的mapper,可以指定装饰器的配置文件名,另一种可打印的装饰器,可以允许你当用http://localhost/aaa/a.html?printable=true方式访问时给出原始页面以供打印(免得把header,footer等的花哨的图片也搭上)

(但一般不用建立它,默认设置足够了:com/opensymphony/module/sitemesh/factory/sitemesh-default.xml), 范例如下:

<sitemesh>
     
<page-parsers>
       
<parser default="true" class="com.opensymphony.module.sitemesh.parser.DefaultPageParser" />
       
<parser content-type="text/html" class="com.opensymphony.module.sitemesh.parser.FastPageParser" />
       
<parser content-type="text/html;charset=ISO-8859-1" class="com.opensymphony.module.sitemesh.parser.FastPageParser" />
     
</page-parsers>

     
<decorator-mappers>
       
<mapper class="com.opensymphony.module.sitemesh.mapper.ConfigDecoratorMapper">
         
<param name="config" value="/WEB-INF/decorators.xml" />
       
</mapper>
         
<mapper class="com.opensymphony.module.sitemesh.mapper.PrintableDecoratorMapper">
            
<param name="decorator" value="printable" />
            
<param name="parameter.name" value="printable" />
            
<param name="parameter.value" value="true" />
         
</mapper>
  
</decorator-mappers>
</sitemesh> 


实现:
这里定义了一个过滤器.所有的请求都交由sitemesh来处理,在web.xml中加入如下片段:

<filter>   
    
<filter-name>sitemeshfilter-name>   
    
<filter-class>com.opensymphony.module.sitemesh.filter.PageFilterfilter-class>   
<filter>   
   
<filter-mapping>   
    
<filter-name>sitemeshfilter-name>   
    
<url-pattern>/*url-pattern>   
<filter-mapping>   
   
<taglib>   
    
<taglib-uri>sitemesh-decoratortaglib-uri>   
    
<taglib-location>/WEB-INF/sitemesh-decorator.tldtaglib-location>   
<taglib>   
   
<taglib>   
    
<taglib-uri>sitemesh-pagetaglib-uri>   
    
<taglib-location>/WEB-INF/sitemesh-page.tldtaglib-location>   
<taglib>

 
建立WEB-INF/decorators.xml描述各装饰器页面。

<decorators defaultdir="/_decorators">  
    
<decorator name="main" page="main.jsp">         
        
<pattern>*pattern>     
    
<decorator>
    
    
<!-- 不需要装饰的目录 -->
    
<excludes>
        
<pattern>/public/*</pattern>
    
</excludes> 
    
    
<!-- 需要装饰的目录 -->
    
<decorator name="inside" page="inside.jsp" role="custom" webapp="client">
        
<pattern>/admin/*</pattern>
        
<pattern>/user/*</pattern>
    
</decorator>
<decorators>

各标签常见属性的含义为:
defaultdir: 包含装饰器页面的目录
page : 页面文件名
name : 别名
role : 角色,用于安全
webapp : 可以另外指定此文件存放目录
Patterns : 匹配的路径,可以用*,那些被访问的页面需要被装饰


 在web下面建一个文件夹取名decorators.在decoratots下面创建上面定义的模板页面main.jsp,内容如下:

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
    
<head>
       
<title><decorator:title default="默认title" /></title>
    
<body>
        
<h2>SiteMesh装饰header</h2>        
        
<p>Add head decorator</p>
        
<decorator:body />    
        
<p>Add foot decorator</p>
        
<h2>SiteMesh装饰footer</h2>
    
</body>
</html>

说明:

<%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator"%>

此处为decorator标签的声明。因为我们下面要使用到它

<decorator:title />

把请求的原始页面的title内容插入到<title></title>,比如我们要请求index.jsp页面的时候。会把index.jsp中的title的内容放入到这里

<decorator:body />


把请求的原始页面的body内容插入到<body></body>,发现没有我们在这句的前面加上了<p>Add head decorator...</p>和<p>Add foot decorator...</p>

相当于给我们请求的页面的body内容加上了头部和尾部.实现了模板功能。


在WEB-INF下创建我们要请求访问的页面index.jsp,内容如下:

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
    
<head>
       
<title>SiteMesh Sample Site</title>
    
</head>
    
<body>
       Welcome to the SiteMesh sample
    
</body>
</html>

把web工程部署到tomcat容器中。

输入http://localhost:8080/SitemeshSample/index.jsp


页面效果如下:

Add head decorator
Welcome to the SiteMesh sample 
Add foot decorator


不难发现,我们index.jsp中只有Welcome to the SiteMesh sample... 一句。但是在返回给我们之前套上了main.jsp模板页。在它的前面和后面分别加上了一句话。通过Sitemesh我们可以很容易实现页面中动态内容和静态装饰外观的分离。


只有注册用户登录后才能发表评论。


网站导航: