WebApp 쿠키 유틸리티 클래스 CookieBox 만들기

황제낙엽 2007.08.27 11:38 조회 수 : 2045 추천:148

쿠키 유틸리티 클래스 CookieBox 만들기
쿠키는 웹 어플리케이션에서 클라이언트의 정보를 임시로 저장하기 위해 많이 사용된다.
또한, 클라이언트의 상태를 유지할 때 사용되는 세션을 구현하기 위해 쿠키를 사용하기도 한다.
쿠키는 약방의 감초와 같은 존재로서, 쿠키를 사용함으로써 좀더 쉽고 간결한 방법으로 웹 어플리케이션을 구현할 수 있게 되는 경우가 많다.

쿠키가 사용되는 부분은 많은데, 서블릿 API의 쿠키 지원 클래스는 2.4 버전이 나올 때 까지 여전히 빈약하다.
서블릿 API의 javax.servlet.http.HttpServletRequest 인터페이스가 제공하는 쿠키 관련 메소드는 아래에 표시한 한개뿐이다.

   public Cookie[] getCookies()


HttpServletRequest 인터페이스가 쿠키 관련된 메소드를 빈약하게 제공하기 때문에(진짜 심하게 빈약함이 느껴진다!!), JSP나 서블릿 등에서 쿠키를 사용할 때에는 쿠키를 다루기 위한 보조 클래스를 작성해서 작업하는 것이 좋다.
본 글에서는 편리하게 쿠키를 처리할 수 있도록 해 주는 CookieBox 라는 클래스를 작성해볼 것이다.

CookieBox 클래스의 소스 코드

말보다는 소스 코드를 직접 보면서 설명하는 것이 이해가 빠를 것 같으므로, CookieBox 클래스의 소스 코드부터 살펴보도록 하자.

·미리보기 | 소스복사·
 
  1. package jsp.util;   
  2.   
  3. import javax.servlet.http.HttpServletRequest;   
  4. import javax.servlet.http.Cookie;   
  5. import java.util.Map;   
  6. import java.net.URLEncoder;    
  7. import java.net.URLDecoder;    
  8. import java.io.IOException;    
  9.   
  10. public class CookieBox {   
  11.        
  12.     private Map cookieMap = new java.util.HashMap();   
  13.        
  14.     public CookieBox(HttpServletRequest request) {   
  15.         Cookie[] cookies = request.getCookies();   
  16.         if (cookies != null) {   
  17.             for (int i = 0 ; i < cookies.length ; i++) {   
  18.                 cookieMap.put(cookies[i].getName(), cookies[i]);   
  19.             }   
  20.         }   
  21.     }   
  22.        
  23.     public static Cookie createCookie(String name, String value)   
  24.     throws IOException {   
  25.         return new Cookie(name, URLEncoder.encode(value, "euc-kr"));   
  26.     }   
  27.   
  28.     public static Cookie createCookie(   
  29.             String name, String value, String path, int maxAge)    
  30.     throws IOException {   
  31.         Cookie cookie = new Cookie(name,    
  32.                                 URLEncoder.encode(value, "euc-kr"));   
  33.         cookie.setPath(path);   
  34.         cookie.setMaxAge(maxAge);   
  35.         return cookie;   
  36.     }   
  37.        
  38.     public static Cookie createCookie(   
  39.             String name, String value,     
  40.             String domain, String path, int maxAge)    
  41.     throws IOException {   
  42.         Cookie cookie = new Cookie(name,    
  43.                   URLEncoder.encode(value, "euc-kr"));   
  44.         cookie.setDomain(domain);   
  45.         cookie.setPath(path);   
  46.         cookie.setMaxAge(maxAge);   
  47.         return cookie;   
  48.     }   
  49.        
  50.     public Cookie getCookie(String name) {   
  51.         return (Cookie)cookieMap.get(name);    
  52.     }   
  53.        
  54.     public String getValue(String name) throws IOException {   
  55.         Cookie cookie = (Cookie)cookieMap.get(name);   
  56.         if (cookie == null) return null;   
  57.         return URLDecoder.decode(cookie.getValue(), "euc-kr");   
  58.     }   
  59.        
  60.     public boolean exists(String name) {   
  61.         return cookieMap.get(name) != null;   
  62.     }   
  63. }  


CookieBox 클래스는 다음과 같이 두 가지 종류의 메소드를 제공한다.

Cookie 객체를 생성할 때 사용할 수 있는 static 메소드인 createCookie()
HttpServletRequest의 Cookie 객체 및 쿠키값을 읽어올 수 있는 메소드
CookieBox 클래스를 이용한 쿠키값 읽기

먼저, CookieBox 클래스를 사용하면 손쉽게 쿠키를 사용할 수 있다. CookieBox는 다음과 같은 형태로 사용할 수 있다.

   
    // CookieBox 클래스의 생성자는 request로부터 쿠키 정보를 추출
    CookieBox cookieBox = new CookieBox(request);
   
    Cookie idCookie = cookieBox.getCookie("id"); // 쿠키가 존재하지 않으면 null 리턴
   
    // 지정한 이름의 쿠키가 존재하는지의 여부
    if (cookieBox.exists("name")) {
        ...
    }
   
    // 지정한 이름의 쿠키가 존재하지 않으면 값으로 null 리턴
    String value = cookieBox.getValue("ROLE");


일단 CookieBox 객체를 생성한 이후에는 세 개의 메소드(getCookie(), exists(), getValue())를 사용해서 손쉽게 Cookie 객체 및 쿠키값을 사용할 수 있게 된다.
별도의 유틸리티 클래스를 사용하지 않고 쿠키를 사용할 때는 다음과 같은 방식을 사용하게 되는데, 아래 코드와 비교하면 얼마나 위 코드가 간단한 형태인지를 알 수 있을 것이다.

    Cookie[] cookies = request.getCookies();
    Cookie idCookie = null;
   
    if (cookies != null) {
        for (int i = 0 ; i < cookies.length ; i++) {
            if (cookies[i].getName().compareTo("id") == 0) {
                idCookie = cookies[i];
            }
        }
    }
   

CookieBox 클래스를 이용한 Cookie 생성

javax.servlet.http.Cookie 클래스가 제공하는 생성자는 다음과 같이 한개 뿐이기 때문에,

    Cookie(java.lang.String name, java.lang.String value)


쿠키에 대한 도메인, 경로, 유효시간 등을 설정하기 위해서는 다음과 같은 코드를 사용해야 한다.

    Cookie cookie = new Cookie(name, URLEncoder.encode(value, "euc-kr"));
    cookie.setDomain(domain);
    cookie.setPath(path);
    cookie.setMaxAge(maxAge);


CookieBox 클래스는 static 메소드인 createCookie() 메소드를 통해서 적은 코딩량으로 손쉽게 Cookie 객체를 생성할 수 있도록 지원한다.
예를 들어, CookieBox.createCookie() 메소드를 사용하면 위 코드를 다음과 같이 한줄로 변경할 수 있다.

    Cookie cookie = CookieBox.createCookie(name, value, domain, path, maxAge);


CookieBox.createCookie() 메소드가 세 가지 형태로 존재하기 때문에, 그때 그때 알맞은 메소드를 사용해서 Cookie 객체를 생성할 수 있을 것이다.

번호 제목 글쓴이 날짜 조회 수
347 java.util.Optional 에서의 map() 함수의 이해 황제낙엽 2026.06.24 666
346 linux(ubuntu) 의 jdk 21 이 설정된 환경에서 jdk 17 로 다운그레이드 절차 황제낙엽 2025.09.22 1532
345 [ChatGPT] javax.* 패키지와 jakarta.* 패키지의 혼합 사용 방안 황제낙엽 2025.04.15 2459
344 [ChatGPT] *.servlet.http.HttpServlet 클래스를 사용할 수 있는 주요 WAS 목록 황제낙엽 2025.04.14 2038
343 [ChatGPT] JDBC API에서 java.sql과 javax.sql 패키지의 차이점 황제낙엽 2025.01.31 2218
342 jakarta.servlet 패키지를 이용한 File Upload 구현 (2024.03.03, Servlet 5.0) 황제낙엽 2025.01.02 2310
341 [ChatGPT] Java EE가 Jakarta EE로 전환 황제낙엽 2025.01.01 2525
340 [ChatGPT] File.delete() 함수로 파일 삭제가 되지 않는 경우 황제낙엽 2024.12.10 2809
339 [ChatGPT] <jsp:include>에서 flush="true"를 설정시의 몇 가지 문제점 과 대안 황제낙엽 2024.07.19 2493
338 [Copilot] JSP, Servlet, web.xml, mysql 한글 설정 황제낙엽 2024.07.12 2555
337 Base64 클래스의 encode, decode 에서 URL-safe 황제낙엽 2024.07.10 2624
336 [Copilot] JSP 에서 다른 페이지를 현재 페이지에 포함시키는 문법 (include) 황제낙엽 2024.06.26 2570
335 Exception 출력에 대한 고찰 황제낙엽 2024.06.10 2198
334 google-auth-library-oauth2-http 라이브러리 다운로드 황제낙엽 2023.11.19 4025
333 firebase-admin-java 라이브러리 다운로드 (firebase admin sdk library) 황제낙엽 2023.11.19 2805
332 Enum 활용 (개인블로그, Effective Java) file 황제낙엽 2023.11.02 2759
331 Enum 활용 (우아한기술블로그) file 황제낙엽 2023.11.02 2790
330 servlet name 에 camel case 를 사용해서는 안되는 이유 황제낙엽 2023.10.24 2508
329 org.apache.commons.fileupload.servlet.ServletFileUpload 이용 예시 황제낙엽 2023.08.25 3336
328 ServletFileUpload.parseRequest() 실행 결과 리스트가 비어있는 오류 황제낙엽 2023.08.25 2935