스프링 MVC 1편 (백엔드 웹 개발 핵심 기술)

Ch02. 서블릿 - HTTP 요청 데이터

webmaster 2022. 3. 2. 12:49
728x90
  • 주로 3가지 방법을 사용하여 HTTP 요청 메시지를 통해 클라이언트에서 서버로 데이터를 전달한다
  • 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

GET - 쿼리 파라미터

Get 쿼리 파라미터

  • 쿼리 파라미터는 URL에 다음과 같이 ? 를 시작으로 보낼 수 있다. 추가 파라미터는 & 로 구분하면 된다
  • 전체 파라미터 조회
    • getParameterNames()를 사용하여 request의 Parameter 정보를 뽑을 수 있다.
  • 단일 파라미터 조회
    • getParameter("파라미터명")을 사용하여 단일 파라미터 조회 가능
    • 만약 조회하는 파라미터 명을 value가 2개 이상이면 사용하면 안 된다.
    • 참고로 파라미터에 다중 값이 존재할 때 request.getParameter()를 사용하면 request.getParameterValues()의 첫 번째 값을 반환한다
  • 다중 값 파라미터 조회 
    • getParameterValues("파라미터 명")을 사용하여 배열 형식으로 파라미터 명을 모든 값을 가지고 올 수 있다.

HTTP 요청 데이터 - POST HTML Form

  • content-type: application/x-www-form-urlencoded
  • 메시지 바디에 쿼리 파리미터 형식으로 데이터를 전달한다. username=hello&age=20
  • HTML 생성
<!DOCTYPE html>
<html>
<head>
 <meta charset="UTF-8">
 <title>Title</title>
</head>
<body>
<form action="/request-param" method="post">
 username: <input type="text" name="username" />
 age: <input type="text" name="age" />
 <button type="submit">전송</button>
</form>
</body>
</html>
  • 이 전에 만들었던 GET 방식으로 받았던 서블릿에 전송한다.
  • application/x-www-form-urlencoded 형식은 앞서 GET에서 살펴본 쿼리 파라미터 형식과 같다. 따라서 쿼리 파라미터 조회 메서드를 그대로 사용하면 된다.
  • 클라이언트(웹 브라우저) 입장에서는 두 방식에 차이가 있지만, 서버 입장에서는 둘의 형식이 동일하므로, request.getParameter()로 편리하게 구분 없이 조회할 수 있다
  • 참고
    • content-type은 HTTP 메시지 바디의 데이터 형식을 지정한다.
    • GET URL 쿼리 파라미터 형식으로 클라이언트에서 서버로 데이터를 전달할 때는 HTTP 메시지 바디를 사용하지 않기 때문에 content-type이 없다. 
    • POST HTML Form 형식으로 데이터를 전달하면 HTTP 메시지 바디에 해당 데이터를 포함해서 보내기 때문에 바디에 포함된 데이터가 어떤 형식인지 content-type을 꼭 지정해야 한다. 이렇게 폼으로 데이터를 전송하는 형식을 application/x-www-form-urlencoded 라 한다

HTTP message body에 데이터를 직접 담아서 요청

단순 텍스트

  • HTTP message body에 데이터를 직접 담아서 요청
    • HTTP API에서 주로 사용, JSON, XML, TEXT
    • 데이터 형식은 주로 JSON 사용
    • POST, PUT, PATCH
  • 단순 텍스트 형식으로 데이터를 주고 받을 때에는 ServletInputStream을 사용한다
  • HTTP 메시지 바디의 데이터를 InputStream을 사용해서 직접 읽을 수 있다.
  • inputStream은 byte 코드를 반환한다. byte 코드를 우리가 읽을 수 있는 문자(String)로 보려면 문자 표 (Charset)를 지정해주어야 한다. 여기서는 UTF_8 Charset을 지정해주었다

HTTP 요청 데이터 - API 메시지 바디 - JSON

  • content-type: application/json
  • message body: {"username": "hello", "age": 20} 

스프링 부트가 제공하는 Jackson 라이브러리을 ObjectMapper를 통해 클래스로 변경가능
HelloData

  • 참고
    • JSON 결과를 파싱 해서 사용할 수 있는 자바 객체로 변환하려면 Jackson, Gson 같은 JSON 변환 라이브러리를 추가해서 사용해야 한다. 스프링 부트로 Spring MVC를 선택하면 기본으로 Jackson 라이브러리( ObjectMapper )를 함께 제공한다.
    • HTML form 데이터도 메시지 바디를 통해 전송되므로 직접 읽을 수 있다. 하지만 편리한 파리미터 조회 기능( request.getParameter(...) )을 이미 제공하기 때문에 파라미터 조회 기능을 사용하면 된다.
728x90