JSP에서 HTTP 헤더 읽기란?
JSP에서 요청(request) 객체는 폼 데이터, 쿠키, HTTP 메서드 등 다양한 HTTP 헤더 정보를 가져올 수 있는 메서드를 제공합니다. 이러한 메서드들은 클라이언트의 요청을 웹 서버에 전달하는 역할을 하는 HttpServletRequest 객체를 통해 사용할 수 있습니다.
아래에서는 JSP 프로그램에서 HTTP 헤더와 요청 정보를 읽을 때 활용할 수 있는 주요 메서드들을 용도별로 나누어 정리했습니다.
1. 헤더 및 프로토콜 정보 조회 메서드
| 번호 | 메서드 및 설명 |
|---|---|
| 1 | Enumeration getHeaderNames() 이 요청에 포함된 모든 헤더 이름을 Enumeration 형태로 반환합니다. |
| 2 | String getHeader(String name) 지정한 요청 헤더의 값을 String으로 반환합니다. |
| 3 | int getIntHeader(String name) 지정한 요청 헤더의 값을 int 타입으로 반환합니다. |
| 4 | String getMethod() 요청에 사용된 HTTP 메서드의 이름(예: GET, POST, PUT)을 반환합니다. |
| 5 | String getProtocol() 요청이 사용하는 프로토콜의 이름과 버전을 반환합니다. |
| 6 | String getContentType() 요청 본문의 MIME 타입을 반환하며, 타입을 알 수 없으면 null을 반환합니다. |
| 7 | String getCharacterEncoding() 요청 본문에 사용된 문자 인코딩 방식의 이름을 반환합니다. |
| 8 | int getContentLength() 입력 스트림으로 제공되는 요청 본문의 길이(바이트 단위)를 반환하며, 길이를 알 수 없으면 -1을 반환합니다. |
2. 세션 및 쿠키 관련 메서드
| 번호 | 메서드 및 설명 |
|---|---|
| 9 | Cookie[] getCookies() 클라이언트가 이 요청과 함께 전송한 모든 Cookie 객체를 배열로 반환합니다. |
| 10 | HttpSession getSession() 이 요청과 연관된 현재 세션을 반환하며, 세션이 존재하지 않으면 새로 생성합니다. |
| 11 | HttpSession getSession(boolean create) 이 요청과 연관된 현재 HttpSession을 반환하며, 세션이 없고 create 값이 true인 경우에만 새 세션을 생성해 반환합니다. |
| 12 | String getRequestedSessionId() 클라이언트가 지정한 세션 ID를 반환합니다. |
3. 매개변수 및 속성 처리 메서드
| 번호 | 메서드 및 설명 |
|---|---|
| 13 | Enumeration getParameterNames() 이 요청에 포함된 매개변수 이름들을 담은 String 객체의 Enumeration을 반환합니다. |
| 14 | String getParameter(String name) 요청 매개변수의 값을 String으로 반환하며, 해당 매개변수가 존재하지 않으면 null을 반환합니다. |
| 15 | String[] getParameterValues(String name) 지정한 요청 매개변수가 가진 모든 값을 String 배열로 반환하며, 매개변수가 없으면 null을 반환합니다. |
| 16 | Enumeration getAttributeNames() 이 요청에서 사용할 수 있는 속성 이름들을 담은 Enumeration을 반환합니다. |
| 17 | Object getAttribute(String name) 지정한 이름의 속성 값을 Object 타입으로 반환하며, 해당 이름의 속성이 없으면 null을 반환합니다. |
| 18 | ServletInputStream getInputStream() ServletInputStream을 사용하여 요청 본문을 바이너리 데이터 형태로 가져옵니다. |
4. 클라이언트 및 요청 경로 정보 메서드
| 번호 | 메서드 및 설명 |
|---|---|
| 19 | Locale getLocale() Accept-Language 헤더를 기반으로 클라이언트가 선호하는 로케일(Locale)을 반환합니다. |
| 20 | String getRemoteAddr() 요청을 보낸 클라이언트의 IP(Internet Protocol) 주소를 반환합니다. |
| 21 | String getRemoteHost() 요청을 보낸 클라이언트의 정규화된 도메인 이름(FQDN)을 반환합니다. |
| 22 | String getRemoteUser() 사용자가 인증된 경우 요청을 보낸 사용자의 로그인 계정을 반환하고, 인증되지 않았으면 null을 반환합니다. |
| 23 | String getAuthType() 서블릿을 보호하는 데 사용된 인증 방식의 이름(예: "BASIC", "SSL")을 반환하며, JSP가 보호되지 않은 경우 null을 반환합니다. |
| 24 | boolean isSecure() 이 요청이 HTTPS와 같은 보안 채널을 통해 전송되었는지 여부를 boolean 값으로 반환합니다. |
| 25 | String getRequestURI() HTTP 요청 첫 줄에서 프로토콜 이름부터 쿼리 문자열 앞까지의 URL 부분을 반환합니다. |
| 26 | String getQueryString() 요청 URL에서 경로 뒤에 붙은 쿼리 문자열을 반환합니다. |
| 27 | String getContextPath() 요청 URI 중 요청의 컨텍스트(context)를 나타내는 부분을 반환합니다. |
| 28 | String getServletPath() 요청 URL 중 JSP를 호출하는 부분을 반환합니다. |
| 29 | String getPathInfo() 클라이언트가 요청 시 URL과 함께 전송한 추가 경로 정보를 반환합니다. |
| 30 | int getServerPort() 이 요청이 수신된 서버의 포트 번호를 반환합니다. |
마무리
위 메서드들은 JSP 개발에서 클라이언트 요청을 분석하고 처리하는 데 필수적인 도구입니다. 특히 getHeader(), getCookies(), getSession(), getParameter() 같은 메서드는 실무에서 가장 자주 사용되므로 숙지해 두면 좋습니다. 상황에 맞는 메서드를 적절히 조합하면 헤더 정보, 사용자 인증 상태, 세션 관리 등을 효율적으로 처리할 수 있습니다.