第四章 Spring MVC的标签库

《Spring+MyBatis企业应用实战》笔记

Spring从2.0版开始，提供了一组功能强大的标签用来在JSP和Spring Web MVC中处理表单元素。相比其他标签库，Spring标签库集成在Spring Web MVC中，因此这里的标签可以访问控制器处理命令对象和绑定数据，这样一来JSP更容易开发、阅读和维护。

P63 表单标签库

表单标签库中的所有标签

标签	描述
form	渲染表单元素
input	渲染<input type="text">元素
password	渲染<input type="password">元素
hidden	渲染<input type="hidden">元素
textarea	渲染textarea元素
checkbox	渲染一个<input type="checkbox">元素
checkboxes	渲染多个<input type="checkbox">元素
radiobutton	渲染一个<input type="radiobutton">元素
radiobuttons	渲染多个<input type="radiobutton">元素
select	渲染一个选择元素
option	渲染一个可选元素
options	渲染多个可选元素
errors	在span元素中渲染字段错误

P65 form标签

Spring MVC的form标签主要有两个作用：

• 自动绑定Model中的一个属性值到当前form对应的实体对象，默认为command属性，这样我们就可以在form表单体里面方便地使用该对象的属性了。
• 支持我们在提交表单时使用除GET和POST之外的其他方法进行提交，包括DELETE和PUT等。

Spring MVC的form标签的常用属性

属性	描述
modelAttribute	form绑定的模型属性名称，默认为command
commandName	form绑定的模型属性名称，默认为command
acceptCharset	定义服务器接受的字符编码
cssClass	定义要应用到被渲染的form元素CSS类
cssStyle	定义要应用到被渲染的form元素CSS样式
htmlEscape	boolean值，表示被渲染的值是否应该进行HTML转义

commandName属性是其中最重要的属性，它定义了模型属性的名称，其中包含了一个绑定的JavaBean对象，该对象的属性将用于填充所生成的表单。如果commandName属性存在，则必须在返回该表单的视图的请求处理方法中添加响应的模型属性。

通常我们都会指定commandName或modelAttribute属性，指定绑定到的JavaBean的名称，这两个属性功能基本一致。

P66 input标签

Spring MVC的input标签会被渲染为一个类型为text的普通HTML input标签。使用Spring MVC的input标签的唯一作用就是绑定表单数据，通过path属性来指定要绑定的Model中的值。

Spring MVC的input标签的常用属性

属性	描述
cssClass	定义要应用到被渲染的input元素CSS类
cssStyle	定义要应用到被渲染的input元素CSS样式
cssErrorClass	定义要应用到被渲染的input元素CSS类，如果bound属性中包含错误，则覆盖cssClass属性
htmlEscape	boolean值，表示被渲染的值是否应该进行HTML转义
path	要绑定的属性路径

P68 password标签

Spring MVC的input标签会被渲染为一个类型为password的普通HTML input标签。password标签的用法跟input标签相似，也能绑定表单数据，只是它生成的是一个密码框，并且多了一个showPassword属性。

Spring MVC的password标签的常用属性

属性	描述
cssClass	定义要应用到被渲染的password元素CSS类
cssStyle	定义要应用到被渲染的password元素CSS样式
cssErrorClass	定义要应用到被渲染的password元素CSS类，如果bound属性中包含错误，则覆盖cssClass属性
htmlEscape	boolean值，表示被渲染的值是否应该进行HTML转义
path	要绑定的属性路径
showPassword	表示是否应该显示或遮盖密码，默认值为false

P69 hidden标签

Spring MVC的hidden标签会被渲染为一个类型为hidden的普通HTML input标签。hidden标签的用法跟input标签相似，也能绑定表单数据，只是它生成的是一个隐藏域，没有可视的外观。

Spring MVC的hidden标签的常用属性

属性	描述
htmlEscape	boolean值，表示被渲染的值是否应该进行HTML转义
path	要绑定的属性路径

2018.8.3

P69 textarea标签

Spring MVC的textarea标签会被渲染为一个类型为textarea的普通HTML标签。textarea是一个支持多行输入的HTML元素。

Spring MVC的textarea标签的常用属性

属性	描述
cssClass	定义要应用到被渲染的textarea元素CSS类
cssStyle	定义要应用到被渲染的textarea元素CSS样式
cssErrorClass	定义要应用到被渲染的textarea元素CSS类，如果bound属性中包含错误，则覆盖cssClass属性
htmlEscape	boolean值，表示被渲染的值是否应该进行HTML转义
path	要绑定的属性路径

P70 checkbox标签

Spring MVC的checkbox标签会被渲染为一个类型为checkbox的普通HTML input标签。

Spring MVC的checkbox标签的常用属性

属性	描述
cssClass	定义要应用到被渲染的checkbox元素CSS类
cssStyle	定义要应用到被渲染的checkbox元素CSS样式
cssErrorClass	定义要应用到被渲染的checkbox元素CSS类，如果bound属性中包含错误，则覆盖cssClass属性
htmlEscape	boolean值，表示被渲染的值是否应该进行HTML转义
path	要绑定的属性路径
label	要作为label被渲染的复选框的值

• 绑定boolean数据

当checkbox绑定的是一个boolean数据时，checkbox的状态跟被绑定的boolean数据的状态是一样的，即为true时复选框选中，为false时复选框不选中。

• 绑定列表数据

这里的列表数据包括数组、List和Set。假设有一个User类，User类有一个类型为List的属性courses。当我们需要显示该User的courses时，可以使用checkbox标签来绑定coueses数据进行显示。当checkbox标签的value属性在我们绑定的列表数据中存在时checkbox将为选中状态。

P71 checkboxes标签

Spring MVC的checkboxes标签会被渲染为多个类型为checkbox的普通HTML input标签。

Spring MVC的checkboxes标签的常用属性

属性	描述
cssClass	定义要应用到被渲染的checkbox元素CSS类
cssStyle	定义要应用到被渲染的checkbox元素CSS样式
cssErrorClass	定义要应用到被渲染的checkbox元素CSS类，如果bound属性中包含错误，则覆盖cssClass属性
htmlEscape	boolean值，表示被渲染的值是否应该进行HTML转义
path	要绑定的属性路径
items	用于生成checkbox元素的对象的Collection、Map或者Array
itemLabel	item属性中定义的Collection、Map或者Array中的对象属性，为每个checkbox元素提供label
itemValue	item属性中定义的Collection、Map或者Array中的对象属性，为每个checkbox元素提供值
delimiter	定义两个input元素之间的分隔符，默认没有分隔符

相对于一个checkbox标签中只能生成一个对应的复选框而言，一个checkboxes标签将根据其绑定的数据生成多个复选框。checkboxes绑定的数据可以是数组、集合和Map。在使用checkboxes标签是有两个属性是必须指定的，一个是path，另一个是items。items表示当前用来显示的项有哪些，而path所绑定的表单对象的属性表示当前表单对象拥有的项，即在items所显示的所有项中表单对象拥有的项会被设定为选中状态。 

P76 radiobutton标签

Spring MVC的radiobutton标签会被渲染为一个类型为radio的普通HTML input标签。

Spring MVC的radiobutton标签的常用属性

属性	标签
cssClass	定义要应用到被渲染的radiobutton元素CSS类
cssStyle	定义要应用到被渲染的radiobutton元素CSS样式
cssErrorClass	定义要应用到被渲染的radiobutton元素CSS类，如果bound属性中包含错误，则覆盖cssClass属性
htmlEscape	boolean值，表示被渲染的值是否应该进行HTML转义
path	要绑定的属性路径
label	要作为label被渲染的复选框的值

P77 radiobuttons标签

Spring MVC的radiobuttons标签会被渲染为多个类型为radio的普通HTML input标签。

Spring MVC的radiobuttons标签的常用属性

属性	描述
cssClass	定义要应用到被渲染的radiobutton元素CSS类
cssStyle	定义要应用到被渲染的radiobutton元素CSS样式
cssErrorClass	定义要应用到被渲染的radiobutton元素CSS类，如果bound属性中包含错误，则覆盖cssClass属性
htmlEscape	boolean值，表示被渲染的值是否应该进行HTML转义
path	要绑定的属性路径
items	用于生成radio元素的对象的Collection、Map或者Array
itemLabel	item属性中定义的Collection、Map或者Array中的对象属性，为每个radio元素提供label
itemValue	item属性中定义的Collection、Map或者Array中的对象属性，为每个radio元素提供值
delimiter	定义两个input元素之间的分隔符，默认没有分隔符

相对于一个radiobutton标签只能生成一个对应的单选框，一个radiobuttons标签将根据其绑定的数据生成多个单选框。radiobuttons绑定的数据可以是数组、集合和Map。在使用radiobuttons时有两个属性是必须绑定的，一个是path，另一个是items。items表示当前要用来显示的项有哪些，而path绑定的表单对象的属性表示当前表单对象拥有的项，即在items所显示的所有项中表单对象拥有的项会被设定为选中状态。

P79 select标签

Spring MVC的select标签会渲染为一个HTML的select元素。被渲染元素的选项可能来自其items属性的一个Collection、Map及Array，或者来自一个嵌套的option或者options标签。

Spring MVC的select标签的常用属性

属性	描述
cssClass	定义要应用到被渲染的select元素CSS类
cssStyle	定义要应用到被渲染的select元素CSS样式
cssErrorClass	定义要应用到被渲染的select元素CSS类，如果bound属性中包含错误，则覆盖cssClass属性
htmlEscape	boolean值，表示被渲染的值是否应该进行HTML转义
path	要绑定的属性路径
items	用于生成radio元素的对象的Collection、Map或者Array
itemLabel	item属性中定义的Collection、Map或者Array中的对象属性，为每个radio元素提供label
itemValue	item属性中定义的Collection、Map或者Array中的对象属性，为每个radio元素提供值

其中，items属性特别有用，因为它可以绑定到对象的Collection、Map、Array，为select元素生成选项

P79 option标签

Spring MVC的option标签会渲染select元素中使用的一个HTML的option元素。

Spring MVC的option标签的常用属性

属性	描述
cssClass	定义要应用到被渲染的option元素CSS类
cssStyle	定义要应用到被渲染的option元素CSS样式
cssErrorClass	定义要应用到被渲染的option元素CSS类，如果bound属性中包含错误，则覆盖cssClass属性
htmlEscape	boolean值，表示被渲染的值是否应该进行HTML转义

P79 options标签

Spring MVC的options标签会渲染select元素中使用的一个HTML的option元素列表。

Spring MVC的options标签的常用属性

属性	描述
cssClass	定义要应用到被渲染的option元素CSS类
cssStyle	定义要应用到被渲染的option元素CSS样式
cssErrorClass	定义要应用到被渲染的option元素CSS类，如果bound属性中包含错误，则覆盖cssClass属性
htmlEscape	boolean值，表示被渲染的值是否应该进行HTML转义
items	用于生成radio元素的对象的Collection、Map或者Array
itemLabel	item属性中定义的Collection、Map或者Array中的对象属性，为每个radio元素提供label
itemValue	item属性中定义的Collection、Map或者Array中的对象属性，为每个radio元素提供值

P83 errors标签

Spring MVC的errors标签是对应于Spring MVC的Errors对象的，它的作用就是用于显示Errors对象中包含的错误信息。如果Errors不为null，则会渲染一个HTML的span元素，用来显示错误信息。

Spring MVC的errors标签的常用属性

属性	描述
cssClass	定义要应用到被渲染的errors元素CSS类
cssStyle	定义要应用到被渲染的errors元素CSS样式
htmlEscape	boolean值，表示被渲染的值是否应该进行HTML转义
delimiter	定义两个input元素之间的分隔符，默认没有分隔符
path	要绑定的属性路径

利用errors标签来显示Errors的时候，是通过errors标签的path属性来绑定一个错误信息。可以通过path属性来显示两种类型的错误信息。

• 所有的错误信息，这个时候path的值应该置为“*”。
• 当前对象的某一个属性的错误信息，这个时候的值应为所需显示的属性的名称。

2018.8.5

 光るなら—Goose house

若能绽放光芒。