기본 제공 유틸리티
util 변수에는 데이터 작업에 도움이 되는 일반 유틸리티 메서드가 포함되어 있습니다. 달리 지정하지 않는 한, 모든 유틸리티는 UTF-8 문자 집합을 사용합니다.
인코딩 유틸리티
-
util.urlEncode(String) -
입력 문자열을
application/x-www-form-urlencoded인코딩 문자열로 반환합니다. -
util.urlDecode(String) -
application/x-www-form-urlencoded인코딩 문자열을 인코딩되지 않은 형식으로 다시 디코딩합니다. util.base64Encode(string) : string-
입력을 base64 인코딩 문자열로 인코딩합니다.
util.base64Decode(string) : string-
데이터를 base64 인코딩 문자열에서 디코딩합니다.
ID 생성 유틸리티
-
util.autoId() -
임의로 생성된 128비트 UUID를 반환합니다.
util.autoUlid()-
무작위로 생성된 128비트 ULID(Universally Unique Lexicographically Sortable Identifier)를 반환합니다.
util.autoKsuid()-
길이가 27인 문자열로 인코딩된 무작위로 생성된 128비트 KSUID(K-Sortable Unique Identifier) base62를 반환합니다.
오류 유틸리티
-
util.error(String, String?, Object?, Object?) -
사용자 지정 오류를 발생시킵니다. 이 필드는 요청 또는 응답 매핑 템플릿에서 템플릿이 요청 또는 호출 결과와 관련된 오류를 감지하는 경우 사용할 수 있습니다. 또한
errorType,data및errorInfo필드를 지정할 수 있습니다. GraphQL 응답에서data값은error내 해당errors블록에 추가됩니다.참고
참고:
data는 쿼리 선택 세트를 기반으로 필터링됩니다. GraphQL 응답에서errorInfo값은error내 해당errors블록에 추가됩니다.errorInfo는 쿼리 선택 세트를 기반으로 필터링되지 않습니다. -
util.appendError(String, String?, Object?, Object?) -
사용자 지정 오류를 추가합니다. 이 필드는 요청 또는 응답 매핑 템플릿에서 템플릿이 요청 또는 호출 결과와 관련된 오류를 감지하는 경우 사용할 수 있습니다. 또한
errorType,data및errorInfo필드를 지정할 수 있습니다.util.error(String, String?, Object?, Object?)와 달리 템플릿 평가가 중단되지 않기 때문에 데이터를 호출자에게 반환할 수 있습니다. GraphQL 응답에서data값은error내 해당errors블록에 추가됩니다.참고
참고:
data는 쿼리 선택 세트를 기반으로 필터링됩니다. GraphQL 응답에서errorInfo값은error내 해당errors블록에 추가됩니다.errorInfo는 쿼리 선택 세트를 기반으로 필터링되지 않습니다.
유형 및 패턴 매칭 유틸리티
util.matches(String, String) : Boolean-
첫 번째 인수의 지정된 패턴이 두 번째 인수에서 제공되는 데이터와 일치하는 경우 true를 반환합니다. 패턴은
util.matches("a*b", "aaaaab")등과 같은 정규식이어야 합니다. 이 기능은 Pattern을 기반으로 하며, 여기서 자세한 설명을 참조할 수 있습니다. -
util.authType() -
요청에 사용되는 다중 인증 유형을 설명하는 문자열을 반환하고 'IAM 권한 부여', '사용자 풀 권한 부여', 'Open ID Connect 권한 부여' 또는 'API 키 인증'을 반환합니다.
반환 값 동작 유틸리티
-
util.escapeJavaScript(String) -
입력 문자열을 JavaScript 의 이스케이프된 문자열로 반환합니다.
해석기 권한 부여 유틸리티
-
util.unauthorized() -
해석 중인 필드에 대해
Unauthorized를 발생시킵니다. 요청 또는 응답 매핑 템플릿에서 이를 사용하여 호출자가 필드를 확인하도록 허용할지 여부를 결정합니다.
