Spring表单标签

Posted 2020-10-22 OverZeal

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Spring表单标签相关的知识，希望对你有一定的参考价值。

虽然我们可以使用html原生的form表单标签来轻松的写出一个表单，其实我一直都是这样做的，但是使用Spring表单标签可以更方便我们完成例如：验证失败后表单数据的回填功能（虽然你可以使用EL+JSTL来实现），但是使用spring表单标签更为方便。

如同使用JSTL一样，我们需要先在JSP页面中使用taglib指令导入：

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

表单标签库中的标签：

标签	描述
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="radio">
radiobuttons	渲染多个<input type="radio">
select	渲染一个select元素
option	渲染一个可选元素
errors	在span元素中渲染字段错误

表单标签

表单标签用于渲染HTML表单，要使用渲染一个表单输入字段的任何其他标签，必须有一个form标签。

commandName属性或许是其中最为重要的属性，因为它定义了模型属性的名称，该值要求与返回该表单视图的请求处理方法中模型名一致。commandName==模型名，建议这个属性为必填属性

<form:form commandName="book" action="save-book" method="post">
...
</form>

这个commandName为book，是与请求“save-book”对应的请求方法中模型数据名一样的，也就是说需要在请求方法中将数据模型添加到Model对象中，model.addAttribute("book",new Book()),如果不这样做，页面就会抛出异常。

表单标签的属性：

属性	描述
acceptCharset	定义服务器接受的字符编码列表
commandName	暴露表单对象的模型数据名，默认名为command
cssClass	定义要应用到被渲染form元素的CSS类
cssStyle	定义要应用到被渲染form元素的CSS样式
htmlEscape	接受true/false，表示被渲染的值是否进行HTML转义
modelAttribute	暴露表单对象的模型数据名，默认名为command

一般来说，仍是需要action和method属性，因为这两个属性是HTML属性，还是必须的。

input标签

input标签渲染<input type="text">元素，这个标签最重要的是path，它将这个输入字段绑定到表单对象的一个属性，类似HTML表单的name值。

input标签的属性：

属性	描述
cssClass	定义要应用到被渲染input元素的CSS类
cssStyle	定义要应用到被渲染input元素的CSS样式
cssErrorClass	定义要应用到被渲染input元素的CSS类，如果bound属性中包含错误，则会覆盖cssClass属性值
htmlEscape	接受true/false ，表示是否应该对渲染的值进行HTML转义
path	要绑定的属性名，作用与HTML中的name值一致

input标签也支持绑定到嵌套对象的属性（支持属性的属性，这种级联的属性名），如：

<form:input path="category.id"/>

password标签

password标签渲染<input type="password"/>元素，password标签与input标签类似，只不过有一个showPassword属性：

属性	描述
cssClass	定义要应用到被渲染input元素的CSS类
cssStyle	定义要应用到被渲染input元素的CSS样式
cssErrorClass	定义要应用到被渲染input元素的CSS类，如果bound属性中包含错误，则会覆盖cssClass属性值
htmlEscape	接受true/false ，表示是否应该对渲染的值进行HTML转义
path	要绑定的属性名，作用与HTML中的name值一致
showPassword	表示是否应该显示密码，默认为false

hidden标签

hidden标签渲染<input type="hidden"/>元素，hidden标签，hidden标签与input标签相似，只不过它没有可视的外观，以此不支持cssClass和cssStyle属性

属性	描述
htmlEscape	接受true/false ，表示是否应该对渲染的值进行HTML转义
path	要绑定的属性名，作用与HTML中的name值一致

textarea 标签

textarea标签渲染一个HTML的textarea元素，Textarea实际就是一个支持多行输入的一个input元素

属性值同input类似，我们还可以通过rows(行)，cols(列)设置textarea的大小：

<form:textarea path=""note" rows="5" cols="80"/>

checkbox标签 checkboxs标签 radioButton标签 radioButtons标签

这些标签的属性都与input类似，path属性较为重要，但是后面带s的复数形式是有些区别的：

带s多个标签的特有的属性：

属性	标签
items	用于生成Collection，Map或者Array数据
itemLabel	item属性中定义的Collection，Map或者Array中对象属性，为每个输入项提供标签名
iteamsValue	item属性中定义的Collection，Map或者Array中对象属性，为每个输入项提供值
delimiter	定义两个input元素之间的分隔符，默认没有分隔符
element	给每个被渲染的input元素都定义一个HTML元素，默认为“span”

例如：


<form:checkbox path="outOfStock" value="Out of Stock">

<form:checkboxs path="category" items="${categoryList}">

Computing Now <form:radiobutton path="newsletter" value="Computing Now"/>
Modern Health<form:radiobutton path="mewsletter" value="Modern Health">

<form:radiobuttons path="category" items="${categoryList}"/>

select和option标签，options标签

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

属性值同上checkboxbutton/radiobutton一样。items对于select或后面加s的标签特别有用，因为它可以绑定带对象的Collection，Map，Array，为select元素生成选项（option）

<form:select id="category" path="category.id" items="${categories}" itemLabel="name" itemValue="id">

id和name都是categories集合中没有category对象的属性

<form:select id="category" path="category.id" items="${categories}" itemLabel="name" itemValue="id">
      <option value="0">--Please select--</option>
</form:select>

这个代码片段是渲染一个select元素，其选项来自model属性catagories，以及option标签。

同其他后缀为s的标签一样，options标签用于生成多个option元素列表

errors标签

errors标签用于渲染一个或多个span元素，每个span元素中都包括一个字段错误信息。这个标签用于显示一个特定的字段错误，或者所有的字段错误

下面这个erros标签将显示所有错误（所有绑定在BindingResult中的错误）

<form:errors path="*"/>

下面这个errors标签显示了一个与表单支持对象的author属性相关的字段错误

<form:errors path="author"/>

使用spring表单标签的注意项

我们在写修改表单的时候还是需要来一个隐藏域保存id，这样修改的时候不至于id丢失，这个隐藏域还是需要的。
之前说个可以使用JSTL的<c:url>标签来保证url地址的正确，但是遗憾的是表单的action属性不能取<c:url/>.因此，需要创建一个变量并从action属性中引用它，如下所示：

<c:url var="url" value="/emp"></c:url>
<form:form commandName="employee" action="${url }" method="POST">

一个需求

我们不允许用户修改某些字段，但是这样从修改表单传过来的表单数据就会没有这几项，如果就这样去修改数据库，这几项的数据就会被置空，这明显不是我们想要的，我们想让这样不能修改的值保持原样，应该怎么做呢？

一个办法就是使用隐藏域，将这些不能修改的值以隐藏域方式，这些值虽然存在，但是直接从网页上是看不到的，然而聪明的用户可以从浏览器的开发者工具中找到这些隐藏项，如果这些选项敏感而又需要安全，这种做法就不太好

还有一种办法就是使用springMVC的@ModelAttribute注解修饰一个会请求的方法，在这个方法中通过id获得该对象，并将这个对象放在Model中，因为@ModelAttribute修饰的方法在每个请求方法前会被调用，所以在我们的修改update方法的形参再使用@ModelAttribute来获得这个实例，springMVC在获得表单输入的数据进行封装时，会将你修改的字段封装，所以也不用担心修改的字段值丢失：

    @ModelAttribute
    public void getThisBook(@RequestParam(value="id",required=false) Integer id,Model model) {
        if(id==null) {
            return;
        }
        model.addAttribute(bookService.get(id));
    }
    @RequestMapping("/update-book")
    public String updateBook(@ModelAttribute Book book) {
        System.out.println(book.getCategory().getId());
        System.out.println(bookService.getCategory(book.getCategory().getId()));
        Category category=bookService.getCategory(book.getCategory().getId());
        book.setCategory(category);
        bookService.update(book);
        return "redirect:/list-book";
    }

注意:因为id这个字段很重要，但是并不是每次从表单中传来的数据都有id，例如添加的时候就没有id，所以一定要设置为required=false ，要不让就会报错。而且建议使用返回为void的@ModelAttribute修饰的非请求方法，并在其中判断id是否为null