17.14. RequestDumping Handler 구성

RequestDumping 핸들러인 io.undertow.server.handlers.RequestDumpingHandler 는 JBoss EAP 내에서 Undertow에서 처리하는 요청 및 해당 응답 개체의 세부 정보를 기록합니다.

중요

이 핸들러는 디버깅에 유용할 수 있지만 중요한 정보를 기록할 수도 있습니다. 이 핸들러를 활성화할 때 유의하십시오.

참고

RequestDumping 핸들러가 JBoss EAP 6에서 RequestDumperValve 를 대체합니다.

JBoss EAP에서 직접 서버 수준 또는 개별 애플리케이션 내에서 RequestDumping 핸들러를 구성할 수 있습니다.

17.14.1. 서버에서 RequestDumping Handler 구성

RequestDumping 핸들러는 표현식 필터로 구성해야 합니다. RequestDumping 핸들러를 표현식 필터로 구성하려면 다음을 수행해야 합니다.

RequestDumping Handler를 사용하여 새 표현식 필터 만들기
/subsystem=undertow/configuration=filter/expression-filter=requestDumperExpression:add(expression="dump-request")
Undertow 웹 서버에서 표현식 필터 활성화
/subsystem=undertow/server=default-server/host=default-host/filter-ref=requestDumperExpression:add
중요

이러한 방식으로 RequestDumping 핸들러를 표현식 필터로 활성화하면 Undertow 웹 서버에서 처리하는 모든 요청 및 해당 응답이 기록됩니다.

특정 URL에 대한 RequestDumping Handler 구성

모든 요청을 기록하는 것 외에도 표현식 필터를 사용하여 특정 URL에 대한 요청 및 해당 응답만 로깅할 수 있습니다. 이 작업은 경로, 경로 접두사또는 경로 접미사와 같은 표현식에 서술자를 사용하여 수행할 수 있습니다. 예를 들어 /myApplication/test 에 모든 요청과 해당 응답을 로깅하려면 표현식 필터를 생성할 때 " dump-request" 표현식 대신 "path(/myApplication/test) dump-request" 표현식을 사용할 수 있습니다. 이는 /myApplication/test 와 정확히 일치하는 경로가 있는 요청만 RequestDumping 핸들러에 직접 보냅니다.

17.14.2. 애플리케이션 내에서 RequestDumping Handler 구성

서버에서 RequestDumping 핸들러를 구성하는 것 외에도 개별 애플리케이션 내에서 구성할 수도 있습니다. 이렇게 하면 핸들러의 범위가 특정 애플리케이션으로만 제한됩니다. RequestDumping 핸들러는 WEB-INF/undertow-handlers.conf 에서 구성해야 합니다.

WEB-INF/undertow-handlers.conf 에서 RequestDumping 핸들러를 구성하여 이 애플리케이션에 대한 모든 요청 및 해당 응답을 기록하려면 WEB-INF/undertow-handlers.conf에 다음 표현식을 추가합니다.

예제: WEB-INF/undertow-handlers.conf

dump-request

WEB-INF/undertow-handlers.conf 에서 RequestDumping 핸들러를 구성하여 이 애플리케이션 내의 특정 URL에 대한 요청 및 해당 응답만 기록하려면 경로, 경로 접두사또는 경로 접미사와 같은 표현식에 서술자를 사용할 수 있습니다. 예를 들어 애플리케이션에서 테스트할 모든 요청 및 해당 응답을 기록하려면 경로 서술자를 사용하여 다음 표현식을 사용할 수 있습니다.

예제: WEB-INF/undertow-handlers.conf

path(/test) -> dump-request

참고

애플리케이션의 WEB-INF/undertow - handlers.conf 에 정의된 표현식 에서 경로, 경로 접두사 또는 경로 접미사와 같은 서술자를 사용하는 경우 사용되는 값은 애플리케이션의 컨텍스트 루트에 상대적입니다. 예를 들어 애플리케이션의 컨텍스트 루트가 표현식 경로(/test) dump-request가 WEB-INF/undertow- handlers.conf 에 구성된 myApplication 인 경우 /myApplication/test 에 요청 및 해당 응답만 기록합니다.