「影像轉譯」支援以規則運算式比對和替代規則為基礎的簡單要求預處理機制。
預處理規則的集合(規則集)可以附加到材料目錄或預設目錄。 僅當請求未附加特定物料目錄時,預設目錄中的規則才適用。
請求預處理規則可以在請求被伺服器的請求解析器處理之前修改請求的路徑和查詢部分,包括操作路徑、添加命令、更改命令值以及應用模板或宏。 規則也可用來設定和覆寫某些目錄屬性,以及將服務限制在特定用戶端IP位址。
規則集儲存為XML文檔檔案。 必須在attribute::RuleSetFile
中指定規則集檔案的相對路徑或絕對路徑。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE ruleset SYSTEM" RuleSet.dtd">
<ruleset>
<rule>
<expression>
<varname>
expression
</varname></expression>
<substitution>
<varname>
substitution
</varname></substitution>
<addressfilter>
<varname>
addressFilter
</varname></addressfilter>
</rule>
</ruleset>
有效規則集XML檔案中始終需要<?xml>
、<!DOCTYPE>
和<ruleset>
元素,即使未定義實際規則亦然。
允許一個<ruleset>
元素包含任意數量的<rule>
元素。
預處理規則檔案的內容區分大小寫。
在進行任何其他處理之前,傳入的HTTP要求會部分剖析,以決定應套用哪些材料目錄。 識別目錄後,會套用所選目錄(或預設目錄,若未識別特定目錄)的規則集。
按照為與<expression>
元素(expression
)的內容匹配而指定的順序搜索<rule>
元素。
如果<rule>
匹配,則應用可選substitution
,並將修改的請求字串傳遞到伺服器的請求解析器,以進行正常處理。
如果達到<ruleset>
結尾時未進行成功匹配,則該請求將傳遞給解析器,無需修改。
預設行為可使用<rule>
元素的OnMatch
屬性進行修改。 OnMatch
可設為( break
預設值)、 continue
或 error.
元素和屬性 |
發生符合時的行為 |
---|---|
<rule OnMatch="break"> |
套用此規則的替代後,規則處理會立即終止。 預設. |
<rule OnMatch="continue"> |
替代會套用,處理會繼續處理下一個規則。 |
<rule OnMatch="error"> |
規則處理會立即終止,並傳回「請求拒絕」回應狀態給用戶端。 |
<rule>
元素可以選擇性地定義在規則成功匹配且已設定時覆蓋相應目錄屬 OnMatch="break"
性的屬性。如果設定OnMatch="continue"
,則不會套用任何屬性。 有關可以使用規則控制的屬性清單,請參閱<rule>
的說明。
簡單字串比對非常基本的應用程式有用,但大多數情況下都需要規則運算式。 雖然規則運算式為業界標準,但特定實作會因例項而異。
套件java.util. regex描述了影像伺服器使用的特定規則運算式實施。
為方便複雜的URL修改,可在運算式中擷取子字串,方法是以括弧(…)包住子字串。 擷取的子字串會根據前括弧的位置,從1開始依序編號。 可使用$n
將捕獲的子字串插入替代中,其中n
是捕獲的子字串的序列號。
一個規則集檔案可以附加到每個具有目錄屬性attribute::RuleSetFile
的物料目錄。 雖然您可以隨時編輯規則集檔案,但映像伺服器僅在重新載入關聯的材料目錄時才能識別更改。 當Platform Server啟動或重新啟動時,以及當主目錄檔案(其檔案尾碼為.ini)被修改或「接觸」(以變更檔案日期)時,就會發生此情況。
在影像伺服檔案的影像目錄參考的對應區段中提供規則集範例。