[스프링 MVC 1편] #2. 서블릿 (1)

[YuDeokRin]

서블릿

1️⃣프로젝트 생성

• 프로젝트 생성 같은 경우

  • 전 강의(스프링 핵심원리)와 다른점은 jar가 아닌 war를 사용하여서 해야한다. 이유는 jsp, jstl 등을 사용하려면 war 를 사용해야하기 때문이라고한다.

• 프로젝트 생성

1. spring boot로 생성
2. 자바 버전은 11이상 권장 → 17을 사용한다.
3. Dependencies를 설정 → spring web, lombok 의존성
4. 잘 작동되는지 실행 테스트

• 추가로, PostMan 설치

2️⃣ Hello 서블릿

✅스프링 부트 서불릿 환경 구성

• @ServletComponentScan // 서블릿 자동 등록
  • 스프링 부트는 서블릿을 직접 등록해서 사용할 수 있도록 @ServletComponentScan 을 지원한다.

@ServletComponentScan // 서블릿 자동 등록
@SpringBootApplication
public class ServletApplication {

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

}

✅서블릿 등록하기

• @WebServlet 서블릿 애노테이션
  • name : 서블릿 이름
  • urlPatterns : URL 매핑

@WebServlet(name = "helloServlet", urlPatterns = "/hello")
public class helloServlet extends HttpServlet {

    @Override
    protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        System.out.println("helloServlet.service");
        System.out.println("request = " + request);
        System.out.println("response = " + response);

        String username = request.getParameter("username");
        System.out.println("userName = " + username);
        
        response.setContentType("text/plain");
        response.setCharacterEncoding("utf-8");
        response.getWriter().write("hello " + username);

    }
}

• HTTP 요청을 통해 매핑된 URL이 호출되면 서블릿 컨테이너는 다음 메서드를 실행한다.

protected void service(HttpServletRequest request, HttpServletResponse response)

• 결과

request = org.apache.catalina.connector.RequestFacade@744d716
response = org.apache.catalina.connector.ResponseFacade@983398e
userName = world

✅HTTP 요청 메시지 로그로 확인하기

• application.properties

logging.level.org.apache.coyote.http11=debug

🎈주의 - 스프링 부트 3.2부터 debug 대신에 trace를 사용해야 로그가 출력된다.

• 결과

💈참고
운영서버에 이렇게 모든 요청 정보가다 남기면 성능저하가 발생할 수 있다. 개발 단계에서만 적용하자. 

• 내장 톰켓 서버 생성

• 웹 애플리케이션 서버의 요청 응답 구조

💈참고
HTTP 응답에서 Content-Length는 웹 애플리케이션 서버가 자동으로 생성해준다.

3️⃣ HttpServletRequest - 개요

✅HttpServletRequest 역할

• HTTP 요청 메시지를 개발자가 직접 파싱해서 사용해도 되지만, 코드 하나하나 직접쳐야하기 때문에 매우 불편하다. 서블릿은 개발자가 HTTP 요청 메시지를 편리하게 사용할 수 있도록 개발자 대신에 HTTP 요청 메시지를 파싱한다. 결과를 HttpServletReqeust 객체에 담아서 제공한다.

• HTTP 요청 메시지

POST /save HTTP/1.1
Host: localhost:8080
Content-Type: application/x-www-form-urlencoded
username=yu&age=10

• START LINE

  • HTTP 메소드 URL
  • 쿼리 스트링
  • 스키마, 프로토콜 헤더
  • 헤더 조회 바디

• 헤더

  • 헤더 조회 바디
  • form 파라미터 형식 조회 message body 데이터 직접 조회

✅임시 저장소 기능

임시 저장소 기능

해당 HTTP 요청이 시작부터 끝날 때 까지 유지되는 임시 저장소 기능
저장: `request.setAttribute(name, value)` 
조회: `request.getAttribute(name)`

✅세션 관리 기능

• request.getSession(create: true)

🔴중요

HttpServletRequest, HttpServletResponse를 사용할 때 가장 중요한 점은 이 객체들이 HTTP 요청 메시지, HTTP 응답 메시지를 편리하게 사용하도록 도와주는 객체라는 점이다. 따라서 이 기능에 대해서 깊이있는 이해를 하려면 **HTTP 스펙이 제공하는 요청, 응답 메시지 자체를 이해**해야 한다.

4️⃣ HttpServletRequest - 기본 사용법

@WebServlet(name = "requestHeaderServlet", urlPatterns = "/request-header")
 public class RequestHeaderServlet extends HttpServlet {
@Override
     protected void service(HttpServletRequest request, HttpServletResponse
 response)
             throws ServletException, IOException {
         printStartLine(request);
         printHeaders(request);
         printHeaderUtils(request);
         printEtc(request);
         response.getWriter().write("ok");
     }
}

• start-line 정보

//start line 정보
private void printStartLine(HttpServletRequest request) {
     System.out.println("--- REQUEST-LINE - start ---");
     System.out.println("request.getMethod() = " + request.getMethod()); //GET
     System.out.println("request.getProtocol() = " + request.getProtocol()); //
 HTTP/1.1
     System.out.println("request.getScheme() = " + request.getScheme()); //http
     // http://localhost:8080/request-header
     System.out.println("request.getRequestURL() = " + request.getRequestURL());
      // /request-header
     System.out.println("request.getRequestURI() = " + request.getRequestURI());
     //username=hi
     System.out.println("request.getQueryString() = " +
request.getQueryString());
System.out.println("request.isSecure() = " + request.isSecure()); //https 사용
유무
     System.out.println();

• 결과

--- REQUEST-LINE - start ---
 request.getMethod() = GET
 request.getProtocol() = HTTP/1.1
 request.getScheme() = http
 request.getRequestURL() = http://localhost:8080/request-header
 request.getRequestURI() = /request-header
 request.getQueryString() = username=hello
 request.isSecure() = false
 --- REQUEST-LINE - end ---

5️⃣ HTTP 요청 데이터 개요

• HTTP 요청 메시지를 통해 클라이언트에서 서버로 데이터를 전달하는 방법을 알아보자.

주로 다음 3가지 방법을 사용한다.

• GET - 쿼리 파라미터
  • /url**?username=hello&age=20**
  • 메시지 바디 없이, URL의 쿼리 파라미터에 데이터를 포함해서 전달
  • 예) 검색, 필터, 페이징등에서 많이 사용하는 방식
• POST - HTML Form
  • content-type: application/x-www-form-urlencoded
  • 메시지 바디에 쿼리 파리미터 형식으로 전달 username=hello&age=20
  • 예) 회원 가입, 상품 주문, HTML Form 사용
• HTTP message body
• 에 데이터를 직접 담아서 요청
  HTTP API에서 주로 사용, JSON, XML, TEXT

데이터 형식은 주로 JSON 사용
POST, PUT, PATCH