`
willdomybest
  • 浏览: 17671 次
  • 性别: Icon_minigender_1
  • 来自: 北京
社区版块
存档分类
最新评论

sitemash原理与配置应用

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

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

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

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

三，Sitemesh的配置与使用
1）WEB-INF/web.xml中加入filter定义与sitemesh的taglib定义 

<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>       <taglib>           <taglib-uri>sitemesh-decorator</taglib-uri>           <taglib-location>/WEB-INF/sitemesh-decorator.tld</taglib-location>      </taglib>      <taglib>           <taglib-uri>sitemesh-page</taglib-uri>           <taglib-location>/WEB-INF/sitemesh-page.tld</taglib-location>      </taglib>


2）创建WEB-INF/decorators.xml，在该文件中配置有哪些模板，以及每个模板具体修饰哪些URL，另外也可以配置哪些URL不需要模板控制 , decorators.xml的一个例子如下：
<excludes> <pattern>/Login*</pattern> </excludes>  <decorators defaultdir="/decorators">     <decorator name="main" page=“DecoratorMainPage.jsp">         <pattern>/*</pattern>      </decorator>      <decorator name=“pop" page=“PopPage.jsp">         <pattern>/showinfo.jsp*</pattern>         <pattern>               /myModule/GreatWallDetailAction.do*         </pattern>     </decorator> </decorators>

3）我们看一个修饰模板的例子 
<%@page contentType="text/html;?charset=GBK"%> <%@taglib uri="sitemesh-decorator"?prefix="decorator" %>  <html>     <head>          <title> <decorator:title/> </title>          <decorator:head/>     </head>      <body>         Hello World  <hr/>         <decorator:body/>     </body> </html>

4）我们看一个被修饰的页面的例子： 
<%@ page contentType="text/html;?charset=GBK"%> <html>     <head>         <title>Hello World</title>     </head>      <body>         <p>Decorated page goes here.</p     </body> </html>

5）我们看一下装饰模板中可以使用的Sitemesh标签
<decorator:head />
取出被装饰页面的head标签中的内容。
<decorator:body />
取出被装饰页面的body标签中的内容。
<decorator:title default=""  />
取出被装饰页面的title标签中的内容。default为默认值
<decorator:getProperty property="" default=""  writeEntireProperty=""/>
取出被装饰页面相关标签的属性值。
writeEntireProperty表明，是显示属性的值还是显示“属性=值”
Html标签的属性
Body标签的属性
Meta标签的属性
注意如果其content值中包含“>或<”会报错，需转码，例如&lt;等等
default是默认值
<decorator:usePage id="" />
将被装饰页面构造为一个对象，可以在装饰页面的JSP中直接引用。
6）看一个在装饰模板中使用标签的例子 
<html lang=“ <decorator:getProperty property=‘lang’/> ”>     <head>         <title> <decorator:title default=“你好” /> </title>         <decorator:head />     </head>          <body <decorator:getProperty property=“body.onload" writeEntireProperty=“1"/> >

从meta中获取变量company的名称：              <decorator:getProperty property=“meta.company”/>             
下面是被修饰页面的body中的内容： 
<decorator:body />           <decorator:usePage id=“myPage" />           <%=myPage.getRequest().getAttribute(“username”)%>     </body> </html>
             
7）看一下相应的在被修饰页面中的代码： 
<html lang=“en”>     <head>         <title>我的sitemesh</title>         <meta name=“company” content=“smartdot”/>         <meta name=“Author” content=“zhangsan”/>         <script>              function count(){return 10;}         </script>     </head>      <body onload=“count()”>          <p>这是一个被修饰页面</p>     </body> </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属性指定了模板文件存放的目录;
分享到：
| Myeclipse注册码
评论
发表评论

您还没有登录,请您登录后再发表评论

相关推荐

Magicbox
Global site tag (gtag.js) - Google Analytics