快速体验
- 打开 InsCode(快马)平台 https://www.inscode.net
- 输入框内输入如下内容：
创建一个简单的Java Web应用教学示例，展示@notblank的基本用法。包含一个学生信息表单(姓名、学号必填)，逐步演示如何添加验证、处理验证错误。代码要有详细注释，适合初学者理解。 - 点击'项目生成'按钮，等待项目生成完整后预览效果
最近在学习Java Web开发时，遇到了一个很实用的注解——@NotBlank。作为一个刚入门的新手，一开始对这个注解的作用和使用方法有点懵，但通过实践后发现它真的能帮我们省去很多表单验证的麻烦。今天我就用最通俗的方式，分享一下我的学习笔记。
1. 为什么需要@NotBlank注解
在开发Web应用时，我们经常需要处理用户提交的表单数据。比如一个学生信息录入系统，姓名和学号是必填项。如果没有验证，用户可能会提交空数据，导致后续处理出错。
传统做法是写一堆if判断：
if(name == null || name.trim().isEmpty()) { // 报错处理 }这样不仅代码冗长，而且每个必填字段都要重复写类似的验证逻辑。而@NotBlank注解可以帮我们自动完成这些验证。
2. @NotBlank注解是什么
@NotBlank是Java校验规范(JSR-380)中的一个注解，专门用来验证字符串：
- 不能为null
- 不能是空字符串""
- 不能全是空白字符（如空格、制表符等）
它通常用在实体类的字段上，配合Spring框架的@Valid注解一起使用，能自动完成表单验证。
3. 实际应用示例
假设我们要做一个学生信息表单，包含姓名和学号两个必填项。下面看看如何用@NotBlank实现验证：
- 首先创建一个Student实体类，在必填字段上添加@NotBlank注解
public class Student { @NotBlank(message = "姓名不能为空") private String name; @NotBlank(message = "学号不能为空") private String studentId; // getter和setter方法 }- 在Controller中接收表单数据时，使用@Valid开启自动验证
@PostMapping("/submit") public String submitForm(@Valid Student student, BindingResult result) { if(result.hasErrors()) { // 如果有验证错误，返回错误信息 return "errorPage"; } // 验证通过，处理业务逻辑 return "successPage"; }- 在前端页面上显示错误信息（以Thymeleaf为例）
<form th:object="${student}" method="post"> 姓名：<input type="text" th:field="*{name}"/> <span th:if="${#fields.hasErrors('name')}" th:errors="*{name}"></span> 学号：<input type="text" th:field="*{studentId}"/> <span th:if="${#fields.hasErrors('studentId')}" th:errors="*{studentId}"></span> <button type="submit">提交</button> </form>4. 常见问题及注意事项
- 需要添加依赖：spring-boot-starter-validation
- 与@NotEmpty的区别：@NotEmpty不检查空白字符
- 与@NotNull的区别：@NotNull只检查null，不检查空字符串
- 自定义错误消息：通过message属性设置
5. 为什么推荐使用
- 代码简洁：一行注解代替多行if判断
- 统一标准：所有验证逻辑集中管理
- 易于维护：修改验证规则只需改注解
- 错误信息自动处理：无需手动收集和返回
实际体验建议
我是在InsCode(快马)平台上练习这个例子的，发现它的在线编辑器特别适合新手：
- 不用配置任何环境，打开网页就能写代码
- 内置了Java Web开发需要的所有依赖
- 可以实时看到运行效果
- 遇到问题还能随时查看文档
对于想学习Java Web开发的新手来说，这种即开即用的体验真的很友好。特别是像@NotBlank这样的注解实践，在InsCode上可以快速搭建示例项目，马上看到验证效果，比本地配置环境要方便很多。
希望这篇笔记能帮助到同样刚入门的朋友。记住，学习编程最好的方式就是动手实践，遇到不懂的概念就写个小demo试试看，很快就能掌握了！
快速体验
- 打开 InsCode(快马)平台 https://www.inscode.net
- 输入框内输入如下内容：
创建一个简单的Java Web应用教学示例，展示@notblank的基本用法。包含一个学生信息表单(姓名、学号必填)，逐步演示如何添加验证、处理验证错误。代码要有详细注释，适合初学者理解。 - 点击'项目生成'按钮，等待项目生成完整后预览效果
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
