Référence du jeu de règles

Le rendu d’image prend en charge un mécanisme de prétraitement de requête simple qui est basé sur les règles de correspondance et de substitution des expressions régulières.

Les collections de règles de prétraitement (ensembles de règles) peuvent être jointes aux catalogues de matières ou au catalogue par défaut. Les règles du catalogue par défaut s’appliquent uniquement si la demande ne joint pas un catalogue de matières spécifique.

Les règles de prétraitement des requêtes peuvent modifier les parties chemin et requête des requêtes avant d’être traitées par l’analyseur de requêtes du serveur, notamment en manipulant le chemin d’accès, en ajoutant des commandes, en modifiant les valeurs de commande et en appliquant des modèles ou des macros. Des règles peuvent également être utilisées pour configurer et remplacer certains attributs de catalogue, ainsi que pour limiter le service à des adresses IP client spécifiques.

Les jeux de règles sont stockés en tant que fichiers de document XML. Le chemin relatif ou absolu du fichier de jeu de règles doit être spécifié dans attribute::RuleSetFile.

Structure générale

<?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>

Les éléments <?xml>, <!DOCTYPE> et <ruleset> sont toujours requis dans un fichier XML de jeu de règles valide, même si aucune règle réelle n'est définie.

Un élément <ruleset> contenant un nombre quelconque d'éléments <rule> est autorisé.

Le contenu des fichiers de règles de prétraitement est sensible à la casse.

Prétraitement de l’URL

Avant tout autre traitement, une requête HTTP entrante est partiellement analysée afin de déterminer quel catalogue de matières doit être appliqué. Une fois le catalogue identifié, le jeu de règles pour le catalogue sélectionné (ou le catalogue par défaut, si aucun catalogue spécifique n’a été identifié) est appliqué.

Les éléments <rule> sont recherchés dans l'ordre spécifié pour une correspondance avec le contenu de l'élément <expression> ( expression).

Si un <rule> correspond, le substitution facultatif est appliqué et la chaîne de requête modifiée est transmise à l’analyseur de requêtes du serveur pour traitement normal.

Si aucune correspondance réussie n'est établie lorsque la fin de <ruleset> est atteinte, la requête est transmise à l'analyseur sans modification.

Attribut OnMatch

Le comportement par défaut peut être modifié avec l'attribut OnMatch des éléments <rule>. OnMatch peut être défini sur break (par défaut), continue ou error.

Elément et attribut

Comportement en cas de correspondance

<rule OnMatch="break">

Le traitement des règles est arrêté immédiatement après l’application de la substitution de cette règle. Par défaut.

<rule OnMatch="continue">

La substitution est appliquée et le traitement se poursuit avec la règle suivante.

<rule OnMatch="error">

Le traitement de la règle est arrêté immédiatement et un état de réponse "demande refusée" est renvoyé au client.

Remplacement des attributs de catalogue

<rule> peuvent éventuellement définir des attributs qui remplacent les attributs de catalogue correspondants lorsque la règle est correctement mise en correspondance et OnMatch="break" est définie. Aucun attribut n’est appliqué si OnMatch="continue" est défini. Reportez-vous à la description de <rule> pour une liste d’attributs qui peuvent être contrôlés avec des règles.

Expressions régulières

La simple correspondance des chaînes fonctionne pour les applications de base, mais des expressions régulières sont requises dans la plupart des cas. Bien que les expressions régulières soient conformes aux normes du secteur, la mise en oeuvre spécifique varie d’une instance à l’autre.

package java.util. regexdécrit l’implémentation d’expression régulière spécifique utilisée par Image Serving.

Sous-chaînes capturées

Pour faciliter des modifications d’URL complexes, les sous-chaînes peuvent être capturées dans l’expression en encadrant la sous-chaîne avec des parenthèses (…). Les sous-chaînes capturées sont numérotées de manière séquentielle en commençant par 1, en fonction de la position de la parenthèse de début. Les sous-chaînes capturées peuvent être insérées dans la substitution en utilisant $n, où n correspond au numéro de séquence de la sous-chaîne capturée.

Gestion des fichiers de jeu de règles

Un fichier d'ensemble de règles peut être joint à chaque catalogue de matières avec l'attribut de catalogue attribute::RuleSetFile. Bien que vous puissiez modifier le fichier du jeu de règles à tout moment, le serveur d’images ne reconnaît les modifications que lorsque le catalogue de matières associé est rechargé. Cela se produit lorsque le serveur de plateformes est démarré ou redémarré et chaque fois que le fichier catalogue Principal (qui comporte un suffixe de fichier .ini) est modifié ou "touché" (pour modifier la date du fichier).

Exemples

Les exemples d’ensemble de règles sont fournis dans la section correspondante de la référence du catalogue d’images dans la documentation sur la diffusion d’images.

Voir aussi

package java.util.regex

Sur cette page