一,基本概念
1,Sitemesh是一种页面装饰技术 :
None.gif 1  :它通过过滤器(filter)来拦截页面访问
None.gif
2  :根据被访问页面的URL找到合适的装饰模板
None.gif
3  :提取被访问页面的内容,放到装饰模板中合适的位置
None.gif
4  :最终将装饰后的页面发送给客户端。None.gif
2,在sitemesh中,页面分为两种:装饰模板和普通页面。
1)装饰模板,是指用于修饰其它页面的页面。
2)普通页面,一般指各种应用页面。
3,接下来,我们通过一个简单的例子来说明一下sitemesh修饰网页的基本原理。
二,模板修饰网页的原理

pagecutomize2.gif

pagecutomize3.gif

pagecutomize4.gif

通过Sitemesh的注册机制,告诉Sitemesh,当访问该路径时使用XXX模板(假定使用前面那个模板)来修饰被访问页面。

pagecutomize5.gif

当用户在左边导航栏点击“戏说长城”( /ShowGreatWall.do)时,右边的“戏说长城”页面将会被指定的模板修饰

pagecutomize6.gif

总结上面过程,Sitemesh修饰网页的基本原理,可以通过下面来说明:

pagecutomize7.gif

三,Sitemesh的配置与使用
1)WEB-INF/web.xml中加入filter定义与sitemesh的taglib定义
None.gif       < filter >
None.gif          
< filter - name > sitemesh </ filter - name >
None.gif          
< filter - class > com.opensymphony.module.sitemesh.filter.PageFilter </ filter - class >
None.gif     
</ filter >
None.gif     
< filter - mapping >
None.gif          
< filter - name > sitemesh </ filter - name >
ExpandedBlockStart.gifContractedBlock.gif          
< url - pattern > /**/ /*</url-pattern>
InBlock.gif     </filter-mapping>
InBlock.gif
InBlock.gif     <taglib>
InBlock.gif          <taglib-uri>sitemesh-decorator</taglib-uri>
InBlock.gif          <taglib-location>/WEB-INF/sitemesh-decorator.tld</taglib-location>
InBlock.gif     </taglib>
InBlock.gif     <taglib>
InBlock.gif          <taglib-uri>sitemesh-page</taglib-uri>
InBlock.gif          <taglib-location>/WEB-INF/sitemesh-page.tld</taglib-location>
InBlock.gif     </taglib> 
2)创建WEB-INF/decorators.xml,在该文件中配置有哪些模板,以及每个模板具体修饰哪些URL,另外也可以配置哪些URL不需要模板控制 , decorators.xml的一个例子如下:
None.gif < excludes >
None.gif
< pattern > /Login* </ pattern >
None.gif
</ excludes >
None.gif
None.gif
< decorators  defaultdir ="/decorators" >
None.gif    
< decorator  name ="main"  page =“DecoratorMainPage.jsp">
None.gif        
<pattern > /* </ pattern >  
None.gif    
</ decorator >
None.gif
None.gif    
< decorator  name =“pop"  page =“PopPage.jsp">
None.gif        
<pattern > /showinfo.jsp* </ pattern >
None.gif        
< pattern >
None.gif              /myModule/GreatWallDetailAction.do*
None.gif        
</ pattern >
None.gif    
</ decorator >
None.gif
</ decorators >
3)我们看一个修饰模板的例子
None.gif < %@page  contentType ="text/html;?charset=GBK" % >
None.gif
< %@taglib  uri ="sitemesh-decorator" ?prefix ="decorator"  % >
None.gif
None.gif
< html >
None.gif    
< head >
None.gif         
< title > < decorator:title /> </ title >
None.gif         
<decorator:head/>
None.gif    
</ head >
None.gif
None.gif    
< body >
None.gif        Hello World  
< hr />
None.gif        
<decorator:body/>
None.gif    
</ body >
None.gif
</ html >  
4)我们看一个被修饰的页面的例子:
None.gif < %@ page  contentType ="text/html;?charset=GBK" % >
None.gif
< html >
None.gif    
< head >
None.gif        
< title > Hello World </ title >
None.gif    
</ head >
None.gif
None.gif    
< body >
None.gif        
< p > Decorated page goes here. </ p
None.gif    </body
>
None.gif
</ html >  
5)我们看一下装饰模板中可以使用的Sitemesh标签 
None.gif < decorator:head  />
 取出被装饰页面的head标签中的内容。
None.gif < decorator:body  />
取出被装饰页面的body标签中的内容。
None.gif < decorator:title  default ="dot.gif"    />
取出被装饰页面的title标签中的内容。default为默认值
None.gif < decorator:getProperty  property ="dot.gif"  default ="dot.gif"   writeEntireProperty ="dot.gif" />
取出被装饰页面相关标签的属性值。
None.gif writeEntireProperty表明,是显示属性的值还是显示“属性=值”
Html标签的属性
Body标签的属性
Meta标签的属性
None.gif 注意如果其content值中包含“>或 < ”会报错,需转码,例如&lt ;等等
default是默认值
None.gif < decorator:usePage  id ="dot.gif"   />
  将被装饰页面构造为一个对象,可以在装饰页面的JSP中直接引用
6)看一个在装饰模板中使用标签的例子
None.gif < html  lang =“ <decorator:getProperty  property =‘lang’/> ”>
None.gif    
<head >
None.gif        
< title >   <decorator:title default=“你好”  /> </ title >
None.gif        
<decorator:head />
None.gif    
</ head >
None.gif    
None.gif    
< body  <decorator:getProperty property=“body.onload" writeEntireProperty =“1"/> >
None.gif         
从meta中获取变量company的名称:
None.gif             <decorator:getProperty property
=“meta.company”/>
None.gif
None.gif            
下面是被修饰页面的body中的内容:
None.gif             <decorator:body 
/>
None.gif
None.gif         
<decorator:usePage id=“myPage" />
None.gif
None.gif         
<%=myPage.getRequest().getAttribute(“username”)%>
None.gif    
</ body >
None.gif
</ html >
7)看一下相应的在被修饰页面中的代码:
None.gif < html  lang =“en”>
None.gif    
<head >
None.gif        
< title > 我的sitemesh </ title >
None.gif        
< meta  name =“company”  content =“smartdot”/>
None.gif        
<meta name =“Author”  content =“zhangsan”/>
None.gif        
<script >
None.gif             function count(){return 10;}
None.gif        
</ script >
None.gif    
</ head >
None.gif
None.gif    
< body  onload =“count()”>
None.gif         
<p > 这是一个被修饰页面 </ p >
None.gif    
</ body >
None.gif
</ html >
四,总结

1,Sitemesh最为重要的就是做用于修饰的模板,并在decorators.xml中配置这些模板用于修饰哪些页面。因此使用Sitemesh的主要过程就是: 做装饰模板,然后 在decorators.xml中配置URL Pattern

2,分析整个工程,看哪些页面需要抽象成模板,例如二级页面、三级页面、弹出窗口等等可能都需要做成相应的模板,一般来说,一个大型的OA系统,模板不会超过8个。
 
— — —— — — — — — — — — — — — — — — — — — — — — —
如果某个特殊的需求请求路径在过滤器的范围内,但又不想使用模板怎么办?
你总不能这么不讲道理吧!
        大家放心吧,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属性指定了模板文件存放的目录;