使用 **Filter** 攔截請求,**ServletContext** 存儲計數器 (應用級共享),**本地檔案** 持久化 (重啟不歸零)。Filter 生命週期:init() 讀取檔案 → doFilter() 計數 → destroy() 寫回檔案。
package com.example.filter;
import jakarta.servlet.*;
import jakarta.servlet.http.*;
import java.io.*;
import java.nio.file.*;
@WebFilter("/*") // 攔截所有請求
public class VisitCounterFilter implements Filter {
private static final String COUNTER_FILE = "visit_counter.dat";
private static final String COUNT_ATTR = "visitCount";
private ServletContext context;
private Path counterPath;
@Override
public void init(FilterConfig config) throws ServletException {
context = config.getServletContext();
// 檔案存放在 webapp 目錄下 (或指定絕對路徑)
counterPath = Paths.get(context.getRealPath("/"), COUNTER_FILE).toAbsolutePath();
// 初始化:讀取檔案或建立新檔
long count = 0;
try {
if (Files.exists(counterPath)) {
String content = Files.readString(counterPath).trim();
count = Long.parseLong(content);
}
} catch (Exception e) {
// 檔案損毀/不存在,從 0 開始
count = 0;
}
context.setAttribute(COUNT_ATTR, count);
System.out.println("[Counter] 初始化完成,當前計數: " + count);
}
@Override
public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain)
throws IOException, ServletException {
HttpServletRequest request = (HttpServletRequest) req;
String uri = request.getRequestURI();
// 僅統計特定頁面 (如首頁、登入頁),排除靜態資源、AJAX、API
if (shouldCount(uri)) {
// 從 ServletContext 取得並遞增 (需同步)
synchronized (context) {
Long count = (Long) context.getAttribute(COUNT_ATTR);
if (count == null) count = 0L;
count++;
context.setAttribute(COUNT_ATTR, count);
// 可選:即時寫入檔案 (效能較差) 或定期寫入
// writeToFile(count);
}
}
chain.doFilter(req, res);
}
private boolean shouldCount(String uri) {
// 排除靜態資源
if (uri.matches(".*\\.(css|js|png|jpg|gif|ico|woff2?|map)$")) return false;
// 排除 AJAX/API (可根據 Header 判斷)
// 只統計主要頁面
return uri.equals("/") || uri.endsWith("/index.jsp") || uri.endsWith("/login.jsp");
}
@Override
public void destroy() {
// 關閉時寫回檔案
Long count = (Long) context.getAttribute(COUNT_ATTR);
if (count != null) {
try {
Files.writeString(counterPath, count.toString());
System.out.println("[Counter] 銷毀持久化,計數: " + count);
} catch (IOException e) {
System.err.println("[Counter] 持久化失敗: " + e.getMessage());
}
}
}
}
<%@ page contentType="text/html;charset=UTF-8" %>
<!DOCTYPE html>
<html>
<head><title>訪客計數器</title></head>
<body>
<h1>歡迎光臨!</h1>
<p>您是第 <strong><%= application.getAttribute("visitCount") %></strong> 位訪客</p>
<!-- 或使用 EL -->
<p>總訪問次數: ${applicationScope.visitCount} 次</p>
</body></html>
// 使用 ScheduledExecutorService 定期寫入
private ScheduledExecutorService scheduler = Executors.newSingleThreadScheduledExecutor();
@Override
public void init(FilterConfig config) {
// ... 讀取檔案 ...
// 每 30 秒寫入一次
scheduler.scheduleAtFixedRate(this::persistCount, 30, 30, TimeUnit.SECONDS);
}
private void persistCount() {
Long count = (Long) context.getAttribute(COUNT_ATTR);
if (count != null) {
try { Files.writeString(counterPath, count.toString()); }
catch (IOException ignored) {}
}
}
@Override
public void destroy() {
scheduler.shutdown();
persistCount(); // 最後一次寫入
}
// Spring Data Redis
@Autowired StringRedisTemplate redisTemplate;
public void increment() {
// 原子遞增,天然分散式安全
Long count = redisTemplate.opsForValue().increment("site:visit:count");
// 同步到 ServletContext 供 JSP 讀取
context.setAttribute(COUNT_ATTR, count);
}
private boolean isBot(HttpServletRequest req) {
String ua = req.getHeader("User-Agent");
if (ua == null) return true;
String lower = ua.toLowerCase();
return lower.contains("bot") || lower.contains("spider") || lower.contains("crawler")
|| lower.contains("slurp") || lower.contains("googlebot") || lower.contains("bingbot");
}
@Override
public void doFilter(...) {
if (isBot(request)) { chain.doFilter(req, res); return; }
// 正常計數邏輯
}
private boolean isNewVisitor(HttpServletRequest req, HttpServletResponse resp) {
Cookie[] cookies = req.getCookies();
if (cookies != null) {
for (Cookie c : cookies) {
if ("visitor_id".equals(c.getName())) return false; // 舊訪客
}
}
// 新訪客:發放 Cookie (1年有效期)
Cookie c = new Cookie("visitor_id", UUID.randomUUID().toString());
c.setMaxAge(365 * 24 * 3600);
c.setPath("/");
resp.addCookie(c);
return true;
}
<filter>
<filter-name>visitCounter</filter-name>
<filter-class>com.example.filter.VisitCounterFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>visitCounter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
@Bean
public FilterRegistrationBean counterFilter() {
FilterRegistrationBean bean = new FilterRegistrationBean<>();
bean.setFilter(new VisitCounterFilter());
bean.addUrlPatterns("/*");
bean.setOrder(1); // 高優先級
return bean;
}
Filter + ServletContext + 本地檔案 實現簡單、零依賴的網頁計數器。生產環境建議:**非同步批次寫入** 減少 I/O、**Redis 原子計數** 支援叢集、**機器人過濾** 提升準確度、**Cookie 識別 UV** 區分 PV/UV。本方案適合中小型單體應用,大型系統建議接入專業分析平台 (Google Analytics、Matomo、自建 ClickHouse)。