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.confmyApplication
인 경우 /myApplication/test
에 요청 및 해당 응답만 기록합니다.