쿠키

쿠키(Cookie)란, 클라이언트의 상태 정보를 클라이언트 pc에 저장했다가, 다음 요청 시 저장된 쿠키를 서버로 전송해서 사용하는 기능입니다.

• 쿠키는 Key, Value 형태로 저장됩니다.
• 쿠키는 3000개까지 만들 수 있습니다.
• 쿠키 하나의 최대 크니는 4096 바이트 입니다.
• 하나의 호스트나 도메인에서 최대 50개까지 만들 수 있습니다.

쿠키의 동작 메커니즘

1. 클라이언트가 서버에 요청을 보냅니다! (최초 접속)
2. 서버가 쿠키를 생성해서 HTTP 응답 헤더에 실어서 클라이언트에 전송합니다.
3. 클라이언트 쿠키를 받아 클라이언트 pc에 저장합니다. (아직 클라이언트 pc에만 있는 상태)
4. 클라이언트의 다음번 요청 시 저장해둔 쿠키를 HTTP 요청 헤더에 실어 서버로 보냅니다.
5. 서버는 클리어인트가 보낸 쿠키 정보를 읽어 작업을 수행합니다.

쿠키의 속성과 메서드

쿠키의 속성

• 이름(name)
  쿠키를 구별하는 이름 입니다. (이름 중복 불가)
  String 타입으로 저장합니다.
• 값(value)
  쿠키에 저장할 실제 데이터 입니다.
  String 타입으로 저장합니다.
  ( ) < > @ , ; : \ " / [ ] ? = { } 의 특수문자는 사용이 제한됩니다.
• 도메인(domain)
  쿠키를 적용할 도메인 입니다.
• 경로(path)
  쿠키를 적용할 경로 입니다.
• 유지 기간(max age)
  쿠키가 클라이언트 pc에서 만들어진 후 유지될 기간, 즉 쿠키의 수명 입니다.
  초 단위로 설정합니다.

쿠키 관련 메서드

사용법

쿠키 생성법은 아래 쿠키 조작법(기본) 부분을 참고해주세요

<%
// 사용법
쿠키담은변수명.메서드();

// 사용예시
Cookie cookie = new Cookie("cookieName", "cookieValue");
cookie.setValue("changedValue");
%>

리턴 타입	메서드 명	설명
void	setValue(String value)	- 해당 쿠키의 값을 입력한 value로 설정(수정)합니다.
void	setDomain(String domain)	- 해당 쿠키를 적용할 도메인을 설정 합니다.
void	setPath(String path)	- 쿠키를 적용할 경로를 지정합니다. - 지정한 경로와 그 하위 경로까지 적용됩니다.
void	setMaxAge(int expire_seconds)	- 쿠키의 수명을 설정합니다. - 초 단위로 설정하며, 클라이언트 pc에 저장된 순간부터 설정된 초 만큼의 수명을 갖습니다. - 수명을 설정하지 않으면 자동으로 0으로 설정되어 클라이언트 pc에서 만들어진 순간 삭제됩니다.
String	getName()	- 해당 쿠키의 이름을 반환합니다.
String	getValue()	- 해당 쿠키의 값을 반환합니다.
String	getDomain()	- 해당 쿠키가 적용되어있는 도메인을 반환합니다.
String	getPath()	- 해당 쿠키가 적용되어있는 경로를 반환합니다.
int	getMaxAge()	- 해당 쿠키의 수명을 반환합니다. - 수명이 설정되어있지 않다면, -1을 반환합니다.

쿠키 조작법(기본)

쿠키생성

1. 쿠키 생성
   쿠키를 생성할 때는 Cookie 생성자를 이용해서 생성합니다.
   Cookie 변수명 = new Cookie(String Key, String value);
2. 도메인 설정
   쿠키에 적용할 도메인을 설정합니다.
   변수명.setDomain(String domain);
3. 경로 설정
   쿠키가 적용될 경로로 지정합니다.
   변수명.setPath(String path);
4. 수명 설정
   해당 쿠키가 유지될 기간을 초단위로 작성합니다. 미작성 시 0으로 설정되면 만들어지자마자 사라집니다.
   변수명.setMaxAge(int age);
5. 열심히 만든 쿠키 추가하기
   위 순서대로 만든 쿠키를 response 객체를 이용해서 응답헤더에 쿠키를 추가합니다.
   response.addCookie(변수명);

<!-- 사용예시 -->
<%
// 1. 쿠키 생성
Cookie cookie = new Cookie("myCookie", "쿠키값1");
// 2. 도메인 설정 : 현재 localhost에서만 사용할 꺼라 일단 생략
// 3. 경로설정
cookie.setPath(request.getContextPath());  
// 컨텍스트 패스에 값을 안주면 루트가 됨 = "/"
// 4. 수명설정
cookie.setMaxAge(3600);
// 5. 쿠키 응답헤더에 추가하기
response.addCookie(cookie);
%>

쿠키 조회

1. 쿠키 정보 갖고오기
   request 객체를 이용해서 클라이언트의 요청정보에서 쿠키 정보를 배열로 가져옵니다.
   Cookie[] 변수명 = request.getCookies();
2. 쿠키 값 가져오기
   위 생성한 배열에서 getName, getValue 으로 쿠키명과 값을 갖고올 수 있습니다.
   for문으로 돌면서 하나씩 값을 꺼낼 수 있습니다.

<%
// 1. 쿠키 정보 갖고오기
Cookie[] cookies = request.getCookies();
// 2. 쿠키 값 가져오기
if (cookies != null) {
	for(Cookie c : cookies) {
		String cookieName = c.getName();
		String cookieVal = c.getValue();
        // + 원하는 쿠키 정보만 갖고오기 위해서 if 문으로 체크 할 수 있습니다.
        if (cookieName.equals("원하는 쿠키 이름") {
        	out.print(String.format("%s : %s + %s<br>", cookieNamem cookieVal)
        }
	}
}
%>

쿠키 삭제

특정 조건일 때 쿠키를 삭제할 경우는, 쿠키 생성 시와 동일한 로직을 이용합니다. 다만, setValue("")로 값을 지워주고, setMaxAge(0)으로 해당 쿠키가 저장됨과 동시에 없어지도록 할 수 있습니다.

<%
// 1. 쿠키 생성 (단, 삭제이므로 값을 ""으로 지워줌
Cookie cookie = new Cookie("myCookie", "");
// 2. 도메인 설정 : 현재 localhost에서만 사용할 꺼라 일단 생략
// 3. 경로설정
cookie.setPath(request.getContextPath());  
// 컨텍스트 패스에 값을 안주면 루트가 됨 = "/"
// 4. 수명설정 (단, 삭제이므로 0으로 설정하여 저장과 동시에 사라지게 함)
cookie.setMaxAge(0);
// 5. 쿠키 응답헤더에 추가하기
response.addCookie(cookie);
%>

클라이언트가 직접 본인 쿠키 삭제하기

• 브라우저 마다 설정 창에서 전체 쿠키 삭제

1. 크롬 쿠키 삭제
2. 엣지 쿠키 삭제

• 개발자 도구(F12) 이용해서 원하는 쿠키 직접 삭제
  개발자도구(F12) > Application 탭 > Storage > Cookies > 해당하는 도메인 > 원하는 쿠키 우 클릭 후 삭제
  

쿠키 조작법(응용) : 쿠키 매니저

쿠키 매니저는, 위 쿠키 기본 조작법을 클래스로 구현해놓고 해당 클래스를 이용해서 간편하게 사용하는 방식 입니다.

• CookieManger 클래스 작성

package chap04;

import jakarta.servlet.http.*;
// response, request 사용을 위해 import함.

public class CookieUtil {
	
    // 쿠키 만드는 메서드
	public static void setCookie(HttpServletResponse resp, String name, String value, int expire_date, String path) {
		Cookie cookie = new Cookie(name, value);
		cookie.setPath(path);
		cookie.setMaxAge(expire_date); 
		resp.addCookie(cookie);
	}
	
    // 쿠키 갖고오는 메서드 (쿠키 이름으로 갖고오게끔 작성)
	public static String getCookieValue(HttpServletRequest req, String name) {
		String value = "";
		Cookie[] cookies = req.getCookies();
		for(Cookie c : cookies) {
			String cookieName = c.getName();
			String cookieVal = c.getValue();
			if (name.equals(cookieName)) {
				value = cookieVal;
				break;
			}
		}
		return value;
	}
	
    // 저장된 쿠키 삭제하는 메서드
	public static void setDeleteCookie(HttpServletResponse resp, String name, String path) {
		 setCookie(resp, name, "",0, path);
	 }
	// 모든 메서드를 static으로 선언하여 객체 생성없이 바로 사용할 수 있도록 작성함.
}

• 쿠키 매니저 사용 예시

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ page trimDirectiveWhitespaces="true" %>
<%@ page import="chap04.CookieManger"%>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Insert title here</title>
</head>
<body>
<%
// 쿠키 생성에 쿠키 매니저 적용
CookieManger.setCookie(respons, "myCookie", "쿠키값1", 3600)
%>
</body>
</html>

쿠키 관련 실습 코드

[TIL]240307 에서 확인할 수 있습니다.

참고

성낙현의 JSP 자바 웹 프로그래밍 2판 - 성낙현 지음
위 책을 공부하며 작성하고 있습니다!