10장. Undertow

Undertow는 차단 작업 및 비차단 작업 모두에 사용하도록 설계된 웹 서버입니다. JBoss EAP 7에서 JBoss Web을 대체합니다. 일부 주요 기능은 다음과 같습니다.

라이프 사이클 요청

클라이언트가 서버에 연결하면 Undertow에서 a io.undertow.server.HttpServerConnection 을 생성합니다. 클라이언트에서 요청을 보내면 Undertow 구문 분석기에서 구문 분석한 다음 result io.undertow.server.HttpServerExchange 가 root 핸들러에 전달됩니다. root 핸들러가 완료되면 다음 네 가지 중 하나가 발생할 수 있습니다.

HttpServerExchange.dispatch() 를 가장 일반적으로 사용하는 것은 차단이 허용되지 않는 IO 스레드에서 실행을 차단할 수 있는 작업자 스레드로 이동하는 것입니다.

public void handleRequest(final HttpServerExchange exchange) throws Exception {
    if (exchange.isInIoThread()) {
      exchange.dispatch(this);
      return;
    }
    //handler code
}

public void handleRequest(final HttpServerExchange exchange) throws Exception {
    if (exchange.isInIoThread()) {
      exchange.dispatch(this);
      return;
    }
    //handler code
}

호출 스택이 반환될 때까지 교환이 실제로 디스패치되지 않으므로 한 번에 둘 이상의 스레드가 교환에서 활성화되지 않도록 할 수 있습니다. 교환은 안전한 스레드가 아닙니다. 그러나 두 스레드가 한 번에 수정하지 않는 한 여러 스레드 간에 전달할 수 있습니다.

교환 종료

교환을 종료하는 방법에는 요청 채널을 완전히 읽고 응답 채널에서 shutdownWrites() 를 호출한 다음 HttpServerExchange.endExchange() 를 호출하여 교환을 종료할 수 있습니다. endExchange() 를 호출하면 Undertow는 콘텐츠가 아직 생성되었는지 확인합니다. 있는 경우 요청 채널을 드레이닝하고 응답 채널을 닫고 플러시합니다. 교환에 등록된 기본 응답 리스너가 없는 경우 Undertow는 각 응답에 기본 응답을 생성할 기회를 제공합니다. 이 메커니즘은 기본 오류 페이지가 생성되는 방법입니다.

Undertow 구성에 대한 자세한 내용은 JBoss EAP 구성 가이드에서 웹 서버 구성을 참조하십시오.