Spring Mobile 实战指南 | Baeldung中文网

1. 概述

Spring Mobile 是 Spring Web MVC 框架的现代扩展，专门用于简化跨设备兼容的 Web 应用开发。它能以最小化代码和极少的模板化工作，实现全平台或部分平台的兼容性。

本文将深入讲解 Spring Mobile 的核心功能，并通过实战项目演示其具体应用场景。

2. Spring Mobile 核心特性

✅ 自动设备检测
内置服务端设备解析抽象层，自动分析所有传入请求并识别设备信息（如设备类型、操作系统等）。

✅ 站点偏好管理
允许用户选择移动端/平板/普通视图。虽然现在更推荐使用 DeviceDelegatingViewresolver 实现设备感知视图（无需用户干预），但此功能仍保留。

✅ 站点切换器
根据设备类型（移动端/桌面端等）自动将用户重定向到最合适的视图。

✅ 设备感知视图管理器
开发者只需按预定义格式组织视图文件，Spring Mobile 会根据设备类型自动管理不同视图的渲染。

3. 构建实战应用

下面我们用 Spring Boot + Freemarker 模板引擎构建一个设备检测的 Demo 应用，用最少的代码实现设备识别功能。

3.1 Maven 依赖

在 pom.xml 中添加 Spring Mobile 依赖：

<dependency>
    <groupId>org.springframework.mobile</groupId>
    <artifactId>spring-mobile-device</artifactId>
    <version>1.1.5.RELEASE</version>
</dependency>

3.2 创建 Freemarker 模板

首先创建三个不同设备类型的模板文件（别忘记添加 Freemarker 的 Spring Boot 依赖）：

在 src/main/resources/templates 下创建以下目录结构：

└── src
    └── main
        └── resources
            └── templates
                └── index.ftl          # 默认视图
                └── mobile
                    └── index.ftl      # 移动端视图
                └── tablet
                    └── index.ftl      # 平板视图

在三个 index.ftl 中分别添加基础 HTML：

<h1>You are into browser version</h1>

根据设备类型修改 <h1> 内容即可

3.3 启用 DeviceDelegatingViewresolver

在 application.properties 中添加配置：

spring.mobile.devicedelegatingviewresolver.enabled: true

3.4 配置 Freemarker 属性

添加以下配置确保模板能被正确加载：

spring.freemarker.template-loader-path: classpath:/templates
spring.freemarker.suffix: .ftl

3.5 创建控制器

编写控制器处理请求并注入设备信息：

@Controller
public class IndexController {

    @GetMapping("/")
    public String greeting(Device device) {
        
        String deviceType = "browser";
        String platform = "browser";
        String viewName = "index";
        
        if (device.isNormal()) {
            deviceType = "browser";
        } else if (device.isMobile()) {
            deviceType = "mobile";
            viewName = "mobile/index";
        } else if (device.isTablet()) {
            deviceType = "tablet";
            viewName = "tablet/index";
        }
        
        platform = device.getDevicePlatform().name();
        
        if (platform.equalsIgnoreCase("UNKNOWN")) {
            platform = "browser";
        }
         
        return viewName;
    }
}

⚠️ 关键点说明：

Device 参数由 DeviceDelegatingViewresolver 自动注入
通过 isMobile()/isTablet() 等方法获取设备信息
根据设备类型动态返回视图路径

3.6 Java 配置

添加设备检测的必要配置：

@Configuration
public class AppConfig implements WebMvcConfigurer {

    @Bean
    public DeviceResolverHandlerInterceptor deviceResolverHandlerInterceptor() { 
        return new DeviceResolverHandlerInterceptor(); 
    }

    @Bean
    public DeviceHandlerMethodArgumentResolver deviceHandlerMethodArgumentResolver() { 
        return new DeviceHandlerMethodArgumentResolver(); 
    }

    @Override
    public void addInterceptors(InterceptorRegistry registry) { 
        registry.addInterceptor(deviceResolverHandlerInterceptor()); 
    }

    @Override
    public void addArgumentResolvers(List<HandlerMethodArgumentResolver> argumentResolvers) {
        argumentResolvers.add(deviceHandlerMethodArgumentResolver()); 
    }
}

最后添加启动类：

@SpringBootApplication
public class Application {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

4. 应用测试

启动应用后访问 http://localhost:8080。

使用 Chrome 开发者工具模拟不同设备（按 F12 或 Ctrl+Shift+I）：

默认桌面视图：
切换移动设备视图：
- 点击开发者工具左上角第二个图标
- 选择 Nexus 6P 并刷新页面
- DeviceDelegatingViewresolver 自动检测并加载 /mobile/index.ftl
切换平板视图：
- 选择 iPad 并刷新
- 自动加载 /tablet/index.ftl

站点偏好测试

通过 URL 参数强制切换视图：

移动视图：?site_preference=mobile
平板视图：?site_preference=tablet

注意：默认 URL 访问仍会根据设备类型自动跳转

5. 总结

我们成功构建了跨平台兼容的 Web 应用，Spring Mobile 的优势在于：

✅ 大幅提升开发效率
减少大量前端跨设备适配脚本

✅ 简化设备检测逻辑
通过注解和配置即可实现复杂功能

✅ 灵活的视图管理
无需修改业务代码即可支持多设备视图

对于需要快速实现多端适配的项目，Spring Mobile 是个简单粗暴的解决方案，能显著降低开发成本。不过要注意，随着响应式设计的普及，这种服务端适配方案更适合需要精细控制的场景。

Persistence

REST

Security