17.7. 핸들러 구성

JBoss EAP를 사용하면 다음 두 가지 유형의 핸들러를 구성할 수 있습니다.

  • 파일 핸들러
  • reverse-proxy 핸들러

파일 핸들러는 정적 파일을 제공합니다. 각 파일 핸들러는 가상 호스트의 위치에 연결해야 합니다. 역방향 프록시 핸들러를 사용하면 JBoss EAP가 고성능 역방향 프록시 역할을 할 수 있습니다.

JBoss EAP는 기본적으로 파일 핸들러를 제공합니다.

기본 Undertow 하위 시스템 구성

<subsystem xmlns="urn:jboss:domain:undertow:10.0" default-server="default-server" default-virtual-host="default-host" default-servlet-container="default" default-security-domain="other">
    <buffer-cache name="default"/>
    <server name="default-server">
        ...
    </server>
    <servlet-container name="default">
        ...
    </servlet-container>
    <handlers>
        <file name="welcome-content" path="${jboss.home.dir}/welcome-content"/>
    </handlers>
</subsystem>

정적 리소스에 WebDAV 사용

이전 버전의 JBoss EAP는 WebdavServlet 을 통해 하위 시스템과 함께 WebDAV를 사용하여 정적 리소스를 호스트하고 추가 HTTP 메서드를 활성화하여 해당 파일에 액세스하고 조작할 수 있게 되었습니다. JBoss EAP 7에서 undertow 하위 시스템은 파일 핸들러를 사용하여 정적 파일을 제공하는 메커니즘을 제공하지만 undertow 하위 시스템은 WebDAV를 지원하지 않습니다. JBoss EAP 7에서 WebDAV를 사용하려면 사용자 지정 WebDAV 서블릿을 작성할 수 있습니다.

기존 파일 핸들러 업데이트

기존 파일 핸들러를 업데이트하려면 다음을 수행합니다.

/subsystem=undertow/configuration=handler/file=welcome-content:write-attribute(name=case-sensitive,value=true)
reload

새 파일 핸들러 생성

새 파일 핸들러를 생성하려면 다음을 수행합니다.

/subsystem=undertow/configuration=handler/file=new-file-handler:add(path="${jboss.home.dir}/welcome-content")
주의

디렉터리 대신 파일 핸들러의 경로를 직접 설정하는 경우 해당 파일 핸들러를 참조하는 모든 위치 요소는 슬래시(/)로 끝나서는 안 됩니다. 그렇지 않으면 서버에서 404 - 찾을 수 없음 응답을 반환합니다.

파일 핸들러 삭제

파일 핸들러 삭제

/subsystem=undertow/configuration=handler/file=new-file-handler:remove
reload

핸들러 구성에 사용할 수 있는 속성의 전체 목록은 Undertow 하위 시스템 속성 섹션을 참조하십시오.