ERRORDOCUMENT 절

WebtoB에서 에러 문제가 발생했을 때 다음과 같은 4가지 방법으로 대응할 수 있습니다.

  • 소스 코드에 정의된 에러 메시지를 출력

  • 사용자가 정의한 에러 메시지를 출력

  • 로컬 URL로 재전송

  • 외부 URL로 재전송

2번째, 3번째, 4번째의 경우에는 ERRORDOCUMENT 절을 설정하여 특정 HTTP 응답 상태 코드 에 대해 특정 페이지로 리다이렉트합니다. HTTP 401 상태 코드를 제외한 HTTP 상태 코드를 모두 설정할 수 있습니다.

설정 항목

다음은 DESTINATION 절의 환경 설정 형식입니다.

#"error_document": {
    #"error_document_list": [
        {
            "name": string,
            "status": integer,          # (HTTP status code)
            "url": string
        }
    ]
}

절과 설정 항목의 구성에 대한 기호나 내용에 대한 자세한 내용은 설정 항목 값의 형식 및 설정 방법을 참고합니다.

error_document_list

ERRORDOCUMENT 설정에 대한 목록입니다.

구분 설명

자료형

array(object)

error_document_list/name (필수 항목)

ERRORDOCUMENT 설정의 이름입니다. 다른 절에서 ERRRORDOCUMENT 절의 기능을 사용할 때는 이 'name’을 설정해야 합니다.

구분 설명

자료형

string

범위

31자 이내

error_document_list/status (필수 항목)

HTTP 상태 코드 값을 설정합니다.

구분 설명

자료형

integer

범위

100 ~ 599

error_document_list/url (필수 항목)

doc_root 이하의 상대 경로가 되거나 클라이언트가 해석할 수 있는 전체 경로 값을 설정합니다.

구분 설명

자료형

string

범위

255자 이내

설정 예시

다음은 ERRORDOCUMENT 절을 설정한 예시입니다.

{
    "error_document": {
        "error_document_list": [
            {
                "name": "forbidden",
                "status": 403,
                "url": "err/403.html"
            },
            {
                "name": "notfound",
                "status": 404,
                "url": "http://tmaxsoft.co.kr/404.html"
            }
        ]
    }
}