Riferimento set di regole

Image Rendering supporta un semplice meccanismo di pre-elaborazione delle richieste basato su regole di corrispondenza e sostituzione delle espressioni regolari.

Le raccolte di regole di pre-elaborazione (set di regole) possono essere collegate ai cataloghi dei materiali o al catalogo predefinito. Le regole nel catalogo predefinito si applicano solo se la richiesta non allega un catalogo materiale specifico.

Le regole di pre-elaborazione delle richieste possono modificare il percorso e le porzioni di query delle richieste prima che vengano elaborate dall'analizzatore delle richieste del server, compresa la manipolazione del percorso, l'aggiunta di comandi, la modifica dei valori dei comandi e l'applicazione di modelli o macro. Le regole possono essere utilizzate anche per configurare e ignorare alcuni attributi del catalogo, nonché per limitare il servizio a specifici indirizzi IP client.

I set di regole sono memorizzati come file di documento XML. Il percorso relativo o assoluto del file del set di regole deve essere specificato in attribute::RuleSetFile.

Struttura generale

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

Gli elementi <?xml>, <!DOCTYPE> e <ruleset> sono sempre richiesti in un file XML di set di regole valido, anche se non sono definite regole effettive.

È consentito un elemento <ruleset> contenente un numero qualsiasi di elementi <rule>.

I contenuti dei file delle regole di pre-elaborazione sono con distinzione tra maiuscole e minuscole.

Pre-elaborazione URL

Prima di qualsiasi altra elaborazione, una richiesta HTTP in entrata viene analizzata in parte per determinare quale catalogo di materiali applicare. Una volta identificato il catalogo, viene applicato il set di regole per il catalogo selezionato (o per il catalogo predefinito, se non è stato identificato alcun catalogo specifico).

La ricerca degli elementi <rule> avviene nell'ordine specificato per trovare una corrispondenza con il contenuto dell'elemento <expression> ( expression).

Se viene rilevata una corrispondenza tra <rule>, viene applicata l'opzione substitution e la stringa di richiesta modificata viene passata al parser di richieste del server per una normale elaborazione.

Se non viene eseguita alcuna corrispondenza valida quando viene raggiunta la fine del <ruleset>, la richiesta viene trasmessa al parser senza modifiche.

L'attributo OnMatch

Il comportamento predefinito può essere modificato con l'attributo OnMatch degli elementi <rule>. OnMatch può essere impostato su break (predefinito), continueoppure error.

Elemento e attributo

Comportamento quando si verifica una corrispondenza

<rule OnMatch="break">

L'elaborazione della regola viene terminata immediatamente dopo l'applicazione della sostituzione per questa regola. Predefinito.

<rule OnMatch="continue">

La sostituzione viene applicata e l'elaborazione continua con la regola successiva.

<rule OnMatch="error">

L'elaborazione della regola viene terminata immediatamente e lo stato di risposta della richiesta rifiutata viene restituito al client.

Sostituzione degli attributi del catalogo

<rule> gli elementi possono anche definire attributi che ignorano gli attributi del catalogo corrispondenti quando la regola viene rilevata e OnMatch="break" impostata correttamente. Non vengono applicati attributi se è impostato OnMatch="continue". Fare riferimento alla descrizione di <rule> per un elenco di attributi che possono essere controllati con le regole.

Espressioni regolari

La semplice corrispondenza delle stringhe funziona per applicazioni molto semplici, ma nella maggior parte dei casi sono necessarie espressioni regolari. Sebbene le espressioni regolari siano standard di settore, l'implementazione specifica varia da un'istanza all'altra.

package java.util. regexdescrive l’implementazione specifica delle espressioni regolari utilizzate da Image Server.

Sottostringhe acquisite

Per semplificare complesse modifiche agli URL, nell'espressione possono essere acquisite delle sottostringhe racchiudendo la sottostringa con parentesi (…). Le sottostringhe acquisite vengono numerate in sequenza a partire da 1 in base alla posizione delle parentesi iniziali. Le sottostringhe acquisite possono essere inserite nella sostituzione utilizzando $n, dove n è il numero di sequenza della sottostringa acquisita.

Gestione dei file di set di regole

È possibile allegare un file set di regole a ciascun catalogo di materiali con l'attributo di catalogo attribute::RuleSetFile. Anche se potete modificare il file del set di regole in qualsiasi momento, il server immagini riconosce le modifiche solo quando il catalogo materiale associato viene ricaricato. Ciò si verifica quando il server della piattaforma viene avviato o riavviato e ogni volta che il file del catalogo principale (con un suffisso di file .ini) viene modificato o toccato (per modificare la data del file).

Esempi

Gli esempi di set di regole sono forniti nella sezione corrispondente del Riferimento per il catalogo immagini nella documentazione di Image Server.

Consultate anche

package java.util.regex

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free