Référence d’ensemble de règles

Le rendu d’image prend en charge un mécanisme de prétraitement de requête simple 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 matériaux ou au catalogue par défaut. Les règles du catalogue par défaut s’appliquent uniquement si la demande ne joint pas de catalogue de matières spécifique.

Les règles de prétraitement des requêtes peuvent modifier les parties de chemin et de requête des requêtes avant qu’elles ne soient traitées par l’analyseur de requêtes du serveur, notamment en manipulant le chemin, 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 ensembles de règles sont stockés sous la forme de fichiers de document XML. Le chemin relatif ou absolu du fichier d’ensemble 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 d’ensemble de règles valide, même si aucune règle réelle n’est définie.

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

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

Prétraitement des URL

Avant tout autre traitement, une requête HTTP entrante est partiellement analysée afin de déterminer quel catalogue de matériaux 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 une correspondance <rule> est trouvée, la valeur facultative substitution est appliquée et la chaîne de requête modifiée est transmise à l’analyseur de requêtes du serveur pour un traitement normal.

Si aucune correspondance réussie n’est effectuée 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 lorsqu’une correspondance se produit

<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> Les éléments peuvent éventuellement définir des attributs qui remplacent les attributs de catalogue correspondants lorsque la règle correspond et OnMatch="break" est définie. Aucun attribut n’est appliqué si OnMatch="continue" est défini. Reportez-vous à la description de <rule> pour obtenir la liste des attributs qui peuvent être contrôlés avec des règles.

Expressions régulières

Une correspondance de chaîne simple fonctionne pour les applications très basiques, mais des expressions régulières sont requises dans la plupart des cas. Bien que les expressions régulières soient standard dans le secteur, l’implémentation spécifique varie d’une instance à l’autre.

package java.util. regexdécrit l’implémentation spécifique des expressions régulières utilisée par le serveur d’images.

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, selon la position de la parenthèse de début. Les sous-chaînes capturées peuvent être insérées dans la substitution à l’aide de $n, où n est le 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 d’ensemble de règles à tout moment, le serveur d’images ne reconnaît les modifications que lorsque le catalogue de matériel associé est rechargé. Cela se produit lorsque le serveur Platform est démarré ou redémarré et lorsque le Principal fichier catalogue (portant le suffixe .ini) est modifié ou "touché" (pour modifier la date du fichier).

Exemples

Des exemples de jeux de règles sont fournis dans la section correspondante de la référence du catalogue d’images de la documentation du serveur d’images.

Voir aussi

package java.util.regex

Sur cette page