SpringMVC入门之七：使用JSP作为视图

使用JSP作为视图

JSP作为JavaWeb应用程序的视图技术已经超过15年了，想在仍然是使用量最大的视图技术。

视图解析器：

InternalResourceViewResolver是最简单和最常用的JSP视图解析器。这种视图解析器遵循一种约定，会在视图名上添加前缀和后缀，进而确定一个Web应用中视图资源的物理路径。

视图位置 在通常的Web应用中，我们把JSP文件放到Web应用的WEB-INF目录下，防止对它的直接访问。

InternalResourceViewResolver视图解析器的配置：

基于Java的配置：

@Bean public ViewResolver viewResolver(){

InternalResourceViewResolver viewResolver = new

InternalResourceViewResolver();

viewResolver.setPrefix("/WEB-INF/views/");

viewResovler.setSuffix(".jsp");   return viewResolver; }

基于XML的配置：

<bean id="viewResolver"

class="org.springframework.web.servlet.view.InternalResourceViewResolver"

p:prefix="/WEB-INF/views/" p:suffix=".jsp"   />

这样，books/detail将会解析为“/WEB-INF/views/books/detail.jsp”。注意，当逻辑视图包含斜线时，这个斜线也会带到资源的路径名中。这样，我们可以很方便地将视图模板组织为层级目录结构，而不是将它们都放到同一个目录中。

使用Spring的JSP库

标签库是为JSP添加功能的强大方式，能够避免在脚本块中直接编写Java代码。Spring提供了两个JSP标签库，用来帮助定义SpringMVC Web的视图。其中一个标签库会用来渲染HTML表单标签，这些标签可以绑定model中的某个属性。另外一个标签库包含了一些工具类标签，我们随时都可以非常便利地使用它们。在这两个标签库汇中，表单绑定的标签库更加有用。

将表单绑定到模型上

Spring的表单绑定JSP标签库包含了14个标签，它们中的大多数都用来渲染HTML中的表单标签。但是，它们与原生HTML标签的区别在于它们会绑定模型中的一个对象，能够根据模型中对象的属性填充值。标签库中还包含了一个为用户展现错误的标签，它会将错误信息渲染到最终的HTML之中。为了使用表单绑定库，需要在JSP中对其进行声明：

<%@ taglib uri="http://www.springframework.org/tags/form" prefix="sf" %>

上面我们将前缀设置为了“sf”，它是Spring form的简写，也可以设置成其他的字符，如“form”。这14个标签及介绍如下：



以一个简单的注册为例，使用相应标签库的注册表单如下所示：

<sf:form method="POST" commandName="spitter">
First Name:<sf:input path="firstName"/><br/>
Last Name:<sf:input path="lastName"/><br/>
Email:<sf:input path="email"/><br/>
User Name:<sf:input path="username"/><br/>
Password:<sf:password path="password"/><br/>
<input tupe="submit" value="Register" />
</sf:form>

<sf:form>

会渲染一个HTML

<form>

标签，但它也会通过commandName属性构建针对某个模型对象的上下文信息。在其他的表单绑定标签中，会引用这个模型对象的属性。在上面的例子中，我们将commandName属性设置为spitter。因此，在模型中必须要有一个key为spitter的对象，否则的话，表单不能正确渲染（会出现JSP错误）。我们在上面设置了path属性，

<input>

标签的value属性值将会设置为模型对象中path属性所对应的值。

另外，值得注意的是，从Spring3.1开始，

<sf:input>

标签能够允许我们制定type属性，这样的话，除了其他可选得类型外，还能制定HTML5特定类型的文本域，如data、range和email。例如：

Email：<sf:input path="email" type="email" /><br/>

相对于标准的HTML标签，使用Spring的表单绑定标签能够带来一定的功能提升，在校验失败后，表单中会预先填充之前输入的值。但是，这依然没有告诉用户错在什么地方。为了知道用户矫正错误，我们需要使用

<sf:errors>

。

展现错误

<sf:form method="POST" commandName="spitter">
First Name:<sf:input path="firstName" />
<sf:errors path="firstName" /><br/>
...
</sf:form>

标签

<sf:errors>

渲染了校验错误后的提示信息，如果firstName属性没有错误的话，那么

<sf:errors>

不会渲染任何内容。但如果有校验错误的话，那么它将会在一个HTML

<span>

标签中显示错误信息。例如，如果用户提交的姓名为字母“J”的话，那么如下的HTML片段就是针对First Name输入域所显示的内容：

First Name:<input id="firstName" name="firstName" type="text" value="J" />
<span id="firstName.errors">size must be between 2 and 30</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;
}

那么当出现校验错误时，会有红色的提示信息出现。显然，这样的表单才更加的用户友好。

此外，还有一个重要的属性：cssErrorClass。这个属性可以设置在

<sf:label>、<sf:input>

等标签中。如：

<sf:input path="firstName" cssErrorClass="error" />

当error的样式为：

input.errer{
background-color:#ffcccc;
}

且firstName域的校验出错时，该输入框的背景将会被设置为淡红色，这样的提示效果更好。

自定义错误信息

现在我们已经有了很好的方式为用户展现错误信息。不过，我们还能够让这些错误信息更加易读。重新修改一下Spitter类就可以达到效果了：

@NotNull
@Size(min=5,max=16,message="{username.size}")
private String username;
...

对于上面每个域，我们都将其@Size注解的message设置为一个字符串，这个字符串是用大括号括起来的。如果没有大括号的话，massage中的值将会作为展现给用户的错误信息。但是使用了大括号之后，我们使用的就是属性文件中的某一个属性，该属性包含了实际的信息。接下来需要做的就是创建一个名为ValidationMessages.properties的文件，并将其放在根类路径之下：

firstName.size= First name must be between {min} and {max} characters long.
lastName.size= First name must be between {min} and {max} characters long.
...

ValidationMessages.properties文件中每条信息的key值对应于注解中message属性占位符的值。同时，最小和最大长度也没有硬编码在文件中，在这个用户友好的信息中也有自己的占位符——{min}和{max}——他们会引用@Size注解上所设置的min和max属性。

将这些错误信息抽取到属性文件中还会带来一个好处，那就是我们可以创建地域相关的配置文件，为用户展现特定地域的特定语言。

上一篇：SpringMVC入门之六：使用Thymeleaf作为视图

下一篇：SpringMVC入门之八：使用Apache Tiles视图定义布局