Riferimento set di regole rule-set-reference
Image Server supporta un semplice meccanismo di preelaborazione delle richieste basato su regole di corrispondenza e sostituzione delle espressioni regolari.
Raccolte di regole di pre-elaborazione (set di regole) possono essere collegate ai cataloghi di immagini o al catalogo predefinito. Le regole del catalogo predefinito si applicano solo se la richiesta non identifica un catalogo principale di immagini specifico.
Le regole di pre-elaborazione delle richieste possono modificare il percorso e eseguire query su parti delle richieste prima che vengano elaborate dal parser di Platform Server, inclusa la modifica 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 alcune funzioni di sicurezza che di solito sono controllate solo con attributi di catalogo, come offuscamento delle richieste, watermark, nonché per limitare il servizio a specifici indirizzi IP client.
I set di regole vengono memorizzati come file di documenti XML. Il percorso relativo o assoluto del file del set di regole deve essere specificato in attribute::RuleSetFile.
Struttura generale section-8bcbd91ea8a946f28051bde8ad21827f
<?xml version="1.0" encoding="UTF-8"?>
<ruleset>
<rule>
<expression>
<varname>
expression
</varname></expression>
<substitution>
<varname>
substitution
</varname></substitution>
<addressfilter>
<varname>
addressFilter
</varname></addressfilter>
<header>
<varname>
headerValue
</varname></header>
</rule>
</ruleset>
Gli elementi <?xml> e <ruleset> sono sempre necessari 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>.
Il contenuto dei file delle regole di preelaborazione distingue tra maiuscole e minuscole.
Convalida set di regole section-d8d101a0b4d74580835e37d128d05567
Una copia di RuleSet.xsd è fornita nella cartella del catalogo e deve essere utilizzata per convalidare un file del set di regole prima di registrarlo nel file catalog.ini. Image Server utilizza una copia interna di RuleSet.xsd per la convalida.
Pre-elaborazione URL section-2c09a2d79ada46b994857c6a7fb4c13a
Prima di qualsiasi altra elaborazione, viene parzialmente analizzata una richiesta HTTP in ingresso per determinare quale catalogo immagini applicare. Una volta identificato il catalogo, viene applicato il set di regole per il catalogo selezionato (o il catalogo predefinito, se non è stato identificato alcun catalogo specifico).
Gli elementi <rule> vengono cercati nell'ordine specificato per trovare una corrispondenza con il contenuto dell'elemento <expression> ( expression).
Se viene trovata una corrispondenza per <rule>, viene applicato l'elemento facoltativo substitution e la stringa di richiesta modificata viene passata al parser di richieste del server per la normale elaborazione.
Se non viene stabilita una corrispondenza corretta quando viene raggiunta la fine di <ruleset>, la richiesta viene passata al parser senza modifiche.
Attributo OnMatch section-ed952fa55d99422db0ee68a2b9d395d3
È possibile modificare il comportamento predefinito con l'attributo OnMatch dell'elemento <rule>. OnMatch può essere impostato su break (impostazione predefinita), continue o error.
Ignorare gli attributi del catalogo section-3f1e33a65c5346d1b4a69958c61432f3
L'elemento rule può facoltativamente definire attributi che sostituiscono gli attributi di catalogo corrispondenti quando la regola viene trovata correttamente corrispondente. Se più regole corrispondenti impostano lo stesso attributo, prevale l’ultimo. Per un elenco di attributi controllabili tramite regole, vedere l'elemento rule.
Espressioni regolari section-3f77bb9a265147b38c645f63ab1bad8b
La corrispondenza delle stringhe semplice funziona per applicazioni molto semplici, ma nella maggior parte dei casi sono necessarie espressioni regolari. Anche se le espressioni regolari sono standard di settore, l’implementazione specifica varia da un’istanza all’altra.
package java.util.regex descrive l'implementazione specifica delle espressioni regolari utilizzata da Image Server.
Sottostringhe acquisite section-066e659406d5403599cd26ae35e80d68
Per facilitare modifiche URL complesse, è possibile acquisire sottostringhe nell’espressione racchiudendo la sottostringa tra parentesi (…). Le sottostringhe acquisite vengono numerate in sequenza iniziando 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 del set di regole section-0598a608e4044bb4805fe93ceebe10a9
È possibile allegare un file di set di regole a ogni catalogo immagini con l'attributo di catalogo attribute::RuleSetFile. Anche se è possibile modificare il file del set di regole in qualsiasi momento, il server immagini riconosce le modifiche solo quando il catalogo immagini associato viene ricaricato. Questo ricaricamento si verifica all'avvio o al riavvio del server Platform e ogni volta che il file di catalogo primario, con suffisso di file .ini, viene modificato o "toccato" per modificare la data del file.
Esempi section-aa769437d967459299b83a4bf34fe924
Esempio A. Definisci una regola che aumenti le impostazioni di qualità dell'immagine se il nome dell'immagine ha il suffisso " _hg":
<rule>
<expression>(?i)_hg$</expression>
<substitution>\?&qlt=95,1&resmode=bicub</substitution>
</rule>
L'espressione della regola specifica una corrispondenza senza distinzione tra maiuscole e minuscole di " _hg" alla fine della stringa URL. Il suffisso viene sostituito con la stringa di query specificata che modifica le impostazioni di qualità dell'immagine. Si noti che il carattere ? nella stringa di sostituzione ha escape, in quanto si tratta di un carattere speciale nelle espressioni regolari.
<substitution><![CDATA[&qlt=95,1&resmode=bicub]]></substitution>
Esempio B. Una particolare applicazione Web non consente stringhe di query. Definire una regola che converta l'elemento del percorso finale small, medium o large in un modello, utilizzando il resto del percorso come nome dell'immagine. myCat/myImage/small, ad esempio, tradurrebbe in myCat/smallTemplate?src=myCat/myImage.
È possibile utilizzare le sottostringhe per ristrutturare la richiesta:
<rule>
<expression>([^/]+)/(small|medium|large)$</expression>
<substitution>$2Template?src=sample/$1</substitution>
</rule>