Referens för regeluppsättning rule-set-reference
Bildåtergivning har stöd för en enkel förbearbetningsmekanism för begäranden som baseras på matchnings- och ersättningsregler för reguljära uttryck.
Samlingar med förbearbetningsregler (regeluppsättningar) kan bifogas till materialkataloger eller standardkatalogen. Regler i standardkatalogen gäller bara om begäran inte bifogar en viss materialkatalog.
Regler för förbehandling av begäranden kan ändra sökvägen och frågedelarna av begäranden innan de bearbetas av serverns begärandeparser, bland annat ändra sökvägen, lägga till kommandon, ändra kommandovärden och använda mallar eller makron. Regler kan också användas för att konfigurera och åsidosätta vissa katalogattribut, samt för att begränsa tjänsten till vissa IP-adresser för klienter.
Regeluppsättningar sparas som XML-dokumentfiler. Den relativa eller absoluta sökvägen för regeluppsättningsfilen måste anges i attribute::RuleSetFile.
Allmän struktur section-74faaee27fc543a2ab4a306f3a03674e
<?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>
Elementen <?xml>, <!DOCTYPE> och <ruleset> krävs alltid i en giltig XML-fil för regeluppsättningar, även om inga faktiska regler har definierats.
Ett <ruleset>-element som innehåller valfritt antal <rule>-element tillåts.
Innehållet i regelfiler för förbearbetning är skiftlägeskänsligt.
Förbehandling av URL section-737a38d1b8c746f995e64fa6cfbcec87
Innan någon annan bearbetning utförs, analyseras en inkommande HTTP-begäran delvis för att avgöra vilken materialkatalog som ska användas. När katalogen har identifierats tillämpas regeluppsättningen för den valda katalogen (eller standardkatalogen, om ingen specifik katalog har identifierats).
<rule>-elementen söks igenom i den ordning som anges för att matcha innehållet i <expression>-elementet ( expression).
Om en <rule> matchas tillämpas den valfria substitution och den ändrade begärandesträngen skickas till serverns begärandeparser för normal bearbetning.
Om ingen matchning görs när slutet av <ruleset> nås, skickas begäran till tolken utan ändring.
Attributet OnMatch section-7a8ad3597780486985af5e9a3b1c7b56
Standardbeteendet kan ändras med attributet OnMatch för elementen <rule>. OnMatch kan anges till break (standard), continue eller error.
Åsidosätta katalogattribut section-1f59ce84234f4576ba8473b0e6ba22ee
<rule>-element kan eventuellt definiera attribut som åsidosätter motsvarande katalogattribut när regeln matchas och OnMatch="break" anges. Inga attribut används om OnMatch="continue" har angetts. Se beskrivningen av <rule> för en lista över attribut som kan kontrolleras med regler.
Reguljära uttryck section-4d326507b52544b0960a9a5f303e3fe6
Enkel strängmatchning fungerar för mycket grundläggande program, men reguljära uttryck krävs i de flesta fall. Medan reguljära uttryck är branschstandard varierar den specifika implementeringen från instans till instans.
package java.util.regex beskriver den specifika implementeringen av reguljära uttryck som används av Image Serving.
Infångade delsträngar section-8057cd65d48949ffb6a50e929bd3688b
För att underlätta komplexa URL-ändringar kan delsträngar fångas in i uttrycket genom att omsluta delsträngen med parenteser (…). Infångade delsträngar numreras sekventiellt med början på 1 enligt positionen för den inledande parentesen. De hämtade delsträngarna kan infogas i ersättningen med $n, där n är sekvensnumret för den hämtade delsträngen.
Hantera regeluppsättningsfiler section-e8ce976b56404c009496426fd334d23d
En regeluppsättningsfil kan bifogas till varje materialkatalog med katalogattributet attribute::RuleSetFile. Du kan redigera regeluppsättningsfilen när som helst, men bildservern känner bara igen ändringarna när den tillhörande materialkatalogen läses in igen. Detta inträffar när Platform Server startas eller startas om och när den primära katalogfilen (som har ett .ini filsuffix) ändras eller "ändras" (för att ändra fildatumet).
Exempel section-c4142a41f5cd4ff799a72fbc130c3700
Exempel på regeluppsättningar finns i motsvarande avsnitt i referenshandboken för bildkatalogen i dokumentationen för bildservrar.