서블릿 - HTTP 요청 데이터

Minseok Kim·2024년 1월 27일

Spring

목록 보기
6/13

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

HTTP 요청 데이터 - GET 쿼리 파라미터

@WebServlet(name = "requestParamServlet", urlPatterns = "/request-param")
public class RequestParamServlet extends HttpServlet {
    @Override
    protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        System.out.println("[전체 파라미터 조회] - start");

        request.getParameterNames().asIterator().forEachRemaining(paramName -> System.out.println(paramName + "=" + request.getParameter(paramName)));
        System.out.println("[전체 파라미터 조회] - end");
        System.out.println();

        System.out.println("[단일 파라미터 조회]");
        String username = request.getParameter("username");
        System.out.println("request.getParameter(username) = " + username);

        String age = request.getParameter("age");
        System.out.println("request.getParameter(age) = " + age);
        System.out.println();
    }
}

URL의 쿼리 파라미터를 사용해서 데이터를 전달
http://localhost:8080/request-param?username=mindol&age=20

결과

이름이 같은 복수 파라미터도 조회할 수 있다.
위의 코드에 아래 코드를 추가하겠다.

System.out.println("이름이 같은 복수 파라미터 조회");
System.out.println("request.getParameterValues(username)");
String[] usernames = request.getParameterValues("username");
for (String name : usernames) {
            System.out.println("username = " + name);
        }

URL의 쿼리 파라미터를 사용해서 데이터를 전달
http://localhost:8080/request-param?username=mindol&age=20&username=minseok

결과

request.getParameter() - 하나의 파라미터 이름에 대해서 단 하나의 값만 있을 때 사용
request.getParameterValues() - 파라미터의 이름은 하나인데 값이 중복될 때 사용

HTTP 요청 데이터 - POST HTML Form

HTML Form을 사용하여 클라이언트에서 서버로 데이터를 전송하겠다.
특징

  • content-type: application/x-www-form-urlencoded
  • 메시지 바디에 쿼리 파리미터 형식으로 데이터를 전달한다.username=hello&age=20
<!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>

form action="/request-param" method="post"이므로 아래 서블릿에 post 방식으로 전송

결과

POST의 HTML Form을 전송하면 웹 브라우저는 다음 형식으로 HTTP 메시지를 만든다.
- 요청 URL: http://localhost:8080/request-param
- content-type: application/x-www-form-urlencoded
- message body: username=abcde&age=20

application/x-www-form-urlencoded 형식은 앞서 GET에서 살펴본 쿼리 파라미터 형식과 같다.
따라서 쿼리 파라미터 조회 메서드를 그대로 사용하면 된다. 클라이언트(웹 브라우저) 입장에서는 두 방식에 차이가 있지만, 서버 입장에서는 둘의 형식이 동일하므로, request.getParameter() 로 편리하게 구분없이 조회할 수 있다.
정리하면 request.getParameter() 는 GET URL 쿼리 파라미터 형식도 지원하고, POST HTML Form 형식도 둘 다 지원한다.

HTML form을 생성하여 테스트를 진행하였다. 하지만 HTML form을 생성하지 않고 Postman을 사용하여 테스트를 할 수도 있다.

출처
스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술

0개의 댓글