TIL

섹션 3 독립 실행형 서블릿 애플리케이션

Containerless 개발 준비

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class HellobootApplication {
	public static void main(String[] args) {
		SpringApplication.run(HellobootApplication.class, args);
	}
}

• 스프링 부트를 사용하면 아래 두 가지만 있으면 웹 애플리케이션을 구동시킬 수 있다.
  • @SpringBootApplication
  • SpringApplication.run()
• 이 두 가지를 없애고 스프링을 실행시키도록 만들어 볼 것이다.

public class HellobootApplication {
	public static void main(String[] args) {
	}
}

서블릿 컨테이너 띄우기

public class HellobootApplication {

	public static void main(String[] args) {
		ServletWebServerFactory serverFactory = new TomcatServletWebServerFactory();
		WebServer webServer = serverFactory.getWebServer();
		webServer.start();
	}
}

• 톰캣을 정상적으로 띄우려면 사전 준비 및 설정은 너무 복잡하다.
• TomcatServletWebServerFactory
  • 스프링 부트가 톰캣 서블릿 컨테이너를 내장해 쉽게 사용할 수 있도록 만든 도우미 클래스
  • 추상화 타입인 ServletWebServerFactory로 업캐스팅 가능하다.
• WebServer
  • tomcat, jetty 등 웹 서버 구현체를 받을 수 있는 추상화
  • ServletWebServerFactory.getWebServer 메서드를 통해 얻을 수 있다.
  • start() 메서드를 통해 웹 서버를 동작시킬 수 있다.
• 하지만 이대로는 HTTP 요청을 받을 수 없고 contorller가 존재하더라도 404 not found 응답을 반환한다.
  • 서블릿을 추가해야 함

서블릿 등록

• ServletWebServerFactory.getWebServer는 ServletContextInitializer를 파라미터로 받아 서블릿을 추가할 수 있다.
• ServletContextInitializer
  • onStartUp(ServletContext) 메서드 하나만 가지는 함수형 인터페이스
  • 람다 표현식으로 서블릿을 추가할 수 있다는 뜻이다.
  • 파라미터인 ServletContext의 addServlet을 통해 서블릿 등록 가능
    • 이름과 Servlet 인터페이스를 받을 수 있다.

public class HellobootApplication {

    public static void main(String[] args) {
        ServletWebServerFactory serverFactory = new TomcatServletWebServerFactory();
        WebServer webServer = serverFactory.getWebServer(context -> {
            context.addServlet("hello", ...);
        });
        webServer.start();
    }
}

• Servlet 또한 인터페이스이지만 오버라이딩할 메서드가 너무 많다.
• HttpServlet을 통해 필요한 값만 오버라이딩하여 서블릿을 등록할 수 있다.

public class HellobootApplication {

    public static void main(String[] args) {
        ServletWebServerFactory serverFactory = new TomcatServletWebServerFactory();
        WebServer webServer = serverFactory.getWebServer(context -> {
            context.addServlet("hello", new HttpServlet() {
                @Override
                protected void service(HttpServletRequest req,
                                       HttpServletResponse res) throws IOException {
                    String name = req.getParameter("name");
                    res.setStatus(HttpStatus.OK.value());
                    res.setHeader(HttpHeaders.CONTENT_TYPE, MediaType.TEXT_PLAIN_VALUE);
                    res.getWriter().println("Hello " + name);
                }
            }).addMapping("/hello");
        });
        webServer.start();
    }
}

프론트 컨트롤러

• 기존의 서블릿은 요청 url 마다 새로운 서블릿을 만들어야 했다.
  • 공통적인 작업이 중복되어 나타나는 문제가 있다.
  • request 오브젝트와 response 오브젝트를 직접 다뤄야 한다.
• 프론트 컨트롤러의 등장
  • 모든 서블릿의 공통 작업을 중앙화된 ‘컨트롤러’ 오브젝트에서 처리
  • 요청에 따라 핸들러에게 작업을 위임하도록 동작
  • 앞단 뿐 아니라 후처리 작업 중에서도 공통적인 작업을 처리할 수 있다.
  • ex) 인증, 보안, 다국어 처리 등

프론트 컨트롤러로 전환

• /hello 요청을 처리하는 controller 메서드가 존재하기에 이를 사용하도록 하면 로직을 외부 클래스로 분리할 수 있다.

public class HelloController {
    public String hello(String name) {
        return "Hello " + name;
    }
}

public class HellobootApplication {

    public static void main(String[] args) {
        ServletWebServerFactory serverFactory = new TomcatServletWebServerFactory();
        WebServer webServer = serverFactory.getWebServer(context -> {
            HelloController helloController = new HelloController();

            context.addServlet("front-controller", new HttpServlet() {
                @Override
                protected void service(HttpServletRequest req,
                                       HttpServletResponse res) throws IOException {
                    // 공통 기능 처리 ...
                    if (req.getRequestURI().equals("/hello") && req.getMethod().equals(HttpMethod.GET.name())) {
                        String name = req.getParameter("name");

                        String response = helloController.hello(name);

                        res.setStatus(HttpStatus.OK.value());
                        res.setHeader(HttpHeaders.CONTENT_TYPE, MediaType.TEXT_PLAIN_VALUE);
                        res.getWriter().println(response);
                    } else if (req.getRequestURI().equals("/user")) {
                        // ...
                    } else {
                        res.setStatus(HttpStatus.NOT_FOUND.value());
                    }
                }
            }).addMapping("/*");
        });
        webServer.start();
    }
}

• 위 프론트 컨트롤러의 주 역할은 바로 ‘매핑’과 ‘바인딩’
  • 매핑 - 요청 url과 http method를 통해 알맞은 로직을 매핑
  • 바인딩 - 웹 기술과 관련된 코드와 컨트롤러를 분리하여 필요한 데이터를 컨트롤러에게 전달
    • ex) request parameter인 name을 HelloController에게 전달