[스프링 MVC] - 3. HTTP 요청 데이터 ( GET / POST / API )

 

HTTP 요청 데이터

 

 

HTTP 요청 메시지를 통해 클라이언트에서 서버로 데이터를 전달하는 방법을 알아보자.

 

주로 다음 3가지 방법을 사용한다.

 

 

 

GET - 쿼리 파라미터

 

/url?username=hello&age=20

메시지 바디 없이, URL의 쿼리 파라미터에 데이터를 포함해서 전달 예) 검색, 필터, 페이징등에서 많이 사용하는 방식

 

 

 

 

POST - HTML Form

 

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

메시지 바디에 쿼리 파리미터 형식으로 전달 username=hello&age=20 예) 회원 가입, 상품 주문, HTML Form 사용

 

 

 

 

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

 

HTTP API에서 주로 사용, JSON, XML, TEXT

 

데이터 형식은 주로 JSON 사용 POST, PUT, PATCH

 

 

 

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

 

쿼리파라미터는 URL에 다음과 같이 ?를 시작으로 보낼 수 있다. 추가파라미터는 &로 구분하면 된다.

 

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

 

URL의 쿼리 파라미터를 사용해서 데이터를 전달

 

request.getParameterNames().asIterator()
        .forEachRemaining(paramName -> System.out.println(paramName + "=" + request.getParameter(paramName)));

 

[전체 파라미터 조회] - getParameterNames()

 

asIterator() : 순회 하는 Iterator 를 리턴 

 

forEachRemaining() : 모든 요소가 처리되거나 적업에서 예외가 발생할 때까지 남은 각 요소에 대해 지정된 작업을 수행

 

 

이터레이터(Iterator) 란?

 

컬렉션에 저장된 데이터를 접근하는데 사용

 

컬렉션에 저장된 요소들을 읽어오는 방법을 표준화한 것. 

 

 

asIterator() 메서드

이 열거에 포함 된 요소들을 순회 하는 Iterator를 리턴합니다.

 

Iterator 메서드

boolean hasNex()	읽어 올 요소가 남아있는지 확인한다. 있으면 true, 없으면 false를 반환한다.
Object next()	다음 요소를 읽어 온다. next()를 호출하기 전에 hasNext()를 호출해서 읽어 올 요소가 있는지 확인하는 것이 안전하다.

 

 

Iterator 이랑 Enumeration 은 거의 같다.

 

Iterator 이 최신 버전이고, Enumeration 구버전이라고 생각하면 된다.

 

 

Iterator 쓰는 방법.

 

• 컬렉션에 iterator()를 호출해서 iterator 를 구현한 객체를 얻어서 사용한다.

 

List list = new ArrayList(); // 다른 컬렉션으로 변경할 때는 이 부분만 고치면 된다.
Iterator it = list.iterator(); // Iterator 객체를 반환.

while(it.hasNext()) { // 읽어올 요소가 있는지 확인
		System.out.println(it.next()); // 다음 요소를 읽어옴
}

 

 

 

 

System.out.println("[단일 파라미터 조회]");
String username = request.getParameter("username");
System.out.println("username = " + username);

 

[단일 파라미터 조회]  -  request.getParameter

 

 

 

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

 

복수 파라미터에서 단일 파라미터 조회 - request.getParameterValues

 

 

 

 

 

 

 

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

 

 

 

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

 

지금처럼 중복일 때는 request.getParameterValues() 를 사용해야 한다.

참고로 이렇게 중복일 때 request.getParameter() 를 사용하면 request.getParameterValues() 의 첫 번째 값을 반환한다.

 

 

 

HTTP 요청 데이터 - POST HTML Form

 

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

 

HTML의 Form을 사용해서 클라이언트에서 서버로 데이터를 전송

 

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

 

 

 

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

 

폼으로 데이터를 전송하는 형식을 application/x-www-form-urlencoded

 

message body: username=hello&age=20

 

 

 

> GET URL 쿼리 파라미터 형식으로 클라이언트에서 서버로 데이터를 전달할 때는

 

HTTP 메시지 바디를 사용하지 않기 때문에 content-type이 없다.

 

 

> POST HTML Form 형식으로 데이터를 전달하면

 

HTTP 메시지 바디에 해당 데이터를 포함해서 보내기 때문에 바디에 포함된 데이터가 어떤 형식인지 content-type을 꼭 지정해야 한다.

 

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

 

 

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

 

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

 

HTTP 요청 데이터에 메시지 바디에 내가 원하는 데이터를 직접 실어서 서버에 전송

 

먼저 가장 단순한 텍스트 메시지를 HTTP 메시지 바디에 담아서 전송하고, 읽어보자.

 

 

 

ServletInputStream inputStream = request.getInputStream();
String messageBody = StreamUtils.copyToString(inputStream, StandardCharsets.UTF_8);

 

HTTP 메시지 바디의 데이터를 InputStream을 사용해서 직접 읽을 수 있다.

 

getInputStream() :  byte 코드를 반환

 

 

StreamUtils.copyToString() : 문자열로 반환 

 

코드를 우리가 읽을 수 있는 문자(String)로 보려면 문자표 (Charset)를 지정해주어야 한다.

 

여기서는 UTF_8 Charset을 지정해주었다.

 

 

 

 

Postman 으로 테스트 

 

 

content-type: text/plain

message body: hello

결과: messageBody = hello

 

 

 

 

 

 

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

 

 

이번에는 HTTP API에서 주로 사용하는 JSON 형식으로 데이터를 전달해보자.

 

 

 

 

 

 

 

 

 

public class HelloData {

    private String username;
    private int age;

 

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

 

 

 

 

JSON 결과를 파싱해서 사용할 수 있는 자바 객체로 변환하려면

 

Jackson, Gson 같은 JSON 변환 라이브러리를 추가해서 사용해야 한다.

 

private ObjectMapper objectMapper = new ObjectMapper();

 

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

 

 

 

# 참고 : ObjectMapper (JSON 파싱)

 

ObjectMapper

 

ObjectMapper를 이용하면 JSON을 Java 객체로 변환

 

반대로 Java 객체를 JSON 객체로 serialization 할 수 있다.

 

 

Java Object → JSON

 

Java 객체를 JSON으로 serialization 하기 위해서는 ObjectMapper의 writeValue() 메서드를 이용한다.

 

// Java Object ->  JSON
        Person person = new Person("zooneon", 25, "seoul");
        try {
            objectMapper.writeValue(new File("src/person.json"), person);
        } catch (IOException e) {
            e.printStackTrace();
        }

위와 같이 파라미터로 JSON을 저장할 파일과 직렬화시킬 객체를 넣어주면 된다.

 

JSON → Java Object

 

JSON 파일을 Java 객체로 deserialization 하기 위해서는 ObjectMapper의 readValue() 메서드를 이용한다.

 

// JSON -> Java Object
        String json = "{\"name\":\"zooneon\",\"age\":25,\"address\":\"seoul\"}";
        try {
            Person deserializedPerson = objectMapper.readValue(json, Person.class);
            System.out.println(deserializedPerson);
        } catch (JsonProcessingException e) {
            e.printStackTrace();
        }

위와 같이 파라미터로 JSON 형태의 문자열 or 객체와 역직렬화 시킬 클래스를 넣어주면 된다.

 

 

 

# 출처

 https://velog.io/@zooneon/Java-ObjectMapper%EB%A5%BC-%EC%9D%B4%EC%9A%A9%ED%95%98%EC%97%AC-JSON-%ED%8C%8C%EC%8B%B1%ED%95%98%EA%B8%B0

 

 

HelloData helloData = objectMapper.readValue(messageBody, HelloData.class);
System.out.println("helloData.username = " + helloData.getUsername());
System.out.println("helloData.age = " + helloData.getAge());

 

JSON 파일을 Java 객체로 deserialization 하기 위해서는 ObjectMapper의 readValue() 메서드를 이용한다.

 

 

 

 

 

 

 

 

 

https://www.inflearn.com/course/%EC%8A%A4%ED%94%84%EB%A7%81-mvc-1/dashboard 

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