차근차근정확하게

Servlet 응답 처리

Properties1
tagsjava-기반-웹개발, servlet--and--jsp

3 min read

Servlet 응답 처리

HttpServletResponse로 응답을 구성하는 세 가지 방식을 정리한 노트다. 상태 코드·헤더·쿠키 설정과 리다이렉트 같은 기본 사용법, PrintWriter로 텍스트/HTML 본문을 직접 작성하는 방식, 그리고 Jackson ObjectMapper로 객체를 JSON 문자열로 변환해 application/json 응답을 만드는 방식을 다룬다.

실행 환경

@WebServlet 어노테이션 기반 등록 방식이 사용되어 Servlet 3.0 이상을 전제로 한다. 구체적인 Servlet/Tomcat 버전은 코드상 명시되어 있지 않다.

ServletResponse 기본 사용법

  • 기본적으로 response 헤더 설정 : setHeader(“[field Name]”, “[value]”)
  • Response 상태 코드 : setStatus(“[HTTP 정의 상수]”)
  • Headet 편의 메서드 : ContentType, Cookie, Redirect
@WebServlet(urlPatterns="/main")
public class ResponseTest extends HttpServlet{
    
    @Override
    protected void service( HttpServletRequest request, HttpServletResponse response) throws ServletExceptio, IOException
    {
        
        response.setStatus(HttpServletResponse.SC_OK); // 200 상태코드
        
        response.setHeader("Content-Type", "text/plain; charset=utf-8");
        response.setHeader("Cache-Control", "no-cache, no-store, must-revalidate");
        response.setHeader("Pragma", "no-cache");
        
        [Content Type 설정 편의 메서드]
        response.setContentType("text/plain");
        response.setCharsetEncoding("utf-8");
        
        //[쿠키 설정]
        Cookie cookie = new Cookie("TestCookie", "good");
        cookie.setMaxAge(600);
        response.addCookie(cookie);
        
        //[리다이렉트]
        response.sendRedirect("/main/redirect/page");
        
        PrintWriter writer = response.getWriter();
    
        writer.println("ok");
    }
}

Response 텍스트 / HTML

  • PrintWriter 객체를 이용해서 응답 (텍스트 , html)
  • response.getWriter()을 이용하여 반환
@WebServlet(urlPatterns="/main")
public class ResponseTest extends HttpServlet{
    
    @Override
    protected void service( HttpServletRequest request, HttpServletResponse response) throws ServletExceptio, IOException
    {
        
        response.setStatus(HttpServletResponse.SC_OK); // 200 상태코드
        
        response.setHeader("Content-Type", "text/plain; charset=utf-8");
        response.setHeader("Cache-Control", "no-cache, no-store, must-revalidate");
        response.setHeader("Pragma", "no-cache");
        
        PrintWriter writer = response.getWriter();
        
        //단순 텍스트
        writer.println("ok");
        
        //html 반환
        writer.println("<html>");
        writer.println("<body>");
        writer.println("<p> Test </p>");
        writer.println("</body>");
        writer.println("</html>");
        
    }
}

HTTP API JSON

public class TestObject{
    private String username;
    private int count;
    
    void setUsername(String username)
    {
        this.username = username;
    }
    
    void setCount(int count)
    {
        this.count = count;
    }
    
    String getUsername()
    {
        return this.username;
    }
    
    int getCount()
    {
        return this.count;
    }
}
 
@WebServlet(urlPatterns="/main")
public class TestResponse extends HttpServlet{
    
    private ObjectMapper objecvtMapper = new ObjectMapper();
    
    @Override
    protected void service(HttpServletREquest request, HttpServletResponse response) throws ServletException, IOException{
        
        //application/json 은 utf-8을 사용하도록 정의되있다 ( 굳이 추가하지 않아도 됨 )
        response.setHeader("content-type", "application/json");
        response.setCharacterEncoding("utf-8");
        
        TestObject data = new TestObject();
        data.setUsername("test");
        data.setCount(20);
        
        String result = objectMapper.writeValueAsString(data);
        
        response.getWriter().wirte(result);
    }
}

그래프 뷰