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 특성에서 참조되는 함수에서 이러한 함수에 액세스합니다.