概述

表單標簽庫中包含了可以用在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項目并按照下圖創建文件及文件夾：

各文件代碼如下：

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>

運行效果

點擊【添加學生】按鈕

點擊【繼續添加】超鏈接即可繼續添加。

如果添加失敗，表單中的信息也不會消失。（例如添加姓名為張三的學生）

這是數據綁定的自動回填（但必須結合form標簽）。

 

如果對完整源碼有興趣。

可搜索微信公眾號【Java實例程序】或者掃描下方二維碼關注公眾號獲取更多。

注意：在公眾號后臺回復【CSDN201911160941】可獲取本節源碼。