눈이 녹으면 Spring-MVC 1월 31일 8회차

오늘 할 일

HttpServletResponse 사용법 익히기

 

HTTP 응답 메시지 생성

• HTTP 응답코드 지정 Ex)200, 404, 400 등의 코드
• 헤더 생성
• 바디 생성

편의 기능 제공

• Content-Type, 쿠키, Redirect

먼저 baisc 패키지에 response 패키지를 생성한다.

그 다음 응답코드 지정코드와 캐시 무효화 코드를 헤더에 설정한다.

추가적으로 사용자 생성 헤더 요소도 만들 수 있다.

한글 깨짐을 방지하기 위해서는 Content-Type에 charset = utf-8로 지정한다.

//[status-line]
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, must-revalidate");//cache무효화
response.setHeader("Pragma", "no-cache");//cache header무효화 과거버전
response.setHeader("my-header", "hello");

//[message body]
PrintWriter writer = response.getWriter();
writer.println("안녕하세요");

만약 응답상태지정을 BAD-REQUEST로 지정하면

response.setStatus(HttpServletResponse.SC_BAD_REQUEST);*//400응답*

 

또한 이러한 header의 content를 구성하기 위한 편의 메서드를 아래와 같이 구현할 수 있다.

public 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); //(생략시 자동 생성)
}

그 다음은 header에 cookie를 넣는 메서드다.

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

마지막으로 다른 페이지를 호출하는 redirect 메서드를 정의한다.

public 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");
}//다시 호출

이렇게 하면 header-response로 접근하면 hello-form.html파일을 불러온다.

response-header의 HTTP 응답메시지와 hello-form.html HTTP 응답메시지가 같이 있는 것을 볼 수 있다.

 

전체 코드는 아래와 같다.

packagehello.servlet.basic.response;

importjavax.servlet.ServletException;
importjavax.servlet.annotation.WebServlet;
importjavax.servlet.http.Cookie;
importjavax.servlet.http.HttpServlet;
importjavax.servlet.http.HttpServletRequest;
importjavax.servlet.http.HttpServletResponse;
importjava.io.IOException;
importjava.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]
	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, must-revalidate");//cache무효화
	response.setHeader("Pragma", "no-cache");//cache header무효화 과거버전
	response.setHeader("my-header", "hello");

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

	//[message body]
		PrintWriter writer = response.getWriter();
        writer.println("안녕하세요");
    }
	public 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); //(생략시 자동 생성)
}
	public void cookie(HttpServletResponse response){
				//Set-Cookie: myCookie=good; Max-Age=600;
        //response.setHeader("Set-Cookie", "myCookie=good; Max-Age=600"
				Cookie cookie =newCookie("myCookie", "good");
        cookie.setMaxAge(600);//600초
				response.addCookie(cookie);
    }
	public void redirect(HttpServletResponse response)throwsIOException {
				//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");
    }//다시 호출
}

 

HTTP 응답 메시지는 주로 다음 내용을 담아서 전달한다.

• 단순 텍스트 응답
  • 앞에서 살펴봄(writer.println(”ok”);)
• HTML 응답
• HTTP API, MessageBody JSON 응답

단순 텍스트와 HTML응답을 보낼때는 직접 작성한다.

//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 API를 다룰때 JSON파일을 뿌리는 방법을 해본다.

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

    HelloData helloData =new HelloData();
    helloData.setUsername("park");
    helloData.setAge(23);

//{"username":"park", "age":23}
String result = objectMapper.writeValueAsString(helloData);
    response.getWriter().write(result);
}

json라이브러리를 다루기 위해 ObjectMapper를 사용하여 helloData객체를 String타입으로 만들어낸다. 그 다음에 서버의 응답으로 넘겨준다.

 

향후에는 단순히 HelloData를 리턴하는 방식으로까지 간편화 된다.

위의 실습을 통해 알게된 것은

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()으로 출력하면 그런 문제가 없다.

• 단순 텍스트 응답
  • 앞에서 살펴봄(writer.println(”ok”);)
• HTML 응답
• HTTP API, MessageBody JSON 응답

단순 텍스트와 HTML응답을 보낼때는 직접 작성한다.

//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 API를 다룰때 JSON파일을 뿌리는 방법을 해본다.

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

    HelloData helloData =new HelloData();
    helloData.setUsername("park");
    helloData.setAge(23);

//{"username":"park", "age":23}
String result = objectMapper.writeValueAsString(helloData);
    response.getWriter().write(result);
}

json라이브러리를 다루기 위해 ObjectMapper를 사용하여 helloData객체를 String타입으로 만들어낸다. 그 다음에 서버의 응답으로 넘겨준다.

그러면 아래와 같은 json타입의 결과를 얻는다.

향후에는 단순히 HelloData를 리턴하는 방식으로까지 간편화 된다.

위의 실습을 통해 알게된 것은

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()으로 출력하면 그런 문제가 없다.