一、前言

　　因参与公司框架改造，接触到了Sitemesh这个用于网页布局和修饰的框架，因之前没有接触过（汗颜），但是发现其小巧好用，便以此文记之~

二、正文

　　Sitemesh有什么作用呢？我相信很多人在使用jsp的时候，经常会将head部分单独放一个jsp，然后在需要使用的地方，用<%@ include file="/WEB-INF/layouts/header.jsp"%>加载进来，如果一两个文件还好，假如文件太多，难道要一个个配置进去？能不能有一种方法，减少这种体力劳动呢？这个时候Sitemesh派上用场了，通过配置，它可以自动为请求的页面添加上类似刚刚header.jsp中的内容，然后拼装完成之后，返回给用户的浏览器，惊不惊喜，意不意外？下面我就来介绍如何使用~

　　1. 在开始介绍Sitemesh前，先po一张官网的流程图

　　

　　2. 本文基于的环境

　jdk1.8

  sitemash-2.4.2.jar

  servlet-api-3.0-alpha-1.jar

　　3. Maven配置文件pom.xml如下

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">

  <modelVersion>4.0.0</modelVersion>

  <groupId>com.sitemesh.test</groupId>

  <artifactId>Sitemesh</artifactId>

  <packaging>war</packaging>

  <version>1.0-SNAPSHOT</version>

  <name>Sitemesh Maven Webapp</name>

  <url>http://maven.apache.org</url>

  <dependencies>

    <dependency>

      <groupId>junit</groupId>

      <artifactId>junit</artifactId>

      <version>3.8.1</version>

      <scope>test</scope>

    </dependency>

    <dependency>

        <groupId>javax.servlet</groupId>

        <artifactId>servlet-api</artifactId>

        <version>3.0-alpha-1</version>

        <scope>provided</scope>

    </dependency>

    <dependency>

        <groupId>opensymphony</groupId>

        <artifactId>sitemesh</artifactId>

        <version>2.4.2</version>

    </dependency>

  </dependencies>

  <build>

    <finalName>Sitemesh</finalName>

    <plugins>

        <plugin>

            <groupId>org.apache.tomcat.maven</groupId>

            <artifactId>tomcat7-maven-plugin</artifactId>

            <version>2.2</version>

            <configuration>

              <port>8080</port>

              <path>/</path>

              <uriEncoding>UTF-8</uriEncoding>

            </configuration>

          </plugin>

    </plugins>

  </build>

</project>

　　4. 工程目录结构

　　

　

　　7. 接下来，就说下使用sitemesh的步骤

　　1）首先，下载sitemesh对应的jar

　　笔者使用maven下载，如果看官不是使用maven，自己到Sitemesh官网下载对应jar，传送门：http://wiki.sitemesh.org/wiki/display/sitemesh/Download

　　2）在web.xml中配置Filter

  ............................

  <filter>

    <filter-name>sitemeshFilter</filter-name>

    <filter-class>com.opensymphony.sitemesh.webapp.SiteMeshFilter</filter-class>

  </filter>

  <filter-mapping>

    <filter-name>sitemeshFilter</filter-name>

    <url-pattern>/*</url-pattern>

  </filter-mapping>

  ............................

　　3）在WEB-INFO目录下建立一个layouts文件夹（这个文件夹随便命名，理论上，位置你可以放在webapp目录下任何地方，这个后续decorator.xml需要用到），并且在该文件夹下面建立三个文件：default.jsp、header.jsp、footer.jsp，三个文件的内容如下：

　　default.jsp

<%@ page contentType="text/html;charset=UTF-8"%>

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

<!DOCTYPE html>

<html>

    <head>

        <title>QuickStart示例:<sitemesh:title/></title>

        <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />

        <meta http-equiv="Cache-Control" content="no-store" />

        <meta http-equiv="Pragma" content="no-cache" />

        <meta http-equiv="Expires" content="0" />

        <sitemesh:head/>

    </head>

    <body>

        <div class="container">

            <%@ include file="/WEB-INF/layouts/header.jsp"%>

            <div id="content">

                <sitemesh:body/>

            </div>

            <%@ include file="/WEB-INF/layouts/footer.jsp"%>

        </div>

    </body>

</html>

　　这个文件中sitemesh标签说明如下：

<sitemesh:title/>这个标签会找到被装饰页面的title(<title></title>标签内)内容填入

<sitemesh:head/>找到被装饰页面的head(<head></head>标签内)内容填入

<sitemesh:body/>找到被装饰页面的body(<body></body>标签内)内容填入．

　　header.jsp

<%@page contentType="text/html;charset=utf-8" %>

This is the header!

　　footer.jsp

<%@page contentType="text/html;charset=utf-8" %>

This is the footer!

　　4）在WEB-INFO目录中建立文件decorators.xml

<?xml version="1.0" encoding="utf-8"?>

<decorators defaultdir="/WEB-INF/layouts/">

    <excludes>

        <pattern>/static/*</pattern><!--这边指定不需要装饰的页面，支持通配符-->

    </excludes>

    <!-- 用来定义装饰器要过滤的页面 -->

    <decorator name="default" page="default.jsp"><!--指明用于装饰的框架页面-->

        <pattern>/*</pattern><!--这边指定需要被装饰的页面，支持通配符-->

    </decorator>

</decorators>

　　5）访问工程index.jsp

　　首先，先看下index.jsp页面内容：

<%@page contentType="text/html;charset=utf-8" %>

<html>

    <head>

        <title>Sitemesh测试</title>

    </head>

    <body>

        <h2>Body 内容</h2>

    </body>

</html>

　　访问后页面展示的效果：

　　

　　查看网页源码：

<!DOCTYPE html>

<html>

    <head>

        <title>QuickStart示例:Sitemesh测试</title>

        <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />

        <meta http-equiv="Cache-Control" content="no-store" />

        <meta http-equiv="Pragma" content="no-cache" />

        <meta http-equiv="Expires" content="0" />

    </head>

    <body>

        <div class="container">

            This is the header!

            <div id="content">

                <h2>Body 内容</h2>

            </div>

            This is the footer!

        </div>

    </body>

</html>

　　8、补充说明

　　假如在decorators.xml文件中，配置了多个decorator节点，如下：

<?xml version="1.0" encoding="utf-8"?>

<decorators defaultdir="/WEB-INF/layouts/">

    <!-- 此处用来定义不需要过滤的页面 -->

    <excludes>

        <pattern>/static/*</pattern>

    </excludes>

    <!-- 用来定义装饰器要过滤的页面 -->

    <decorator name="default" page="default.jsp">

        <pattern>/*</pattern>

    </decorator>

    <decorator name="default2" page="default2.jsp">

        <pattern>/*</pattern>

    </decorator>

</decorators>

　　过滤器的配置不变，现在我又有个页面叫index2.jsp，我需要的是被名为“default2”的decorator装饰时，如何指定呢？那么只需在index2.jsp中，进行如下配置：

　　

　　其中name的值固定为“decorator”，content的内容与decorators.xml文件中decorator节点的name属性对应

　　

　　总结：当浏览器里面请求页面数据时，过滤器SiteMeshFilter拦截请求，然后根据decorator.xml中配置内容，确定是否为excludes设置为不需要装饰的页面，如果不是，那么就使用decorator节点配置的装饰框架default.jsp，并且将其中<sitemesh:title />、<sitemesh:head />、<sitemesh:body />分别用请求页面的<title>、<head>、<body>部分的内容替换，最终输出到用户的浏览器

　　

三、参考链接

https://www.cnblogs.com/china-li/archive/2013/05/15/3080154.html

四、联系本人

　　为方便没有博客园账号的读者交流，特意建立一个企鹅群（纯公益，非利益相关），读者如果有对博文不明之处，欢迎加群交流：261746360，小杜比亚-博客园

Sitemesh小记的更多相关文章

  1. [原]Paste.deploy 与 WSGI, keystone 小记

    Paste.deploy 与 WSGI, keystone 小记 名词解释: Paste.deploy 是一个WSGI工具包,用于更方便的管理WSGI应用, 可以通过配置文件,将WSGI应用加载起来. ...

  2. MySql 小记

    MySql  简单 小记 以备查看 1.sql概述 1.什么是sql? 2.sql发展过程? 3.sql标准与方言的关系? 4.常用数据库? 5.MySql数据库安装? 2.关键概念 表结构----- ...

  3. Spring MVC学习笔记——SiteMesh的使用（转）

    转自 SiteMesh的使用 SiteMesh的介绍就不多说了,主要是用来统一页面风格,减少重复编码的. 它定义了一个过滤器,然后把页面都加上统一的头部和底部. 需要先在WEB-INF/lib下引入s ...

  4. Git小记

    Git简~介 Git是一个分布式版本控制系统,其他的版本控制系统我只用过SVN,但用的时间不长.大家都知道,分布式的好处多多,而且分布式已经包含了集中式的几乎所有功能.Linus创造Git的传奇经历就 ...

  5. 广州PostgreSQL用户会技术交流会小记 2015-9-19

    广州PostgreSQL用户会技术交流会小记 2015-9-19 今天去了广州PostgreSQL用户会组织的技术交流会 分别有两个session 第一个讲师介绍了他公司使用PostgreSQL-X2 ...

  6. 东哥读书小记 之 《MacTalk人生元编程》

         一直以来的自我感觉:自己是个记性偏弱的人.反正从小读书就喜欢做笔记(可自己的字写得巨丑无比,尼玛不科学呀),抄书这事儿真的就常发生俺的身上. 因为那时经常要背诵课文之类,反正为了怕自己忘记, ...

  7. Paypal支付小记

    Paypal支付小记 *:first-child { margin-top: 0 !important; } body>*:last-child { margin-bottom: 0 !impo ...

  8. linux 下cmake 编译 ,调用,调试 poco 1.6.0 小记

    上篇文章 小记了: 关于 Poco::TCPServer框架 (windows 下使用的是 select模型) 学习笔记. http://www.cnblogs.com/bleachli/p/4352 ...

  9. mongodb入门学习小记

    Mongodb 简单入门(个人学习小记) 1.安装并注册成服务:(示例) E:\DevTools\mongodb3.2.6\bin>mongod.exe --bind_ip 127.0.0.1 ...

随机推荐

  1. STM32 时钟配置的坑

    今天在调试公司的一款产品的时候发现8M的晶振用完了,于是找了一个16M的替代 坑爹的就在这里,明明已经把时钟按照时钟树配置好了,但是串口等外设一直无法正常工作 折腾了一下午,终于发现这位老兄的文章ht ...

  2. Java多线程一些基础知识

    最近复习了一些多线程方面的基础知识,做一下总结,多以自己的理解来文字叙述,如果有漏点或者理解错的地方,欢迎各位大佬多多指出: ps:线程分为用户线程和守护线程,当程序中的所有的用户线程都执行完了之后, ...

  3. xshell5连接虚拟机的小问题处理

    1.首先确保虚拟机是桥接状态,然后在虚拟机下用ifconfig查看ip地址(当然是默认你虚拟机下是linux) 2.确保虚拟机安装了ssh...安装openssh-server: 对应的sudo ap ...

  4. sql 删除表字段中所有的空格

    源地址:http://bbs.csdn.net/topics/30322040 Sample表中有一个Name字段,目前当中有很多记录含有空格,如:“ 张 学 友 ”,如何用SQL语句将这些空格删掉, ...

  5. VS2015编译MapWinGIS

    在github上下载MapWinGIS,目前最新版本为4.9.5.0 GitHub上项目地址为:https://github.com/MapWindow/MapWinGIS 通过git客户端下载mas ...

  6. SpringBoot-02：SpringBoot中的POM文件详细解释

    ------------吾亦无他,唯手熟尔,谦卑若愚,好学若饥------------- 我把pom文件,以及它的详细解释发出来 <?xml version="1.0" en ...

  7. 说说Ruby中的Symbol类

    相信大多人在学习Ruby过程中,都被Symbol类型迷惑过.因为其他语言基本没有这个类.而且它太灵活了.很多人只知其一不知其二. 本人查了不少资料,自己总结一下. 首先来看一下Ruby之父所著的< ...

  8. 【费元星】crt 无法上传文件，总是显示盾牌表示-完美解决

    将如下内容保存到文件中,已.bat 结尾 taskkill /f /im explorer.exeattrib -s -r -h "%userprofile%\AppData\Local\i ...

  9. C#中创建二维数组，使用[][]和[,]的区别

    C#中,我们在创建二维数组的时候,一般使用arr[][]的形式,例如 int[][] aInt = new int[2][]; 但声明二维数组还有一种方法,是使用arr[,]的形式.两者有什么区别呢? ...

  10. Linux内核设计笔记14——块I/O层

    块I/O层 基本概念 系统中可以随机访问固定大小数据片的硬件设备称做块设备,这些固定大小的数据片称之为块.还有一种基本的设备称之为字符设备,其需要按照顺序访问,比如键盘. 扇区:块设备中最小的寻址单元 ...