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

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

 

JSON 형식 전송

 - POST http://localhost:8080/request-body-json

 - content-type: application/json

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

 - 결과: messageBody = {"username": "hello", "age": 20}

 

JSON 형식의 파싱을 하나 추가한다.

JSON 형식으로 파싱할 수 있게 객체를 하나 생성한다.

HelloData.java

 

package helloMVC.servlet.basic;

import lombok.Getter;
import lombok.Setter;

@Setter
@Getter
public class HelloData {

    private String username;
    private int age;
}

lombok 라이브러리는 개발자가 직접 일일이 getter setter 를 만드는 수고를 덜어준다.

 

만약 lombok이 제대로 작동하지 않는다면,

 

https://drcode-devblog.tistory.com/456

[Spring] 서블릿(Servlet) 프로젝트 환경 설정 (IntelliJ)

 

위의 게시글에서 

 

File > Settings > Build, Excution, Deployment > Compiler > Annotation Processors 

> Enable annotation processing 활성화 

 

부분을 확인해봐야 한다.

 

 

 

RequestBodyJsonServlet.java

RequestBodyJsonServlet.java

package helloMVC.servlet.basic.request;

import com.fasterxml.jackson.databind.ObjectMapper;
import helloMVC.servlet.basic.HelloData;
import org.springframework.util.StreamUtils;

import javax.servlet.ServletException;
import javax.servlet.ServletInputStream;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.nio.charset.StandardCharsets;

@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 으로 HTTP 통신을 실행한다

Body > raw > TEXT를 JSON으로 변경

콘솔 실행 결과

 

참고로, JSON 결과를 파싱해서 사용할 수 있는 자바 객체로 변환하려면 Jackson, Gson 과 같은 JSON 변환 라이브러리를 추가해서 사용해야 한다.

스프링 부트로 Spring MVC를 선택하면 기본적으로 Jackson 라이브러리(ObjectMapper)를 함께 제공한다.

 

그리고 HTML Form 데이터도 메시지 바디를 통해 전송되므로 직접 읽을 수 있다.

하지만 편리한 파라미터 조회 기능(request.getParameter())를 이미 제공하기 때문에 파라미터 조회 기능을 사용하면 된다.