DojoLib
DojoLib 라이브러리에는 EGL Dojo 위젯에서 사용되는 상수 및 유효성 검증 함수가 포함되어 있습니다. 이 라이브러리는 시스템 라이브러리가 아니며 사용에는 전제조건이 있습니다.
전제조건은 다음과 같습니다.
- 다음과 같은 import 문을 지정하십시오.
import dojo.widgets.DojoLib;Rich UI 핸들러에 다음 use 문을 포함시키면 가장 쉽게 DojoLib 라이브러리에 액세스할 수 있습니다.use DojoLib; - 프로젝트의 EGL 빌드 경로는 com.ibm.egl.rui.dojo.runtime.local_x.y와 같은 Dojo 런타임을 참조해야 합니다. 여기서 x.y는 런타임 프로젝트의 현재 버전을 표시합니다. 세부사항은 "EGL 빌드 경로 편집"을 참조하십시오.
라이브러리를 통해 다음 함수를 사용할 수 있습니다.
- Validators.EmailValidator(emailAddress String in, constraints Dictionary in) returns (Boolean)
- Validators.EmailValidator는 첫 번째 매개변수가 이메일 주소를
나타내는지 여부를 표시합니다. 두 번째 매개변수는 제한조건 세트를 포함하는 사전이며, 각각은 부울 값으로 설정됩니다.
사전의 각 키를 부울 값으로 설정하십시오. true는 필수를 의미하며 false는 허용되지 않음을 의미하고 [true, false]는 선택사항을 의미합니다.
다음 제한조건에 유의하십시오.- allowCC
- 국가 코드 최상위 레벨 도메인의 사용을 확인합니다. 유효한 국가 코드 목록에 대해서는 IANA(Internet Assigned Numbers Authority)가 제공하는 "Root Zone Database"를 참조하십시오.
- allowCruft
- mailto 형식의 사용을 확인합니다. 기본값은 false입니다.
- allowDecimal
- 0 - 4294967295 범위의 10진수를 확인합니다.
- allowDottedDecimal
- IPv4의 경우 207.142.131.235과 같은 주소인지 확인합니다. 0 채우기는 허용되지 않습니다.
- allowDottedHex
- IPv4의 경우 0x18.0x11.0x9b과 같은 주소인지 확인합니다. 값은 대소문자를 구분하지 않습니다. 0 채우기가 허용됩니다.
- allowDottedOctal
- IPv4의 경우 0030.0021.0233.0050과 같은 주소인지 확인합니다. 0 채우기가 허용됩니다.
- allowGeneric
- 일반 최상위 레벨 도메인의 사용을 확인합니다. 유효한 도메인 목록에 대해서는 IANA(Internet Assigned Numbers Authority)가 제공하는 "Root Zone Database"를 참조하십시오.
- allowHex
- IPv4의 경우 0x0 - 0xFFFFFFFF 범위의 16진수인지 확인합니다(예: 0xCF8E83EB). 값은 대소문자를 구분하지 않습니다. 0 채우기가 허용됩니다.
- allowHybrid
- 16진수 4자리의 6개 그룹으로 쓰여진 IPv6 주소 다음에 IPv4의 일반적인 4자리 점분리 10진수 표기를 확인합니다. 전체 형식은 x:x:x:x:x:x:d.d.d.d입니다.
- allowInfra
- 인프라 최상위 레벨 도메인의 사용을 확인합니다. 유효한 도메인은 ARPA(Address and Routing Parameter Area) 도메인입니다. 세부사항은 IANA(Internet Assigned Numbers Authority)가 제공하는 ".ARPA Zone Management"를 참조하십시오.
- allowIP
- 리터럴 IP 주소의 사용을 확인합니다. 기본값은 true입니다.
- allowIPV6
- 16진수 4자리의 8개 그룹으로 쓰여진 IPv6 주소를 확인합니다.
- allowLocal
- "localhost"가 허용됨을 확인합니다. 기본값은 false입니다.
- allowNamed
- URL에 로컬 네트워크를 위한 이름 지정된 호스트가 포함될 수 있는지 확인합니다. 기본값은 false입니다.
- allowPort
- 포트 번호가 허용되는지 확인합니다. 기본값은 true입니다.
myDictionary Dictionary {allowCruft = true}; Validators.EmailValidator("mailto:you@example.com", myDictionary); - Validators.IPValidator (IPAddress String in, constraints Dictionary in) returns (Boolean)
- Validators.IPValidator는 첫 번째 매개변수가 IP 주소를
나타내는지 여부를 표시합니다. 두 번째 매개변수는 제한조건 세트를 포함하는 사전이며, 각각은 부울 값으로 설정됩니다. 예제 호출은 다음과 같습니다.
myDictionary Dictionary {allowDottedDecimal = true, allowIPV6 = false}; Validators.IPValidator("191.0.2.1", myDictionary);IPv4의 첫 네 개와 IPv6의 마지막 두 개에 대해 다음 제한조건이 적용됩니다.- allowDecimal
- 0 - 4294967295 범위의 10진수를 확인합니다.
- allowDottedDecimal
- IPv4의 경우 207.142.131.235과 같은 주소인지 확인합니다. 0 채우기는 허용되지 않습니다.
- allowDottedHex
- IPv4의 경우 0x18.0x11.0x9b과 같은 주소인지 확인합니다. 값은 대소문자를 구분하지 않습니다. 0 채우기가 허용됩니다.
- allowDottedOctal
- IPv4의 경우 0030.0021.0233.0050과 같은 주소인지 확인합니다. 0 채우기가 허용됩니다.
- allowHex
- IPv4의 경우 0x0 - 0xFFFFFFFF 범위의 16진수인지 확인합니다(예: 0xCF8E83EB). 값은 대소문자를 구분하지 않습니다. 0 채우기가 허용됩니다.
- allowHybrid
- 16진수 4자리의 6개 그룹으로 쓰여진 IPv6 주소 다음에 IPv4의 일반적인 4자리 점분리 10진수 표기를 확인합니다. 전체 형식은 x:x:x:x:x:x:d.d.d.d입니다.
- allowIPV6
- 16진수 4자리의 8개 그룹으로 쓰여진 IPv6 주소를 확인합니다.
- Validators.NumberFormatValidator (inputNumber String in, constraints Dictionary in) returns (Boolean)
- Validators.NumberFormatValidator는 첫 번째 매개변수가 적절하게 형식화된 수를
나타내는지 여부를 표시합니다. 두 번째 매개변수는 제한조건 세트를 포함하는 사전입니다. 유일한 사전 키는 format이고 값 변형은 다음과 같습니다.
# Represents a digit, 0-9. ? Represents a digit, 0-9; but the digit is optional. Other characters are as is. Here are examples: "(###) ###-####" -> (999) 999-9999 "(###) ###-#### x#???" -> (999) 9999-9999 x123예제 호출은 다음과 같습니다.
myDictionary Dictionary {format = "(###) ###-####"}; Validators.NumberFormatValidator("191.42", myDictionary); - Validators.PatternValidator (input String in, pattern String in) returns (Boolean)
- Validators.PatternValidator는 첫 번째 매개변수가 정규식인 두 번째 매개변수와
일치하는지 여부를 표시합니다. 예제 호출은 다음과 같습니다.
Validators.PatternValidator("1234", "[0-9]+");정규식 규칙은 JavaScript가 지원하는 것입니다. 다음 스펙에 나타낸 것처럼 규칙은 Perl 버전 5를 기반으로 합니다.배경 정보에 대해서는 Jeffrey E.F. Friedl의 Mastering Regular Expressions(O'Reilly Media, August 2006, ISBN 978-0-596-52812-6)을 고려하십시오.
- Validators.RangeValidator (input String in, constraints Dictionary in) returns (Boolean);
- Validators.RangeValidator은 두 번째 매개변수가 지정하는 범위에서
첫 번째 매개변수가 숫자인지 여부를 표시합니다. 사전에서 다음 키가 유효합니다.
- min
- 첫 번째 매개변수가 지정된 수보다 크거나 같은지 확인합니다.
- max
- 첫 번째 매개변수가 지정된 수보다 작거나 같은지 확인합니다.
- decimal
- 10진수 소수점에 사용되는 문자를 식별합니다. 기본값은 마침표입니다.
예제 호출은 다음과 같습니다.
myDictionary Dictionary {min = 10, max = 20}; Validators.RangeValidator("18", myDictionary); - Validators.TextValidator (input String in, constraints Dictionary in) returns (Boolean)
- Validators.TextValidator는 첫 번째 매개변수가 두 번째 매개변수와
일치하는지 여부를 표시합니다. 사전에서 다음 키가 유효합니다.
- length
- 첫 번째 매개변수의 문자 수가 여기에 지정된 수와 일치하는지 확인합니다.
- minlength
- 첫 번째 매개변수의 문자 수가 여기에 지정된 수 이상인지 확인합니다.
- maxlength
- 첫 번째 매개변수의 문자 수가 여기에 지정된 수 이하인지 확인합니다.
예제 호출은 다음과 같습니다.myDictionary Dictionary {length = 4}; Validators.TextValidator("Four", myDictionary); - Validators.URLValidator (input String in, constraints Dictionary in) returns (Boolean)
- Validators.URLValidator는 첫 번째 매개변수가 두 번째 매개변수와
일치하는지 여부를 표시합니다. 사전의 각 키를 부울 값으로 설정하십시오. true는 필수를 의미하며 false는 허용되지 않음을 의미하고 [true, false]는 선택사항을 의미합니다. 올바른 키는 다음과 같습니다.예제 호출은 다음과 같습니다.
- allowCC
- 국가 코드 최상위 레벨 도메인의 사용을 확인합니다. 유효한 국가 코드 목록에 대해서는 IANA(Internet Assigned Numbers Authority)가 제공하는 "Root Zone Database"를 참조하십시오.
- allowDecimal
- 0 - 4294967295 범위의 10진수를 확인합니다.
- allowDottedDecimal
- IPv4의 경우 207.142.131.235과 같은 주소인지 확인합니다. 0 채우기는 허용되지 않습니다.
- allowDottedHex
- IPv4의 경우 0x18.0x11.0x9b과 같은 주소인지 확인합니다. 값은 대소문자를 구분하지 않습니다. 0 채우기가 허용됩니다.
- allowDottedOctal
- IPv4의 경우 0030.0021.0233.0050과 같은 주소인지 확인합니다. 0 채우기가 허용됩니다.
- allowGeneric
- 일반 최상위 레벨 도메인의 사용을 확인합니다. 유효한 도메인 목록에 대해서는 IANA(Internet Assigned Numbers Authority)가 제공하는 "Root Zone Database"를 참조하십시오.
- allowHex
- IPv4의 경우 0x0 - 0xFFFFFFFF 범위의 16진수인지 확인합니다(예: 0xCF8E83EB). 값은 대소문자를 구분하지 않습니다. 0 채우기가 허용됩니다.
- allowHybrid
- 16진수 4자리의 6개 그룹으로 쓰여진 IPv6 주소 다음에 IPv4의 일반적인 4자리 점분리 10진수 표기를 확인합니다. 전체 형식은 x:x:x:x:x:x:d.d.d.d입니다.
- allowInfra
- 인프라 최상위 레벨 도메인의 사용을 확인합니다. 세부사항은 IANA(Internet Assigned Numbers Authority)가 제공하는 ".ARPA Zone Management"를 참조하십시오.
- allowIP
- URL이 리터럴 IP 주소가 될 수 있는지 확인합니다. 기본값은 true입니다.
- allowIPV6
- 16진수 4자리의 8개 그룹으로 쓰여진 IPv6 주소를 확인합니다.
- allowLocal
- "localhost"가 허용됨을 확인합니다. 기본값은 false입니다.
- allowNamed
- URL에 로컬 네트워크를 위한 이름 지정된 호스트가 포함될 수 있는지 확인합니다. 기본값은 false입니다.
- allowPort
- 포트 번호가 허용되는지 확인합니다. 기본값은 true입니다.
myDictionary Dictionary {}; Validators.TextValidator("", myDictionary);
일반적으로 유효성 검증기 함수, 특히 DojoTextField 위젯의 validators 특성에서 참조되는 함수에서 이러한 함수에 액세스합니다.
