概述

表单标签库中包含了可以用在JSP页面中渲染HTML元素的标签。

JSP页面中使用Spring表单标签库时，必须在JSP页面开头处声明taglib指令：

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

在表单标签库中有form、input、password、hidden、textarea、checkbox、checkboxes、
radiobutton、Iradiobuttons、select、option、options、errors等标签。

常用标签

表单标签

语法：

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

    </form:form>

表单标签除了具有HTML表单元素属性以外,还具有acceptCharset、commandName、
cssSClass、cssStyle、htmlEscape和modelAttribute等属性。

acceptCharset:定义服务器接受的字符编码列表。
commandName:暴露表单对象的模型属性名称,默认为command。
cssClass:定义应用到form元素的CSS类。
cssStyle:定义应用到form元素的CSS样式。
htmlEscape:true或false,表示是否进行HTML转义。
modelAttribute:暴露form backing object的模型属性名称,默认为command。

其中，commandName和modelAttribute属性的功能基本一致，属性值绑定一个JavaBean对象。

input标签

语法：

<form:input path="xxx"/>

该标签有cssClass、cssStyle、htmlEscape及path属性。

path属性将文本框输入值绑定到form backing object上。

password标签

语法：

<form:password path="xxx"/>

hidden标签

语法：

<form:hidden path="xxx"/>

表示隐藏的元素，故不支持cssClass和cssStyle属性。

textarea标签

语法：

<form:textarea path="xxx"/>

checkbox标签

语法：

<form:checkbox path="xxx" value="xxx"/>

多个path相同的checkbox标签，它们是一个选项组，允许多选，选项值绑定到一个数组属性。

例：

    <form:checkbox path="language" value="汉语"/>汉语
    <form:checkbox path="language" value="英语"/>英语
    <form:checkbox path="language" value="俄语"/>俄语
    <form:checkbox path="language" value="拉丁语"/>拉丁语
    <form:checkbox path="language" value="法语"/>法语

checkboxes标签

与多个path相同的checkbox标签功能相同。

三个重要属性：

items:用于生成input元素的Collection、Map或Array。
itemLabel:items属性中指定的集合对象的属性,为每个input元素提供label。
itemValue:items属性中指定的集合对象的属性,为每个input元素提供value。

语法：

<form:checkboxes items="xxx" path="xxx"/>

radiobutton标签

语法：

<form:radiobutton path="xxx" value="xxx"/>

多个path相同的radiobutton标签是一个选项组，只支持单选。

radiobuttons标签

语法：

<form:radiobuttons path="xxx" items="xxx"/>

等价于多个path形同的radiobutton标签，也只支持单选。

select标签

语法：

<form:select path="xxx" items="xxx"/>

或

<form:select path="xxx" items="xxx">
    <option value="xxx">xxx</option>
</form:select>

或

<form:select path="xxx">
    <form:options items="xxx"/>
</form:select>

select标签的选项来自属性items指定集合或者嵌套的option标签或options标签。

options标签

和select标签嵌套使用。

errors标签

渲染一个或者多个的span元素，每个span元素包含一个错误消息。

显示所有错误消息的语法：

<form:errors path="*"/>

显示特定的错误消息的语法：

<form:errors path="xxx"/>

实例

本项目要用到的jar包：

SpringMVC（9）——表单标签库

创建springmvc项目并按照下图创建文件及文件夹：

SpringMVC（9）——表单标签库

各文件代码如下：

StudentController.java

package springmvcdemo.controller;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.RequestMapping;
import springmvcdemo.pojo.Student;
import springmvcdemo.service.StudentService;

import java.util.ArrayList;
import java.util.HashMap;

@Controller
@RequestMapping("/student")
public class StudentController {
    @Autowired
    private StudentService studentService;

    @RequestMapping("input")
    public String inputUser(Model model) {
        HashMap<java.lang.String, java.lang.String> hobbys = new HashMap<>();
        hobbys.put("阅读", "阅读");
        hobbys.put("运动", "运动");
        hobbys.put("游戏", "游戏");
        hobbys.put("旅行", "旅行");
        model.addAttribute("student", new Student());
        model.addAttribute("hobbys", hobbys);
        model.addAttribute("studentClass", new java.lang.String[]{"高三1班", "高三2班", "高三3班"});
        return "studentAdd";
    }

    @RequestMapping("/addStudent")
    public String addStudent(@ModelAttribute Student student, Model model) {
        if (studentService.addStudent(student)) {
            System.out.println("添加成功");
            return "redirect:/student/studentsList";
        } else {
            System.out.println("添加失败");
            HashMap<java.lang.String, java.lang.String> hobbys = new HashMap<>();
            hobbys.put("阅读", "阅读");
            hobbys.put("运动", "运动");
            hobbys.put("游戏", "游戏");
            hobbys.put("旅行", "旅行");
            // 不需要model.addAttribute()，因为@ModelAttribute指定了form backing object
//            model.addAttribute("student",new Student());
            model.addAttribute("hobbys", hobbys);
            model.addAttribute("studentClass", new java.lang.String[]{"高三1班", "高三2班", "高三3班"});
            return "studentAdd";
        }
    }

    @RequestMapping("studentsList")
    public String studentsList(Model model) {
        ArrayList<Student> students = studentService.getStudents();
        model.addAttribute("students", students);
        return "studentsList";
    }

}

Student.java

package springmvcdemo.pojo;

public class Student {
    private String name;
    private String sex;
    private String[] hobby;
    private String studentClass;
    private String memo;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getSex() {
        return sex;
    }

    public void setSex(String sex) {
        this.sex = sex;
    }

    public String[] getHobby() {
        return hobby;
    }

    public void setHobby(String[] hobby) {
        this.hobby = hobby;
    }

    public String getStudentClass() {
        return studentClass;
    }

    public void setStudentClass(String studentClass) {
        this.studentClass = studentClass;
    }

    public String getMemo() {
        return memo;
    }

    public void setMemo(String memo) {
        this.memo = memo;
    }
}

StudentService.java

package springmvcdemo.service;

import springmvcdemo.pojo.Student;

import java.util.ArrayList;

public interface StudentService {
    /**
     * 添加学生
     *
     * @param student 学生
     * @return 返回是否添加成功，如果是true则添加成功，false表示没有添加成功
     */
    boolean addStudent(Student student);

    /**
     * 获取学生
     *
     * @return 返回学生集
     */
    ArrayList<Student> getStudents();
}

StudentServiceImpl.java

package springmvcdemo.service;

import org.springframework.stereotype.Service;
import springmvcdemo.pojo.Student;

import java.util.ArrayList;

@Service
public class StudentServiceImpl implements StudentService{
    private static ArrayList<Student> students=new ArrayList<>();

    @Override
    public boolean addStudent(Student student) {
        if (!"张三".equals(student.getName())) {
            students.add(student);
            return true;
        }
        return false;
    }

    @Override
    public ArrayList<Student> getStudents() {
        return students;
    }
}

springmvc-servlet.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
               http://www.springframework.org/schema/beans/spring-beans.xsd
               http://www.springframework.org/schema/context
               http://www.springframework.org/schema/context/spring-context.xsd">

    <!--使用扫描机制扫描控制器类，控制器类都在controller包及其子包下-->
    <context:component-scan base-package="springmvcdemo.controller"/>

    <!--使用扫描机制扫描服务类，服务类都在service包及其子包下-->
    <context:component-scan base-package="springmvcdemo.service"/>

    <!--配置视图解析器-->
    <!--配置视图解析器成功后，RegisterController和LoginController控制器类的视图路径仅需提供register和login，视图解析器将会自动添加前缀和后缀-->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver" id="internalResourceViewResolver">
        <!--前缀-->
        <property name="prefix" value="/WEB-INF/jsp/"/>
        <!--后缀-->
        <property name="suffix" value=".jsp"/>
    </bean>

</beans>

studentAdd.jsp

<%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>添加学生</title>
</head>
<body>
    <form:form modelAttribute="student" method="post" action="/student/addStudent">
        姓名：<form:input path="name"/><br>
        性别：<form:radiobutton path="sex" value="男"/>男
              <form:radiobutton path="sex" value="女"/>女<br/>
        爱好：<form:checkboxes path="hobby" items="${hobbys}"/><br/>
        班级：<form:select path="studentClass">
                <form:option value="请选择班级">请选择班级</form:option>
                <form:options items="${studentClass}"/>
              </form:select><br/>
        备注：<form:textarea path="memo" rows="5"/><br/>
        <input type="reset" id="reset">
        <input type="submit" id="submit" value="添加学生">
    </form:form>
</body>
</html>

studentList.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<html>
<head>
    <title>学生列表</title>
</head>
<body>
    <h1>学生列表</h1><br>
    <a href="/student/input">继续添加</a>
    <table>
        <tr>
            <th>姓名</th>
            <th>性别</th>
            <th>爱好</th>
            <th>班级</th>
            <th>备注</th>
        </tr>
        <c:forEach items="${students}" var="student">
            <tr>
                <td>${student.name}</td>
                <td>${student.sex}</td>
                <td>
                    <c:forEach items="${student.hobby}" var="hobby">
                        ${hobby}&nbsp;
                    </c:forEach>
                </td>
                <td>${student.studentClass}</td>
                <td>${student.memo}</td>
            </tr>
        </c:forEach>
    </table>
</body>
</html>

web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">
    <!--部署DispatcherServlet-->
    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!--加载Spring MVC的配置文件，配置文件可以放在项目目录的任意位置，使用init-param元素加载配置文件-->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <!--配置文件的位置-->
            <param-value>/WEB-INF/config/springmvc-config/springmvc-servlet.xml</param-value>
        </init-param>
        <!--表示容器在启动时立即加载servlet-->
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <!--处理所有URL-->
        <url-pattern>/</url-pattern>
    </servlet-mapping>
    <!--避免中文乱码-->
    <filter>
        <filter-name>characterEncodingFilter</filter-name>
        <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
        <init-param>
            <param-name>encoding</param-name>
            <param-value>UTF-8</param-value>
        </init-param>
        <init-param>
            <param-name>forceEncoding</param-name>
            <param-value>true</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>characterEncodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>
</web-app>

运行效果

SpringMVC（9）——表单标签库

点击【添加学生】按钮

SpringMVC（9）——表单标签库

点击【继续添加】超链接即可继续添加。

如果添加失败，表单中的信息也不会消失。（例如添加姓名为张三的学生）

这是数据绑定的自动回填（但必须结合form标签）。

SpringMVC（9）——表单标签库

智算服务

应用商城

合作伙伴

开发者

支持与服务

了解天翼云

SpringMVC（9）——表单标签库

SpringMVC（9）——表单标签库

概述

常用标签

表单标签

input标签

password标签

hidden标签

textarea标签

checkbox标签

checkboxes标签

radiobutton标签

radiobuttons标签

select标签

options标签

errors标签

实例

运行效果

相关文章

Java学习路线-54： JSTL（标准标签库）

21.jsp指令

作者介绍

最新文章

Java学习路线-54： JSTL（标准标签库）

热门文章

Java学习路线-54： JSTL（标准标签库）

热门标签

相关产品

弹性云主机

天翼云电脑（公众版）

对象存储

云硬盘

随机文章

Java学习路线-54： JSTL（标准标签库）

活动

智算服务

应用商城

合作伙伴

开发者

支持与服务

了解天翼云

SpringMVC（9）——表单标签库

SpringMVC（9）——表单标签库

概述

常用标签

表单标签

input标签

password标签

hidden标签

textarea标签

checkbox标签

checkboxes标签

radiobutton标签

radiobuttons标签

select标签

options标签

errors标签

实例

运行效果

相关文章

Java学习路线-54： JSTL（标准标签库）

21.jsp指令

作者介绍

最新文章

Java学习路线-54： JSTL（标准标签库）

热门文章

Java学习路线-54： JSTL（标准标签库）

热门标签

相关产品

弹性云主机

天翼云电脑（公众版）

对象存储

云硬盘

随机文章

Java学习路线-54： JSTL（标准标签库）