리스너 (Listener)

리스너는 이벤트를 감지하고 처리하는 감시자 역할을 하며, 웹 애플리케이션의 생명주기나 상태 변화에 자동으로 반응할 수 있도록 해줍니다.

Listener란?

웹 애플리케이션 내에서 발생하는 특정 이벤트 에 대해 자동으로 실행되는 코드를 포함하는 클래스입니다.

•

이벤트 (예: 세션 생성, 애플리케이션 시작 등)

리스너는 서블릿 컨테이너(Tomcat 등)가 자동으로 호출합니다. 즉, 개발자가 직접 호출하지 않아도 됩니다.

주요 Listener 종류

Listener 인터페이스	감지 대상 (이벤트)	주 사용 목적
ServletContextListener	웹 애플리케이션 시작/종료	초기 설정, 리소스 정리 등
HttpSessionListener	세션 생성/종료	로그인 추적, 세션 수 관리
ServletRequestListener	요청 시작/종료	요청 시간 측정, 로깅 등
HttpSessionAttributeListener	세션 속성 변경	로그인 정보 추적 등
ServletContextAttributeListener	컨텍스트 속성 변경	전역 설정 변경 감시
ServletRequestAttributeListener	요청 속성 변경	디버깅, 로깅 등

1. ServletContextListener

역할:

•

웹 앱 시작/종료 시점에 동작

코드 예시:

@WebListener
public class AppStartListener implements ServletContextListener {
    public void contextInitialized(ServletContextEvent sce) {
        System.out.println("🌐 웹 애플리케이션 시작됨");
    }

    public void contextDestroyed(ServletContextEvent sce) {
        System.out.println("🛑 웹 애플리케이션 종료됨");
    }
}
Java
복사

2. HttpSessionListener

역할:

•

세션 생성/종료 감지 (로그인 상태 등 추적)

코드 예시:

@WebListener
public class SessionTracker implements HttpSessionListener {
    public void sessionCreated(HttpSessionEvent se) {
        System.out.println("🟢 세션 생성됨: " + se.getSession().getId());
    }

    public void sessionDestroyed(HttpSessionEvent se) {
        System.out.println("🔴 세션 종료됨: " + se.getSession().getId());
    }
}
Java
복사

3. ServletRequestListener

역할:

•

HTTP 요청의 시작/종료 감지

코드 예시:

@WebListener
public class RequestLogger implements ServletRequestListener {
    public void requestInitialized(ServletRequestEvent sre) {
        System.out.println("➡️ 요청 시작됨: " + ((HttpServletRequest) sre.getServletRequest()).getRequestURI());
    }

    public void requestDestroyed(ServletRequestEvent sre) {
        System.out.println("⬅️ 요청 종료됨");
    }
}
Java
복사

리스너 등록 방법

어노테이션 사용 (@WebListener) → 최신 방식

web.xml에 등록 → 전통 방식

<!-- web.xml 방식 예시 -->
<listener>
    <listener-class>com.example.MyListener</listener-class>
</listener>
XML
복사

사용 예

시나리오	활용할 리스너
웹 앱 시작 시 DB 연결 풀 생성	ServletContextListener
사용자 로그인 수 카운팅	HttpSessionListener
요청 로그 기록	ServletRequestListener
로그인 사용자 정보 추적	HttpSessionAttributeListener
전역 설정 변경 감시	ServletContextAttributeListener

정리

리스너 종류	감지 시점
ServletContextListener	웹 앱 시작/종료
HttpSessionListener	세션 생성/종료
ServletRequestListener	요청 시작/종료
속성 관련 리스너들	속성 추가/변경/삭제 시점

실시간 접속자 수

세션 리스너로 실시간 접속자 수 구현

세션이 생성되고 종료될 때마다 접속자 수를 카운팅하여 실시간으로 추적할 수 있습니다.

SessionCountListener 구현

@WebListener
public class SessionCountListener implements HttpSessionListener {
    private static int activeSessions = 0;

    public void sessionCreated(HttpSessionEvent se) {
        activeSessions++;
        ServletContext context = se.getSession().getServletContext();
        context.setAttribute("activeSessions", activeSessions);
        System.out.println("🟢 세션 생성 | 현재 접속자 수: " + activeSessions);
    }

    public void sessionDestroyed(HttpSessionEvent se) {
        activeSessions--;
        ServletContext context = se.getSession().getServletContext();
        context.setAttribute("activeSessions", activeSessions);
        System.out.println("🔴 세션 종료 | 현재 접속자 수: " + activeSessions);
    }

    public static int getActiveSessions() {
        return activeSessions;
    }
}
Java
복사

Servlet에서 접속자 수 조회

@WebServlet("/visitor-count")
public class VisitorCountServlet extends HttpServlet {
    protected void doGet(HttpServletRequest request, HttpServletResponse response) 
            throws ServletException, IOException {
        
        // ServletContext에서 접속자 수 가져오기
        int count = (int) getServletContext().getAttribute("activeSessions");
        
        response.setContentType("text/html; charset=UTF-8");
        PrintWriter out = response.getWriter();
        out.println("<h1>현재 접속자 수: " + count + "명</h1>");
    }
}
Java
복사

JSP에서 접속자 수 표시

<%@ page language="java" contentType="text/html; charset=UTF-8" %>
<!DOCTYPE html>
<html>
<head>
    <title>실시간 접속자</title>
</head>
<body>
    <h2>🌐 현재 접속자 수</h2>
    <p>접속 중인 사용자: <strong>${applicationScope.activeSessions}</strong>명</p>
</body>
</html>
XML
복사

동작 원리

•

세션 생성 시: sessionCreated()가 호출되어 activeSessions 증가

•

세션 종료 시: sessionDestroyed()가 호출되어 activeSessions 감소

•

ServletContext에 저장: 전역 범위에서 접속자 수 공유

•

JSP/Servlet에서 조회: ${applicationScope.activeSessions} 또는 getAttribute()로 접근

동시 접속 제한

동시 접속 제한 구현 (최대 3개 세션)

동일한 사용자 ID가 3개 이상의 세션으로 접속하는 것을 방지하는 기능입니다.

SessionLimitListener 구현

@WebListener
public class SessionLimitListener implements HttpSessionListener, HttpSessionAttributeListener {
    // 사용자별 세션 목록 저장 (userId → List<HttpSession>)
    private static Map<String, List<HttpSession>> userSessions = new ConcurrentHashMap<>();
    private static final int MAX_SESSIONS = 3;

    @Override
    public void sessionCreated(HttpSessionEvent se) {
        System.out.println("🟢 세션 생성: " + se.getSession().getId());
    }

    @Override
    public void sessionDestroyed(HttpSessionEvent se) {
        HttpSession session = se.getSession();
        String userId = (String) session.getAttribute("userId");
        
        if (userId != null) {
            List<HttpSession> sessions = userSessions.get(userId);
            if (sessions != null) {
                sessions.remove(session);
                if (sessions.isEmpty()) {
                    userSessions.remove(userId);
                }
                System.out.println("🔴 세션 종료: " + userId + " | 남은 세션: " + sessions.size());
            }
        }
    }

    @Override
    public void attributeAdded(HttpSessionBindingEvent event) {
        if ("userId".equals(event.getName())) {
            String userId = (String) event.getValue();
            HttpSession newSession = event.getSession();
            
            // 해당 사용자의 세션 목록 가져오기
            List<HttpSession> sessions = userSessions.computeIfAbsent(userId, k -> new ArrayList<>());
            
            // 이미 3개 이상이면 가장 오래된 세션 강제 종료
            if (sessions.size() >= MAX_SESSIONS) {
                HttpSession oldestSession = sessions.get(0);
                oldestSession.invalidate();
                System.out.println("⚠️ 최대 접속 초과 | 가장 오래된 세션 종료: " + oldestSession.getId());
            }
            
            // 새 세션 추가
            sessions.add(newSession);
            System.out.println("✅ 사용자 '" + userId + "' 로그인 | 현재 세션 수: " + sessions.size());
        }
    }

    @Override
    public void attributeRemoved(HttpSessionBindingEvent event) {
        // 로그아웃 시 처리
    }

    @Override
    public void attributeReplaced(HttpSessionBindingEvent event) {
        // 속성 변경 시 처리
    }
}
Java
복사

로그인 Servlet에서 userId 설정

@WebServlet("/login")
public class LoginServlet extends HttpServlet {
    protected void doPost(HttpServletRequest request, HttpServletResponse response) 
            throws ServletException, IOException {
        
        String userId = request.getParameter("userId");
        String password = request.getParameter("password");
        
        // 로그인 검증 (간단 예시)
        if (userId != null &amp;&amp; !userId.isEmpty()) {
            // 세션에 userId 저장 → 리스너가 자동으로 감지
            request.getSession().setAttribute("userId", userId);
            
            response.sendRedirect("main.jsp");
        } else {
            response.sendRedirect("login.jsp?error=1");
        }
    }
}
Java
복사

로그인 페이지 (login.jsp)

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>로그인</title>
    <style>
        body {
            font-family: Arial, sans-serif;
            display: flex;
            justify-content: center;
            align-items: center;
            height: 100vh;
            margin: 0;
            background-color: #f0f0f0;
        }
        .login-container {
            background: white;
            padding: 30px;
            border-radius: 8px;
            box-shadow: 0 2px 10px rgba(0,0,0,0.1);
            width: 300px;
        }
        h2 {
            text-align: center;
            color: #333;
        }
        input[type="text"], input[type="password"] {
            width: 100%;
            padding: 10px;
            margin: 10px 0;
            border: 1px solid #ddd;
            border-radius: 4px;
            box-sizing: border-box;
        }
        button {
            width: 100%;
            padding: 10px;
            background-color: #4CAF50;
            color: white;
            border: none;
            border-radius: 4px;
            cursor: pointer;
            font-size: 16px;
        }
        button:hover {
            background-color: #45a049;
        }
        .error {
            color: red;
            text-align: center;
            margin-top: 10px;
        }
    </style>
</head>
<body>
    <div class="login-container">
        <h2>🔐 로그인</h2>
        <form action="login" method="post">
            <input type="text" name="userId" placeholder="아이디" required>
            <input type="password" name="password" placeholder="비밀번호" required>
            <button type="submit">로그인</button>
        </form>
        
        <% if (request.getParameter("error") != null) { %>
            <p class="error">⚠️ 로그인 정보를 확인해주세요.</p>
        <% } %>
        
        <% if (request.getParameter("limit") != null) { %>
            <p class="error">⚠️ 최대 접속 수를 초과하여 가장 오래된 세션이 종료되었습니다.</p>
        <% } %>
    </div>
</body>
</html>
XML
복사

IP 기반 제한 (선택 사항)

PC나 IP 기반으로 제한하려면 userId 대신 IP 주소를 키로 사용할 수 있습니다.

@Override
public void sessionCreated(HttpSessionEvent se) {
    HttpSession session = se.getSession();
    
    // IP 주소 가져오기
    ServletRequest request = ...; // 실제로는 Filter에서 처리 필요
    String ipAddress = request.getRemoteAddr();
    
    session.setAttribute("ipAddress", ipAddress);
}
Java
복사

동작 흐름

로그인 시: userId가 세션에 저장됨 → attributeAdded() 호출

세션 수 확인: 해당 사용자의 세션이 3개 이상이면 가장 오래된 세션 강제 종료

새 세션 추가: 현재 세션을 사용자별 세션 목록에 추가

로그아웃/세션 만료: sessionDestroyed()에서 목록에서 제거

주의사항

•

ConcurrentHashMap 사용: 멀티스레드 환경에서 안전하게 관리

•

가장 오래된 세션 종료: sessions.get(0)이 가장 먼저 추가된 세션

•

IP 기반 제한 시: 동적 IP 환경에서는 제한이 어려울 수 있음

•

PC 식별: 완전한 PC 식별은 어려우므로 IP + User-Agent 조합 사용 권장