[Spring MVC] [1] 2. 서블릿_2

윤경·2021년 9월 6일

TIL springMVC

Spring MVC

목록 보기

3/26

이 챕터는 실습 내용을 올린 것이라 별 내용은 없다 ^^;

[9] HttpServletResponse - 기본 사용법

HttpServletResponse 역할

HTTP 응답 메시지 생성 (HTTP 응답 코드 지정 / 헤더 생성 / 바디 생성)

편의 기능 제공 (Content-Type, 쿠키, Redirect)

✔️ ResponseHeaderServlet

package hello.servlet.basic.response;

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.Cookie;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;

@WebServlet(name = "responseHeaderServlet", urlPatterns = "/response-header")
public class ResponseHeaderServlet extends HttpServlet {

    @Override
    protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // [status-line]
        // 200을 바로 넣어도 되지만 의미를 바로 확인할 수 있는 sc_ok를 추천
        response.setStatus(HttpServletResponse.SC_OK);

        // [response-header]
        response.setHeader("Content-Type", "text/plain;charset=utf-8");
        response.setHeader("Cache-Control", "no-cache, no-store, must-revalidate"); // 캐시 무효화
        response.setHeader("Progma", "no-cache");   // 캐시 무효화
        response.setHeader("my-header", "hello");   // 임의의 헤더(를 만들 수도 있음)

        // [Header 편의 메소드]
//        content(response);
//        cookie(response);
        redirect(response);

        PrintWriter writer = response.getWriter();
        writer.println("ok");
    }

    private void content(HttpServletResponse response) {
        // Content-Type: text/plain;charset=utf-8
        // Content-Length: 2

        // 위의 이 줄을 주석 처리하고 돌려보면 이 두 줄로도 잘 돌아가는 것을 확인할 수 있음
        // 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) {
        // Set-Cookie: myCookie=good; Max-Age=600;
        // 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 {
        // Status Code 302
        // Location: /basic/hello-form.html

        // response.setStatus(HttpServletResponse.SC_FOUND); //302
        // response.setHeader("Location", "/basic/hello-form.html");
        // 이렇게 두 줄로 해도 되지만 아래의 한 줄로도 가능
        response.sendRedirect("/basic/hello-form.html");
    }

}

결과

[10] HTTP 응답 데이터 - 단순 텍스트, HTML

HTTP 응답 메시지에 담기는 내용

단순 텍스트 응답 (ex. write.println("ok");)

HTML 응답

HTTP API - MessageBody JSON (으로 바로)응답

✔️ ResponseHtmlServlet

package hello.servlet.basic.response;

import javax.servlet.ServletException;
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.io.PrintWriter;

@WebServlet(name = "responseHtmlServlet", urlPatterns = "/response-html")
public class ResponseHtmlServlet extends HttpServlet {

    @Override
    protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // 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>");

    }
}

결과

HTTP 응답으로 HTML을 반환하려면 content-type은 text/html로 지정해야 한다.

[11] HTTP 응답 데이터 - API JSON

응답은 세가지 - 단순 텍스트, html, body에 직접 json 데이터 보내기

✔️ ResponseJsonServlet

package hello.servlet.basic.response;

import com.fasterxml.jackson.databind.ObjectMapper;
import hello.servlet.basic.HelloData;

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

@WebServlet(name = "responseJsonServlet", urlPatterns = "/response-json")
public class ResponseJsonServlet extends HttpServlet {

    private ObjectMapper objectMapper = new ObjectMapper();

    @Override
    protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // Content-Type: application/json
        response.setContentType("application/json");
        response.setCharacterEncoding("utf-8");

        HelloData helloData = new HelloData();
        helloData.setUsername("kim");
        helloData.setAge(200);

        // {"username":"kim", "age":20}으로 바뀔 것 -> objectMapper 필요
        String result = objectMapper.writeValueAsString(helloData);
        response.getWriter().write(result);
    }
}

결과

HTTP 응답으로 JSON을 반환할 때는 content-type으로 application/json으로 지정해줘야 한다.
Jackson라이브러리가 제공하는 objectMapper.writeValueAsString()를 사용하면 객체를 JSON 문자로 변경할 수 있다.

📌

application/json은 스펙상 utf-8 형식을 사용하도록 정의되어 있어 스펙에서 charset=utf-8 과 같은 추가 파라미터를 지원하지 않는다.
따라서, application/json 이라고만 사용해야지 application/json;charset=utf-8 이라고 전달하는 것은 의미 없는 파라미터를 추가한 것이 된다.

response.getWriter()를 사용하면 추가 파라미터를 자동으로 추가해버린다. 이때는 response.getOutputStream()으로 출력하면 그런 문제가 없다.

[12] 정리

Request

HttpRequestServlet ➡️ HTTP 메시지의 스펙을 편리하게 사용할 수 있도록 해줌

HTTP 요청 메시지 보내는 방법 3가지

GET 방식으로 url에 쿼리 파라미터로 전송 (body X)

POST 방식으로 HTML form을 이용 (submit하면 웹 브라우저가 html 메시지를 생성해 전송. body O)

📌 서버 입장에서는 둘 다 같아서 request.getParamete 형식으로 통용해 받을 수 있음.

HTTP message body에 직접 데이터를 담아 전송
단순 text로 보낼 수도 있고, json 형식으로 보낼 수도 있고,, 사실 모든 걸 다 전송할 수 있음.
주로 HTTP API로 많이 쓰며 JSON 형태로 많이 전송.