Tomcat SSI（服務器端嵌入）

簡介

SSI（服務器端嵌入）是一組放在 HTML 頁面中的指令，當服務器向客戶端訪問提供這些頁面時，會解釋執(zhí)行這些指令。它們能為已有的 HTML 頁面添加動態(tài)生成內(nèi)容，不需要通過 CGI 程序來或其他的動態(tài)技術(shù)來重新改變整個頁面。

如果利用 Tomcat 作為 HTTP 服務器并需要 SSI 支持時，可以添加 SSI 支持。通常，如果你運行的不是像 Apache 那樣的服務器，就通過開發(fā)來實現(xiàn)這種支持。

Tomcat SSI 支持實現(xiàn)了與 Apache 完全一致的 SSI 指令。關于使用 SSI 指令的詳細信息，可參考Apache 的 SSI 簡介。

SSI 支持可以有兩種方式來實現(xiàn)：servlet 或過濾器。你只能利用其中的一種方式來提供 SSI 支持。

基于 servlet 的 SSI 支持是通過 org.apache.catalina.ssi.SSIServlet 類來實現(xiàn)的。一般來說，這個 servlet 映射至 URL 模式"*.shtml"。

基于過濾器的 SSI 支持則利用 org.apache.catalina.ssi.SSIFilter 類來實現(xiàn)。一般而言，該過濾器映射至 URL 模式 "*.shtml"，但是它也可以被映射至 "*"，因為它會基于 MIME 類型選擇性地啟用/禁用對 SSI 的處理。初始參數(shù) contentType 允許你將 SSI 處理應用于 JSP 頁面、JavaScript 內(nèi)容以及其他內(nèi)容中。

默認 Tomcat 是不支持 SSI 的。

安裝

警告：SSI 指令可用于執(zhí)行 Tomcat JVM 之外的程序。如果使用 Java SecurityManager，它會繞過你在 catalina.policy 中配置的安全策略。

為了使用 SSI servlet，要從 $CATALINA_BASE/conf/web.xml 中去除 SSI servlet 及 servlet 映射配置旁邊的 XML 注釋。

為了使用 SSI 過濾器，要從 $CATALINA_BASE/conf/web.xml 中去除 SSI 過濾器及過濾器映射配置旁邊的 XML 注釋。

只有標明為 privileged 的上下文才可以使用 SSI 功能（參看 Context 元素的 privileged 屬性）。

Servlet 配置

以下這些 servlet 初始化參數(shù)可以配置 SSI servlet 的行為：

• buffered 是否應緩存該 servlet 的輸出？（0 = false，1 = true）默認為 0（false）。
• debug 調(diào)試 servlet 所記錄信息的調(diào)試細節(jié)度。默認為 0。
• expires 包含 SSI 指令的頁面失效的秒數(shù)。默認行為針對的是每個請求所應執(zhí)行的所有 SSI 指令。
• isVirtualWebappRelative “虛擬”的 SSI 指令路徑是否應被解釋為相對于上下文根目錄的相對路徑（而不是服務器根目錄）？默認為 false。
• inputEncoding 如果無法從資源本身確定編碼，則應指定給 SSI 資源的編碼。默認為系統(tǒng)默認編碼。
• outputEncoding 用于 SSI 處理結(jié)果的編碼。默認為 UTF-8。
• allowExec 是否啟用 exec 命令？默認為 false。

過濾器配置

以下這些過濾器初始化參數(shù)可以配置 SSI 過濾器的行為：

• contentType 在應用 SSI 處理之前必須匹配的正則表達式模式。在設計自己的模式時，不要忘記 MIME 內(nèi)容類型后面可能會帶著可選的字符集：“mime/type; charset=set”。默認為 “text/x-server-parsed-html(;.*)?”。
• debug 調(diào)試 servlet 所記錄信息的調(diào)試細節(jié)度。默認為 0。
• expires 包含 SSI 指令的頁面失效的秒數(shù)。默認行為針對的是每個請求所應執(zhí)行的所有 SSI 指令。
• isVirtualWebappRelative “虛擬”的 SSI 指令路徑是否應被解釋為相對于上下文根目錄的相對路徑（而不是服務器根目錄）？默認為 false。
• allowExec 是否啟用 exec 命令？默認為 false。

指令

指令采取 HTML 注釋的形式。在將頁面發(fā)送到客戶端之前，解讀指令，并用所得結(jié)果來替換指令。指令的一般形式為：

<!--#directive [parm=value] -->

這些指令包括：

• config <!--#config timefmt="%B %Y" --> 用于設定日期格式以及其他一些 SSI 處理的項目。
• echo <!--#echo var="VARIABLE_NAME" --> 將被變量值所取代。
• exec 在主機系統(tǒng)上用于運行命令。
• include <!--#include virtual="file-name" --> 插入內(nèi)容。
• flastmod <!--#flastmod file="filename.shtml" --> 返回文件最后修改的時間。
• fsize <!--#fsize file="filename.shtml" --> 返回文件大小。
• printenv <!--#printenv --> 返回所有定義變量的列表。
• set <!--#set var="foo" value="Bar" --> 為用戶自定義變量賦值。
• if elif endif else 用于生成條件部分，例如：

<!--#config timefmt="%A" -->
<!--#if expr="$DATE_LOCAL = /Monday/" -->
<p>Meeting at 10:00 on Mondays</p>
<!--#elif expr="$DATE_LOCAL = /Friday/" -->
<p>Turn in your time card</p>
<!--#else -->
<p>Yoga class at noon.</p>
<!--#endif -->

關于使用 SSI 指令的詳細信息，可參考Apache 的 SSI 簡介。

變量

SSI servlet 當前能實現(xiàn)下列變量：