ZetCode

Spring Boot 提交表单

最后修改于 2023 年 7 月 29 日

在本文中,我们将展示如何在 Spring Boot 应用程序中提交表单。

Spring 是一个流行的 Java 应用程序框架。Spring Boot 旨在以最小的努力创建独立的、生产级的基于 Spring 的应用程序。

Spring Boot 提交表单示例

以下应用程序包含一个简单的表单。来自表单的数据会自动插入到 UI Bean 中,并可用于视图。 Thymeleaf 用作视图引擎。

该应用程序仅显示发送和处理表单的简单过程。实际上,表单提交需要广泛的验证和安全检查。

build.gradle
...
src
├───main
│   ├───java
│   │   └───com
│   │       └───zetcode
│   │           │   Application.java
│   │           ├───bean
│   │           │       User.java
│   │           └───controller
│   │                   MyController.java
│   └───resources
│       └───templates
│               addUser.html
│               showMessage.html
└───test
    └───java

这是项目结构。

build.gradle
plugins {
    id 'org.springframework.boot' version '3.1.1'
    id 'io.spring.dependency-management' version '1.1.0'
    id 'java'
}

group = 'com.zetcode'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '17'

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
}

test {
    useJUnitPlatform()
}

这是 Gradle 构建文件。 spring-boot-starter-web 是使用 Spring MVC 构建 Web(包括 RESTful)应用程序的启动器。 spring-boot-starter-thymeleaf 是 Thymeleaf 引擎的启动器。

com/zetcode/bean/User.java
package com.zetcode.bean;

public class User {

    private String name;
    private String occupation;

    public String getName() {
        return name;
    }

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

    public String getOccupation() {
        return occupation;
    }

    public void setOccupation(String occupation) {
        this.occupation = occupation;
    }
}

这是 User Bean。它会自动填充来自表单请求的数据。属性必须与表单字段匹配。

com/zetcode/controller/MyController.java
package com.zetcode.controller;

import com.zetcode.bean.User;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;

@Controller
public class MyController {

    @GetMapping("/addUser")
    public String sendForm(User user) {

        return "addUser";
    }

    @PostMapping("/addUser")
    public String processForm(User user) {

        return "showMessage";
    }
}

控制器类发送和读取表单视图。

@PostMapping("/addUser")
public String processForm(User user) {

    return "showMessage";
}

User Bean 作为参数传递给 processForm 处理程序。 Spring 尝试用请求数据填充 Bean。数据也可自动用于 Thymeleaf 的 showMessage 视图。

resources/templates/addUser.html
<!DOCTYPE HTML>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>Add user</title>
    <meta charset="UTF-8">
</head>
<body>

<h1>Add User</h1>

<form action="#" th:action="@{/addUser}" th:object="${user}" method="post">
    <p>
        Name: <input type="text" th:field="*{name}">
    </p>
    <p>
        Occupation: <input type="text" th:field="*{occupation}">
    </p>
    <p>
        <input type="submit" value="Submit"/> <input type="reset" value="Reset">
    </p>
</form>

</body>
</html>

此视图包含表单。

<form action="#" th:action="@{/addUser}" th:object="${user}" method="post">

th:object 指的是 user 表单 Bean。这不是类名,而是 Spring Bean 名称;因此它是小写的。

<p>
    Name: <input type="text" th:field="*{name}">
</p>

使用 *{} 语法,我们引用了已定义的对象。

resources/templates/showMessage.html
<!DOCTYPE HTML>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>Show message</title>
    <meta charset="UTF-8">
</head>
<body>

<h1>Result</h1>

<p th:text="'Name: ' + ${user.name}"></p>
<p th:text="'Occupation: ' + ${user.occupation}"></p>
<a href="/addUser">Submit another message</a>

</body>
</html>

此模板显示在表单中输入的数据。

<p th:text="'Name: ' + ${user.name}"></p>

我们使用 ${} 语法引用表单 Bean 属性。

com/zetcode/Application.java
package com.zetcode;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;

@SpringBootApplication
public class Application extends SpringBootServletInitializer {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

`Application` 设置了 Spring Boot 应用程序。

导航到 localhost:8080/addUser 以运行该应用程序。

在本文中,我们展示了如何在 Spring Boot 应用程序中提交一个简单的表单。

作者

我的名字是 Jan Bodnar,我是一位充满激情的程序员,拥有丰富的编程经验。自 2007 年以来,我一直在撰写编程文章。迄今为止,我撰写了 1,400 多篇文章和 8 本电子书。我拥有超过十年的编程教学经验。

列出 所有 Spring Boot 教程