配置tomcat让shtml嵌套文件显示

之前，我知道tomcat可以直接解析shtml文件，在浏览器中显示效果来，后来由于需求发生改变，比如说 在做静态化生成的时候一个网站的头部和底部都是一样的，如果每个页面都生成一次，显然很浪费时间，所有我们可以把 这个共同的头部 和底部挖出来单独生成，然后通过shtml嵌套显示，就可以了。可是怎么导入静态头部和底部呢？？有好的标签吗？？有 shtml中有include标签导入外部文件显示。

例如：[color=red]<!--#include virtual="web/header.html"-->[/color]（这个不是注释，shtml导入标签就是这么写的）。

如果直接这样子使用，tomcat是无法解析的。还需要在tomcat中做两下简单的配置：

第一：在 tomcat/conf/context.xml 中加上 privileged="true" ，表示享有特权的，

第二：在 tomcat/conf/web.xml中 关于name=“ssi”的servlet 配置取消掉注释，包括该servlet的映射配置。

 <servlet>  
        <servlet-name>ssi</servlet-name>  
        <servlet-class>  
          org.apache.catalina.ssi.SSIServlet  
        </servlet-class>  
        <init-param>  
          <param-name>buffered</param-name>  
          <param-value>1</param-value>  
        </init-param>  
        <init-param>  
          <param-name>debug</param-name>  
          <param-value>0</param-value>  
        </init-param>  
        <init-param>  
          <param-name>expires</param-name>  
          <param-value>666</param-value>  
        </init-param>  
        <init-param>  
          <param-name>isVirtualWebappRelative</param-name>  
          <param-value>0</param-value>  
        </init-param>  
       <!--- <span style="color:#FF0000;">这里需要手动添加</span> -->  
        <init-param>  
          <param-name>inputEncoding</param-name>  
          <param-value>UTF-8</param-value>  
        </init-param>  
        <init-param>  
          <param-name>outputEncoding</param-name>  
          <param-value>UTF-8</param-value>  
        </init-param>  

        <load-on-startup>4</load-on-startup>  
    </servlet>  

  下面别忘了改了，跟上面不在一个地方
    <servlet-mapping>  
        <servlet-name>ssi</servlet-name>  
        <url-pattern>*.shtml</url-pattern>  
    </servlet-mapping>  

备注：23-30行需要手动添加，不然在显示的页面中会乱码。

基本上这样子配置之后tomcat就回帮你解析shtml的include标签了。感觉还是蛮方便，蛮强大的。

另外：

导入的文件可以不是完整的页面，就是说可以不用包含html标签，直接写几个div什么的也是可以的。

如果在页面上报错： [an error occurred while processing this directive] 是因为导入的文件不存在引发的。
tomcat里面<!--#include virtual="web/header.html"-->
记得最前面不要加/参看源码就知道了，会报错的。nonVirtualPath就是你设置的路径

       if (nonVirtualPath.startsWith("/") || nonVirtualPath.startsWith("\\")) {
            throw new IOException("A non-virtual path can't be absolute: "
                    + nonVirtualPath);
        }
        if (nonVirtualPath.indexOf("../") >= 0) {
            throw new IOException("A non-virtual path can't contain '../' : "
                    + nonVirtualPath);
        }

示例
<!--被包含文件与父文件存在于相同目录中。 -->
<!-- #include file = "myfile.inc" -->

<!--被包含文件位于脚本虚拟目录中。 -->
<!-- #include virtual = "/scripts/tools/global.inc" -->
如果是tomcat的话，virtual的时候配置的路径应该是tomcat/webapps文件夹下面开始的路径，
如tomcat所在路径为c:/tomcat
工程所在路径为c:/tomcat/webapps/xxxx
其中xxxx为工程名字
inc文件的路径为c:/tomcat/webapps/xxxx/common/test.inc
virtual的配置为
<!-- #include virtual = "/xxxx/common/test.inc" -->
file 的话只能是本目录下面的文件，如存在别的目录下的话，貌似不行
最起码我不会~

include file 与include virtual的区别

1。#include file 包含文件的相对路径，#include virtual包含文件的虚拟路径。
2。在同一个虚拟目录内，<!--#include file="file.asp"-->和<!--#include virtual="file.asp"-->效果是相同的，但假设虚拟目录名为myweb,则<!--#include virtual="myweb/file.asp"-->也可以通过调试，但我们知道<!--#include file="myweb/file.asp"-->是绝对要报错的。
3。如果一个站点下有2个虚拟目录myweb1和 myweb2,myweb1下有文件file1.asp,myweb2下有文件file2.asp,如果file1.asp要调用file2.asp,那么在file1.asp中要这样写：<!--#include virtual="myweb2/file2.asp"-->，在这种情况下用#include file是无法实现的，用<!--#include file="myweb2/file2.asp"-->必然报错。相反，在myweb2的文件中包含myweb1中的文件也是一样。如果该被包含文件在某个文件夹下面，只要在虚拟路径中加上该文件夹即可。
4。不论用#include file 还是 #include virtual，在路径中用“/”还是“\”或者二者交叉使用都不会影响编译效果，程序会顺利执行。
5。以上情况不适用于2个站点文件的相互调用，而且在同一个站点内，<!--#include file="file.asp"-->和<!--#include virtual="file.asp"-->等效，但假设站点名为website,使用<!--#include virtual="website/file.asp"-->是错误的。

<!--include file="abc/abc.asp"-->