萬盛學電腦網

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

JSP 透過 User-Agent 判斷瀏覽器版本:完整工具類與實戰應用

User-Agent 解析挑戰

User-Agent 字串格式混亂、歷史包袱重、偽裝常見。簡單關鍵字匹配只能滿足基本統計或相容性處理,精準識別建議使用專業庫 (UAParser.js、Yauaa)。

輕量級 JSP/JAVA 實作

瀏覽器識別工具類

package com.example.util;

public class BrowserDetector {
    
    // 瀏覽器關鍵字陣列 (優先序:越前面越優先匹配)
    private static final String[][] BROWSER_PATTERNS = {
        // {英文關鍵字, 中文顯示名}
        {"Edg/", "Edge"},
        {"Chrome", "Chrome"},
        {"Firefox", "Firefox"},
        {"Safari", "Safari"},      // Chrome 也含 Safari,故須在 Chrome 之後
        {"MSIE", "IE"},            // IE 10-
        {"Trident/", "IE"},        // IE 11
        {"Opera", "Opera"},
        {"OPR/", "Opera"},         // 新版 Opera (Chromium)
        {"UCBrowser", "UC瀏覽器"},
        {"QQBrowser", "QQ瀏覽器"},
        {"MicroMessenger", "微信內嵌"},
        {"Weibo", "微博內嵌"},
        {"Mobile", "行動裝置瀏覽器"} // 通用 fallback
    };
    
    // IE 版本對應
    private static final String[] IE_VERSIONS = {
        "MSIE 10.0", "IE 10.0",
        "MSIE 9.0", "IE 9.0",
        "MSIE 8.0", "IE 8.0",
        "MSIE 7.0", "IE 7.0",
        "MSIE 6.0", "IE 6.0"
    };

    public static String detect(String userAgent) {
        if (userAgent == null || userAgent.isEmpty()) return "Unknown";
        String ua = userAgent.toLowerCase();
        
        // 1. 精確匹配瀏覽器
        for (String[] pair : BROWSER_PATTERNS) {
            if (ua.contains(pair[0].toLowerCase())) {
                String browser = pair[1];
                
                // 2. IE 版本細分
                if ("IE".equals(browser)) {
                    for (int i = 0; i < IE_VERSIONS.length; i += 2) {
                        if (ua.contains(IE_VERSIONS[i].toLowerCase())) {
                            return IE_VERSIONS[i+1];
                        }
                    }
                    return "IE (未知版本)";
                }
                return browser;
            }
        }
        return "Unknown Browser";
    }
    
    // 判斷作業系統
    public static String detectOS(String userAgent) {
        if (userAgent == null) return "Unknown";
        String ua = userAgent.toLowerCase();
        if (ua.contains("windows nt 10.0")) return "Windows 10/11";
        if (ua.contains("windows nt 6.3")) return "Windows 8.1";
        if (ua.contains("windows nt 6.2")) return "Windows 8";
        if (ua.contains("windows nt 6.1")) return "Windows 7";
        if (ua.contains("windows nt 6.0")) return "Windows Vista";
        if (ua.contains("windows nt 5.1")) return "Windows XP";
        if (ua.contains("mac os x")) return "macOS";
        if (ua.contains("android")) return "Android";
        if (ua.contains("iphone") || ua.contains("ipad") || ua.contains("ipod")) return "iOS";
        if (ua.contains("linux")) return "Linux";
        return "Other";
    }
    
    // 判斷是否行動裝置
    public static boolean isMobile(String userAgent) {
        if (userAgent == null) return false;
        String ua = userAgent.toLowerCase();
        return ua.contains("mobile") || ua.contains("android") || ua.contains("iphone") 
            || ua.contains("ipad") || ua.contains("ipod");
    }
}

JSP 頁面應用範例

<%@ page import="com.example.util.BrowserDetector" %>
<%@ page contentType="text/html;charset=UTF-8" %>
<%
    String ua = request.getHeader("User-Agent");
    String browser = BrowserDetector.detect(ua);
    String os = BrowserDetector.detectOS(ua);
    boolean mobile = BrowserDetector.isMobile(ua);
%>
<!DOCTYPE html>
<html>
<head><title>瀏覽器偵測測試</title></head>
<body>
    <h2>User-Agent 分析結果</h2>
    <p>原始 UA: <%= ua %></p>
    <p>瀏覽器: <%= browser %></p>
    <p>作業系統: <%= os %></p>
    <p>行動裝置: <%= mobile ? "是" : "否" %></p>
    
    <hr>
    <h3>應用場景</h3>
    <ul>
        <li>相容性警告:舊版 IE 提示升級</li>
        <li>行動版導向:<% if (mobile) { %> 導向行動版 <% } %></li>
        <li>統計分析:記錄瀏覽器分佈</li>
        <li>功能降級:不支援功能提供替代方案</li>
    </ul>
</body></html>

Servlet 3.0+ 整合 (自動解析)

// ServletRequest 介面新增 (Servlet 3.1 / Tomcat 8.5+)
String browser = request.getHeader("User-Agent"); // 仍需自行解析
// 標準 API 未內建解析器,需自行實作或引入庫

生產環境建議:引入專業解析庫

Yauaa (Yet Another User Agent Analyzer) - Java 原生

<dependency>
    <groupId>nl.basjes.parse.useragent</groupId>
    <artifactId>yauaa</artifactId>
    <version>7.10.0</version>
</dependency>
UserAgentAnalyzer analyzer = UserAgentAnalyzer.newBuilder().build();
UserAgent agent = analyzer.parse(request.getHeader("User-Agent"));
String browser = agent.getValue(UserAgent.AGENT_NAME);      // "Chrome"
String version = agent.getValue(UserAgent.AGENT_VERSION);   // "120.0.6099.109"
String os = agent.getValue(UserAgent.OPERATING_SYSTEM_NAME); // "Windows 10"
boolean isMobile = agent.getValue(UserAgent.DEVICE_CLASS).equals("Phone");

UAParser.js (前端/Node.js 同構)

<script src="https://cdn.jsdelivr.net/npm/ua-parser-js@1.0.37/dist/ua-parser.min.js"></script>
<script>
    const parser = new UAParser();
    const result = parser.setUA(navigator.userAgent).getResult();
    console.log(result.browser, result.os, result.device);
</script>

常見應用場景與代碼片段

1. IE 相容性警告

<% if (browser.startsWith("IE")) { %>
    <div class="alert alert-warning">
        您使用的是舊版 <%=browser%>,建議升級至 Edge/Chrome/Firefox 以獲得最佳體驗。
    </div>
<% } %>

2. 行動裝置導向

<% if (mobile && !request.getRequestURI().contains("/mobile")) { %>
    <% response.sendRedirect(request.getContextPath() + "/mobile/"); %>
<% } %>

3. 統計日誌記錄

log.info("訪問: IP={}, Browser={}, OS={}, Mobile={}, URL={}", 
    request.getRemoteAddr(), browser, os, mobile, request.getRequestURI());

總結

簡單關鍵字匹配適合輕量級需求 (統計、簡單導向),但**無法應對 UA 偽裝、新瀏覽器、複雜版本號**。生產系統強烈建議整合 **Yauaa** (Java後端) 或 **UAParser.js** (前端),定期更新規則庫。記住:User-Agent 非權威身分證,關鍵安全決策不可單憑 UA 判斷。

copyright © 萬盛學電腦網 all rights reserved