十天熟练掌握SpringMvc第六天

Spring MVC 构造URI

1 在Spring MVC中，使用了UriComponentsBuilder和UriComponents两个类来提供URI的加密解密。

UriComponents uriComponents = UriComponentsBuilder.fromUriString(

"http://example.com/hotels/{hotel}/bookings/{booking}").build();

URI uri = uriComponents.expand("42", "21").encode().toUri();

UriComponents
是不可变对象。因此
expand()
与
encode()
操作在必要的时候会返回一个新的实例。

2 也可以使用一个URI组件实例对象来实现URI的填充与加密：

UriComponents uriComponents = UriComponentsBuilder.newInstance()

.scheme("http").host("
example.com").path("/hotels/
{hotel}/bookings/{booking}").build()

.expand("42", "21")

.encode();

3 在servlet开发中，可以使用ServletUriComponentsBuilder类 提供一个静态工厂方法 可以从请求获取URI

ServletUriComponentsBuilder ucb = ServletUriComponentsBuilder.fromContextPath(request)

.path("/accounts").build()

4 如果DispatchServlet是通过名字请求映射的，还可以通过DispatchServlet获取请求

ServletUriComponentsBuilder ucb = ServletUriComponentsBuilder.fromServletMapping(request)

.path("/accounts").build()
，也是基于父类
Servlet
的静态工厂方法

Spring MVC 提供地区信息

DispatcherServlet
为你提供了自动使用用户的地区信息来解析消息的能力。而这，是通过
LocaleResolver
对象来完成的。

一个请求进入处理时，
DispatcherServlet
会查找一个地区解析器。如果找到，就尝试使用它来设置地区相关的信息。

通过调用
RequestContext.getLocale()
都能取到地区解析器所解析到的地区信息。

此外，如果你需要自动解析地区信息，你可以在处理器映射前加一个拦截器

Spring MVC 获取时区信息

除了获取客户端的地区信息外，有时他们所在的时区信息也非常有用。

LocaleContextResolver
接口为
LocaleResolver
提供了拓展点，

允许解析器在
LocaleContext
中提供更多的信息，这里面就可以包含时区信息。

如果用户的时区信息能被解析到，那么你总可以通过
RequestContext.getTimeZone()
方法获得。

时区信息会自动被
SpringConversionService
下注册的日期
/
时间转换器
Converter
及格式化对象
Formatter
所使用。

SpringMVC Accept
请求头解析器

AcceptHeaderLocaleResolver
解析器会检查客户端（比如，浏览器，等）

所发送的请求中是否携带
accept-language
请求头。通常，该请求头字段中包含了客户端操作系统的地区信息。

不过请注意，该解析器不支持时区信息的解析。（）

SpringMVC Cookie
解析器

CookieLocaleResolver
解析会检查客户端是否有
Cookie
，里面可能存放了地区
Locale
或时区
TimeZone
信息。

如果检查到相应的值，解析器就使用它们。通过该解析器的属性，你可以指定
cookie
的名称和其最大的存活时间。

定义一个
CookieLocaleResolver
：

<bean id="localeResolver" class="org.springframework.web.servlet.i18n.CookieLocaleResolver">

<property name="cookieName" value="clientlanguage"/>

<!-- 单位为秒。若设置为-1，则cookie不会被持久化（客户端关闭浏览器后即被删除） -->

<property name="cookieMaxAge" value="100000">

</bean>

CookieLocaleResolver
的属性

（
cookie
名）
cookieName
：默认值
classname + LOCALE

cookieMaxAge：默认值 Integer.MAX_INT

（
cookie
被保存在客户端的最长时间。如果该值为
-1
，

那么
cookie
将不会被持久化，在客户端浏览器关闭之后就失效了）

cookiePath
：存放位置 默认为
/

SpringMVC Session
解析器

SessionLocaleResolver
允许你从
session
中取得可能与用户请求相关联的地区
Locale
和时区
TimeZone
信息。

与
CookieLocaleResolver
不同，这种存取策略仅将
Servlet
容器的
HttpSession
中相关的地区信息存取到本地。

因此，这些设置仅会为该会话（
session
）临时保存，
session
结束后，这些设置就会失效。

但该解析器与其他外部
session
管理机制，比如
Spring
的
Session
项目等，并没有直接联系。

该
SessionLocaleResolver
仅会简单地从与当前请求
HttpServletRequest
相关的
HttpSession
对象中，

取出对应的属性，并修改其值，仅此而已

SpringMVC
地区更改拦截器

你可以在处理器映射前添加一个
LocaleChangeInterceptor
拦截器来更改地区信息。

它能检测请求中的参数，并根据其值相应地更新地区信息。

它通过调用
LocaleResolver
的
setLocale()
方法来更改地区。

*.view
路径并且携带了
siteLanguage
参数的资源请求更改地区。

一个
URL
为
<

http://www.sf.net/home.view?siteLanguage=nl

>
的请求将会将站点语言更改为荷兰语。

<bean id="localeChangeInterceptor" class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor">

<property name="paramName" value="siteLanguage"/>

</bean>

<bean id="localeResolver" class="org.springframework.web.servlet.i18n.CookieLocaleResolver"/>

<bean id="urlMapping" class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">

<property name="interceptors">

<list>

<ref bean="localeChangeInterceptor"/>

</list>

</property>

<property name="mappings">

<value>/**/*.view=someController</value>

</property>

</bean>

Spring MVC 主题解析器

定义主题控制器

要在你的应用中使用主题，你必须实现一个
org.springframework.ui.context.ThemeSource
接口。

WebApplicationContext
接口继承了
ThemeSource
接口，但主要的工作它还是委托给接口具体的实现来完成。

默认的实现是
org.springframework.ui.context.support.ResourceBundleThemeSource
，

它会从
classpath
的根路径下去加载配置文件。如果需要定制
ThemeSource
的实现

定义主题，定义之后，你要决定使用哪个主题。

DispatcherServlet
会查找一个名称为
themeResolver
的
bean
以确定使用哪个
ThemeResolver
的实现。

主题解析器的工作原理与地区解析器
LocaleResolver
的工作原理大同小异。

它会检测，对于一个请求来说，应该使用哪个主题，同时它也可以修改一个请求所应应用的主题。

Spring
提供了下列的这些主题解析器：

1 FixedThemeResolver 选择一个固定的主题，这是通过设置defaultThemeName这个属性值实现的

2 SessionThemeResolver 请求相关的主题保存在用户的HTTP会话（session）中。

对于每个会话来说，它只需要被设置一次，但它不能在会话之间保存

3 CookieThemeResolver 选中的主题被保存在客户端的cookie中

Spring
提供了一个主题更改拦截器
ThemeChangeInterceptor
，支持主题的更换。

Spring MVC 文件上传

通用的多路上传解析器
CommonsMultipartResolver

<bean id="multipartResolver" class="
org.springframework.web.multipart.commons.CommonsMultipartResolver
">

<!-- 支持的其中一个属性，支持的最大文件大小，以字节为单位 -->

<property name="maxUploadSize" value="100000"/>

</bean>

上传解析器
CommonsMultipartResolver
，
jar
包是
commons-fileupload.jar
。

DispatcherServlet
发现多部分请求，把请求转发给多路配置的解析器。

解析器把
HttpServletRequest
请求对象封装成多路文件上传的请求对象
MultipartHttpServletRequest
。

Servlet3.0
以下，解析器不同，
3.0
以下的解析器不支持基本配置

Spring MVC 处理表单中的文件上传

创建一个接受文件上传的表单将允许用于直接上传整个表单。

编码属性（
enctype="multipart/form-data"
）让浏览器知道如何对多路上传请求的表单进行编码（
encode
）。

<form method="post" action="/form" enctype="multipart/form-data">

<input type="text" name="name"/>

<input type="file" name="file"/>

<input type="submit"/>

</form>

接受参数的类型是
MultipartHttpServletRequest
，或
MultipartFile

@RequestMapping(path = "/form", method = RequestMethod.POST)

public String handleFormUpload(@RequestParam("name") String name, @RequestParam("file") MultipartFile file) {

if (!file.isEmpty()) {

byte[] bytes = file.getBytes();

// store the bytes somewhere

return "redirect:uploadSuccess";

}