SpringMVC（13） - 使用主题

参考：https://docs.spring.io/spring/docs/4.3.20.RELEASE/spring-framework-reference/htmlsingle/#mvc-themeresolver

1. 主题概述
可以应用Spring Web MVC框架主题来设置应用程序的整体外观，从而增强用户体验。主题是静态资源的集合，通常是样式表和图像，它们会影响应用程序的视觉样式。

2. 定义主题
要在Web应用程序中使用主题，必须设置org.springframework.ui.context.ThemeSource接口的实现。 WebApplicationContext接口扩展了ThemeSource，但将其职责委托给专用实现。默认情况下，委托是一个org.springframework.ui.context.support.ResourceBundleThemeSource实现，它从类路径的根目录加载属性文件。要使用自定义ThemeSource实现或配置ResourceBundleThemeSource的基本名称前缀，可以在应用程序上下文中使用保留名称themeSource来注册bean。 Web应用程序上下文自动检测具有该名称的bean并使用它。

使用ResourceBundleThemeSource时，主题在简单属性文件中定义。属性文件列出构成主题的资源。这是一个例子：

styleSheet=/themes/cool/style.css
background=/themes/cool/img/coolBg.jpg

属性的key是在视图代码引用主题元素的名称。对于JSP，通常使用spring:theme自定义标签执行此操作，该标签与spring:message标签相似。以下JSP片段使用上一示例中定义的主题来自定义外观：

<%@ taglib prefix="spring" uri="http://www.springframework.org/tags"%>
<html>
    <head>
        <link rel="stylesheet" href="<spring:theme code='styleSheet'/>" type="text/css"/>
    </head>
    <body style="background=<spring:theme code='background'/>">
        ...
    </body>
</html>

默认情况下，ResourceBundleThemeSource使用空的基本名称前缀。因此，属性文件从类路径的根加载。因此，可以将cool.properties主题定义放在类路径根目录的目录中，例如，在/WEB-INF/classes中。 ResourceBundleThemeSource使用标准的Java资源包加载机制，允许主题的完全国际化。例如，我们可以有一个/WEB-INF/classes/cool_nl.properties，它引用一个带有荷兰文本的特殊背景图像。

3. 主题解析器
定义主题后，如上一节所述，可以决定使用哪个主题。 DispatcherServlet将查找名为themeResolver的bean，以找出要使用的ThemeResolver实现。主题解析器的工作方式与LocaleResolver的工作方式大致相同。它检测用于特定请求的主题，还可以更改请求的主题。 Spring提供以下主题解析器：

ThemeResolver的实现：

类	描述
`FixedThemeResolver`	选择使用defaultThemeName属性设置的固定主题。
`SessionThemeResolver`	用户的HTTP会话中维护主题。它只需要为每个会话设置一次，但不会在会话之间保留。
`CookieThemeResolver`	所选主题存储在客户端的cookie中。

Spring还提供了一个ThemeChangeInterceptor，它允许使用简单的请求参数对每个请求进行主题更改。

SpringMVC（13） - 使用主题

猜你喜欢