SpringBoot?UserAgentUtils獲取用戶瀏覽器的用法

更新時間：2025年04月27日 11:00:16 作者：生產隊的驢.

UserAgentUtils是于處理用戶代理（User-Agent）字符串的工具類,一般用于解析和處理瀏覽器、操作系統(tǒng)以及設備等相關信息,這些信息通常包含在接口請求的?User-Agent?字符串中,本文介紹SpringBoot?UserAgentUtils獲取用戶瀏覽器的用法,感興趣的朋友一起看看吧

介紹

UserAgentUtils 是于處理用戶代理（User-Agent）字符串的工具類，一般用于解析和處理瀏覽器、操作系統(tǒng)以及設備等相關信息，這些信息通常包含在接口請求的 User-Agent 字符串中。

這個庫可以用于解析用戶代理頭，以提取有關所使用的瀏覽器、瀏覽器版本、平臺、平臺版本和設備類型的信息。對于確定客戶端是否是臺式機、平板電腦或移動設備，或者客戶端是否在Windows或Mac OS上（僅舉幾例）非常有用。

超過150種不同的瀏覽器；
7種不同的瀏覽器類型；
超過60種不同的操作系統(tǒng)；
6種不同的設備類型；
9種不同的渲染引擎；
9種不同的Web應用，如HttpClient、Bot。

官方文檔：https://www.bitwalker.eu/software/user-agent-utils
Github：https://github.com/HaraldWalker/user-agent-utils/tree/release-1.21

特別注意該項目已停止了維護，但是功能還是挺好用的

效果圖

依賴

<!--解析瀏覽器字符串-->
<dependency>
    <groupId>eu.bitwalker</groupId>
    <artifactId>UserAgentUtils</artifactId>
    <version>1.21</version>
</dependency>
<!--字符串工具-->
<dependency>
	<groupId>org.apache.commons</groupId>
    <artifactId>commons-lang3</artifactId>
    <version>3.12.0</version> 
</dependency>
<!--提供了大量的工具類，更方便地進行字符串、日期、集合、反射等操作。-->

封裝客戶端工具

public class ClientUtils {
    /**
     * 獲取當前線程的請求
     */
    public static ServletRequestAttributes getRequestAttributes()
    {
        //獲取當前線程的請求
        RequestAttributes attributes = RequestContextHolder.getRequestAttributes();
        //提供了更具體的 Servlet 請求屬性
        return (ServletRequestAttributes) attributes;
    }
    /**
     * 獲取request信息
     */
    public static HttpServletRequest getRequest()
    {
        return getRequestAttributes().getRequest();
    }
}

封裝IP工具

public class IpUtils {
    /**
     * 獲取客戶端IP
     *
     * @return IP地址
     */
    public static String getIpAddr()
    {
        return getIpAddr(ClientUtils.getRequest());
    }
    /**
     * 獲取客戶端IP
     *
     * @param request 請求對象
     * @return IP地址
     */
    public static String getIpAddr(HttpServletRequest request)
    {
        if (request == null)
        {
            return "unknown";
        }
        String ip = request.getHeader("x-forwarded-for");
        if (ip == null || ip.length() == 0 || "unknown".equalsIgnoreCase(ip))
        {
            ip = request.getHeader("Proxy-Client-IP");
        }
        if (ip == null || ip.length() == 0 || "unknown".equalsIgnoreCase(ip))
        {
            ip = request.getHeader("X-Forwarded-For");
        }
        if (ip == null || ip.length() == 0 || "unknown".equalsIgnoreCase(ip))
        {
            ip = request.getHeader("WL-Proxy-Client-IP");
        }
        if (ip == null || ip.length() == 0 || "unknown".equalsIgnoreCase(ip))
        {
            ip = request.getHeader("X-Real-IP");
        }
        if (ip == null || ip.length() == 0 || "unknown".equalsIgnoreCase(ip))
        {
            ip = request.getRemoteAddr();
        }
        return "0:0:0:0:0:0:0:1".equals(ip) ? "127.0.0.1" : getMultistageReverseProxyIp(ip);
    }
    /**
     * 從多級反向代理中獲得第一個非unknown IP地址
     *
     * @param ip 獲得的IP地址
     * @return 第一個非unknown IP地址
     */
    public static String getMultistageReverseProxyIp(String ip)
    {
        // 多級反向代理檢測
        if (ip != null && ip.indexOf(",") > 0)
        {
            final String[] ips = ip.trim().split(",");
            for (String subIp : ips)
            {
                if (false == isUnknown(subIp))
                {
                    ip = subIp;
                    break;
                }
            }
        }
        return StringUtils.substring(ip, 0, 255);
    }
    /**
     * 檢測給定字符串是否為未知，多用于檢測HTTP請求相關
     *
     * @param checkString 被檢測的字符串
     * @return 是否未知
     */
    public static boolean isUnknown(String checkString)
    {
        return StringUtils.isBlank(checkString) || "unknown".equalsIgnoreCase(checkString);
    }
}

實體類

@Data
@EqualsAndHashCode(callSuper = false)
@Accessors(chain = true)
@TableName("login_log")
public class LoginLog implements Serializable {
    private static final long serialVersionUID = 1L;
    /**
     * 編號
     */
    @TableId(value = "id", type = IdType.AUTO)
    private Integer id;
    /**
     * 用戶名稱
     */
    @TableField("user_name")
    private String userName;
    /**
     * IP
     */
    @TableField("ip")
    private String ip;
    /**
     * 瀏覽器
     */
    @TableField("browser")
    private String browser;
    /**
     * 操作系統(tǒng)
     */
    @TableField("platform")
    private String platform;
    /**
     * 登錄時間
     */
    @TableField("login_time")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private String loginTime;
}

獲取設備信息入庫

    public void recordLogin(LoginLog loginLog){
    	//獲取當前線程中的請求
        String s = ClientUtils.getRequest().getHeader("User-Agent");
		//反向代理中獲取IP
        loginLog.setIp(IpUtils.getIpAddr());
		//異步執(zhí)行
        CompletableFuture.runAsync(() -> {
            // 獲取當前線程請求頭的 "User-Agent"
            UserAgent userAgent = UserAgent.parseUserAgentString(s);
            // 獲取使用的瀏覽器
            loginLog.setBrowser(userAgent.getBrowser().getName());
            // 獲取使用的操作系統(tǒng)
            loginLog.setPlatform(userAgent.getOperatingSystem().getName());
            //數(shù)據(jù)入庫
            mapper.insert(loginLog);
        });
    }

效果圖

到此這篇關于SpringBoot UserAgentUtils獲取用戶瀏覽器操作系統(tǒng)設備統(tǒng)計信息統(tǒng)計日志入庫的文章就介紹到這了,更多相關SpringBoot UserAgentUtils獲取用戶瀏覽器內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！