참고 HttpServletRequest
서블릿은 개발자가 HTTP 요청 메시지를 편리하게 사용할 수 있도록 개발자 대신에 HTTP 요청 메시지를 파싱 한다. 그리고 그 결과를 HttpServletRequest 객체에 담아서 제공한다.
HttpServletRequest를 사용하면 다음과 같은 HTTP 요청 메시지를 편리하게 조회할 수 있다.
참고 HTTP 요청 메시지
- START LINE (POST / save HTTP/1.1)
- HTTP 메서드 (POST)
- URL (/save)
- 쿼리 스트링
- 스키마, 프로토콜 (HTTP/1.1)
- Header
- 헤더 조회
- Body
- form 파라미터 형식 조회
- message body 데이터 직접 조회
HTTP Request 데이터 3가지
(1) GET - 쿼리 파라미터
- /url?username=hello&age=20
- Message Body 없이, URL의 쿼리 파라미터에 데이터를 포함해서 전달
- ex) 검색, 필터, 페이징 등에서 많이 사용하는 방식
Query Parameter 조회 메서드
String username = request.getParameter("username"); //단일 파라미터 조회
Enumeration<String> parameterNames = request.getParameterNames(); //파라미터 이름들 모두 조회
Map<String, String[]> parameterMap = request.getParameterMap(); //파라미터를 Map으로 조회
String[] usernames = request.getParameterValues("username"); //복수 파라미터 조회
RequstParamServlet
http://localhost:8080/request-param?username=hello&username=kim&age=20
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 = "requestParamServlet", urlPatterns = "/request-param")
public class RequestParamServlet extends HttpServlet {
@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("[단일 파라미터 조회]");
String username = request.getParameter("username");
System.out.println("username = " + username);
String age = request.getParameter("age");
System.out.println("age = " + age);
System.out.println();
System.out.println("[이름이 같은 복수 파라미터 조회]");
String[] usernames = request.getParameterValues("username");
for (String name : usernames) {
System.out.println("username = " + name);
}
response.getWriter().write("ok");
}
}
결과
복수 파라미터에서 단일 파라미터 조회
- username=hello&username=kim과 같이 파라이머 이름은 하나인데, 값이 중복인 경우
- request.getParameter()는 하나의 파라미터 이름에 대해서 단 하나의 값만 있을 때 사용해야 한다.
- 값이 중복일 때 request.getParameter 사용 시 첫 번째 값만 반환한다.
- 중복일 때는 request.getParameterValues()를 사용해야 한다.
GET URL 쿼리 파라미터 형식으로 클라이언트에서 서버로 데이터를 전달할 때는 HTTP 메시지 바디를 사용하지 않기 때문에 content-type이 없다.
(2) POST HTML Form
- content-type : application/x-www-form-urlencoded
- Message Body에 쿼리 파라미터 형식으로 전달 username=hello&age=20
- ex) 회원 가입, 상품 주문, HTML Form 사용
HTTP Message
- 요청 URL : http://localhost:8080/request-param
- content-type : application/x-www-form-urlencoded
- message body : username=hello&age=20
application/x-www-form-urlencoded 형식은 앞서 GET 쿼리 파라미터 형식과 같다.
그러므로 쿼리 파라미터 조회 메서드를 그대로 사용하면 된다.
클라이언트(웹 브라우저) 입장에서는 두 방식에 차이가 있지만, 서버 입장에서는 둘의 형식이 동일하므로 request.getParameter()로 편리하게 구분 없이 조회할 수 있다.
(3) HTTP API
- HTTP API에서 주로 사용, JSON, XML, TEXT
- 데이터 형식은 주로 JSON 사용
- POST, PUT, PATCH 모두 사용 가능
JSON 형식 파싱 추가
import lombok.Getter;
import lombok.Setter;
@Getter
@Setter
public class HelloData {
private String username;
private int age;
}
HTTP API - Json 조회 메서드
import com.fasterxml.jackson.databind.ObjectMapper;
import hello.servlet.basic.HelloData;
import org.springframework.util.StreamUtils;
import javax.servlet.ServletException;
import javax.servlet.ServletInputStream;
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.nio.charset.StandardCharsets;
/**
* http://localhost:8080/request-body-json
* JSON 형식 전송
* content-type : application/json
* message body : {"username":"hello", "age":20}
*/
@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);
System.out.println("helloData.Username = " + helloData.getUsername());
System.out.println("helloData.Age = " + helloData.getAge());
response.getWriter().write("ok");
}
}
Postman으로 request Message 보내기
- Post http://localhost:8080/request-body-json
- content-type : application/json(Body -> raw, json)
- message body : {"username":"hello", "age":20}
출력 결과
JSON 결과를 파싱 해서 사용할 수 있는 자바 객체로 변환하려면 Jackson, Gson 같은 JSON 변환 라이브러리를 추가해서 사용해야 한다. 스프링 부트로 Spring MVC를 선택하면 기본으로 Jackson 라이브러리 (ObjectMapper)를 함께 제공한다.
본 글은 김영한 님의 "스프링 핵심 원리"(인프런) 유료 강의를 들으며 요약, 정리하고 일부 정보를 추가 작성한 것입니다.
반응형
'Spring(JAVA Framework) > Spring MVC' 카테고리의 다른 글
SpringMVC 구조 (0) | 2021.09.15 |
---|---|
HTTP Response 데이터 (0) | 2021.08.29 |
Servlet 환경 세팅과 등록 (0) | 2021.08.28 |
HTTP API (0) | 2021.08.28 |
Servlet (서블릿) (0) | 2021.08.28 |
댓글