규칙 세트 참조 rule-set-reference

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

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

요청 전처리 규칙은 요청에 의해 처리되기 전에 요청의 경로 및 쿼리 부분을 수정할 수 있습니다. Platform Server경로 조작, 명령 추가, 명령 값 변경, 템플릿 또는 매크로 적용 등 의 파서입니다. 규칙을 사용하여 요청 난독화, 워터마크 지정과 같은 카탈로그 특성으로만 일반적으로 제어되는 특정 보안 기능을 구성하고 재정의하고 서비스를 특정 클라이언트 IP 주소로 제한할 수도 있습니다.

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

일반 구조 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>

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

1개 <ruleset> 임의 개수의 요소를 포함하는 경우 <rule> 요소를 사용할 수 있습니다.

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

규칙 집합 유효성 검사 section-d8d101a0b4d74580835e37d128d05567

다음의 사본 RuleSet.xsd 는 카탈로그 폴더에 제공되며, 규칙 세트 파일을 다음에 등록하기 전에 유효성을 검사하는 데 사용해야 합니다. catalog.ini 파일. 이미지 제공에서는 의 내부 복사본을 사용합니다. RuleSet.xsd 유효성 검사용.

URL 사전 처리 section-2c09a2d79ada46b994857c6a7fb4c13a

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

다음 <rule> 요소는 의 콘텐츠와 일치시키기 위해 지정된 순서대로 검색됩니다. <expression> 요소( expression).

다음과 같은 경우 <rule> 일치함, 선택 사항 substitution 가 적용되고 수정된 요청 문자열이 정상적인 처리를 위해 서버의 요청 파서로 전달됩니다.

가 끝날 때 일치하는 항목이 없는 경우 <ruleset> 에 도달하면 수정 없이 요청이 파서로 전달됩니다.

OnMatch 특성 section-ed952fa55d99422db0ee68a2b9d395d3

기본 비헤이비어는 OnMatch 속성 <rule> 요소를 생성하지 않습니다. OnMatch 로 설정될 수 있습니다. break (기본값), continue, 또는 error.

카탈로그 속성 재정의 section-3f1e33a65c5346d1b4a69958c61432f3

다음 rule 요소는 규칙이 성공적으로 일치할 때 해당 카탈로그 속성을 재정의하는 속성을 선택적으로 정의할 수 있습니다. 일치하는 규칙을 여러 개 사용하여 동일한 속성을 설정하면 마지막 속성이 우선합니다. 다음을 참조하십시오 규칙 요소로 제어할 수 있는 속성 목록에 대한 요소입니다.

정규 표현식 section-3f77bb9a265147b38c645f63ab1bad8b

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

package java.util.regex이미지 제공에 사용되는 특정 정규 표현식 구현에 대해 설명합니다.

캡처된 하위 문자열 section-066e659406d5403599cd26ae35e80d68

복잡한 URL 수정을 용이하게 하기 위해 하위 문자열을 괄호(…)로 묶어 표현식에서 하위 문자열을 캡처할 수 있습니다. 캡처된 하위 문자열은 선행 괄호의 위치에 따라 1부터 순차적으로 번호가 매겨진다. 캡처된 서브스트링들은 다음을 사용하여 대체에 삽입될 수 있다. $ *n*, 여기서 n 는 캡처된 하위 문자열의 시퀀스 번호입니다.

규칙 세트 파일 관리 section-0598a608e4044bb4805fe93ceebe10a9

카탈로그 특성이 있는 각 이미지 카탈로그에 하나의 규칙 세트 파일을 첨부할 수 있습니다 attribute::RuleSetFile. 규칙 세트 파일을 언제든지 편집할 수 있지만 이미지 서버는 연결된 이미지 카탈로그가 다시 로드될 때만 변경 사항을 인식합니다. 이 다시 로드는 플랫폼 서버가 시작되거나 다시 시작될 때 및 이 있는 기본 카탈로그 파일이 .ini 파일 접미사를 수정하거나 "터치"하여 파일 날짜를 변경합니다.

예제 section-aa769437d967459299b83a4bf34fe924

예 A. 이미지 이름에 접미사 가 있는 경우 이미지 품질 설정을 높이는 규칙을 정의합니다. _hg":

<rule>
   <expression>(?i)_hg$</expression>
   <substitution>\?&amp;qlt=95,1&amp;resmode=bicub</substitution>
</rule>

규칙 표현식은 의 대소문자를 구분하지 않는 일치를 지정합니다. _hgURL 문자열 끝에 있는 ". 접미사는 이미지 품질 설정을 변경하는 지정된 쿼리 문자열로 대체됩니다. 다음 사항에 주의하십시오. ? 정규 표현식에서 이 문자는 특수 문자이므로 대체 문자열의 문자는 이스케이프됩니다.

<substitution><![CDATA[&qlt=95,1&resmode=bicub]]></substitution>

예 B. 특정 웹 응용 프로그램에서는 쿼리 문자열을 허용하지 않습니다. 후행 경로 요소를 변환하는 규칙 정의 small, medium, 또는 large 나머지 경로를 이미지 이름으로 사용하여 템플릿에 매핑할 수도 있습니다. 예를 들어, myCat/myImage/small 을(를) (으)로 번역 myCat/smallTemplate?src=myCat/myImage.

하위 문자열을 사용하여 요청을 재구성할 수 있습니다.

<rule>
   <expression>([^/]+)/(small|medium|large)$</expression>
   <substitution>$2Template?src=sample/$1</substitution>
</rule>

참조 section-9b748e7c5cff4759a70f96657bd43352

패키지 java.util.regex