《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等。
| 属性 | 描述 |
|---|---|
| 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中的值。
| 属性 | 描述 |
|---|---|
| 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属性。
| 属性 | 描述 |
|---|---|
| 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标签相似，也能绑定表单数据，只是它生成的是一个隐藏域，没有可视的外观。
| 属性 | 描述 |
|---|---|
| htmlEscape | boolean值，表示被渲染的值是否应该进行HTML转义 |
| path | 要绑定的属性路径 |
2018.8.3
P69 textarea标签
Spring MVC的textarea标签会被渲染为一个类型为textarea的普通HTML标签。textarea是一个支持多行输入的HTML元素。
| 属性 | 描述 |
|---|---|
| cssClass | 定义要应用到被渲染的textarea元素CSS类 |
| cssStyle | 定义要应用到被渲染的textarea元素CSS样式 |
| cssErrorClass | 定义要应用到被渲染的textarea元素CSS类，如果bound属性中包含错误，则覆盖cssClass属性 |
| htmlEscape | boolean值，表示被渲染的值是否应该进行HTML转义 |
| path | 要绑定的属性路径 |
P70 checkbox标签
Spring MVC的checkbox标签会被渲染为一个类型为checkbox的普通HTML input标签。
| 属性 | 描述 |
|---|---|
| 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标签。
| 属性 | 描述 |
|---|---|
| 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标签。
| 属性 | 标签 |
|---|---|
| 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标签。
| 属性 | 描述 |
|---|---|
| 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标签。
| 属性 | 描述 |
|---|---|
| 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元素。
| 属性 | 描述 |
|---|---|
| cssClass | 定义要应用到被渲染的option元素CSS类 |
| cssStyle | 定义要应用到被渲染的option元素CSS样式 |
| cssErrorClass | 定义要应用到被渲染的option元素CSS类，如果bound属性中包含错误，则覆盖cssClass属性 |
| htmlEscape | boolean值，表示被渲染的值是否应该进行HTML转义 |
P79 options标签
Spring MVC的options标签会渲染select元素中使用的一个HTML的option元素列表。
| 属性 | 描述 |
|---|---|
| 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元素，用来显示错误信息。
| 属性 | 描述 |
|---|---|
| cssClass | 定义要应用到被渲染的errors元素CSS类 |
| cssStyle | 定义要应用到被渲染的errors元素CSS样式 |
| htmlEscape | boolean值，表示被渲染的值是否应该进行HTML转义 |
| delimiter | 定义两个input元素之间的分隔符，默认没有分隔符 |
| path | 要绑定的属性路径 |
利用errors标签来显示Errors的时候，是通过errors标签的path属性来绑定一个错误信息。可以通过path属性来显示两种类型的错误信息。
- 所有的错误信息，这个时候path的值应该置为“*”。
- 当前对象的某一个属性的错误信息，这个时候的值应为所需显示的属性的名称。
2018.8.5
光るなら—Goose house
若能绽放光芒。