HTTP 요청 데이터

황준하·2023년 8월 25일
Spring

SpringMVC

목록 보기
4/19
post-thumbnail

HTTP 요청 데이터 - 개요

GET - 쿼리 파라미터

  • /url?username=hello&age=20
  • 메세지 바디 없이, URL의 쿼리 파라미터에 데이터를 포함해서 전달

POST - HTML Form

  • content-type application/x-www-form-urlencoded
  • 메세지 바디에 쿼리 파라미터 형식으로 전달 username=hello&age=20
  • 주로 회원가입, 상품 주문 등에서 사용하는 방식

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

  • HTTP API에서 주로 사용, JSON, XML, TEXT
  • 데이터 형식은 주로 JSON 사용
  • POST, PUT, PATCH

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

전달데이터

  • username=hello
  • age=20
package hello.servlet.basic.request;

import ...

/**
 * 1. 파라미터 전송 기능
 * http://localhost:8080/request-param?username=hello&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");

        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");
        String age = request.getParameter("age");

        System.out.println("username = " + username);
        System.out.println("age = " + age);
        System.out.println();

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

        response.getWriter().write("ok");
    }
}
[전체 파라미터 조회] - start
username=hello
age=20
[전체 파라미터 조회] - end

[단일 파라미터 조회]
username = hello
age = 20

[이름이 같은 복수 파라미터 조회]
username = hello
username = kim
2022-08-19 16:03:36.497 DEBUG 16632 --- [nio-8080-exec-1] o.a.coyote.http11.Http11InputBuffer      : Before fill(): parsingHeader: [true], parsingRequestLine: [true], parsingRequestLinePhase: [0], parsingRequestLineStart: [0], byteBuffer.position(): [0], byteBuffer.limit(): [0], end: [754]
2022-08-19 16:03:36.497 DEBUG 16632 --- [nio-8080-exec-1] o.a.coyote.http11.Http11InputBuffer      : Received []
2022-08-19 16:03:36.497 DEBUG 16632 --- [nio-8080-exec-1] o.apache.coyote.http11.Http11Processor   : Socket: [org.apache.tomcat.util.net.NioEndpoint$NioSocketWrapper@154394e0:org.apache.tomcat.util.net.NioChannel@483e4cfc:java.nio.channels.SocketChannel[connected local=/0:0:0:0:0:0:0:1:8080 remote=/0:0:0:0:0:0:0:1:10020]], Status in: [OPEN_READ], State out: [OPEN]

복수 파라미터에서 단일 파라미터 조회

request.getParameter() 는 하나의 파라미터 이름에 대해서 단 하나의 값만 있을 때 사용해야 한다.

HTTP 요청 데이터 - POST HTML Form

  • 메세지 바디에 쿼리 파라미터 형식으로 전달 username=hello&age=20
  • 주로 회원가입, 상품 주문 등에서 사용하는 방식

특징

content-type application/x-www-form-urlencoded

<!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에서 본 쿼리 파라미터 형식과 같다. 따라서 쿼리 파라미터 조회 메서드를 그대로 사용하면 된다.

request.getParameter() 는 GET URL 쿼리 파라미터 형식도 지원하고, POST HTML Form 형식도 둘 다 지원한다.

Postman을 사용하여 테스트

POST 전송시

  • Body -> x-www-form-urlencoded 선택
  • Headers에서 content-type: application/x-www-form-urlencoded 지정된 부분 확인

Log

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

[단일 파라미터 조회]
username = kim
age = 20

[이름이 같은 복수 파라미터 조회]
username = kim

HTTP 요청 데이터 - API 메시지 바디 - 단순 텍스트

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

  • HTTP API에서 주로 사용, JSON, XML, TEXT
  • 데이터 형식은 주로 JSON 사용
  • POST, PUT, PATCH
package hello.servlet.basic.request;

import ...

@WebServlet(name = "RequestBodyStringServlet", urlPatterns = "/request-body-string")
public class RequestBodyStringServlet extends HttpServlet {
    @Override
    protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        ServletInputStream inputStream = request.getInputStream();
        String messageBody = StreamUtils.copyToString(inputStream, StandardCharsets.UTF_8);

        System.out.println("messageBody = " + messageBody);

        response.getWriter().write("ok");
    }
}

Postman을 사용해서 테스트

messageBody = hello!

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

HTTP API에서 주로 사용하는 JSON형식으로 데이터 전달

JSON 형식 전송

message body: {"username": "hello", "age": 20}

package hello.servlet.basic;

import lombok.Getter;
import lombok.Setter;

@Getter @Setter
public class HelloData {

    private String username;
    private int age;


}

롬복이 자동으로 getter setter를 추가해준다.

package hello.servlet.basic.request;

import ...

@WebServlet(name = "RequestBodyJsonServlet", urlPatterns = "/request-body-json")
public class RequestBodyJsonServlet extends HttpServlet {

    private ObjectMapper objectMapper = new ObjectMapper();

    @Override
    protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        ServletInputStream inputStream = request.getInputStream();
        String messageBody = StreamUtils.copyToString(inputStream, StandardCharsets.UTF_8);

        System.out.println("messageBody = " + messageBody);

        HelloData helloData = objectMapper.readValue(messageBody, HelloData.class);

        System.out.println("helloData.username = " + helloData.getUsername());
        System.out.println("helloData.age = " + helloData.getAge());

        response.getWriter().write("ok");

    }
}

Postman으로 실행

messageBody = {"username": "hello", "age": 20}
helloData.username = hello
helloData.age = 20

JSON 결과를 파싱해서 사용할 수 있는 자바 객체로 변환하려면 Jackson, Gson 같은 JSON 변환 라이브러리를 추가해서 사용해야 한다. 스프링 부트로 Spring MVC를 선택하면 기본으로 Jackson 라이브러리 ObjectMapper를 제공한다.

HTML  form 데이터도 메세지 바디를 통해 전송되므로 직접 읽을 수 있다. 하지만 편리한 파라미터 조회 기능 

request.getParameter 을 이미 제공하기 때문에 파라미터 조회 기능을 사용하면 된다.

profile
황준하
이전 포스트

HttpServletRequest

다음 포스트

HttpServletResponse

0개의 댓글