GlideStringUtil - 범위가 지정됨, 전역

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기9분
  • GlideStringUtil API는 문자열 처리 메서드를 제공합니다.

    정적 객체 GlideStringUtil을 사용하여 이러한 메서드에 액세스합니다. 이 클래스는 범위 지정 및 전역 스크립트에서 사용할 수 있습니다.

    GlideStringUtil - dotToUnderBar(문자열 sourceString)

    마침표를 밑줄 문자로 바꿉니다.

    표 1. 매개변수
    이름 유형 설명
    소스 문자열 문자열 처리할 텍스트입니다.
    표 2. 반환
    유형 설명
    문자열 마침표가 밑줄로 바뀐 텍스트입니다.
    var filename="../../../../../../etc/passwd";
    cleanFilename=GlideStringUtil.dotToUnderBar(filename);
    gs.info(cleanFilename);

    출력:

     __/__/__/__/__/__/etc/passwd

    GlideStringUtil - escapeAllQuotes(문자열 sourceString)

    문자열에서 따옴표를 제거합니다.

    표 3. 매개변수
    이름 유형 설명
    소스 문자열 문자열 처리할 문자열입니다.
    표 4. 반환
    유형 설명
    문자열 따옴표가 제거된 문자열입니다.
    mystring="let's escape some quotes";
    escapeQuote=GlideStringUtil.escapeAllQuotes(mystring);
    gs.info(escapeQuote);

    출력:

    lets escape some quotes

    GlideStringUtil - escapeForHomePage(문자열: sourceString)

    문제 문자를 이스케이프 문자로 바꿉니다.

    표 5. 매개변수
    이름 유형 설명
    소스 문자열 문자열 처리할 텍스트입니다.
    표 6. 반환
    유형 설명
    문자열 문제 문자가 이스케이프 문자로 바뀐 텍스트입니다.
    mystring="<test> string \n to escape";
    escapedString=GlideStringUtil.escapeForHomePage(mystring);
    gs.info(escapedString);

    출력:

    %3ctest%3e string \n to escape

    GlideStringUtil - escapeHTML(문자열 htmlString)

    잘못된 문자를 이스케이프 코드로 대체합니다.

    이 메서드를 사용하면 UI가 부적절하게 렌더링되거나 JavaScript 또는 HTML 삽입과 같은 클라이언트 쪽 공격을 트리거할 수 있는 잘못된 문자가 제거됩니다.

    표 7. 매개변수
    이름 유형 설명
    html문자열 문자열 처리할 텍스트입니다.
    표 8. 반환
    유형 설명
    문자열 잘못된 문자가 이스케이프 코드로 바뀐 텍스트입니다.
    mydata='"<>&';
    mydata=GlideStringUtil.escapeHTML(mydata);
    gs.info(mydata);

    출력:

    "<>&

    GlideStringUtil - escapeNonPrintable(문자열: sourceString)

    인쇄할 수 없는 문자를 인쇄 가능한 표기법으로 바꿉니다.

    표 9. 매개변수
    이름 유형 설명
    소스 문자열 문자열 처리할 텍스트입니다.
    표 10. 반환
    유형 설명
    문자열 인쇄할 수 없는 문자가 인쇄 가능한 표기법으로 바뀐 텍스트입니다.
    mystring="test \x09 non \x00 printable \x07 chars";
    escapedString=GlideStringUtil.escapeNonPrintable(mystring);
    gs.info(escapedString);

    출력:

    test \t non \u0000 printable \u0007 chars

    GlideStringUtil - escapeQueryTermSeparator(문자열 sourceString)

    쿼리 용어 구분 기호 "^"를 이스케이프 시퀀스 "^^"로 바꿉니다.

    표 11. 매개변수
    이름 유형 설명
    소스 문자열 문자열 처리할 텍스트입니다.
    표 12. 반환
    유형 설명
    문자열 쿼리 용어 구분 기호가 이스케이프 문자로 바뀐 텍스트입니다.
    myquery="test^Test";
    escapedQuery=GlideStringUtil.escapeQueryTermSeparator(myquery);
    gs.info(escapedQuery);

    출력:

    test^^Test

    GlideStringUtil - escapeTicks(문자열 sourceString)

    각 따옴표 앞에 백슬래시를 추가하여 따옴표를 이스케이프 문자로 바꿉니다.

    표 13. 매개변수
    이름 유형 설명
    소스 문자열 문자열 처리할 텍스트입니다.
    표 14. 반환
    유형 설명
    문자열 따옴표 앞에 백슬래시가 추가된 텍스트입니다.
    mystring="let's try escapeTicks";
    escaped=GlideStringUtil.escapeTicks(mystring);
    gs.info(escaped); 

    출력:

    let\'s try escapeTicks

    GlideStringUtil - getHTMLValue(문자열 sourceString)

    잘못된 HTML 문자를 HTML 표기법으로 대체합니다.

    이 메서드를 사용하면 UI가 부적절하게 렌더링되거나 JavaScript 또는 HTML 삽입과 같은 클라이언트 쪽 공격을 트리거할 수 있는 잘못된 문자가 제거됩니다.

    표 15. 매개변수
    이름 유형 설명
    소스 문자열 문자열 처리할 텍스트입니다.
    표 16. 반환
    유형 설명
    문자열 잘못된 문자가 있는 텍스트가 HTML 표기법으로 대체되었습니다.
    mydata='&';
    htmlvalue=GlideStringUtil.getHTMLValue(mydata);
    gs.info(htmlvalue);

    출력:

    &

    GlideStringUtil - getNumeric(문자열, sourceString)

    문자열에서 숫자를 추출합니다.

    표 17. 매개변수
    이름 유형 설명
    소스 문자열 문자열 처리할 텍스트입니다.
    표 18. 반환
    유형 설명
    문자열 숫자만 포함하는 텍스트입니다.
    mystring='123 test 456 String 789 cleaning';
    onlyNumeric=GlideStringUtil.getNumeric(mystring);
    gs.info(onlyNumeric); 

    출력:

    123456789

    GlideStringUtil - isBase64(문자열 sourceString)

    지정된 문자열이 유효한 base64 문자열인지 여부를 확인합니다.

    표 19. 매개변수
    이름 유형 설명
    소스 문자열 문자열 처리할 텍스트입니다.
    표 20. 반환
    유형 설명
    부울 지정된 문자열이 유효한 base64 형식인지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 유효한 base64 형식의 문자열입니다.
    • false: 잘못된 base64 형식의 문자열입니다.
    //(adding a "*" to corrupt the base64 format)
    base64="GethdTYehdtshetB*";
    isValid=GlideStringUtil.isBase64(base64);
    gs.info(isValid);

    출력:

    false

    GlideStringUtil - isEligibleSysID(문자열 sourceString)

    지정된 문자열이 유효한 sys_id 형식인지 확인합니다.

    sys_id 형식은 모든 문자가 [0-9, a-f, A-F] 범위에 있는 32개의 16진수 문자로 구성된 시퀀스입니다.

    표 21. 매개변수
    이름 유형 설명
    소스 문자열 문자열 처리할 텍스트입니다.
    표 22. 반환
    유형 설명
    부울 지정된 문자열이 유효한 sys_id 형식인지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 형식이 지정된 문자열sys_id 유효합니다.
    • false: 형식이 지정된 문자열sys_id 잘못되었습니다.
    sysID="62826bf03710200044e0bfc8bcbe5df1";
    isElig=GlideStringUtil.isEligibleSysID(sysID);
    gs.info(isElig);

    출력:

    true

    GlideStringUtil - newLinesToBreaks(문자열 sourceString)

    줄 바꿈 문자 /n을 중단 코드 <br/>로 바꿉니다.

    표 23. 매개변수
    이름 유형 설명
    소스 문자열 문자열 처리할 텍스트입니다.
    표 24. 반환
    유형 설명
    문자열 줄 바꿈 문자가 있는 텍스트가 HTML 줄 바꿈 코드로 바뀝니다.
    mystring="new line break \n, this is after the break";
    replaceNewLine=GlideStringUtil.newLinesToBreaks(mystring);
    gs.info(replaceNewLine); 

    출력:

    new line break <br/>, this is after the break

    GlideStringUtil - normalizeWhitespace(문자열 sourceString)

    캐리지 리턴, 줄 바꿈 및 탭을 공백으로 바꾼 다음 선행, 후행 및 중복 공백을 제거합니다.

    표 25. 매개변수
    이름 유형 설명
    소스 문자열 문자열 처리할 텍스트입니다.
    표 26. 반환
    유형 설명
    문자열 캐리지 리턴, 줄 바꿈 및 탭이 공백으로 바뀐 다음 선행, 후행 및 중복 공백이 제거된 텍스트입니다.
    mystring="test with \n (new line) and \t (tabulation)";
    normalizedString=GlideStringUtil.normalizeWhitespace(mystring);
    gs.info(normalizedString);

    출력:

    test with (new line) and (tabulation)

    GlideStringUtil - unEscapeHTML(문자열 htmlString)

    이스케이프 문자를 해당 문자로 바꿉니다.

    이 메서드는 이스케이프 문자 < >: & quote;를 대체합니다.

    주:
    범위가 지정된 응용 프로그램에서는 이 메서드를 unescapeHTML(String)로 호출합니다. 전역 응용 프로그램에서는 이 메서드를 unEscapeHTML(String)로 호출합니다.
    표 27. 매개변수
    이름 유형 설명
    html문자열 문자열 처리할 문자열입니다.
    표 28. 반환
    유형 설명
    문자열 이스케이프 문자가 바뀐 문자열입니다.

    이 코드 예제에서는 전역 응용 프로그램에서 호출되는 메서드를 보여 줍니다.

    mydata='"<>&';
    unescaped=GlideStringUtil.unEscapeHTML(mydata);
    gs.info(unescaped);

    출력:

    "<>&

    이 코드 예제에서는 범위가 지정된 응용 프로그램에서 호출되는 메서드를 보여 줍니다.

    mydata='"<>&';
    unescaped=GlideStringUtil.unescapeHTML(mydata);
    gs.info(unescaped);

    출력:

    "<>&

    GlideStringUtil - urlEncode(문자열 URL)

    반환된 문자열을 인터넷에서 사용할 수 있도록 ASCII가 아닌 문자, 안전하지 않은 ASCII 문자 및 공백을 인코딩합니다. UTF-8 인코딩을 사용합니다. 퍼센트(%) 인코딩을 사용합니다.

    주:
    전역 범위에서만 사용할 수 있습니다.
    표 29. 매개변수
    이름 유형 설명
    URL 문자열 인코딩할 문자열입니다.
    표 30. 반환
    유형 설명
    문자열 ASCII가 아닌 문자, 안전하지 않은 ASCII 문자 및 공백이 인코딩된 문자열입니다.
    var mystring='Test characters: " < > & " < > &';
    escapedString=GlideStringUtil.urlEncode(mystring);
    gs.info(escapedString);

    출력:

    Test+characters%3A+%22+%3C+%3E+%26+%26quot%3B+%26lt%3B+%26gt%3B+%26amp%3B