규칙 세트 참조

이미지 렌더링은 정규 표현식 일치 및 대체 규칙을 기반으로 하는 간단한 요청 사전 처리 메커니즘을 지원합니다.

사전 처리 규칙(규칙 세트)의 컬렉션은 재료 카탈로그 또는 기본 카탈로그에 첨부할 수 있습니다. 기본 카탈로그의 규칙은 요청이 특정 자재 카탈로그를 첨부하지 않는 경우에만 적용됩니다.

요청 사전 처리 규칙은 경로 조작, 명령 추가, 명령 값 변경, 템플릿 또는 매크로 적용 등 서버의 요청 파서가 처리하기 전에 요청의 경로 및 쿼리 부분을 수정할 수 있습니다. 규칙을 사용하여 일부 카탈로그 속성을 구성하고 재정의할 수 있을 뿐만 아니라 특정 클라이언트 IP 주소로 서비스를 제한할 수도 있습니다.

규칙 세트는 XML 문서 파일로 저장됩니다. 규칙 세트 파일의 상대 또는 절대 경로는 attribute::RuleSetFile에 지정해야 합니다.

일반 구조

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

실제 규칙이 정의되지 않은 경우에도 항상 유효한 규칙 세트 XML 파일에 <?xml>, <!DOCTYPE><ruleset> 요소가 필요합니다.

임의 개수의 <rule> 요소를 포함하는 하나의 <ruleset> 요소가 허용됩니다.

사전 처리 규칙 파일의 내용은 대/소문자를 구분합니다.

URL 사전 처리

다른 처리 전에 들어오는 HTTP 요청을 부분적으로 구문 분석하여 어떤 자료 카탈로그를 적용해야 하는지 결정합니다. 카탈로그가 식별되면 선택한 카탈로그(또는 특정 카탈로그가 식별되지 않은 경우 기본 카탈로그)에 대한 규칙 세트가 적용됩니다.

<rule> 요소는 <expression> 요소의 내용( expression)과 일치시키기 위해 지정된 순서로 검색됩니다.

<rule>이(가) 일치하는 경우 선택적 substitution​이 적용되며 수정된 요청 문자열이 정상적인 처리를 위해 서버의 요청 파서에 전달됩니다.

<ruleset>의 끝에 도달했을 때 일치하는 항목이 없으면 요청이 수정 없이 파서에 전달됩니다.

OnMatch 속성

기본 동작은 <rule> 요소의 OnMatch 속성으로 수정할 수 있습니다. OnMatchbreak (기본값), continue 또는 로 설정될 수 있습니다. error.

요소 및 속성

일치하는 경우 동작

<rule OnMatch="break">

이 규칙에 대한 대체가 적용된 후 규칙 처리가 즉시 종료됩니다. 기본값.

<rule OnMatch="continue">

대체가 적용되고 다음 규칙이 계속 처리됩니다.

<rule OnMatch="error">

규칙 처리가 즉시 종료되고 "요청 거부" 응답 상태가 클라이언트에 반환됩니다.

카탈로그 속성 재정의

<rule> 규칙이 성공적으로 일치하고 설정될 때 해당 카탈로그 속성을 재정의하는 속성 OnMatch="break" 을 선택적으로 정의할 수 있습니다. OnMatch="continue" 이 설정된 경우에는 특성이 적용되지 않습니다. 규칙으로 제어할 수 있는 특성 목록은 <rule>에 대한 설명을 참조하십시오.

정규 표현식

간단한 문자열 일치 기능은 매우 기본적인 응용 프로그램에 대해 작동하지만 대부분의 경우 정규 표현식이 필요합니다. 정규 표현식은 업계 표준이지만 특정 구현은 인스턴스에 따라 다릅니다.

패키지 java.util. 는 이미지 제공 시 사용되는 특정 정규 표현식 구현을 다시 설명합니다.

캡처된 하위 문자열

복잡한 URL을 쉽게 수정할 수 있도록 하위 문자열을 괄호(…)로 묶어서 표현식에서 캡처할 수 있습니다. 캡처된 부분 문자열은 선행 괄호의 위치에 따라 순차적으로 1로 번호가 매겨집니다. 캡처된 하위 문자열은 $n​을 사용하여 대체에서 삽입할 수 있습니다. 여기서 n​은 캡처된 하위 문자열의 시퀀스 번호입니다.

규칙 세트 파일 관리

카탈로그 속성 attribute::RuleSetFile을 사용하여 각 재료 카탈로그에 하나의 규칙 세트 파일을 첨부할 수 있습니다. 언제든지 규칙 세트 파일을 편집할 수 있지만 이미지 서버는 연관된 자료 카탈로그가 다시 로드될 때만 변경 내용을 인식합니다. 이 문제는 Platform Server가 시작되거나 다시 시작될 때 그리고 파일 날짜를 변경하기 위해 .ini 파일 접미사가 있는 기본 카탈로그 파일이 수정되거나 '터치함'될 때마다 발생합니다.

예제

규칙 세트 예는 이미지 제공 설명서의 이미지 카탈로그 참조의 해당 섹션에 있습니다.

참조

java.util.regex

이 페이지에서는