서블릿(Servlet) - HTTP 요청 데이터 : 개요, GET 쿼리 파라미터, POST HTML Form

인프런 김영한 님의 스프링 강의이며, 2섹션 - 서블릿(Servlet)를 정리한다.

실습형 교육으로 자세한 설명이 궁금하면 수강을 권장한다. 

스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술 - 인프런 | 강의

---

HTTP 요청 데이터 - 개요

서버로 데이터를 전달하는 방법은 3가지가 있다.

1. GET - 쿼리 파라미터

- /url?username=hello&age20

- 메시지 바디 없이 URL의 쿼리 파라미터에 데이터를 포함해서 전달하는 방식

예) 검색, 필터, 페이징 등에서 사용된다.

 

2. POST - HTML form

- content-type: application/xwww-form-urlencoded

- 메시지 바디에 쿼리 파라미터 형식으로 전달 username=hello&age20

예) 회원가입, 상품 주문 등에 HTML Form 사용

 

3. HTTP message Body

- HTTP API에서 주로 사용, JSON(독보적), XML, TEXT

- POST, PUT, PATCH

 

---

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

쿼리 파라미터는 url 뒤에 ?를 시작으로 보낼 수 있다. 추가 파라미터는 & 로 구분한다. 

?key=value&key=value 로 넣어주면 된다. 

http://localhost:8080/request-param?username=hello&age=20

 

파라미터 조회 방법

1. 전체 파라미터 조회

@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");
    }
}

위의 url를 넣고 실행하면 결과가 나온다.

[전체 파라미터 조회] - start
username=hello
age=20
[전체 파라미터 조회] - end

2. 단일 파라미터 조회

@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");
        String username = request.getParameter("username");
        String age = request.getParameter("age");
        System.out.println("username = " + username);
        System.out.println("age = " + age);
        System.out.println("[단일 파라미터 조회] - end");
    }
}

3. 이름이 같은 복수 파라미터 조회

http://localhost:8080/request-param?username=hello&username=kim&age=20

 

@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");
        String[] usernames = request.getParameterValues("username");
        Arrays.stream(usernames).forEach(name -> System.out.println("username = " + name));
        System.out.println("[복수 파라미터 조회] - end");
    }
}

---

HTTP 요청 데이터 - POST HTML Form 

POST 방식으로 요청하기 위해 form 태그를 작성한다.

<form action="/request-param" method="post">
    username: <input type="text" name="username" /> age: <input type="text" name="age" /> <button type="submit">전송</button>
</form>

작성된 form 태그 이용

// 찍힌 로그
Received [POST /request-param HTTP/1.1
Host: localhost:8080
Origin: http://localhost:8080
Content-Type: application/x-www-form-urlencoded
Accept-Encoding: gzip, deflate
Connection: keep-alive
Upgrade-Insecure-Requests: 1
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.0.3 Safari/605.1.15
Referer: http://localhost:8080/basic/hello-form.html
Content-Length: 62
Accept-Language: ko-kr

username=%EB%A3%A8%ED%94%84-%EC%8A%A4%ED%84%B0%EB%94%94&age=20

GET 방식은 url에 파라미터를 붙이기 때문에 메시지 바디가 없어 content-type이 없지만

POST 방식은 메시지 바디에 데이터를 포함시키기 때문에 content-type : application/x-www-form-urlencoded 이 존재한다. 

클라이언트 입장에서는 GET, POST 두 방식에 차이가 있지만, 서버 입장에서는 동일하므로 HttpServletRequest로 편리하게 조회할 수 있다. 

 

Postman 사용

테스트를 위해 html 파일과 form 태그를 매번 작성하기 힘들 땐 포스트맨을 사용하자.

웹이나 포스트맨이나 HTTP 메시지는 서로 동일하게 만들어준다.

간단하게 확인할 수 있다.