SSI最长用的指令是<!--#include virtual="itzhai/foot.jsp"-->,其作用类似于JSP中的incluce指令。
SSI相对于JSP的include标签的优点:
① SSI是一种通用技术,它不受限于运行环境,在Java,CGI,dotnet,ASP,PHP环境下都可以使用SSI技术。
② 解释SSI的效率要比解析JSP的效率块很多,原因是JSP需要用到Servlet引擎进行解释,所以效率比较低。
解析SSI文件的最佳服务器是Apache Http Server。
SSI在项目中的配置
开启SSI功能:
① 到%Tomcat%/conf/web.xml文件设置,下有两种设置方法:
使用Servlet:
去掉name为ssi的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> <init-param> <param-name>inputEncoding</param-name> <param-value>UTF-8</param-value> </init-param> <init-param> <init-param> <param-name>outputEncoding</param-name> <param-value>UTF-8</param-value> </init-param> <init-param> <param-name>isVirtualWebappRelative</param-name> <param-value>0</param-value> </init-param> <load-on-startup>4</load-on-startup> </servlet>
注意:这里添加了inputEncoding和outputEncoding两个属性设置编码
使用Filter
去掉filter-name为ssi的filter注释:
<filter> <filter-name>ssi</filter-name> <filter-class> org.apache.catalina.ssi.SSIFilter </filter-class> <init-param> <param-name>contentType</param-name> <param-value>text/x-server-parsed-html(;.*)?</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> </filter>
② 到%Tomcat%/conf/context.xml文件中,在<Context>结点中添加如下属性:
privileged=”true”
<Context privileged=”true”>
这个属性指定我们发布的web应用有权限使用容器的Servlet
SSI的相关指令
指令基本格式:
<!--#指令名称="指令参数"-->
注意:<!—与#符号间没有空格,SSI指令是大小写敏感的,参数必须是小写字母才会其作用。
#include指令:
<!--#include file="foot.jsp"-->
file文件名是一个相对路径,且该文件只能是#include指令所在文档的目录的同级目录或其子目录,而不能是上一级目录
<!--#include virtual="itzhai/foot.jsp"-->
virtual文件名是Web站点上的虚拟目录的完整路径。
注意:① 文件名必须带有扩展名 ②被包含的文件可以具有任何文件扩展名
#flastmod指令:
<!--#flastmod file="filename.ext"-->
#fsize指令:
<!--#fsize file="filename.ext"-->
文件的长度
#echo指令:
<!--#echo var="变量名"-->
<!--#echo var="DOCUMENT_NAME"-->
该文档的名称
<!--#echo var="DOCUMENT_URI"-->
当前文件的虚拟路径
<!--#echo var="REMOTE_ADDR"-->
用户的IP地址
<!--#echo var="QUERY_String_UNESCAPED"-->
显示用户发送的查询字符串
<!--#config timefmt="%Y/%m/%d %a %H:%M:%S"-->
设置格式化时间
<!--#echo var="DATE_LOCAL"-->
显示当前时间
#set指令:
<!--#set var="变量名" value="变量值"-->
给变量赋值
#if指令:
<!--#if expr="$变量名=\"arthinking\""-->
User:arthinking
<!--#elif expr="$变量名=\"Jason\""-->
User:Jason
<!--#else-->
other
<!--#endif-->