Trunk
The Web Application Server
개요 (Overview)
Trunk는 Elephant Project의 가장 근간이 되는 웹 애플리케이션 서버(WAS) 모듈입니다. 외부의 HTTP 요청을 받아 내부의 서블릿 컨테이너까지 전달하는 모든 과정을 순수 Java로 구현합니다. 이는 Tomcat의 핵심 아키텍처 구조를 모방하여, 저수준 I/O 처리부터 서블릿 생명주기 관리에 대한 깊은 이해를 목표로 합니다.
아키텍처 (Architecture)
Trunk는 크게 요청을 받아들이고 연결을 관리하는 Connector와, 전달된 요청을 실제 비즈니스 로직(서블릿)으로 연결하는 Container 두 부분으로 나뉩니다.
Connector: I/O Handler
Connector는 클라이언트와의 통신을 전담하며, 다양한 I/O모델을 지원하도록 전략 패턴과 템플릿 메소드 패턴이 사용됩니다. ProtocolHandler와 Endpoint라는 추상화를 통해 BIO(Blocking I/O)와 NIO(non-Blocking I/O) 방식을 모두 지원하며, 필요에 따라 확장할 수 있습니다.
Endpoint & Acceptor
Endpint는 네트워크 연결을 수락하고 관리하는 최상위 컴포넌트입니다. Acceptor 스레드가 클라이언트의 새로운 연결 요청(accept)을 받아 소켓을 생성합니다.(busy-wait를 피하기 위해 블로킹으로 처리)
일시적인 accept 오류 발생 시 지수 백오프(exponential backoff) 전략을 사용하여 시스템 부하를 줄입니다.
Poller
다수의 소켓 채널을 Selector에 등록하고, I/O 이벤트를 감지하는 이벤트 루프를 실행합니다.
Processor(Http11BioProcessor/Http11NioProcessor)
워커 스레드 풀에서 실행되는 작업 단위(Task)입니다. 소켓으로부터 들어온 Raw 데이터를 파싱하여 HttpRequest 객체를 만들고, HttpResponse 객체를 생성하는 역할을 합니다. Http11NioProcessor는 응답 데이터를 직접 전송하지 않고, 생산자-소비자 패턴을 통해 NioSocketWrapper의 쓰기 큐에 작업을 등록한 후 Poller에게 쓰기 이벤트 처리를 요청하여 비동기 쓰기를 구현합니다.
Http11Processor & CoyoteAdapter
Http11Processor은 I/O 모델(BIO/NIO)에 독립적인 HTTP/1.1 프로토콜 처리 로직을 담당합니다.
실제 서블릿 실행은 CoyoteAdapter에게 위임하여 Connector와 Container의 역할을 명확히 분리합니다.
Container: Servlet Engine
Container는 Connector로부터 전달받은 요청을 처리하는 서블릿 엔진입니다. 서블릿 표준 명세를 구현하고 서블릿의 생명주기를 관리하며, URL 요청을 가장 적절한 서블릿으로 매핑하는 역할을 수행합니다.
ContextConfig
웹 애플리케이션의 배포 서술자인 webapp/WEB-INF/web.xml 파일을 파싱하여, 서블릿 정보를 읽어들이고 StandardContext를 동적으로 설정하는 역할을 담당합니다.
StandardContext
하나의 웹 애플리케이션(webapp)에 해당되는 최상위 컨테이너입니다. web.xml에 명시된 load-on-startup값에 따라 서버 시작 시점에 서블릿을 미리 로딩(Eager Loading)하거나, 첫 요청 시 로딩(Lazy Loading)하는 전략을 관리합니다.
StandardWrapper
개별 서블릿 인스턴스를 감싸는 래퍼 객체입니다. 서블릿의 init(), service(), destroy() 메서드를 호출하며 생명주기를 직접 제어합니다. 또한, 서블릿이 ServletContextAware 인터페이스를 구현한 경우, Context 객체를 서블릿에 주입(DI)하여 컨테이너의 기능을 사용할 수 있도록 지원합니다.
Mapper
요청 URI와 서블릿을 매핑하는 컴포넌트입니다. 서블릿 표준 명세와 동일하게, 아래와 같은 우선순위 규칙에 따라 가장 적합한 서블릿을 찾아냅니다.
- 정확한 경로 매칭 (Exact Match)
- 가장 긴 접두사 매칭 (Longest Path Prefix Match)
- 확장자 매칭 (Extension Match)
- 기본 매칭 (Default Match)
서블릿 생성 및 등록 가이드 (Servlet Usage Guide)
Trunk 컨테이너 위에서 동작하는 서블릿을 개발하고 배포하는 전체 과정을 안내합니다.
1. 서블릿 생명주기(Lifecycle)와 구현
서블릿은 컨테이너에 의해 생명주기가 관리됩니다. Trunk는 서블릿 스펙에 따라 init(), service(), (doGet/doPost), destroy() 메서드를 호출합니다.
- init(): 서블릿 인스턴스가 생성된 후, 첫 요청을 처리하기 전에 단 한 번 호출됩니다. 서블릿이 필요로 하는 자원을 초기화하는 데 사용됩니다.
- service(): 각 클라이언트의 요청이 들어올 때마다 호출됩니다.
HttpServlet에서는 이 메서드가 요청의 HTTP Method에 따라doGet(),doPost()등을 다시 호출해줍니다. - destroy(): 서블릿 인스턴스가 컨테이너에서 소멸되기 직전에 단 한 번 호출됩니다. 사용했던 자원을 해제하는 데 사용됩니다.
아래 예제는 이 생명주기 메서드들에 로그를 추가하여 호출 시점을 직접 확인할 수 있도록 수정한 `HelloServlet`입니다.
package com.example.elephant;
import trunk.http11.request.HttpRequest;
import trunk.http11.response.HttpResponse;
import trunk.servlet.HttpServlet;
import java.io.IOException;
public class HelloServlet extends HttpServlet {
@Override
public void init() {
System.out.println("HelloServlet initialized. (서블릿 초기화)");
}
@Override
protected void doGet(HttpRequest request, HttpResponse response) throws IOException {
String message = "Hello, World!";
response.setStatusCode(200);
response.setHeader("Content-Type", "text/plain; charset=utf-8");
response.setBody(message.getBytes());
}
@Override
public void destroy() {
system.out.println("HelloServlet destroyed. (서블릿 소멸)");
}
}
2. 서블릿 로딩 전략과 web.xml설정
서블릿 컨테이너가 서블릿을 언제 로드할지는 web.xml의 <load-on-startup> 태그로 결정할 수 있습니다.
- 서버 시작 시 로딩 (Eager Loading):
<load-on-startup>값을 0 또는 양수로 지정하면, Trunk 서버가 시작되는 시점에 해당 서블릿의init()메서드가 호출됩니다. 여러 개일 경우 숫자가 낮을수록 먼저 로드됩니다. - 첫 요청 시 로딩 (Lazy Loading): 이 태그를 생략하거나 음수 값을 주면, 해당 서블릿에 대한 첫 요청이 들어왔을 때 비로소
init()메서드가 호출됩니다.
<!-- web.xml -->
<web-app>
<servlet>
<servlet-name>HelloServlet</servlet-name>
<servlet-class>com.example.elephant.HelloServlet</servlet-class>
<load-on-startup>1</load-on-startup> <!-- 서버 시작 시 로드 -->
</servlet>
<servlet-mapping>
<servlet-name>HelloServlet</servlet-name>
<url-pattern>/hello</url-pattern>
</servlet-mapping>
</web-app>