[Spring] MVC 1편 (3) - HTTP 요청 데이터

📌 HttpServletRequest

✅ 역할

HTTP 요청 메세지

POST /save HTTP/1.1
Host: localhost:8080
Content-Type: application/x-www-form-urlencoded

username=kim&age=20

• 서블릿은 개발자가 HTTP 요청 메세지를 편리하게 사용할 수 있도록 파싱해줌
• 그 결과를 HttpServletRequest 객체에 담아서 제공
• + 부가기능
  • 임시 저장소 기능
    • 저장: request.setAttribute(name, value)
    • 조회: request.getAttribute(name)
  • 세션 관리 기능
    • request.getSession(create: true)

 

📌 HTTP 요청 메세지 전달 (클라이언트 → 서버)

✅ GET - 쿼리 파라미터

• /url?username=hello&age=20
• 메세지 바디 없이, URL의 쿼리 파라미터에 데이터를 포함해서 전달
• e.g. 검색, 필터, 페이징 등에서 많이 사용하는 방식

 

✅ POST - HTML Form

• content-type: application/x-www-form-urlencoded
• 메세지 바디에 쿼리 파라미터 형식으로 전달 username=hello&age=20
• e.g. 회원 가입, 상품 주문

 

✅ HTTP 메세지 바디에 데이터를 직접 담아서 요청

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

 

📌 쿼리 파라미터 조회 메서드

String username = request.getParameter("username"); //단일 파라미터 조회
Enumeration<String> parameterNames = request.getParameterNames(); //파라미터 이름들
모두 조회
Map<String, String[]> parameterMap = request.getParameterMap(); //파라미터를 Map
으로 조회
String[] usernames = request.getParameterValues("username"); //복수 파라미터 조회

• GET- 쿼리 파라미터 방식과 POST - HTML Form의 파라미터 형식이 같기 때문에 같은 조회 메서드를 사용한다.
• 파라미터 이름은 하나이고, 중복 값이 있을 때는 getParameter() 대신 getParameterValues()를 사용해야 한다.

 

※참고※

쿼리 파라미터 형식으로 데이터를 전달할 때는 HTTP 메세지 바디를 사용하지 않기 때문에 content-type이 없는 반면, HTML From 형식으로 전달할 경우 HTTP 메세지 바디에 데이터를 포함해서 보내기 때문에 content-type을 지정해주어야 한다. (application/x-www-form-urlencoded)

 

📌 API 메세지 바디 - 단순 텍스트

• content-type: text/plain

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

• HTTP 메세지 바디의 데이터를 InputStream을 사용해서 직접 읽을 수 있음
• inputStream은 byte 코드를 반환하기 때문에 charset을 지정해주어야 함

 

📌 API 메세지 바디 - JSON

• content-type: application/json

JSON 형식으로 파싱하기 위한 객체

@Getter @Setter
public class HelloData {
     private String username;
     private int age;
}

 

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

• JSON 결과를 파싱해서 사용할 수 있는 자바 객체로 변환하기 위해서는 Jackson 같은 JSON 변환 라이브러리를 추가해서 사용해야 함. Spring MVC를 선택하면 기본으로 Jackson 라이브러리 (ObjectMapper)를 제공

 

---

강의 링크

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