java表单验证教程



表单验证在Web开发中是非常常见和重要的一部分，它用于确保用户提交的数据符合预期的规则和限制。

通过表单验证，我们可以有效地捕获并处理用户输入中的错误或不正确的数据，从而提高应用程序的数据质量和用户体验。在本教程中，我们将学习如何使用Spring MVC的表单验证功能来验证用户提交的表单数据，并处理验证结果。

在接下来的内容中，我们将深入了解Spring MVC表单验证的各个方面，包括如何定义验证规则、如何显示验证错误信息以及如何处理验证结果等。我们还将探讨常见的表单验证场景，并提供实际示例来演示如何实现这些验证逻辑。

1、新建项目，结构如下

 2、导入依赖 

是一个基于Hibernate Validator的Java Bean验证框架。它提供了一组用于验证Java Bean属性的注解，并具有灵活、可扩展的验证机制。

使用可以实现对Java Bean对象进行数据验证和校验，确保对象符合预期的规则和约束。它可以用于以下方面：

1. 参数校验：在方法参数上添加注解，对传入的参数进行验证，以确保参数满足指定的条件。例如，可以验证参数是否为非空、是否满足正则表达式、是否在指定的范围内等。
2. 表单验证：在表单提交时，对表单中的字段进行验证，以确保用户输入的数据符合要求。例如，可以验证用户名、密码、邮箱等字段的格式和有效性。
3. 实体类验证：在保存或更新实体对象时，对实体类中的字段进行验证，以确保数据的完整性和一致性。例如，可以验证实体对象的属性是否为空、长度是否符合要求、是否满足特定的业务规则等。
4. 自定义验证：除了使用内置的验证注解外，还可以自定义验证注解和验证器，以实现更复杂的验证逻辑。通过自定义注解和验证器，可以灵活地定义和扩展验证规则。

通过引入的依赖，可以在项目中使用其提供的注解来对Java Bean对象进行验证。在验证过程中，如果发现验证不通过，将会抛出相关的异常或返回验证结果，从而方便开发者处理验证失败的情况。

 3、配置 web.xml 

用于配置 Servlet 的映射和加载。在 Spring MVC 中，它用于配置 DispatcherServlet 的初始化和请求映射。

具体来说，这段配置的作用如下：

1. 定义了一个名为 "dispatcher" 的 Servlet，并指定了 org.springframework.web.servlet.DispatcherServlet 作为其处理类。
2. 设置了 load-on-startup 属性为 1，表示在应用启动时就加载该 Servlet。
3. 使用 <servlet-mapping> 元素将 "dispatcher" Servlet 映射到所有的请求路径上（即 <url-pattern>/</url-pattern>），意味着所有的请求都会经过该 Servlet 进行处理。

 这段配置的作用是将所有的请求交给 DispatcherServlet 处理，并让它成为应用的核心控制器。DispatcherServlet 将根据请求的 URL 和其他配置信息，将请求分发给相应的处理器方法进行处理，然后返回响应结果。

4、在 resources 包下新建一个 message.properties

这里面的值会在实体类中获取。 

5、新建 User 实体类

这段代码是一个User类的定义，使用了一些注解来进行数据验证。下面是每个注解的作用：

1. ：该注解用于验证字符串属性值是否非空。如果userName属性为空字符串，则会产生一个指定消息的验证错误。
2. ：该注解用于验证属性值是否非空。如果age属性为空值（null），则会产生一个指定消息的验证错误。
3. ：该注解用于验证数值属性值是否大于等于指定的最小值。在这个例子中，如果age属性的值小于18，则会产生一个指定消息的验证错误。
4. ：该注解用于验证属性值是否非空。如果birth属性为空值（null），则会产生一个指定消息的验证错误。
5. ：这是一个注释，用于指定日期类型属性的格式化规则。在这个例子中，如果取消注释并指定了合适的格式化规则，可以对brith属性的日期进行格式验证。
6. ：该注解用于验证字符串属性值是否非空。如果email属性为空字符串，则会产生一个指定消息的验证错误。
7. ：该注解用于验证字符串属性值是否符合Email的格式要求。如果email属性不是合法的Email格式，则会产生一个指定消息的验证错误。

通过在User类的属性上添加这些注解，可以对属性值进行验证，确保满足特定的条件和格式要求。当验证失败时，会生成相应的错误消息供使用者查看和处理。

6、新建一个 ResultVO

泛型类ResultVO，用于封装接口的响应结果。下面是每个属性的作用：

1. ：该属性表示响应的状态码，默认为200，表示成功。HttpStatus.OK.value()是Spring提供的常量，表示HTTP状态码200。
2. ：该属性表示响应的消息，用于描述响应的详细信息。根据具体的业务需求，可以设置不同的消息内容。
3. ：该属性表示响应的数据，是一个泛型类型，可以根据实际情况指定具体的数据类型。根据接口的需求，可以将查询结果、返回对象等放在这个属性中。

通过定义这个ResultVO类，可以将接口的响应结果统一封装并返回给前端。它包含了响应的状态码、消息和数据，可以方便地进行操作和处理。在实际使用中，可以根据业务需要对ResultVO类进行扩展，添加更多的属性和方法。

1、编写 controller 控制器

UserController类，用于处理用户相关的请求。下面是每个方法的作用：

1. 方法：该方法使用注解，用于注册日期格式化器。在这个例子中，通过调用方法，将日期格式化器注册到WebDataBinder中，指定日期的格式为"yyyy-MM-dd"。
2. 方法：该方法使用注解，用于处理添加用户的请求。在这个例子中，通过注解标注了参数，表示要对对象进行Bean验证。同时，该方法还接受一个参数，用于存放验证结果的信息。
   • 首先，通过创建一个对象来存放响应结果。
   • 然后，通过判断是否存在验证错误消息。如果存在错误，则进行错误处理。
   • 在错误处理中，创建一个对象来保存错误信息，循环遍历所有的错误信息，并将字段名作为键，错误信息作为值，保存到中。
   • 设置响应状态码为500（），并将对象序列化为JSON字符串，赋给的属性。
   • 如果需要，可以将对象直接保存到的属性中。
   • 最后，返回对象作为响应结果。

通过定义这个类，并使用注解进行日期格式化注册和Bean验证，可以处理用户添加请求，并根据验证结果返回相应的响应结果。在实际使用中，可以根据业务需求对方法进行扩展和优化。

2、配置 dispatcher-servlet.xml 

每个属性的作用：

1. ：该配置用于告诉Spring扫描指定包下的类，以便自动注册为Spring的组件（如控制器、服务等）。
2. ：该配置启用Spring MVC对注解驱动的支持，其中属性指定用于处理验证的验证器Bean的ID。它会自动将验证错误与错误消息关联起来。
3. ：该配置用于将静态资源的请求交给默认的Servlet处理，而不是通过DispatcherServlet处理。这样可以让静态资源（如CSS、JavaScript等）能够直接访问。
4. ：这是一个内部资源视图解析器的配置，用于解析并返回JSP视图的路径。属性指定JSP文件所在的目录，属性指定JSP文件的后缀名。
5. ：该配置用于配置资源消息，即国际化文本消息的配置。属性指定资源文件的位置，属性指定资源文件的编码格式。
6. ：这是一个校验器的配置，用于对验证框架进行配置。属性指定所使用的验证器的提供者，属性引用了前面配置的消息资源。

 3、新建一个 reg.html 页面提交数据

这段代码是一个简单的前端页面，用于用户注册。它使用了jQuery库来处理表单提交和异步请求。

在页面中，有一个标签，包含了用户需要填写的字段，如姓名、年龄、出生日期和电子邮件等。其中，每个字段都使用了标签，并通过属性指定了字段名。

在页面底部的JavaScript代码中，使用了jQuery的方法，确保文档加载完成后执行相应代码。首先，通过选择器选中所有元素，并绑定了一个点击事件处理函数。当按钮被点击时，触发了一个AJAX请求。

AJAX请求使用了方法，其中传入了请求的URL、请求类型和数据等参数。请求的URL为，表示将请求发送到服务器上的路径。请求类型为POST，即使用HTTP POST方法发送请求。数据使用方法对表单进行序列化，将表单中的输入值转换为URL编码的字符串。

当请求成功返回时，会执行回调函数。在回调函数中，首先判断响应的对象中的属性是否为500（表示服务器内部错误）。如果是500，则说明存在验证错误消息。然后，通过选中页面中的元素，并清空其内容。接下来，将响应的属性（包含错误信息的JSON字符串）转换为JSON对象，并使用方法遍历错误信息，将每条错误信息添加到元素中显示出来。

总体而言，这段代码实现了一个简单的用户注册页面，并使用AJAX请求将表单数据发送到服务器进行处理。在服务器端，通过验证结果返回不同的响应。在前端页面中，通过jQuery来处理和显示服务器返回的验证错误信息。

4、运行效果

我们测试的结果，刚开始什么都不写的时候都提示了为空，当一个一个输进去后，就没有了提示，不满足条件的也会提示。 

Spring MVC的表单验证功能具有以下几个好处：

1. 提高数据的有效性和完整性：通过表单验证，可以确保用户提交的数据符合预期的格式、长度、范围等要求。这可以避免因为不合法的数据导致程序出错或产生意外结果。有效的表单验证可以提高数据的质量和可靠性。
2. 减少后端开发工作量：使用Spring MVC的表单验证，可以在后端自动执行验证逻辑，而无需手动编写大量的验证代码。框架会根据注解配置或自定义验证规则，自动完成验证过程。这样可以极大地减少开发人员的工作量，并提高开发效率。
3. 支持代码重用和模块化：通过使用Spring MVC的表单验证，可以将验证逻辑从业务逻辑中分离出来，形成独立的验证模块。这样可以提高代码的重用性和可维护性，减少重复代码的编写。同时，验证模块可以针对不同的实体对象进行复用，进一步提高开发效率。
4. 提供友好的用户反馈：通过表单验证，可以及时地向用户提供错误信息或者警告信息，帮助用户发现并纠正输入错误。这可以提升用户体验，让用户更加轻松地填写正确的数据。同时，通过在前端页面显示验证错误信息，可以帮助开发人员快速定位并修复问题。
5. 防止安全漏洞和数据损坏：表单验证还可以用于防范安全漏洞，例如输入校验、XSS（跨站脚本攻击）预防等。通过限制输入的数据格式和内容，可以有效地防止恶意用户提交恶意代码或其他危险数据，提高应用程序的安全性。

总之，Spring MVC的表单验证功能在提高数据质量、减少开发工作量、提供友好用户反馈、增强应用程序安全性等方面具有重要的好处。它是开发Web应用程序时不可或缺的一部分，能够提升开发效率和用户体验。

地址：CH07 · qiuqiu/SpringMVC - 码云 - 开源中国 (gitee.com)

版权声明：

本文来源网络，所有图片文章版权属于原作者，如有侵权，联系删除。

本文网址：https://www.bianchenghao6.com/java-jiao-cheng/11857.html