Das Bild-Rendering unterstützt einen einfachen Anfragevorverarbeitungsmechanismus, der auf Übereinstimmungs- und Ersatzregeln für reguläre Ausdrücke basiert.
Kollektionen von Vorab-Verarbeitungsregeln (Regelsätze) können an Materialkataloge oder den Standardkatalog angehängt werden. Regeln im Standardkatalog gelten nur, wenn die Anfrage keinen bestimmten Materialkatalog anfügt.
Vorab-Verarbeitungsregeln für Anfragen können den Pfad und die Anfrageabschnitte von Anforderungen ändern, bevor sie vom Anforderungsparser des Servers verarbeitet werden. Dazu gehören das Manipulieren des Pfads, das Hinzufügen von Befehlen, das Ändern von Befehlswerten und das Anwenden von Vorlagen oder Makros. Regeln können auch verwendet werden, um einige Katalogattribute zu konfigurieren und zu überschreiben sowie um den Dienst auf bestimmte Client-IP-Adressen zu beschränken.
Regelsätze werden als XML-Dokumentdateien gespeichert. Der relative oder absolute Pfad der Regelsatzdatei muss in 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>
Die <?xml>
, <!DOCTYPE>
und <ruleset>
-Elemente sind immer in einer gültigen XML-Regelsatz-Datei erforderlich, auch wenn keine tatsächlichen Regeln definiert sind.
One <ruleset>
Element mit beliebiger Anzahl von <rule>
-Elemente erlaubt sind.
Beim Inhalt von Regeldateien zur Vorverarbeitung wird zwischen Groß- und Kleinschreibung unterschieden.
Vor jeder anderen Verarbeitung wird eine eingehende HTTP-Anforderung teilweise analysiert, um zu bestimmen, welcher Materialkatalog angewendet werden soll. Sobald der Katalog identifiziert wurde, wird der Regelsatz für den ausgewählten Katalog (oder der Standardkatalog, wenn kein bestimmter Katalog identifiziert wurde) angewendet.
Die <rule>
-Elemente in der Reihenfolge durchsucht werden, die für eine Übereinstimmung mit dem Inhalt der <expression>
Element ( expression
).
Wenn eine <rule>
zugeordnet wird, wird das optionale substitution
wird angewendet und die geänderte Anforderungszeichenfolge wird zur normalen Verarbeitung an den Anforderungsparser des Servers übergeben.
Wenn keine erfolgreiche Übereinstimmung beim Ende des <ruleset>
erreicht wird, wird die Anforderung ohne Änderung an den Parser übergeben.
Das Standardverhalten kann mit dem OnMatch
-Attribut <rule>
-Elemente. OnMatch
kann auf break
(Standard), continue
oder error.
Element und Attribut |
Verhalten bei Übereinstimmung |
---|---|
<rule OnMatch="break"> |
Die Regelverarbeitung wird sofort beendet, nachdem die Ersetzung für diese Regel vorgenommen wurde. Standard. |
<rule OnMatch="continue"> |
Die Ersetzung wird angewendet und die Verarbeitung wird mit der nächsten Regel fortgesetzt. |
<rule OnMatch="error"> |
Die Regelverarbeitung wird sofort beendet und der Antwortstatus "Anfrage verweigert"wird an den Client zurückgegeben. |
<rule>
-Elemente können optional Attribute definieren, die die entsprechenden Katalogattribute überschreiben, wenn die Regel erfolgreich abgeglichen wird, und OnMatch="break"
festgelegt ist. Es werden keine Attribute angewendet, wenn OnMatch="continue"
festgelegt ist. Siehe Beschreibung von <rule>
für eine Liste von Attributen, die mit Regeln gesteuert werden können.
Einfache Zeichenfolgenabgleiche funktionieren für sehr einfache Anwendungen, aber in den meisten Fällen sind reguläre Ausdrücke erforderlich. Während reguläre Ausdrücke den Branchenstandard aufweisen, variiert die spezifische Implementierung von Instanz zu Instanz.
package java.util.regex beschreibt die spezifische Implementierung regulärer Ausdrücke, die von Image Serving verwendet wird.
Um komplexe URL-Änderungen zu erleichtern, können Unterzeichenfolgen im Ausdruck erfasst werden, indem die Unterzeichenfolge in Klammern (…) eingeschlossen wird. Erfasste Teilzeichenfolgen werden in der Reihenfolge mit 1 beginnend gemäß der Position der führenden Klammer nummeriert. Die erfassten Teilzeichenfolgen können in die Substitution mit $n
, wobei n
ist die Sequenznummer der erfassten Teilzeichenfolge.
Eine Regelsatzdatei kann mit dem Katalogattribut an jeden Materialkatalog angehängt werden attribute::RuleSetFile
. Sie können die Regelsatzdatei zwar jederzeit bearbeiten, der Bildserver erkennt die Änderungen jedoch nur, wenn der zugehörige Materialkatalog neu geladen wird. Dies geschieht, wenn die Platform Server gestartet oder neu gestartet wird und wann immer die primäre Katalogdatei (die über eine .ini -Dateisuffix) geändert oder "berührt"(um das Dateidatum zu ändern).
Regelsatzbeispiele werden im entsprechenden Abschnitt der Bildkatalog-Referenz in der Image Serving-Dokumentation bereitgestellt.