Referência do conjunto de regras rule-set-reference

A Renderização de imagem é compatível com um mecanismo de pré-processamento de solicitação simples que se baseia em regras de correspondência e substituição de expressão regular.

Coleções de regras de pré-processamento (conjuntos de regras) podem ser anexados a catálogos de materiais ou ao catálogo padrão. As regras no catálogo padrão se aplicam somente se a solicitação não anexar um catálogo de materiais específico.

As regras de pré-processamento de solicitações podem modificar o caminho e as partes de consulta de solicitações antes que elas sejam processadas pelo analisador de solicitações do servidor, incluindo manipulação do caminho, adição de comandos, alteração de valores de comando e aplicação de modelos ou macros. As regras também podem ser usadas para configurar e substituir alguns atributos de catálogo, bem como para limitar o serviço a endereços IP de clientes específicos.

Os conjuntos de regras são armazenados como arquivos de documento XML. O caminho relativo ou absoluto do arquivo de conjunto de regras deve ser especificado em attribute::RuleSetFile.

Estrutura geral section-74faaee27fc543a2ab4a306f3a03674e

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

A variável <?xml>, <!DOCTYPE> e <ruleset> Os elementos são sempre necessários em um arquivo XML válido de conjunto de regras, mesmo se nenhuma regra real estiver definida.

Um <ruleset> elemento que contém qualquer número de <rule> elementos são permitidos.

O conteúdo dos arquivos de regras de pré-processamento diferencia maiúsculas de minúsculas.

Pré-processamento de URL section-737a38d1b8c746f995e64fa6cfbcec87

Antes de qualquer outro processamento, uma solicitação HTTP de entrada é parcialmente analisada para determinar qual catálogo de materiais deve ser aplicado. Depois que o catálogo é identificado, o conjunto de regras do catálogo selecionado (ou o catálogo padrão, se nenhum catálogo específico foi identificado) é aplicado.

A variável <rule> os elementos são pesquisados na ordem especificada para uma correspondência com o conteúdo do <expression> elemento ( expression).

Se um <rule> for correspondente, a variável substitution é aplicado e a string de solicitação modificada é passada para o analisador de solicitação do servidor para processamento normal.

Se nenhuma correspondência bem-sucedida for feita quando o final da <ruleset> for atingida, a solicitação será transmitida ao analisador sem modificação.

O atributo OnMatch section-7a8ad3597780486985af5e9a3b1c7b56

O comportamento padrão pode ser modificado com a variável OnMatch atributo de <rule> elementos. OnMatch pode ser definido como break (padrão), continueou error.

Elemento e atributo
Comportamento quando ocorre uma correspondência
<rule OnMatch="break">
O processamento de regras é encerrado imediatamente após a substituição dessa regra ter sido aplicada. Padrão.
<rule OnMatch="continue">
A substituição é aplicada e o processamento continua com a próxima regra.
<rule OnMatch="error">
O processamento de regras é encerrado imediatamente e um status de resposta "solicitação recusada" é retornado ao cliente.

Substituição de atributos de catálogo section-1f59ce84234f4576ba8473b0e6ba22ee

<rule> os elementos podem, opcionalmente, definir atributos que substituem os atributos de catálogo correspondentes quando a regra é correspondida com sucesso e OnMatch="break" está definido. Nenhum atributo é aplicado se OnMatch="continue" está definido. Consulte a descrição de <rule> para obter uma lista de atributos que podem ser controlados com regras.

Expressões regulares section-4d326507b52544b0960a9a5f303e3fe6

A correspondência de strings simples funciona para aplicativos muito básicos, mas expressões regulares são necessárias na maioria das instâncias. Embora as expressões regulares sejam padrão do setor, a implementação específica varia de instância para instância.

pacote java.util.regex descreve a implementação de expressão regular específica usada pelo Servidor de imagens.

Substrings capturadas section-8057cd65d48949ffb6a50e929bd3688b

Para facilitar modificações complexas de URL, substrings podem ser capturadas na expressão ao colocar a substring entre parênteses (…). As subsequências de caracteres capturadas são numeradas sequencialmente, começando com 1 de acordo com a posição do parêntese inicial. As substrings capturadas podem ser inseridas na substituição usando $n, onde n é o número de sequência da substring capturada.

Gerenciamento de arquivos de conjunto de regras section-e8ce976b56404c009496426fd334d23d

Um arquivo de conjunto de regras pode ser anexado a cada catálogo de materiais com o atributo de catálogo attribute::RuleSetFile. Embora você possa editar o arquivo de conjunto de regras a qualquer momento, o servidor de imagens reconhece as alterações somente quando o catálogo de materiais associado é recarregado. Isso acontece quando a variável Platform Server seja iniciado ou reiniciado e sempre que o arquivo de catálogo principal (que tem um .ini file suffix) for modificado ou "tocado" (para alterar a data do arquivo).

Exemplos section-c4142a41f5cd4ff799a72fbc130c3700

Os exemplos de conjunto de regras são fornecidos na seção correspondente da Referência ao catálogo de imagens na documentação do Servidor de imagens.

Consulte também section-cdaacf84f92c4bffbb4b76197b4e531a

pacote java.util.regex

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49