Web 系統常需「同一帳號同時只能一處登入」與「即時統計在線人數」。本文採用 HttpSessionBindingListener 監聽器模式,利用 Session 生命週期自動管理在線用戶集合,無需資料庫輪詢,效能極佳。
HttpSessionBindingListener,作為 Session 屬性值綁定Map<String, HttpSession> onlineUsers 記錄「帳號 → Session」映射valueBound (登入/Session 建立) 加入集合;valueUnbound (登出/Session 逾時/失效) 移除集合package cn.wst.common.online;
import javax.servlet.http.HttpSessionBindingEvent;
import javax.servlet.http.HttpSessionBindingListener;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;
public class OnLineUser implements HttpSessionBindingListener {
private static final Map<String, HttpSession> onlineUsers = new ConcurrentHashMap<>();
private String username; // 綁定的帳號
public OnLineUser() {}
public OnLineUser(String username) { this.username = username; }
// 檢查帳號是否已在線
public static boolean isOnline(String username) {
return onlineUsers.containsKey(username);
}
// 獲取在線人數
public static int getOnlineCount() {
return onlineUsers.size();
}
// 獲取所有在線用戶名
public static java.util.Set<String> getOnlineUsers() {
return onlineUsers.keySet();
}
// 強制踢出用戶 (管理員功能)
public static void kickOut(String username) {
HttpSession session = onlineUsers.remove(username);
if (session != null) {
try { session.invalidate(); } catch (Exception ignore) {}
}
}
// --- HttpSessionBindingListener 介面方法 ---
@Override
public void valueBound(HttpSessionBindingEvent event) {
// 綁定到 Session 時觸發 (登入成功後 setAttribute)
if (username != null) {
// 若帳號已在線,踢掉舊 Session
HttpSession old = onlineUsers.put(username, event.getSession());
if (old != null && old != event.getSession()) {
try { old.invalidate(); } catch (Exception ignore) {}
}
}
}
@Override
public void valueUnbound(HttpSessionBindingEvent event) {
// 從 Session 移除/失效/逾時時觸發
if (username != null) {
onlineUsers.remove(username, event.getSession()); // 安全移除
}
}
}
<%
// 驗證帳號密碼...
String username = request.getParameter("username");
// boolean valid = validate(username, password);
if (valid) {
// 檢查是否已在線
if (OnLineUser.isOnline(username)) {
out.println("該帳號已在其他地方登入!");
return;
}
// 建立 Session 並綁定 OnLineUser (觸發 valueBound)
session.setMaxInactiveInterval(30 * 60); // 30 分鐘逾時
session.setAttribute("currentUser", new OnLineUser(username));
// 也可存入用戶完整資訊
session.setAttribute("userInfo", userVO);
response.sendRedirect("main.jsp");
} else {
out.println("帳號或密碼錯誤");
}
%>
<%@ page import="cn.wst.common.online.OnLineUser" %>
目前在線人數:<%= OnLineUser.getOnlineCount() %>
<ul>
<% for (String u : OnLineUser.getOnlineUsers()) { %>
<li><%= u %></li>
<% } %>
</ul>
<%
session.invalidate(); // 觸發 valueUnbound 自動從在線集合移除
response.sendRedirect("login.jsp");
%>
| 優點 | 缺點/注意 |
|---|---|
| 無需資料庫,記憶體操作極快 | 叢集環境需 Session 複製或集中式 Session (Redis/JDBC Store) |
| 自動處理 Session 逾時/瀏覽器關閉 (valueUnbound) | 伺服器重啟會丟失在線狀態 (可持久化定期同步) |
| 天然支援「踢出舊登入」邏輯 | 大量用戶時 ConcurrentHashMap 記憶體佔用需監控 |
| 程式碼簡潔,零輪詢 | 需確保 OnLineUser 類在共享 Classloader (放 WEB-INF/classes 或共享 lib) |
<Manager className="org.apache.catalina.ha.session.DeltaManager"/> (DeltaManager/BackupManager)@EnableRedisHttpSession 自動共享 SessiononlineUsers 改為 Redis Hash 或 Set,配合 expire 實現分散式在線統計