레거시 플랫폼

XML 파일에서 정규식 정의

온라인 편집

별도의 XML 파일에 있는 입력 유효성 검증을 위해 정규식을 정의할 수 있습니다.

이들 정규식에 대한 참조는 datatypes.xml 파일에서 정의되는 여러 데이터 유형에서 사용할 수 있습니다. 또한 정규식에 대한 참조는 서로 다른 규칙 XML 파일에서 정의되는 여러 규칙에서 사용될 수 있습니다. 이 방식은 한 장소에서 정규식을 수정하기가 쉽게 만들고 변경사항이 datatypes.xml 파일과 다른 규칙 XML 파일 모두에서 적용됩니다. 각 정규식은 그와 연관된 고유 ID를 갖습니다. 정규식 파일은 <runtime_sandbox>/repository/eardata/smcfs/extn/web.xml 파일에 컨텍스트 매개변수를 추가하여 애플리케이션에 등록할 수 있습니다.

입력 유효성 검증을 위한 정규식을 정의하려면 다음 형식으로 XML 파일을 생성하십시오.

<RegularExpressions>
     <RegularExpression id="" javaPattern="" jsPattern="" blacklistErrorMsg=""
       whitelistErrorMsg=""/>
     <RegularExpression id="" javaPattern="" jsPattern=""/> 
</RegularExpressions>

다음 표에서는 정규식 XML 파일의 다양한 요소 및 속성을 설명합니다.

주: 비어 있는 속성은 제공되지 않은 것으로 간주됩니다. 예를 들어, <RegularExpression id="dates" javaPattern="" jsPattern="^[a-zA-Z0-9.,!\-/+=_ :]*$"/>로 정의된 요소는 <RegularExpression id="dates" jsPattern="^[a-zA-Z0-9.,!\-/+=_ :]*$"/>와 같습니다.

요소/속성

설명

RegularExpressions

필수입니다. 정규식 XML 파일에는 루트 요소로 RegularExpressions를 포함해야 합니다.

RegularExpression

선택사항. 각 정규식은 하나의 RegularExpression 요소로 정의되어야 합니다. 정규식은 발생하지 않거나 한 번 이상 발생할 수 있습니다.

ID

필수입니다. 정규식의 고유한 식별자입니다. 이 ID는 다양한 로케이션에서 이 정규식에 대한 참조로 사용할 수 있습니다.

javaPattern

선택사항. 서버 측 유효성 검증 수행을 위한 정규식 패턴입니다. 지정되지 않으면, jsPattern 속성값을 기반으로 입력 유효성 검증이 클라이언트 측에서 발생하며 서버 측 유효성 검증은 수행되지 않습니다.

jsPattern

선택사항. 클라이언트 측 유효성 검증 수행을 위한 정규식 패턴입니다. 지정되지 않으면, javaPattern 속성값을 기반으로 하는 입력 유효성 검증이 서버 측에서 발생하며 클라이언트 측 유효성 검증은 수행되지 않습니다.

whitelistErrorMsg

선택사항. 정규식에 대한 화이트 리스트 패턴에 실패한 경우 에러 메시지의 번들 키가 표시됩니다.

blacklistErrorMsg

선택사항. 정규식에 대한 블랙리스트 패턴에 실패한 경우 에러 메시지의 번들 키가 표시됩니다.

예를 들어 id가 date인 정규식을 정의하는 경우 정규식 XML 파일은 다음과 같습니다.

<RegularExpressions>
    <RegularExpression id="dates" javaPattern="^[a-zA-Z0-9.,!\-/+=_ :]*$"
           jsPattern="^[a-zA-Z0-9.,!\-/+=_:]*$" blacklistErrorMsg=""
           whitelistErrorMsg=""/> 
</RegularExpressions>

규칙 XML과 데이터 유형 XML 모두에서 date 정규식을 참조할 수 있습니다.

규칙 XML에서 정규식 참조 사용

규칙 XML에서 규칙을 정의할 때 RegularExpression 요소에서 정규식 ID의 참조를 제공할 수 있습니다. 예를 들면 다음과 같습니다.

<ValidationRules> 
    <Rule id="" ruleType="Regex" inputType="" inputName="" uri="" 
      maxLength="" minLength="" allowNull="" > 
     <Whitelist> 
        <RegularExpression ref="dates"/> 
     </Rule> 
</ValidationRules>

데이터 유형 XML에서 정규식 참조 사용

datatypes.xml 파일에서 정규식을 정의할 때 Regex 요소에서 정규식 ID의 참조를 제공할 수 있습니다. 예를 들면 다음과 같습니다.

<DataTypes>
    <DataType Name="Date" PpcSize="12" Size="7" Type="DATE">
        <Validation>
             <Regex Ref="dates" />        
        </Validation>
        <UIType Size="8" UITableSize="15"/>
   </DataType> 
</DataTypes>