配置tomcat让shtml嵌套文件显示

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

例如：<!--#includevirtual="web/header.html"-->（这个不是注释，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什么的也是可以的。

如果在页面上报错：[anerroroccurredwhileprocessingthisdirective]是因为导入的文件不存在引发的。

tomcat里面<!--#includevirtual="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);
        }

示例

<!--被包含文件与父文件存在于相同目录中。-->

<!--#includefile="myfile.inc"-->

<!--被包含文件位于脚本虚拟目录中。-->

<!--#includevirtual="/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的配置为

<!--#includevirtual="/xxxx/common/test.inc"-->

file的话只能是本目录下面的文件，如存在别的目录下的话，貌似不行

最起码我不会~

includefile与includevirtual的区别

1。#includefile包含文件的相对路径，#includevirtual包含文件的虚拟路径。

2。在同一个虚拟目录内，<!--#includefile="file.asp"-->和<!--#includevirtual="file.asp"-->效果是相同的，但假设虚拟目录名为myweb,则<!--#includevirtual="myweb/file.asp"-->也可以通过调试，但我们知道<!--#includefile="myweb/file.asp"-->是绝对要报错的。

3。如果一个站点下有2个虚拟目录myweb1和myweb2,myweb1下有文件file1.asp,myweb2下有文件file2.asp,如果file1.asp要调用file2.asp,那么在file1.asp中要这样写：<!--#includevirtual="myweb2/file2.asp"-->，在这种情况下用#includefile是无法实现的，用<!--#includefile="myweb2/file2.asp"-->必然报错。相反，在myweb2的文件中包含myweb1中的文件也是一样。如果该被包含文件在某个文件夹下面，只要在虚拟路径中加上该文件夹即可。

4。不论用#includefile还是#includevirtual，在路径中用“/”还是“\”或者二者交叉使用都不会影响编译效果，程序会顺利执行。

5。以上情况不适用于2个站点文件的相互调用，而且在同一个站点内，<!--#includefile="file.asp"-->和<!--#includevirtual="file.asp"-->等效，但假设站点名为website,使用<!--#includevirtual="website/file.asp"-->是错误的。

<!--includefile="abc/abc.asp"-->