📗Spring MVC Study [ HTTP REQUEST (GET, POST, API) ]

Caruh·2025년 3월 17일

Spring MVC

목록 보기

6/17

GET - 쿼리 파라미터

쿼리 파라미터는 URL에 아래와 같이 ?를 시작으로 보낼 수 있다.
추가 파라미터는 &으로 구분할 수 있다.

http://localhost:8080/request-param?username=hello&age=20
서버에서는 HttpServletRequest가 제공하는 메서드를 통해 쿼리 파라미터를 편리하게 조회할 수 있다.

String username = request.getParameter("username"); //단일 파라미터 조회

Enumeration<String> parameterNames = request.getParameterNames(); //파라미터 이름들 모두 조회

Map<String, String[]> parameterMap = request.getParameterMap(); //파라미터를 Map으로 조회

String[] usernames = request.getParameterValues("username"); //복수 파라미터 조회

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

username=hello&username=kim&username=dong일 경우 어떻게 조회를 해야할까?

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

중복일 경우 request.getParameter()를 사용하면 request.getParameterValues()의 첫 번째 값을 반환한다.

POST HTML FORM

주로 회원 가입이나, 상품 주문 등에서 사용하는 방식이다.

 <!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>

특징

content-type : application/x-www.form-urlencoded
메시지 바디에 쿼리 파라미터 형식으로 데이터를 전달한다. username=hello&age=20

정리

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

참고

content-type은 HTTP 메시지 바디의 데이터 형식을 지정

GET URL 쿼리 파라미터 형식으로 클라이언트에서 서버로 데이터를 전달할 때는 HTTP 메시지 바디를 사용하지 않기 때문에 content-type이 없다.

POST HTML Form 형식으로 데이터를 전달하면 HTTP 메시지 바디에 포함된 데이터가 어떤 형식인지 content-type을 꼭 지정해야 한다.

이렇게 폼으로 데이터를 전송하는 형식을 application/x-www-form-urlencoded라고 한다.

API 메시지 바디

단순 텍스트를 JSON 형태로 request 요청

HTTP message body에 데이터를 직접 담아서 요청
- HTTP API에서 주로 사용, JSON, XML, TEXT
- 데이터 형식은 주로 JSON사용
- POST, PUT, PATCH 형태로 요청
HTTP 메시지 바디의 데이터를 InputStream을 사용해서 직접 읽을 수 있다.
참고
- inputStream은 byte 코드를 반환한다. byte 코드를 우리가 읽을 수 있는 문자(String)로 보려면 문자표 (Charset)를 지정해주어야 한다.
- 요즘은 euc-kr 보다 utf-8 형태로 인코딩 하는 경우가 많아서 utf-8을 사용하자.

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 형식으로 파싱할 수 있게 객체를 하나 생성

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

Json 형태로 요청이 온것을 확인하려면 inputStream을 사용하면된다.

request를 inputStream으로 받으면 이런식으로 오게된다.
{messageBody = {"username" : "hello", "age" : 20}}

Json형식의 요청을 객체의 형태로 받으려면?

참고

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

스프링 부트로 Spring MVC를 선택하면 기본으로 Jackson 라이브러리(ObjectMapper)를 함께 제공한다. -> 이거 사용하면 자바 객체로 쉽게 변환할 수 있다.

// Jackson 라이브러리 사용
private ObjectMapper objectMapper = new ObjectMapper();

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

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

//객체로 변환후 찍어본 결과
helloData.username: hello
helloData.age: 20