BlogJava-seasun-随笔分类-1.8 sitemeshhttp://www.blogjava.net/shiwenfeng/category/42429.html在不断模仿、思考、总结中一步一步进步！zh-cnWed, 28 Oct 2009 09:19:45 GMTWed, 28 Oct 2009 09:19:45 GMT60Struts2和SiteMesh整合之web.xmlhttp://www.blogjava.net/shiwenfeng/archive/2009/10/28/300084.htmlshiwfshiwfWed, 28 Oct 2009 09:11:00 GMThttp://www.blogjava.net/shiwenfeng/archive/2009/10/28/300084.htmlhttp://www.blogjava.net/shiwenfeng/comments/300084.htmlhttp://www.blogjava.net/shiwenfeng/archive/2009/10/28/300084.html#Feedback0http://www.blogjava.net/shiwenfeng/comments/commentRss/300084.htmlhttp://www.blogjava.net/shiwenfeng/services/trackbacks/300084.html<?xml version="1.0" encoding="GBK"?>
<!-- 配置Web应用配置文件的根元素，并指定配置文件的Schema信息 -->
<web-app xmlns="http://java.sun.com/xml/ns/javaee"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
 http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" version="2.5">
 <!-- 定义ActionContextCleanUp过滤器 -->
 <filter>
  <filter-name>struts-cleanup</filter-name>
  <filter-class>org.apache.struts2.dispatcher.ActionContextCleanUp</filter-class>
 </filter>
 <!-- 定义SiteMesh的核心过滤器 -->
 <filter>
  <filter-name>sitemesh</filter-name>
  <filter-class>com.opensymphony.module.sitemesh.filter.PageFilter</filter-class>
 </filter>
 <!-- 定义Struts 2的核心过滤器 -->
 <filter>
  <filter-name>struts</filter-name>
  <filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class>
 </filter>

 <!-- 定义过滤器链 -->
 <!-- 排在第一位的过滤器是：ActionContextCleanUp过滤器 -->
 <filter-mapping>
  <filter-name>struts-cleanup</filter-name>
  <url-pattern>/*</url-pattern>
 </filter-mapping>
 <!-- 排在第二位的过滤器是：SiteMesh的核心过滤器 -->
 <filter-mapping>
  <filter-name>sitemesh</filter-name>
  <url-pattern>/*</url-pattern>
 </filter-mapping>
 <!-- 排在第三位的过滤器是：FilterDispatcher过滤器 -->
 <filter-mapping>
  <filter-name>struts</filter-name>
  <url-pattern>/*</url-pattern>
 </filter-mapping>

 <!-- 定义一个Listener，该Listener在应用启动时创建Spring容器 -->
 <listener>
  <listener-class>org.springframework.web.context.ContextLoaderListener
  </listener-class>
 </listener>
 <!-- 定义一个Listener，该Listener在应用启动时加载MyFaces的Context -->
 <listener>
  <listener-class>org.apache.myfaces.webapp.StartupServletContextListener
  </listener-class>
 </listener>
 <!-- 配置JSF的FacesServlet，让其在应用启动时加载 -->
 <servlet>
  <servlet-name>faces</servlet-name>
  <servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
  <load-on-startup>1</load-on-startup>
 </servlet>
 <!-- 让FacesServlet拦截所有以*.action结尾的请求 -->
 <servlet-mapping>
  <servlet-name>faces</servlet-name>
  <url-pattern>*.action</url-pattern>
 </servlet-mapping>
</web-app>



shiwf 2009-10-28 17:11 发表评论
]]>sitemesh技术的应用http://www.blogjava.net/shiwenfeng/archive/2009/10/28/300045.htmlshiwfshiwfWed, 28 Oct 2009 05:47:00 GMThttp://www.blogjava.net/shiwenfeng/archive/2009/10/28/300045.htmlhttp://www.blogjava.net/shiwenfeng/comments/300045.htmlhttp://www.blogjava.net/shiwenfeng/archive/2009/10/28/300045.html#Feedback0http://www.blogjava.net/shiwenfeng/comments/commentRss/300045.htmlhttp://www.blogjava.net/shiwenfeng/services/trackbacks/300045.html一、基本概念
1、Sitemesh是一种页面装饰技术 ：
1  ：它通过过滤器(filter)来拦截页面访问
 2  ：根据被访问页面的URL找到合适的装饰模板
 3  ：提取被访问页面的内容，放到装饰模板中合适的位置
 4  ：最终将装饰后的页面发送给客户端。
2、在sitemesh中，页面分为两种：装饰模板和普通页面。
1）装饰模板，是指用于修饰其它页面的页面。
2）普通页面，一般指各种应用页面。
二、模板修饰网页的原理







通过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属性指定了模板文件存放的目录;


shiwf 2009-10-28 13:47 发表评论
]]>初识SiteMeshhttp://www.blogjava.net/shiwenfeng/archive/2009/10/27/299925.htmlshiwfshiwfTue, 27 Oct 2009 07:47:00 GMThttp://www.blogjava.net/shiwenfeng/archive/2009/10/27/299925.htmlhttp://www.blogjava.net/shiwenfeng/comments/299925.htmlhttp://www.blogjava.net/shiwenfeng/archive/2009/10/27/299925.html#Feedback0http://www.blogjava.net/shiwenfeng/comments/commentRss/299925.htmlhttp://www.blogjava.net/shiwenfeng/services/trackbacks/299925.html一、SiteMesh项目简介 （http://www.opensymphony.com/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标签<page:applyDecorator>的一个翻版。其实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.FilterDispatcher过滤器之前org.apache.struts2.dispatcher.ActionContextCleanUp过滤器之后，否则会有问题；

       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: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系统页面的一种方案


本文来自CSDN博客，转载请标明出处：http://blog.csdn.net/it_man/archive/2009/01/17/3817347.aspx



shiwf 2009-10-27 15:47 发表评论
]]>