《Spring实战》是学习Spring框架的一本非常经典的书籍，之前阅读了这本书，只是在书本上写写画画，最近整理了一下《Spring实战》的读书笔记，通过博客的方式进行记录分享。俗话说，好记性不如烂笔头，把学习到的知识记录下来，方便温故知新，让更多的读者可以学习到有关Spring框架的知识。
| 序号 | 内容 | 链接地址 |
|---|---|---|
| 1 | 《Spring实战》读书笔记-第1章 Spring之旅 | https://blog.csdn.net/ThinkWon/article/details/103097364 |
| 2 | 《Spring实战》读书笔记-第2章 装配Bean | https://blog.csdn.net/ThinkWon/article/details/103527675 |
| 3 | 《Spring实战》读书笔记-第3章 高级装配 | https://blog.csdn.net/ThinkWon/article/details/103536621 |
| 4 | 《Spring实战》读书笔记-第4章 面向切面的Spring | https://blog.csdn.net/ThinkWon/article/details/103541166 |
| 5 | 《Spring实战》读书笔记-第5章 构建Spring Web应用程序 | https://blog.csdn.net/ThinkWon/article/details/103550083 |
| 6 | 《Spring实战》读书笔记-第6章 渲染Web视图 | https://blog.csdn.net/ThinkWon/article/details/103559672 |
| 7 | 《Spring实战》读书笔记-第7章 Spring MVC的高级技术 | https://blog.csdn.net/ThinkWon/article/details/103562467 |
文章目录
- 将模型数据渲染为HTML
- 使用JSP视图
- 通过tiles定义视图布局
- 使用Thymeleaf视图
在《Spring实战》的书中是包括6.3 使用Apache Tiles视图定义布局和6.4 使用Thymeleaf这两个小节的，但是考虑到平时开发使用的比较少，就不进行介绍了，感兴趣的小伙伴们可以自行学习。 上一章主要关注于如何编写处理Web请求的控制器。我们也创建了一些简单的视图，用来渲染控制器产生的模型数据，但我们并没有花太多时间讨论视图，也没有讨论控制器完成请求到结果渲染到用户的浏览器中的这段时间内到底发生了什么，而这正是本章的主要内容。
6.1 理解视图解析
Spring MVC定义了一个名为ViewResolver的接口，它大致如下所示：public interface ViewResolver { View resolveViewName(String viewName, Locale locale) throws Exception;}public interface View { String getContentType(); void render(Map<String, ?> model, HttpServletRequest request, HttpServletResponse response) throws Exception;}| 视图解析器 | 描述 |
|---|---|
| BeanNameViewResolver | 将视图解析为Spring应用上下文的bean，其中bean的ID与视图的名字相同 |
| ContentNegotiatingViewResolver | 通过考虑客户端需要的内容类型来解析视图，委托给另外一个能够产生对应内容类型的视图解析器 |
| FreeMarkerViewResolver | 将视图解析为FreeMarker模版 |
| InternalResourceViewResolver | 将视图解析为Web应用的内部资源（一般为JSP） |
| JasperReportsViewResolver | 将视图解析为JasperReports定义 |
| ResourceBundleViewResolver | 将视图解析为资源bundle（一般为属性文件） |
| TilesViewResolver | 将视图解析为Apache Tile定义，其中tile ID与视图名称相同。注意有两个不同的TilesViewResolver实现，分别对应于Tiles 2.0和Tiles 3.0 |
| UrlBasedViewResolver | 直接根据视图的名称解析视图，视图的名称会匹配一个物理视图的定义 |
| VelocityLayoutViewResolver | 将视图解析为Velocity布局，从不同的Velocity模板中组合页面 |
| VelocityViewResolver | 将视图解析为Velocity模板 |
| XmlViewResolver | 将视图解析为特性XML文件中的bean定义。类似于BeanNameViewResolver |
| XsltViewResolver | 将视图解析为XSLT转换后的结果 |
6.2 创建JSP视图
Spring提供了两种支持JSP视图的方式：- InternalResourceViewResolver会将视图名解析为JSP文件。另外，如果在你的JSP页面中使用了JSP标准标签库（JavaServer Pages Standard Tag Library, JSTL）的话，InternalResourceViewResolver能够将视图名解析为JstlView形式的JSP文件，从而将JSTL本地化和资源bundle变量暴露给JSTL的格式化（formatting）和信息（message） 标签。
- Spring提供了两个JSP标签库，一个用于表单到模型的绑定，另一个提供了通用的工具类特性。
配置适用于JSP的视图解析器 InternalResourceViewResolver遵循一种约定，会在视图名上添加前缀和后缀，进而确定一个Web应用中视图资源的物理路径。 通用的实践是将JSP文件放到Web应用的WEB-INF目录下，防止对它的直接访问。假设逻辑视图名为home，那么可以确定物理视图的路径就是逻辑视图名home再加上“/WEB-INF/views/”前缀和“.jsp”后缀。
InternalResourceViewResolver解析视图时，会在视图名上添加前缀和后缀 当使用@Bean注解的时候，我们可以按照如下的方法配置InternalResourceViewResolver,使其在解析视图时，遵循上述的约定。
@Beanpublic ViewResolver viewResolver(){ // 配置jsp视图解析器 InternalResourceViewResolver resolver = new InternalResourceViewResolver(); resolver.setPrefix("/WEB-INF/views/"); resolver.setSuffix(".jsp"); return resolver;}<bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver" p:prefix="/WEB-INF/views/" p:suffix=".jsp" />- home将会解析为“/WEB-INF/views/home.jsp”
- productList将会解析为“/WEB-INF/views/productList.jsp”
- books/detail将会解析为“/WEB-INF/views/books/detail.jsp”
解析JSTL视图 如果JSP使用JSTL标签来处理格式化和信息的话，那么我们会希望InternalResourceViewResolver将视图解析为JstlView。 JSTL的格式化标签需要一个Locale对象，以便于恰当地格式化地域相关的值，如日期和货币。信息标签可以借助Spring的信息资源和Locale，从而选择适当的信息渲染到HTML之中。通过解析JstlView，JSTL能够获得Locale对象以及Spring中配置的信息资源。 如果想让InternalResourceViewResolver将视图解析为JstlView，而不是InternalResourceView的话，那么我们只需设置它的viewClass属性即可：
@Beanpublic ViewResolver viewResolver(){ // 配置jsp视图解析器 InternalResourceViewResolver resolver = new InternalResourceViewResolver(); resolver.setPrefix("/WEB-INF/views/"); resolver.setSuffix(".jsp"); resolver.setViewClass(org.springframework.web.servlet.view.JstlView.class); return resolver;}<bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver" p:prefix="/WEB-INF/views/" p:suffix=".jsp" p:viewClass="org.springframework.web.servlet.view.JstlView" />使用Spring的JSP库 Spring提供了两个JSP标签库，用来帮助定义Spring MVC Web的视图。其中一个标签库会用来渲染HTML表单便签，这些标签可以绑定model中的某个属性。另外一个标签库包含了一些工具类标签，我们随时都可以非常便利地使用它们。 我们将会看到如何将Spittr应用的注册表单绑定到模型上，这样表单就可以预先填充值，并且在表单提交失败后，能够展现校验错误。 将表单绑定到模型上 Spring的表单绑定JSP标签库包含了14个标签，它们中的大多数都用来渲染HTML中的表单标签。但是，它们与原生HTML标签的区别在于它们会绑定模型中的一个对象，能够根据模型中对象的属性填充值。标签库中还包含了一个为用户展示错误的标签，它会将错误信息渲染到最终的HTML之中。 为了使用表单绑定库，需要在JSP页面中对其进行声明：
<%@ taglib prefix="sf" uri="http://www.springframework.org/tags/form" %>| JSP标签 | 描述 |
|---|---|
<sf:checkbox> | 渲染成一个HTML 标签，其中type属性设置为checkbox |
<sf:checkboxes> | 渲染成多个HTML 标签，其中type属性设置为checkbox |
<sf:errors> | 在一个HTML 中渲染输入域的错误 |
<sf:form> | 渲染成一个HTML 标签，并为其内部标签暴露绑定路径，用于数据绑定 |
<sf:hidden> | 渲染成一个HTML 标签，其中type属性设置为hidden |
<sf:input> | 渲染成一个HTML 标签，其中type属性设置为text |
<sf:label> | 渲染成一个HTML |
<sf:option> | 渲染成一个HTML 标签，其中selected属性根据所绑定的值进行设置 |
<sf:options> | 按照绑定的集合、数组或Map，渲染成一个HTML 标签的列表 |
<sf:password> | 渲染成一个标签，其中type属性设置为password |
<sf:radiobutton> | 渲染成一个标签，其中type属性设置为radio |
<sf:select> | 渲染为一个HTML 标签 |
<sf:textarea> | 渲染为一个HTML 标签 |
<sf:form>、
<sf:input>和
<sf:password>WW
<sf:form method="POST" commandName="spitter" > First Name:<sf:input path="firstName"/><br/> Last Name:<sf:input path="lastName" /><br/> Email:<sf:input type="email" path="email" /><br/> Username: <sf:input path="username"/><br/> Password: <sf:password path="password"/><br/> <input type="submit" value="Register" /></sf:form><sf:form>会渲染一个HTML
<form>标签，但它也会通过commandName属性构建针对某个模型对象的上下文信息。在其他的表单绑定标签中，会引用这个模型对象的属性。 在之前的代码中，我们将commandName属性设置为spitter。因此，在模型中必须要有一个key为spitter的对象，否则的话，表单不能正常渲染（会出现JSP错误）。这意味着我们需要修改一下SpitterController,以确保模型中存在以spitter为key的Spitter对象：
@RequestMapping(value="/register", method=GET)public String showRegistrationForm(Model model) { model.addAttribute(new Spitter()); return "registerForm";}<input>标签改成了
<sf:input>。这个标签会渲染成一个HTML
<input>标签，并且type属性将会设置为text。我们在这里设置了path属性，
<input>标签的value属性值将会设置为模型对象中path属性所对应的值。 对于password输入域，我们使用
<sf:password>来代替
<sf:input>。
<sf:password>与
<sf:input>类似，但是它所渲染的HTML
<input>标签中，会将type属性为password，这样当输入的时候，它的值不会直接明文显示。 值得注意的是，从Spring 3.1开始，
<sf:input>标签能够允许我们指定type属性，这样的话，除了其他可选的类型外，还能指定HTML5特定类型的文本域，如date、range和email。
Email: <sf:input path="email" type="email" /><br/><sf:errors> 如果存在校验错误的话，请求中会包含错误的详细信息，这些信息是与模型数据放到一起的。我们所需要做的就是到模型中将这些数据抽取出来，并展现给用户。
<sf:form method="POST" commandName="spitter"> First Name: <sf:input path="firstName" /> <sf:errors path="firstName"/><br/>...
</sf:form><sf:errors>用到First Name输入域的场景，但是它可以按照同样简单的方式用到注册表单的其他输入域中。在这里，它的path属性设置成了firstName，也就是指定了要显示Spitter模型对象中哪个属性的错误。如果firstName属性没有错误的话，那么
<sf:errors>不会渲染任何内容。但如果有校验错误的话，那么将会在HTML
<span>标签中显示错误信息。 现在，我们已经可以为用户展现错误信息，这样他们就能修正这些错误了。我们还可以修改错误的样式，使其更加突出显示。为了做到这一点，可以设置cssClass属性：
<sf:form method="POST" commandName="spitter"> First Name: <sf:input path="firstName" /> <sf:errors path="firstName" cssClass="error"/><br/>...
</sf:form>span.error { color: red;}
在表单输入域的旁边展现校验错误信息 除了这种方式，还有另一种处理校验错误方式就是将所有的错误信息在同一个地方进行显示。为了做到这一点，我们可以移除每个输入域上的
<sf:errors>元素，并将其放到表单的顶部
<sf:form method="POST" commandName="spitter"> <sf:errors path="*" element="div" cssClass="error"/> ...
</sf:form><sf:errors>展现所有属性的所有错误。 同样需要注意的是，我们将element属性设置成了div。默认情况下，错误都会渲染在HTML
标签中，如果只显示一个错误的话，这是不错的选择。但是，如果要渲染所有输入域的错误的话，很可能要展现不止一个错误，这时候使用<span>标签（行内元素）就不合适了。像<div>这样的块级元素会更为合适。因此，我们可以将element属性设置成了div。 像之前一样，cssClass属性被设置errors，这样我们就能为
<div>设置样式了。
div.errors { background-color: #ffcccc; border: 2px solid red;}<sf: label>，并设置它的cssErrorClass属性。如下就是做完必要修改后的FirstName输入域：
<sf:form method="POST" commandName="spitter"> <sf:label path="firstName" cssErrorClass="error">First Name</sf:label>:
<sf:input path="firstName" cssErrorClass="error" /><br/>...
</sf:form><sf:label>标签像其他的表单绑定标签一样，使用path来指定它属于模型对象中的哪个属性。在本例中，我们将其设置为firstName，因此它会绑定Spitter对象的firstName属性。假设没有校验错误的话，它将会渲染为如下的HTML
<label>元素：
<label for="firstName">First Name</label><sf:label>的path属性并没有完成太多的功能，但是，我们还同时设置了cssErrorClass属性。如果它所绑定的属性有任何错误的话，在渲染得到的
<label>元素中，class属性将会被设置为 error，如下所示：
<label for="firstName" class="error">First Name</label><sf:input>标签的cssErrorClass属性被设置为error，如果有任何校验错误，class属性将会被设置为error。下面设置css
label.error { color: red;}input.error { background-color: #ffcccc;}@NotNull@Size(min=5, max=16,message = "{username.size}")private String username;@NotNull@Size(min=5, max=25,message = "{password.size}")private String password;@NotNull@Size(min=2, max=30,message = "{firstName.size}")private String firstName;@NotNull@Size(min=2, max=30,message = "{lastName.size}")private String lastName;@NotNull@Email(message = "{email.valid}")private String email;firstName.size=First name must be between {min} and {max} characters long.lastName.size=Last name must be between {min} and {max} characters long.
username.size=Username must be between {min} and {max} characters long.
password.size=Password must be between {min} and {max} characters long.
email.valid=The email address must be valid.
显示校验错误，其中这些对用户友好的信息是从属性文件中获取到的 我们可以按需创建任意数量的ValidationMessage.properties文件，使其涵盖我们想支持的所有语言和地域。
Spring通用的标签库 除了表单绑定标签库之外，Spring还提供了更为通用的JSP标签库。 要使用Spring通用的标签库，我们必须要在页面上对其进行声明：
<%@ taglib uri="http://www.springframework.org/tags" prefix="s" %>| JSP标签 | 描述 |
|---|---|
<s:bind> | 将绑定属性的状态导出到一个名为status的页面作用域属性中，与<s:path>组合使用获取绑定属性的值 |
<s:escapeBody> | 将标签体中的内容进行HTML和/或JavaScript转义 |
<s:hasBindErrors> | 根据指定模型对象（在请求属性中）是否有绑定错误，有条件地渲染内容 |
<s:htmlEscape> | 为当前页面设置默认的HTML转义值 |
<s:message> | 根据给定的编码获取信息，然后要么进行渲染（默认行为），要么将其设置为页面作用域、请求作用域、会话作用域应用作用域的变量（通过使用var和scope属性实现） |
<s:nestedPath> | 设置嵌入式的path，用于<s:bind>之中 |
<s:theme> | 根据给定的编码获取主题信息，然后要么进行渲染（默认行为），要么将其设置为页面作用域、请求作用域、会话作用域应用作用域的变量（通过使用var和scope属性实现） |
<s:transform> | 使用命名对象的属性编辑器转换命令对象中不包含的属性 |
<s:url> | 创建相对于上下文的URL，支持URI模板变量以及HTML/XML/JavaScript转义。可以渲染URL（默认行为），要么将其设置为页面作用域、请求作用域、会话作用域应用作用域的变量（通过使用var和scope属性实现） |
<s:eval> | 计算符合Spring表达式语言（Spring Expression Language SpEL）语法的某个表达式的值，然后要么进行渲染（默认行为），要么将其设置为页面作用域、请求作用域、会话作用域应用作用域的变量（通过使用var和scope属性实现） |
展现国际化信息 如果要修改JSP模板中的文本，就不那么容易，而且，没有办法根据用户的语言设置国际化这些文本。 例如：
<h1>Welcome to Spitter!</h1><s:message>，我们可以将硬编码的欢迎信息替换为如下的形式：
<h1><s:message code="spitter.welcome" /></h1><s:message>将会根据key为spitter.welcome的信息源来渲染文本。 Spring有多个信息源的类，它们都实现了MessageSource接口。在这些类中，更为常见和有用的是ResourceBundleMessageSource。它会从一个属性文件中加载信息，这个属性文件的名称是根据基础名称（base name）衍生而来的。如下的@Bean方法配置了ResourceBundleMessageSource:
@Beanpublic MessageSource messageSource(){ ResourceBundleMessageSource messageSource = new ResourceBundleMessageSource(); messageSource.setBasename("message"); messageSource.setDefaultEncoding("UTF-8"); return messageSource;}@Beanpublic MessageSource messageSource(){ ReloadableResourceBundleMessageSource messageSource = new ReloadableResourceBundleMessageSource(); messageSource.setBasename("file:///etc/spittr/messages"); messageSource.setCacheSeconds(10); return messageSource;}spittr.welcome=Welcome to Spittr!spittr.welcome=Bienvenidos a Spittr!<s:url>的主要任务就是创建URL，然后将其赋值给一个变量或者渲染到响应中。它是JSTL中
<c:url>标签的替代者，但是它具备几项特殊的技巧。
<s:url>会接受一个相对Servlet上下文的URL，并在渲染的时候，预先添加上Servlet上下文路径。例如，考虑如下
<s:url>的基本用法：
<a href="<s:url href="/spitter/register" />">Register</a><a href="/spittr/spitter/register">Register</a><s:url>将会负责这件事。 另外，我们还可以使用
<s:url>创建URL，并将其赋值给一个变量供模板在稍后使用：
<s:url href="/spitter/register" var="registerUrl" /><a href="${registerUrl}">Register</a><s:url>在应用作用域内、会话作用域内或请求作用域内创建URL：
<s:url href="/spitter/register" var="registerUrl" scope="request" /> <s:param>标签。比如，如下的
<s:url>使用两个内嵌的
<s:param>标签，来设置“/spittles”的max和count参数：
<s:url href="/spittles" var="spittlesUrl"> <s:param name="max" value="60" /> <s:param name="count" value="20" /></s:url><s:param>标签可以承担此任务：
<s:url href="/spitter/{username}" var="spittlesUrl"> <s:param name="username" value="jbauer" /></s:url><s:param>中所指定的参数时，这个参数将会插入到占位符的位置中。如果
<s:param>参数无法匹配href中的任何占位符，那么这个参数将会作为查询参数。
<s:url>标签还可以解决URL的转义需求。例如，如果你希望将渲染得到的URL内容展现在Web页面上（而不是作为超链接），那么你应该要求
<s:url>进行HTML转义，这需要将htmlEscape属性设置为true。例如，如下
<s:url>将会渲染HTML转义后的URL：
<s:url href="/spittles" htmlEscape="true"> <s:param name="max" value="60" /> <s:param name="count" value="20" /></s:url>/spitter/spittles?max=60&count=20<s:url href="/spittles" var="spittlesJSUrl" javaScriptEscape="true"> <s:param name="max" value="60" /> <s:param name="count" value="20" /></s:url><script> var spittlesUrl = "${spittlesJSUrl}" </script><script> var spittlesUrl = "\/spitter\/spittles?max=60&count=20" </script><s:escapeBody>标签是一个通用的转义标签。它会渲染标签体中内嵌的内容，并且在必要的时候进行转义。 例如，假设你希望在页面上展现一个HTML代码片段。为了正确显示，我们需要将“<”和“>”字符替换为“<”和“>”，否则的话，浏览器将会像解析页面上其他HTML那样解析这段HTML内容。 当然，没有人禁止我们手动将其转义为“<”和“>”，但是这很繁琐，并且代码难以阅读。我们可以使用
<s:escapeBody>，并让Spring完成这项任务：
<s:escapeBody htmlEscape="true"> <h1>Hello</h1></s:escapeBody><h1>Hello</h1><s:escapeBody>标签还支持JavaScript转义：
<s:escapeBody javaScriptEscape="true"> <h1>Hello</h1></s:escapeBody><s:escapeBody>只完成一件事，并且完成得非常好。与
<s:url>不同，它只会渲染内容，并不能将内容设置为变量。
