使用Spring Mobile实现网站移动端适配及更换主题

现在的网站,很多都有需要动态更换主题风格的需求,比如每到特殊节日,更换为带有节日气氛的主题。还有用户通过手机端浏览器访问,如果没有做移动端的适配,你的网站基本也是没办法看的。本文介绍了使用Spring Mobile实现网站移动端适配及动态更换网站主题风格。

Spring Mobile简介

Spring Mobile可以检测出当前请求使用的设备是PC、还是手机或者是平板以及用户设备是安卓平台还是iOS平台,然后根据请求设备的不同,返回适合该设备的视图。

引入Spring Mobile

如果你的项目是基于Spring Boot构建的,只需在项目中引入Spring Mobile的starter即可:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-mobile</artifactId>
</dependency>

上代码

本文使用的是Thymeleaf模板引擎,其它模板引擎原理也是一样的。application.properties文件中Thymeleaf模板引擎的配置如下:

# THYMELEAF
spring.thymeleaf.cache=false
spring.thymeleaf.mode=LEGACYHTML5
spring.thymeleaf.check-template=true
spring.thymeleaf.check-template-location=true
spring.thymeleaf.content-type=text/html
spring.thymeleaf.enabled=true
spring.thymeleaf.encoding=UTF-8
spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.suffix=.html

创建controller:

@Controller
public class TestController {
    @GetMapping("/test")
    public String test() {
        return "test";
    }
}

在/resources/templates目录下,新建default目录,用于存放PC端默认主题的视图。新建test.html文件:

<!DOCTYPE html>
<html lang="zh-CN" xmlns="http://www.w3.org/1999/xhtml">
<head>
    <meta charset="utf-8">
    <title>test</title>
</head>
<body>
<h2>这里是【PC端测试页面】</h2>
</body>
</html>

在/resources/templates目录下,新建theme-blue目录,用于存放PC端蓝色主题的视图。新建test.html文件:

<!DOCTYPE html>
<html lang="zh-CN" xmlns="http://www.w3.org/1999/xhtml">
<head>
    <meta charset="utf-8">
    <title>test</title>
</head>
<body>
<h2 style="color: deepskyblue">这里是【PC端测试页面-蓝色主题】</h2>
</body>
</html>

在/resources/templates目录下,新建mobile目录,用于存放移动端默认主题的视图。新建test.html文件:

<!DOCTYPE html>
<html lang="zh-CN" xmlns="http://www.w3.org/1999/xhtml">
<head>
    <meta charset="utf-8">
    <title>test</title>
</head>
<body>
<h2>这里是【移动端测试页面】</h2>
</body>
</html>

在/resources/templates目录下,新建theme-mobile-blue目录,用于存放移动端蓝色主题的视图。新建test.html文件:

<!DOCTYPE html>
<html lang="zh-CN" xmlns="http://www.w3.org/1999/xhtml">
<head>
    <meta charset="utf-8">
    <title>test</title>
</head>
<body>
<h2 style="color: deepskyblue">这里是【移动端测试页面-蓝色主题】</h2>
</body>
</html>

新建主题视图解析类ThemeViewResolver:

import org.apache.commons.lang3.StringUtils;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.mobile.device.Device;
import org.springframework.mobile.device.DeviceUtils;
import org.springframework.mobile.device.util.ResolverUtils;
import org.springframework.mobile.device.view.LiteDeviceDelegatingViewResolver;
import org.springframework.stereotype.Component;
import org.springframework.web.context.request.RequestAttributes;
import org.springframework.web.context.request.RequestContextHolder;
import org.springframework.web.context.request.ServletRequestAttributes;
import org.springframework.web.servlet.View;
import org.springframework.web.servlet.ViewResolver;
import org.thymeleaf.util.ClassLoaderUtils;

import javax.annotation.PostConstruct;
import javax.servlet.http.HttpServletRequest;
import java.net.URL;
import java.util.Locale;

@Component
public class ThemeViewResolver extends LiteDeviceDelegatingViewResolver {
    // PC端默认主题目录
    private static final String DEFAULT_NORMAL_THEME = "default/";
    // 手机端默认主题目录
    private static final String DEFAULT_MOBILE_THEME = "mobile/";
    // 平板端默认主题目录
    private static final String DEFAULT_TABLET_THEME = "mobile/";

    // PC端当前主题目录
    private static final String CURRENT_NORMAL_THEME = "default/";
    // 手机端当前主题目录
    private static final String CURRENT_MOBILE_THEME = "mobile/";
    // 平板端当前主题目录
    private static final String CURRENT_TABLET_THEME = "mobile/";

    @Value("${spring.thymeleaf.prefix}")
    private String thymeleafPrefix;

    @Value("${spring.thymeleaf.suffix}")
    private String thymeleafSuffix;

    public ThemeViewResolver(@Qualifier("thymeleafViewResolver") ViewResolver delegate) {
        super(delegate);
    }

    @PostConstruct
    public void init() {
        // 是否支持回退
        // true表示如果找不到移动端视图,则使用PC端默认视图
        this.setEnableFallback(true);
        this.setNormalPrefix(DEFAULT_NORMAL_THEME);
        this.setMobilePrefix(DEFAULT_MOBILE_THEME);
        this.setTabletPrefix(DEFAULT_TABLET_THEME);

        // 设置的优先级要比ThymeleafViewResolver高,要在ThymeleafViewResolver之前解析
        this.setOrder(1);
    }

    /**
     * 检查当前请求使用的设备,然后根据请求设备的不同,返回适合该设备的视图名
     */
    @Override
    protected String getDeviceViewNameInternal(String viewName) {
        RequestAttributes attrs = RequestContextHolder.getRequestAttributes();
        HttpServletRequest request = ((ServletRequestAttributes) attrs).getRequest();
        Device device = DeviceUtils.getCurrentDevice(request);
        String resolvedViewName = viewName;
        String currentTheme = this.getNormalPrefix();
        if (ResolverUtils.isNormal(device, null)) {
            currentTheme = StringUtils.isNotEmpty(CURRENT_NORMAL_THEME) ? appendTrailingSlash(CURRENT_NORMAL_THEME) : this.getNormalPrefix();
            resolvedViewName = currentTheme + viewName + this.getNormalSuffix();
        } else if (ResolverUtils.isMobile(device, null)) {
            currentTheme = StringUtils.isNotEmpty(CURRENT_MOBILE_THEME) ? appendTrailingSlash(CURRENT_MOBILE_THEME) : this.getMobilePrefix();
            resolvedViewName = currentTheme + viewName + this.getMobileSuffix();
        } else if (ResolverUtils.isTablet(device, null)) {
            currentTheme = StringUtils.isNotEmpty(CURRENT_TABLET_THEME) ? appendTrailingSlash(CURRENT_TABLET_THEME) : this.getTabletPrefix();
            resolvedViewName = currentTheme + viewName + this.getTabletSuffix();
        }

        return this.stripTrailingSlash(resolvedViewName);
    }

    @Override
    public View resolveViewName(String viewName, Locale locale) throws Exception {
        // 获取当前设备对应的视图名
        String deviceViewName = this.getDeviceViewName(viewName);
        // 检查设备视图模板是否存在
        boolean deviceViewExisted = checkViewExisted(deviceViewName);
        View view = null;
        if (this.getEnableFallback() && !deviceViewExisted) {
            // 启用回退功能
            // 如果设备视图模板不存在,则返回PC端默认视图
            String normalViewName = this.getNormalPrefix().concat(viewName).concat(this.getNormalSuffix());
            view = this.getViewResolver().resolveViewName(normalViewName, locale);
        } else {
            view = this.getViewResolver().resolveViewName(deviceViewName, locale);
        }

        return view;
    }

    public boolean checkViewExisted(String viewName) {
        String prefix = thymeleafPrefix.replace("classpath:/", StringUtils.EMPTY);
        String fullPath = prefix.concat(viewName).concat(thymeleafSuffix);
        URL url = ClassLoaderUtils.getClassLoader(this.getClass()).getResource(fullPath);

        return url != null;
    }

    private String stripTrailingSlash(String viewName) {
        return viewName.endsWith("//") ? viewName.substring(0, viewName.length() - 1) : viewName;
    }

    private String appendTrailingSlash(String themeName) {
        return themeName.endsWith("/") ? themeName : themeName.concat("/");
    }
}

使用PC端访问:



使用移动端访问:



修改当前使用的主题为蓝色主题:
// PC端当前主题目录
private static final String CURRENT_NORMAL_THEME = "theme-blue/";
// 手机端当前主题目录
private static final String CURRENT_MOBILE_THEME = "theme-mobile-blue/";
// 平板端当前主题目录
private static final String CURRENT_TABLET_THEME = "theme-mobile-blue/";

使用PC端访问:



使用移动端访问:



测试回退功能,删除theme-mobile-blue目录,因为找不到移动端蓝色主题视图,则回退使用PC端默认视图。
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 155,457评论 4 357
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 65,943评论 1 285
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 105,327评论 0 236
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,307评论 0 201
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 51,630评论 3 283
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,114评论 1 202
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,514评论 2 305
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,227评论 0 193
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 33,859评论 1 234
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,186评论 2 238
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,741评论 1 255
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,087评论 2 248
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,614评论 3 228
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 25,926评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,630评论 0 190
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,117评论 2 261
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,076评论 2 257

推荐阅读更多精彩内容