Spring Boot 与表单处理：如何高效提交、验证和绑定表单数据？

🏆本文收录于「滚雪球学SpringBoot」专栏，手把手带你零基础入门Spring Boot，从入门到就业，助你早日登顶实现财富自由🚀；同时，欢迎大家关注&&收藏&&订阅！持续更新中，up！up！up！！

环境说明：Windows 10 + IntelliJ IDEA 2021.3.2 + Jdk 1.8

前言

在 Web 应用开发中，表单处理是最常见的需求之一。从用户注册、登录，到提交数据，我们往往需要与用户交互并处理他们提交的表单信息。Spring Boot 提供了一系列强大的功能，帮助我们更简便地实现表单数据的提交、验证与绑定。通过不同的注解，如 @ModelAttribute、@RequestParam、@RequestBody 等，我们可以灵活地处理表单数据。

今天，我们将深入探讨 Spring Boot 与表单处理，从提交表单数据到表单验证与数据绑定，每个细节都将通过实际的代码案例展示，帮助你轻松掌握这一重要技能。

📚 目录

1. 🌱 提交表单数据：如何处理用户输入？
2. 🛠 使用 @ModelAttribute、@RequestParam 和 @RequestBody 注解
3. 🔐 表单验证与数据绑定：保证数据的正确性与安全性
4. 🎉 总结与进阶：高效处理表单数据的最佳实践

🌱 提交表单数据：如何处理用户输入？ 🖊️

1. 常见的表单提交方式

在 Web 应用中，表单提交通常有两种常见的方式：

• GET 请求：用户通过 URL 查询字符串提交数据。这种方式适用于数据量小、请求不涉及敏感信息的情况。
• POST 请求：用户通过请求体提交数据，这种方式适用于数据量大或需要处理敏感信息的情况。

在 Spring Boot 中，表单的提交方式通常是 POST，因为它可以通过请求体发送大量数据（如文本、文件等），且不会暴露在 URL 中。

2. HTML 表单的基本结构

首先，我们需要定义一个简单的 HTML 表单，让用户输入数据：

<form action="/submitForm" method="POST">
    <label for="username">Username:</label>
    <input type="text" id="username" name="username">
    
    <label for="email">Email:</label>
    <input type="email" id="email" name="email">
    
    <button type="submit">Submit</button>
</form>

这个表单会收集用户的 username 和 email 数据，并通过 POST 请求提交给服务器。

🛠 使用 @ModelAttribute、@RequestParam 和 @RequestBody 注解 💡

在 Spring Boot 中，我们可以使用不同的注解来处理从表单提交的数据。根据数据的来源和绑定方式，Spring 提供了 @ModelAttribute、@RequestParam 和 @RequestBody 三种常用的注解来接收和处理数据。

1. 使用 @ModelAttribute 来绑定表单数据

@ModelAttribute 注解用于将请求中的表单数据绑定到一个 Java 对象上。它通常与 POST 请求一起使用，用来收集多个表单字段并自动填充一个对象。

示例：使用 @ModelAttribute 绑定数据

假设我们有一个 User 类，包含 username 和 email 两个字段：

public class User {
    private String username;
    private String email;

    // Getter 和 Setter 方法
    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }
}

在控制器中，我们使用 @ModelAttribute 来自动绑定表单数据：

@Controller
public class FormController {

    @PostMapping("/submitForm")
    public String handleFormSubmission(@ModelAttribute User user) {
        // 这里的 user 对象会自动填充来自表单的数据
        System.out.println("Username: " + user.getUsername());
        System.out.println("Email: " + user.getEmail());

        return "formResult";  // 返回一个视图名称
    }
}

解析：

• @ModelAttribute 会自动将表单提交的数据绑定到 User 对象的字段上。
• 在 handleFormSubmission 方法中，我们可以直接使用 user.getUsername() 和 user.getEmail() 来访问表单数据。

2. 使用 @RequestParam 获取单个表单字段

@RequestParam 用于获取单个表单字段的值。这种方式适合处理简单的表单字段，而不需要创建复杂的 Java 对象。

示例：使用 @RequestParam 处理表单字段

@Controller
public class FormController {

    @PostMapping("/submitForm")
    public String handleFormSubmission(@RequestParam String username, @RequestParam String email) {
        System.out.println("Username: " + username);
        System.out.println("Email: " + email);

        return "formResult";  // 返回一个视图名称
    }
}

解析：

• @RequestParam 注解会从请求参数中提取字段值，并将其传递给方法参数。
• 这种方式适用于简单的表单提交，且不需要进行对象绑定。

3. 使用 @RequestBody 处理 JSON 数据

@RequestBody 通常用于处理 JSON 或其他格式的请求体数据。当我们需要通过 Ajax 或其他方式提交 JSON 数据时，@RequestBody 就非常有用。

示例：使用 @RequestBody 处理 JSON 数据

假设我们希望客户端以 JSON 格式提交表单数据：

{
    "username": "john_doe",
    "email": "john@example.com"
}

控制器方法使用 @RequestBody 来接收 JSON 数据：

@Controller
public class FormController {

    @PostMapping("/submitForm")
    public String handleJsonFormSubmission(@RequestBody User user) {
        System.out.println("Username: " + user.getUsername());
        System.out.println("Email: " + user.getEmail());

        return "formResult";  // 返回一个视图名称
    }
}

解析：

• @RequestBody 会将请求体中的 JSON 数据自动转换为 Java 对象（这里是 User 对象）。

🔐 表单验证与数据绑定：保证数据的正确性与安全性 🛡️

表单验证和数据绑定是 Web 开发中至关重要的环节，它们确保了数据的正确性、安全性以及用户体验。Spring Boot 提供了 JSR-303/JSR-380 规范（即 Hibernate Validator）来实现表单验证。

1. 数据绑定与验证

Spring Boot 允许你通过注解对表单数据进行验证。例如，你可以使用 @NotNull、@Size、@Email 等注解来验证用户提交的数据。

示例：添加验证注解

import javax.validation.constraints.Email;
import javax.validation.constraints.NotNull;
import javax.validation.constraints.Size;

public class User {
    
    @NotNull(message = "Username cannot be null")
    @Size(min = 3, max = 50, message = "Username must be between 3 and 50 characters")
    private String username;

    @NotNull(message = "Email cannot be null")
    @Email(message = "Email should be valid")
    private String email;

    // Getter 和 Setter 方法
}

• @NotNull：表示字段不能为空。
• @Size：表示字段的大小范围，适用于字符串长度。
• @Email：表示字段必须是有效的电子邮件地址。

2. 启用验证

在控制器方法中，使用 @Valid 注解来启用验证：

@Controller
public class FormController {

    @PostMapping("/submitForm")
    public String handleFormSubmission(@Valid @ModelAttribute User user, BindingResult result) {
        if (result.hasErrors()) {
            // 验证失败，返回错误信息
            return "formError";
        }

        System.out.println("Username: " + user.getUsername());
        System.out.println("Email: " + user.getEmail());

        return "formResult";  // 返回一个视图名称
    }
}

解析：

• @Valid 注解表示 Spring 应该对 User 对象进行验证。
• BindingResult 用于接收验证结果。如果存在验证错误，可以通过 result.hasErrors() 来判断并进行相应处理。

3. 自定义验证注解

如果你需要进行自定义的表单验证，可以创建自定义验证注解并实现验证逻辑。

示例：创建自定义验证注解

@Target({ElementType.METHOD, ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = PhoneNumberValidator.class)
@Documented
public @interface ValidPhoneNumber {
    String message() default

 "Invalid phone number";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

然后，你需要实现验证逻辑：

public class PhoneNumberValidator implements ConstraintValidator<ValidPhoneNumber, String> {
    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        // 实现自定义的电话号码验证逻辑
        return value != null && value.matches("\\d{10}");
    }
}

🎉 总结与进阶：高效处理表单数据的最佳实践

通过本篇文章，你应该已经掌握了 Spring Boot 与表单处理 的基本技巧。你学到了如何：

• 使用 @ModelAttribute、@RequestParam、@RequestBody 等注解来接收和处理表单数据。
• 实现表单验证，保证提交的数据合法、完整。
• 使用数据绑定与验证注解，确保数据的正确性。

Spring Boot 使得表单处理变得更加高效和灵活，减少了开发的复杂度。如果你还想深入了解更高级的表单处理技巧，不妨尝试探索更多验证注解、表单动态绑定等高级特性。

希望这篇文章能帮助你轻松掌握 Spring Boot 的表单处理技巧，提升你的开发效率！如果有任何问题，随时欢迎来聊！

🧧福利赠与你🧧

  无论你是计算机专业的学生，还是对编程有兴趣的小伙伴，都建议直接毫无顾忌的学习此专栏「滚雪球学SpringBoot」，bug菌郑重承诺，凡是学习此专栏的同学，均能获取到所需的知识和技能，全网最快速入门SpringBoot，就像滚雪球一样，越滚越大， 无边无际，指数级提升。

  最后，如果这篇文章对你有所帮助，帮忙给作者来个一键三连，关注、点赞、收藏，您的支持就是我坚持写作最大的动力。

  同时欢迎大家关注公众号:「猿圈奇妙屋」 ，以便学习更多同类型的技术文章，免费白嫖最新BAT互联网公司面试题、4000G pdf电子书籍、简历模板、技术文章Markdown文档等海量资料。

✨️ Who am I?

我是bug菌，CSDN | 掘金 | InfoQ | 51CTO | 华为云 | 阿里云 | 腾讯云 等社区博客专家，C站博客之星Top30，华为云多年度十佳博主/价值贡献奖，掘金多年度人气作者Top40，掘金等各大社区平台签约作者，51CTO年度博主Top12，掘金/InfoQ/51CTO等社区优质创作者；全网粉丝合计 30w+；更多精彩福利点击这里；硬核微信公众号「猿圈奇妙屋」，欢迎你的加入！免费白嫖最新BAT互联网公司面试真题、4000G PDF电子书籍、简历模板等海量资料，你想要的我都有，关键是你不来拿。

-End-