UA 工具类 - UserAgentUtil

简介

UserAgentUtil 是 Hutool 提供的一个工具类，用于解析用户代理字符串（User-Agent）。通过解析 UA，可以获取用户所使用的浏览器、操作系统、浏览器引擎等信息，还可以判断是否为移动端设备。该工具非常适合在 Web 应用中进行设备和浏览器兼容性处理。

1. 解析用户代理字符串 - UserAgentUtil.parse

UserAgentUtil.parse 方法用于解析用户代理字符串，并返回一个 UserAgent 对象。通过 UserAgent 对象，可以进一步获取浏览器、操作系统、平台等详细信息。

示例：解析用户代理字符串

import cn.hutool.http.useragent.UserAgent;
import cn.hutool.http.useragent.UserAgentUtil;

public class UserAgentExample {
    public static void main(String[] args) {
        // 模拟的用户代理字符串
        String uaStr = "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/535.1 (KHTML, like Gecko) Chrome/14.0.835.163 Safari/535.1";

        // 解析用户代理字符串
        UserAgent ua = UserAgentUtil.parse(uaStr);

        // 获取浏览器名称
        System.out.println("浏览器: " + ua.getBrowser()); // 输出: 浏览器: Chrome

        // 获取浏览器版本
        System.out.println("浏览器版本: " + ua.getVersion()); // 输出: 浏览器版本: 14.0.835.163

        // 获取浏览器引擎
        System.out.println("浏览器引擎: " + ua.getEngine()); // 输出: 浏览器引擎: Webkit

        // 获取浏览器引擎版本
        System.out.println("浏览器引擎版本: " + ua.getEngineVersion()); // 输出: 浏览器引擎版本: 535.1

        // 获取操作系统
        System.out.println("操作系统: " + ua.getOs()); // 输出: 操作系统: Windows 7

        // 获取平台类型
        System.out.println("平台: " + ua.getPlatform()); // 输出: 平台: Windows
    }
}

• parse(String userAgentString)：解析用户代理字符串，返回 UserAgent 对象。
  • userAgentString：用户代理字符串。
  • 返回值：返回 UserAgent 对象，用于进一步获取解析信息。

作用： 用于解析用户代理字符串，提取用户设备和浏览器相关信息。

实际开发场景： 在处理用户设备适配、浏览器兼容性问题时，可以通过解析用户代理字符串来获取用户的具体设备和浏览器信息，从而进行适配和优化。

2. 判断是否为移动端设备 - isMobile

isMobile 方法用于判断当前解析的用户代理是否为移动端设备。该方法可以帮助开发者区分用户是否在使用移动设备访问页面，从而做出不同的响应策略。

示例：判断是否为移动端设备

import cn.hutool.http.useragent.UserAgent;
import cn.hutool.http.useragent.UserAgentUtil;

public class UserAgentExample {
    public static void main(String[] args) {
        // 模拟的用户代理字符串
        String uaStr = "Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_1 like Mac OS X) AppleWebKit/603.1.30 (KHTML, like Gecko) Version/10.0 Mobile/14E304 Safari/602.1";

        // 解析用户代理字符串
        UserAgent ua = UserAgentUtil.parse(uaStr);

        // 判断是否为移动端设备
        boolean isMobile = ua.isMobile();
        System.out.println("是否为移动端: " + isMobile); // 输出: 是否为移动端: true
    }
}

• isMobile()：判断用户代理是否为移动端设备。
  • 返回值：返回布尔值，true 表示为移动端设备，false 表示非移动端设备。

作用： 用于区分用户是否在使用移动设备访问页面，从而采取不同的页面布局和交互方式。

实际开发场景： 在响应式布局、移动优先设计中，可以通过判断用户是否为移动设备来决定显示不同的页面布局或进行重定向。

3. 获取浏览器信息 - getBrowser 和 getVersion

通过 UserAgent 对象，可以获取用户使用的浏览器名称和版本信息。这对于判断用户浏览器是否支持某些功能非常重要。

示例：获取浏览器名称和版本

import cn.hutool.http.useragent.UserAgent;
import cn.hutool.http.useragent.UserAgentUtil;

public class UserAgentExample {
    public static void main(String[] args) {
        // 模拟的用户代理字符串
        String uaStr = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36";

        // 解析用户代理字符串
        UserAgent ua = UserAgentUtil.parse(uaStr);

        // 获取浏览器名称
        System.out.println("浏览器: " + ua.getBrowser()); // 输出: 浏览器: Chrome

        // 获取浏览器版本
        System.out.println("浏览器版本: " + ua.getVersion()); // 输出: 浏览器版本: 91.0.4472.124
    }
}

• getBrowser()：获取用户使用的浏览器名称。

  • 返回值：返回 Browser 枚举类型，表示浏览器名称。

• getVersion()：获取用户浏览器的版本信息。

  • 返回值：返回字符串形式的浏览器版本号。

作用： 用于获取用户浏览器的基本信息，从而判断是否需要进行功能兼容处理。

实际开发场景： 在特定浏览器版本下进行功能适配时，可以根据浏览器名称和版本决定是否启用特定功能或提示用户更新浏览器。