본문 바로가기
Backend, Server/Servlet & JSP

[Servlet & JSP] HttpServletRequest 사용법

by ggyongi 2022. 1. 10.
반응형

HttpServletRequest 역할

서블릿은 HTTP 요청 메시지를 개발자 대신 파싱해준다. 그 결과를 HttpServletRequest 객체에 담아서 제공한다.

 

HTTP 요청 메시지 예시

START LINE
- HTTP 메소드
- URL
- 쿼리 스트링
- 스키마, 프로토콜


헤더
- 헤더 조회


바디
- form 파라미터 형식 조회
- message body 데이터 직접 조회

 

 

- start line 정보

더보기
//start line 정보
private void printStartLine(HttpServletRequest request) {
    System.out.println("--- REQUEST-LINE - start ---");
    System.out.println("request.getMethod() = " + request.getMethod()); //GET
    System.out.println("request.getProtocal() = " + request.getProtocol()); // HTTP/1.1
    System.out.println("request.getScheme() = " + request.getScheme()); // http://localhost:8080/request-header
    System.out.println("request.getRequestURL() = " + request.getRequestURL()); // /request-test
    System.out.println("request.getRequestURI() = " + request.getRequestURI()); //username=hi
    System.out.println("request.getQueryString() = " + request.getQueryString());
    System.out.println("request.isSecure() = " + request.isSecure()); //https 사용 유무
    System.out.println("--- REQUEST-LINE - end ---");
    System.out.println();
}

 

- Header 조회

더보기
//Header 모든 정보
private void printHeaders(HttpServletRequest request) {
    System.out.println("--- Headers - start ---");

    /*
     Enumeration<String> headerNames = request.getHeaderNames();
     while (headerNames.hasMoreElements()) {
     String headerName = headerNames.nextElement();
     System.out.println(headerName + ": " + request.getHeader(headerName));
     }
    */
    request.getHeaderNames().asIterator()
            .forEachRemaining(headerName -> System.out.println(headerName + ": " + request.getHeader(headerName)));
                    System.out.println("--- Headers - end ---");
    System.out.println();
}

//Header 편리한 조회
private void printHeaderUtils(HttpServletRequest request) {
    System.out.println("--- Header 편의 조회 start ---");
    System.out.println("[Host 편의 조회]");
    System.out.println("request.getServerName() = " + request.getServerName()); //Host 헤더
    System.out.println("request.getServerPort() = " + request.getServerPort()); //Host 헤더
    System.out.println();

    System.out.println("[Accept-Language 편의 조회]");
    request.getLocales().asIterator()
            .forEachRemaining(locale -> System.out.println("locale = " +
                    locale));
    System.out.println("request.getLocale() = " + request.getLocale());
    System.out.println();

    System.out.println("[cookie 편의 조회]");
    if (request.getCookies() != null) {
        for (Cookie cookie : request.getCookies()) {
            System.out.println(cookie.getName() + ": " + cookie.getValue());
        }
    }
    System.out.println();
    System.out.println("[Content 편의 조회]");
    System.out.println("request.getContentType() = " + request.getContentType());
    System.out.println("request.getContentLength() = " + request.getContentLength());
    System.out.println("request.getCharacterEncoding() = " + request.getCharacterEncoding());
    System.out.println("--- Header 편의 조회 end ---");
    System.out.println();
}

 

- 기타 조회(HTTP 메시지의 정보는 아님)

더보기
//기타 정보
private void printEtc(HttpServletRequest request) {
    System.out.println("--- 기타 조회 start ---");
    System.out.println("[Remote 정보]");
    System.out.println("request.getRemoteHost() = " + request.getRemoteHost()); //
    System.out.println("request.getRemoteAddr() = " + request.getRemoteAddr()); //
    System.out.println("request.getRemotePort() = " + request.getRemotePort()); //
    System.out.println();
    System.out.println("[Local 정보]");
    System.out.println("request.getLocalName() = " + request.getLocalName()); //
    System.out.println("request.getLocalAddr() = " + request.getLocalAddr()); //
    System.out.println("request.getLocalPort() = " + request.getLocalPort()); //
    System.out.println("--- 기타 조회 end ---");
    System.out.println();
}

 

 

 

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

 

 

 

1. GET - 쿼리 파라미터

- request.getParameter("username"); // 단일 파라미터 조회

- request.getParameterValues("username"); // 복수 파라미터 조회

- request.getParameterNames(); //파라미터 이름들 모두 조회

더보기
@Override
protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

    System.out.println("[전체 파라미터 조회 - start]");

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

    System.out.println("[전체 파라미터 조회 - end]");
    System.out.println();


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

    System.out.println("username = " + username);
    System.out.println("age = " + age);
    System.out.println();

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

    response.getWriter().write("OK");
}

 

2. POST - HTML Form

- 주로 회원가입, 상품 주문 등에서 사용하는 방식

- 쿼리 파라미터 조회 메서드와 같이 request.getParameter()로 편리

 

 

3. API 메시지 바디 - 단순 텍스트

- InputStream을 사용해서 직접 읽기 가능하다.

더보기
@Override
protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    ServletInputStream inputStream = request.getInputStream();
    String messageBody = StreamUtils.copyToString(inputStream, StandardCharsets.UTF_8);
    System.out.println("messageBody = " + messageBody);

    response.getWriter().write("OK");
}

 

4. API 메시지 바디 - JSON

- JSON 형식으로 파싱할 수 있게 객체가 필요(아래와 같이 HelloData 클래스를 만들어줌)

- JSON 변환 라이브러리(Jackson, Gson) 등을 사용하면 변환이 가능. 스프링부트에선 주로 Jackson(ObjectMapper)를 사용한다.

package hello.servlet.basic;
import lombok.Getter;
import lombok.Setter;

@Getter @Setter
public class HelloData {
     private String username;
     private int age;
}
더보기
@WebServlet(name = "requestBodyJsonServlet", urlPatterns = "/request-body-json")
public class RequestBodyJsonServlet extends HttpServlet {

    private ObjectMapper objectMapper = new ObjectMapper();

    @Override
    protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

        ServletInputStream inputStream = request.getInputStream();
        String messageBody = StreamUtils.copyToString(inputStream, StandardCharsets.UTF_8);
        System.out.println("messageBody = " + messageBody);

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

        response.getWriter().write("OK");

    }
}

 

 

 

----------------------------------------

참고 : 인프런 김영한님 강의(스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술)

 

비전공자 네카라 신입 취업 노하우

시행착오 끝에 얻어낸 취업 노하우가 모두 담긴 전자책!

kmong.com

댓글