萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> JSP 程式設計

JSP 網頁計數器實現:Filter + ServletContext + 本地檔案持久化

設計思路

使用 **Filter** 攔截請求,**ServletContext** 存儲計數器 (應用級共享),**本地檔案** 持久化 (重啟不歸零)。Filter 生命週期:init() 讀取檔案 → doFilter() 計數 → destroy() 寫回檔案。

完整 Filter 實作

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());
            }
        }
    }
}

JSP 顯示計數器

<%@ 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>

進階優化方案

1. 非同步批次寫入 (效能優化)

// 使用 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(); // 最後一次寫入
}

2. 分散式環境:Redis 原子計數器

// Spring Data Redis
@Autowired StringRedisTemplate redisTemplate;

public void increment() {
    // 原子遞增,天然分散式安全
    Long count = redisTemplate.opsForValue().increment("site:visit:count");
    // 同步到 ServletContext 供 JSP 讀取
    context.setAttribute(COUNT_ATTR, count);
}

3. 排除機器人/爬蟲流量

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; }
    // 正常計數邏輯
}

4. 獨立訪客統計 (UV) - 基於 Cookie

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;
}

部署配置

web.xml (傳統)

<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>

Spring Boot 自動註冊

@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)。

copyright © 萬盛學電腦網 all rights reserved