SpringMVC form标签

桃扇骨 2022-08-02 02:22 168阅读 0赞

本篇我们来学习Spring MVC表单标签的使用，借助于Spring MVC提供的表单标签可以让我们在视图上展示WebModel中的数据更加轻松。

一.首先我们先做一个简单了例子来对Spring MVC表单表单标签的使用有一个大致的印象，然后再结合例子对各个标签介绍一下如何使用。

1.首先，在com.demo.web.models包中添加一个模型TagsModel内容如下：

![复制代码][copycode.gif]

package com.demo.web.models;
    
    import java.util.List;
    import java.util.Map;
    
    public class TagsModel{
        
        private String username;
        private String password;
        private boolean testBoolean;
        private String[] selectArray;
        private String[] testArray;
        private Integer radiobuttonId;
        private Integer selectId;
        private List<Integer> selectIds;    
        private Map<Integer,String> testMap;
        private String remark;
        
        public void setUsername(String username){
            this.username=username;
        }
        public void setPassword(String password){
            this.password=password;
        }
        public void setTestBoolean(boolean testBoolean){
            this.testBoolean=testBoolean;
        }
        public void setSelectArray(String[] selectArray){
            this.selectArray=selectArray;
        }
        public void setTestArray(String[] testArray){
            this.testArray=testArray;
        }
        public void setRadiobuttonId(Integer radiobuttonId){
            this.radiobuttonId=radiobuttonId;
        }
        public void setSelectId(Integer selectId){
            this.selectId=selectId;
        }
        public void setSelectIds(List<Integer> selectIds){
            this.selectIds=selectIds;
        }
        public void setTestMap(Map<Integer,String> testMap){
            this.testMap=testMap;
        }
        public void setRemark(String remark){
            this.remark=remark;
        }
        
        public String getUsername(){
            return this.username;
        }
        public String getPassword(){
            return this.password;
        }
        public boolean getTestBoolean(){
            return this.testBoolean;
        }
        public String[] getSelectArray(){
            return this.selectArray;
        }
        public String[] getTestArray(){
            return this.testArray;
        }
        public Integer getRadiobuttonId(){
            return this.radiobuttonId;
        }
        public Integer getSelectId(){
            return this.selectId;
        }
        public List<Integer> getSelectIds(){
            return this.selectIds;
        }
        public Map<Integer,String> getTestMap(){
            return this.testMap;
        }
        public String getRemark(){
            return this.remark;
        }
        
    }

![复制代码][copycode.gif]

2.其次，在包com.demo.web.controllers添加一个TagsController内容如下：

![复制代码][copycode.gif]

package com.demo.web.controllers;
    
    import java.util.Arrays;
    import java.util.HashMap;
    import java.util.Map;
    import org.springframework.stereotype.Controller;
    import org.springframework.ui.Model;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RequestMethod;
    import com.demo.web.models.TagsModel;
    
    @Controller
    @RequestMapping(value = "/tags")
    public class TagsController {
        
        @RequestMapping(value="/test", method = {RequestMethod.GET})
        public String test(Model model){
    
            if(!model.containsAttribute("contentModel")){        
                
                TagsModel tagsModel=new TagsModel();
                
                tagsModel.setUsername("aaa");
                tagsModel.setPassword("bbb");
                tagsModel.setTestBoolean(true);
                tagsModel.setSelectArray(new String[] {"arrayItem 路人甲"});
                tagsModel.setTestArray(new String[] {"arrayItem 路人甲","arrayItem 路人乙","arrayItem 路人丙"});
                tagsModel.setRadiobuttonId(1);
                tagsModel.setSelectId(2);
                tagsModel.setSelectIds(Arrays.asList(1,2));
                Map<Integer,String> map=new HashMap<Integer,String>();
                map.put(1, "mapItem 路人甲");
                map.put(2, "mapItem 路人乙");
                map.put(3, "mapItem 路人丙");
                tagsModel.setTestMap(map);
                tagsModel.setRemark("备注...");
                
                model.addAttribute("contentModel", tagsModel);
            }
            return "tagstest";
        }
        
    }

![复制代码][copycode.gif]

3.最后，在views文件夹下添加视图tagstest.jsp内容如下：

![复制代码][copycode.gif]

<%@ page language="java" contentType="text/html; charset=UTF-8"
        pageEncoding="UTF-8"%>
    <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
    
    <%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %>
    
    <html>
    <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    <title>Insert title here</title>
    </head>
    <body>
        <form:form modelAttribute="contentModel" method="post">     
            
            input 标签：<form:input path="username"/><br/>
            password 标签：<form:password path="password"/><br/>
            绑定boolean的checkbox 标签：<br/>
            <form:checkbox path="testBoolean"/><br/>
            绑定Array的checkbox 标签：<br/>
            <form:checkbox path="testArray" value="arrayItem 路人甲"/>arrayItem 路人甲
            <form:checkbox path="testArray" value="arrayItem 路人乙"/>arrayItem 路人乙
            <form:checkbox path="testArray" value="arrayItem 路人丙"/>arrayItem 路人丙
            <form:checkbox path="testArray" value="arrayItem 路人丁"/>arrayItem 路人丁<br/>
            绑定Array的checkboxs 标签：<br/>
            <form:checkboxes path="selectArray" items="${contentModel.testArray}"/><br/>
            绑定Map的checkboxs 标签：<br/>
            <form:checkboxes path="selectIds" items="${contentModel.testMap}"/><br/>
            绑定Integer的radiobutton 标签：<br/>
            <form:radiobutton path="radiobuttonId" value="0"/>0
            <form:radiobutton path="radiobuttonId" value="1"/>1
            <form:radiobutton path="radiobuttonId" value="2"/>2<br/>
            绑定Map的radiobuttons 标签：<br/>
            <form:radiobuttons path="selectId" items="${contentModel.testMap}"/><br/>
            绑定Map的select 标签：<br/>
            <form:select path="selectId" items="${contentModel.testMap}"/><br/>
            不绑定items数据直接在form:option添加的select 标签：<br/>
            <form:select path="selectId">  
               <option>请选择人员</option>
               <form:option value="1">路人甲</form:option>
               <form:option value="2">路人乙</form:option>
               <form:option value="3">路人丙</form:option>
            </form:select><br/>
            不绑定items数据直接在html的option添加的select 标签：<br/>
            <form:select path="selectId">  
               <option>请选择人员</option> 
               <option value="1">路人甲</option>
               <option value="2">路人乙</option>
               <option value="3">路人丙</option>  
            </form:select><br/>
            用form:option绑定items的select 标签：<br/>
            <form:select path="selectId">  
                <option/>请选择人员
                <form:options items="${contentModel.testMap}"/>  
            </form:select><br/>
            textarea 标签：
            <form:textarea path="remark"/><br/>
    
            <input type="submit" value="Submit" />
            
        </form:form>  
    </body>
    </html>

![复制代码][copycode.gif]

4.运行测试：

[![1][]][1 1]

二.下面我们来介绍各个标签的使用方法。   
1.要使用Spring MVC提供的表单标签，首先需要在视图页面添加：

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

2.form标签：

<form:form modelAttribute="contentModel" method="post">

modelAttribute属性指定该form绑定的是哪个Model，当指定了对应的Model后就可以在form标签内部其它表单标签上通过为path指定Model属性的名称来绑定Model中的数据了，method属性指定form的提交方式如GET、POST等。

3.input标签：

<form:input path="username"/>

会生成一个type为text的Html input标签，通过path属性来指定要绑定的Model中的值。

4.password标签：

<form:password path="password"/>

会生成一个type为password的Html input标签，通过path属性来指定要绑定的Model中的值。

5.checkbox标签：

会生成一个type为checkbox的Html input标签，支持绑定boolean、数组、List或Set类型的数据。

绑定boolean数据会生成一个复选框，当boolean为true该复选框为选定状态，false为不选定状态。

<form:checkbox path="testBoolean"/>

[![2][]][2 1]

绑定数组、List或Set类型的数据（以数组作为演示）如果绑定的数据中有对应checkbox指定的value时则为选定状态，反之为不选定状态：

绑定Array的checkbox 标签：<br/>
    <form:checkbox path="testArray" value="arrayItem 路人甲"/>arrayItem 路人甲
    <form:checkbox path="testArray" value="arrayItem 路人乙"/>arrayItem 路人乙
    <form:checkbox path="testArray" value="arrayItem 路人丙"/>arrayItem 路人丙
    <form:checkbox path="testArray" value="arrayItem 路人丁"/>arrayItem 路人丁

[![3][]][3 1]

6.checkboxs标签：

会根据绑定的items数据生成一组对应的type为checkbox的Html input标签，绑定的数据可以是数组、集合或Map，其中checkboxs的path属性也必指定，当path中的数据有和items中的数据值同的时候对应的checkbox为选定状态，反之为不选定状态。

绑定集合数据（以数组作为演示）：

绑定Array的checkboxs 标签：<br/>
    <form:checkboxes path="selectArray" items="${contentModel.testArray}"/>

[![4][]][4 1]

这里需要注意的是当使用EL表达式绑定时需要连Model的名称一起指定如$\{contentModel.testArray\}而不能像path一样只指定Model对应的属性名称。

但通常情况下我们需要的是checkbox显示的是名称，但选择后提交的是对应名称的值，比如id，我们就可以通过绑定Map来实现这个功能：

绑定Map的checkboxs 标签：<br/>
    <form:checkboxes path="selectIds" items="${contentModel.testMap}"/>

[![5][]][5 1]

生成的一组checkbox中其中一个checkbox的html代码：

<span><input id="selectIds1" name="selectIds" type="checkbox" value="1" checked="checked"/><label for="selectIds1">mapItem 路人甲</label></span>

7.radiobutton标签：

会生成一个type为radio的Html input标签，如果绑定的数据的值对应radiobutton指定的value时则为选定状态，反之为不选定状态：

绑定Integer的radiobutton 标签：<br/>
    <form:radiobutton path="radiobuttonId" value="0"/>0
    <form:radiobutton path="radiobuttonId" value="1"/>1
    <form:radiobutton path="radiobuttonId" value="2"/>2

[![6][]][6 1]

8.radiobuttons标签：

会根据绑定的items数据生成一组对应的type为radio的Html input标签，绑定的items数据可以是数组、集合或Map，其中radiobuttons的path属性也必指定，当path的值和items中的某条数据值相同的时候对应的radio为选定状态，反之为不选定状态，用法和checkboxs很相似。但要注意的是：checkboxs的path绑定的是集合radiobuttons的path绑定的是单个值：

绑定Map的radiobuttons 标签：<br/>
    <form:radiobuttons path="selectId" items="${contentModel.testMap}"/>

[![7][]][7 1]

9.select标签：

会生成一个Html select标签，绑定的items数据可以是数组、集合或Map会根据items的内容生成select里面的option选项，当path的值和items中的某条数据值相同的时候对应的option为选定状态，反之为不选定状态，用法与radiobuttons很相似：

绑定Map的select 标签：<br/>
    <form:select path="selectId" items="${contentModel.testMap}"/>

[![8][]][8 1]

上面的是根据指定的items自动生成的option选项，但我们也可以不指定items手动添加select的option选项：

![复制代码][copycode.gif]

[![9][]][9 1]

其中添加<option>请选择人员</option> 可以让在没有进行选择的情况下不指定任何默认值。

下面看一下form:option 与option的区别：

![复制代码][copycode.gif]

不绑定items数据直接在form:option添加的select 标签：<br/>
    <form:select path="selectId">  
       <option>请选择人员</option>
       <form:option value="1">路人甲</form:option>
       <form:option value="2">路人乙</form:option>
       <form:option value="3">路人丙</form:option>
    </form:select><br/>
    不绑定items数据直接在html的option添加的select 标签：<br/>
    <form:select path="selectId">  
       <option>请选择人员</option> 
       <option value="1">路人甲</option>
       <option value="2">路人乙</option>
       <option value="3">路人丙</option>  
    </form:select><br/>

![复制代码][copycode.gif]

[![10][]][10 1]

由截图的结果可以看出form:option 正确选择了path中指定的selectId而option没有，说明form:option有数据绑定功能option没有。

另外我们也可以不为select指定items，而把items指定到form:option 上这两种效果基本是一样的，一点区别就是为select指定items再在select里面添加option是不起作用的会被items生成的option覆盖掉，而把items指定到form:option 上则可以再在select里面添加option：

用form:option绑定items的select 标签：<br/>
    <form:select path="selectId">  
        <option/>请选择人员
        <form:options items="${contentModel.testMap}"/>  
    </form:select>

[![11][]][11 1]

10.textarea标签：

textarea 标签：
    <form:textarea path="remark"/>

[![12][]][12 1]

会生成一个Html textarea标签，通过path属性来指定要绑定的Model中的值。

11.errors标签：用于表单验证中提示错误信息

<form:errors path="\*"></form:errors>  显示所有字段的错误信息

<form:errors path="name"></form:errors>显示name字段的错误信息

[copycode.gif]: /images/20220731/ca87ff4aeb5842819900a952e168dd80.png
[1]: /images/20220731/1ef47427caed436facef6168302d01e2.png
[1 1]: http://images.cnitblog.com/blog/205051/201405/262359496667143.jpg
[2]: /images/20220731/cbd32a32dd54439f875ff5e37aa3b3aa.png
[2 1]: http://images.cnitblog.com/blog/205051/201405/262359505096486.jpg
[3]: /images/20220731/8c18ad17217b41b4b2e02003c1764cc3.png
[3 1]: http://images.cnitblog.com/blog/205051/201405/262359509167428.jpg
[4]: /images/20220731/eafb11ab08a64ab78aa53e7e76033b96.png
[4 1]: http://images.cnitblog.com/blog/205051/201405/262359513531127.jpg
[5]: /images/20220731/bf862d39343d40cca33c271c9b34349d.png
[5 1]: http://images.cnitblog.com/blog/205051/201405/262359528061883.jpg
[6]: /images/20220731/1d5fbc442f574d6aad4de8fba10db8f3.png
[6 1]: http://images.cnitblog.com/blog/205051/201405/262359531974298.jpg
[7]: /images/20220731/a0606bb5479e44c8ae305c9883c9db72.png
[7 1]: http://images.cnitblog.com/blog/205051/201405/262359535723483.jpg
[8]: /images/20220731/eafe15342ba74fa589629cf8f5808823.png
[8 1]: http://images.cnitblog.com/blog/205051/201405/262359539318439.jpg
[9]: /images/20220731/0306ee76cd60440f953c4008d6f4e493.png
[9 1]: http://images.cnitblog.com/blog/205051/201405/262359544008596.jpg
[10]: /images/20220731/2534026a93874b2fb94e508c06f6ddf6.png
[10 1]: http://images.cnitblog.com/blog/205051/201405/262359560099539.jpg
[11]: /images/20220731/8cb58c8f7c8644b79ada65f2cc71ca34.png
[11 1]: http://images.cnitblog.com/blog/205051/201405/262359563848724.jpg
[12]: /images/20220731/8b11ac8fa2114c059d4b29c02136bff3.png
[12 1]: http://images.cnitblog.com/blog/205051/201405/262359567919666.jpg