# HTTP 데이터 전송/응답

프레임워크 없이 순수 자바 서블릿을 WAS에 등록하고, 데이터를 전송 받아보자.

참고로 직접 웹브라우저를 띄워 하나하나 메시지를 입력하는 방법도 있지만, 보통 API 테스트를 쉽게하는 툴인 Postman을 많이 사용한다. 간단히 가입하고 Workspace를 만들어 직접 HTTP 요청을 보낼 수 있다.

https://www.postman.com/

Postman | The Collaboration Platform for API Development

Postman makes API development easy. Our platform offers the tools to simplify each step of the API building process and streamlines collaboration so you can create better APIs faster.

www.postman.com

# HTTP 요청 데이터 전송

HTTP을 통해 요청 데이터를 전송할 때 아래의 3가지 방법을 보통 사용한다.

GET - 쿼리 파라미터
jiwondev.tistory.com/?username=JIWON&age=25
메시지 body없이 URL의 파라메타로 데이터를 포함해서 전달하는 방법
POST - HTML Form 으로 전송, message body 에 파라메타를 전달
content-type: application/x-www.form-urlencoded
body: username=hello&age=20
HTTP API - message body에 데이터를 직접 담아서 요청
json, xml, text 형식. 원한다면 이진데이터(Java 객체 직렬화)도 보낼 수 있으나 보통 json으로 사용
보통 POST, PUT, PATCH를 사용하여 전송함.

@1. HTTP GET

데이터를 URL에 적는다. 쿼리 파라미터는 ? 를 이용하여 보낼 수 있다. 똑같은 이름의 파라메타를 여러번 보낼 수 있다.

http://my.tistory.com/?username=hello&age=30&age=20

이렇게 전달받은 데이터는 request 객체를 통해 서버에서 받아 올 수 있다.

//단일 파라미터 조회 (여러 개가 있다면 첫번째 값)
String username = request.getParameter("username");

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

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

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

@2. HTTP Form (POST) 방식

다음과 같은 HTML 폼을 이용하여 메시지 바디에 파라메타를 포함하여 전송한다.

http://my.tistory.com/hello-form.html

실제 HTTP에서는 이렇게 전송된다. 이는 웹 브라우저가 HTML 폼을 읽고 만들어준다.

* content-type이 뭐죠

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

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

POST HTML Form 형식으로 데이터를 전달하면 HTTP 메시지 바디에 해당 데이터를 포함해서 보내기 때문에 바디에 포함된 데이터가 어떤 형식인지 content-type을 꼭 지정해야 한다. 이렇게 폼으로 데이터를 전송하는 형식을 application/x-www-form-urlencoded 라 한다.

<-- hello-form.html -->

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<form action="/request-param" method="post">
    username: <input name="username" type="text"/>
    age: <input name="age" type="text"/>
    <button type="submit">전송</button>
</form>
</body>
</html>

참고로 이렇게 받은 파라메타를 꺼내는 방법은 @1. HTTP GET과 다르지 않다. 보내는 방식이 다를 뿐이다. 그래서 서블릿에서는 doGet() 과 doPost()같은 메서드를 따로 제공하여, Service() 에서 처리한 후 적절한 메서드를 호출해서 구분한다. (doGet()등을 호출하는 건 HTTPServlet 클래스에 정의되어 있다.)

@3. HTTP API (json, xml, text)

POST, PUT, PATCH등을 이용해서 메시지 바디에 직렬화 데이터(Json, XML, Text)를 직접 담아서 보낸다.

requset에서 파라메타를 꺼내는 방식이 아닌, JSON을 꺼내 파싱하여 사용한다. 자바 객체를 Json으로 손쉽게 전환할 수 있는 ObjectMapper를 사용하면 편리하다. 대표적으로 Jackson, Gson 등이 있다.

참고로 HTML form 데이터도 아래와 같이 직접 바이트 스트림을 연결해 읽을 수 있으나 request.getParameter(...)로 손쉽게 꺼내올 수 있기 때문에 사용하지 않는 것뿐이다.

 ... 서블릿 객체   
    private ObjectMapper objectMapper = new ObjectMapper();

    @Override
    protected void service(HttpServletRequest req, HttpServletResponse resp)
            throws ServletException, IOException {
        
        // request에서 data를 꺼내온다.
        ServletInputStream inputStream = req.getInputStream();
        String messageBody = StreamUtils.copyToString(inputStream, StandardCharsets.UTF_8);
        System.out.println("messageBody = " + messageBody);
        
        // objectMapper를 사용하면 json <-> Object 변환을 간단하게 가능하다.
        HelloData helloData = objectMapper.readValue(messageBody,  HelloData.class);
        System.out.println("helloData.username = " + helloData.getUsername());
        System.out.println("helloData.age = " + helloData.getAge());
        
        // response 수정 후 반환
        resp.getWriter().write("ok");
    }
    
 ... 생략

# HTTP 서버 응답

요청을 받은 서버는 [HTTP 응답코드]와 함께 헤더, 바디를 생성하여 데이터를 전송한다.

1xx(정보) : 요청을 받았으며 프로세스를 계속 진행합니다.
2xx(성공) : 요청을 성공적으로 받았으며 인식했고 수용하였습니다.
3xx(리다이렉션) : 요청 완료를 위해 추가 작업 조치가 필요합니다.
4xx(클라이언트 오류) : 요청의 문법이 잘못되었거나 요청을 처리할 수 없습니다.
5xx(서버 오류) : 서버 응답이 없거나 서버가 명백히 유효한 요청에 대한 충족을 실패했습니다.

서블릿 스펙에서는 response 메서드를 통해 응답을 손쉽게 만들 수 있다.

response.setStatus(HttpServletResponse.SC_OK); //응답코드 200

 //[response-headers]
 response.setHeader("Content-Type", "text/plain;charset=utf-8");
 response.setHeader("Cache-Control", "no-cache, no-store, mustrevalidate");
 response.setHeader("Pragma", "no-cache");
 response.setHeader("my-header","hello");
 
 //[Header 메서드, 아래에 설명]
 content(response);
 cookie(response);
 redirect(response);
 
 //[message body]
 PrintWriter writer = response.getWriter();
 writer.println("ok");

    private void content(HttpServletResponse response) {
        //response.setHeader("Content-Type", "text/plain;charset=utf-8")와 동일
        response.setContentType("text/plain");
        response.setCharacterEncoding("utf-8");
        
        //response.setContentLength(2); //(생략시 자동 생성)
    }


    private void cookie(HttpServletResponse response) {
        //response.setHeader("Set-Cookie", "myCookie=good; Max-Age=600")와 동일
        Cookie cookie = new Cookie("myCookie", "good");
        cookie.setMaxAge(600); //600초
        response.addCookie(cookie);
    }


    private void redirect(HttpServletResponse response) throws IOException {
        // 아래 두 코드와 동일한 동작.
        //response.setStatus(HttpServletResponse.SC_FOUND); //302
        //response.setHeader("Location", "/basic/hello-form.html");
        response.sendRedirect("/basic/hello-form.html");
    }

@ 응답에 데이터 넣기 - HTML

사실 일반 text를 보내는 방식 (write.println)과 크게 다를건 없다. 다만 content-type을 text/html로 지정하고 태그를 보낸다는 점이 다를 뿐이다. 이렇게 자바코드로 HTML를 만들기 어려워 등장한 개념이 View 템플릿, 바로 JSP이다.

//Content-Type: text/html;charset=utf-8
 response.setContentType("text/html");
 response.setCharacterEncoding("utf-8");
 PrintWriter writer = response.getWriter();
 
 writer.println("<html>");
 writer.println("<body>");
 writer.println(" <div>안녕?</div>");
 writer.println("</body>");
 writer.println("</html>")

@ 응답에 데이터 넣기 - Json

Json도 마찬가지로 텍스트로 직접 파싱할 수 있지만, Object Mapper 라이브러리(Jackson)을 사용하면 간편하게 객체를 전달할 수 있다.

        response.setHeader("content-type", "application/json");
        response.setCharacterEncoding("utf-8"); // Json은 UTF-8만 사용한다. 의미없는 파라메타
        
        HelloData data = new HelloData(); // 데이터 전달 객체(DTO)
        data.setUsername("kim");
        data.setAge(20);
        
        //{"username":"kim","age":20}
        // ObjectMapper로 JSON형태로 전환
        String result = objectMapper.writeValueAsString(data);
        response.getWriter().write(result);

'🌱 Spring Framework > Spring MVC' 카테고리의 다른 글

Thymeleaf#2 Spring과 HTML Form 처리 (0)	2021.08.28
Thymeleaf#1 기본기능 (0)	2021.08.28
#2 HTTP API 요청 매핑, 헤더 조회 (0)	2021.08.11
#1 HTTP 요청 매핑과 기본 로깅 (0)	2021.08.11
# Spring MVC를 배우기 전에 (0)	2021.08.11

블로그의 정보

JiwonDev

# HTTP 데이터 전송/응답

# HTTP 요청 데이터 전송

@1. HTTP GET

@2. HTTP Form (POST) 방식

@3. HTTP API (json, xml, text)

# HTTP 서버 응답

@ 응답에 데이터 넣기 - HTML

@ 응답에 데이터 넣기 - Json

'🌱 Spring Framework > Spring MVC' 카테고리의 다른 글

블로그의 정보

활동하기

티스토리툴바

# HTTP 요청 데이터 전송

@1. HTTP GET

@2. HTTP Form (POST) 방식

@3. HTTP API (json, xml, text)

# HTTP 서버 응답

@ 응답에 데이터 넣기 - HTML

@ 응답에 데이터 넣기 - Json

'🌱 Spring Framework > Spring MVC' 카테고리의 다른 글

블로그의 정보

활동하기

공유하기

다른 글

티스토리툴바