📋 目录
一、工具类功能
通过反射判断一个对象(含父类继承字段)的全部实例字段是否都为空,用于丢掉整行空白数据、校验表单是不是一个字都没填、数出这一行填了几个字段,DTO、record、带父类的实体都能用。
二、所需环境
JDK 17或以上
三、方法与调用示例(按需调用)
🔢 方法序号:1
🎯 方法用途:
- 反射读对象自身与父类的全部实例字段,判断整行是否一个值都没填
- Excel/CSV 导入丢空行、表单提交识别「一个字都没填」这类场景直接用它
🧩 方法定义:public static boolean isAllFieldsBlank(Object obj)
🗣️ 入参解释:public static boolean isAllFieldsBlank(待判断对象)
📤 返回值解释:boolean,所有实例字段都为空返回 true
💡 边界口径:
- 空指 null、去首尾空白后为空的字符串与 Character、空集合、空 Map、长度为 0 的数组、空的
Optional系列 - 其余对象按
toString()判断,没重写toString的对象必然算有值;嵌套对象不递归进去看 Integer 0、Boolean false、0.0都算有值,当空就是静默丢数据- 字段声明成
int、char这些基本类型时,没填也是 0 与'\0',空行永远判不出来,导入实体要用包装类型 - 只统计实例字段,跳过
static、编译器合成字段与枚举常量;没有实例字段的对象算全空,数组即属此类 - 别传 JDK 内置对象,读它的私有字段会被模块系统拒绝并抛
IllegalStateException
🧪 方法示例:
- 一个字段都没填的行
isAllFieldsBlank(row)拿到true - 只填了空格与空集合的行拿到
true,空白字符串算空 - 只有父类字段有值的行拿到
false,继承链一起算 - 装着
Integer 0、Boolean false、0.0的行拿到false,三个字段都算有值 - 字段用基本类型的实体一个没填,也拿到
false - 把数组当行对象传进来拿到
true,数组没有实例字段 - 传空串给本方法抛
字段无法访问: java.lang.String.value
🔢 方法序号:2
🎯 方法用途:
- 判断对象里是否至少有一个字段填了值,与方法1 互为反向
- 校验「这行不能全空」的入口用它,读起来比取反顺
🧩 方法定义:public static boolean hasAnyNonBlank(Object obj)
🗣️ 入参解释:public static boolean hasAnyNonBlank(待判断对象)
📤 返回值解释:boolean,至少有一个字段非空返回 true
💡 边界口径:
- 父类字段同样参与判断,只要有一个非空就返回
true - 入参本身为 null 返回
false,不抛异常 - 判空口径与方法1 完全一致,包括 0 与 false 算有值
- 字段里装着「自身全空」的嵌套对象时算有值,本类按
toString判不递归
🧪 方法示例:
- 填了一个字段的行
hasAnyNonBlank(row)拿到true - 入参直接传 null 拿到
false - 只有父类的 creator 有值时拿到
true,整行不算空 - 字段装着自身全空的嵌套对象,拿到
true,不递归进去看
🔢 方法序号:3
🎯 方法用途:
- 数出对象里有多少个字段填了值,给「填了至少 N 项才放行」这类规则用
- 除了判空还要看填了几项的场景,比自己在外面数省事
🧩 方法定义:public static int countNonBlankFields(Object obj)
🗣️ 入参解释:public static int countNonBlankFields(待判断对象)
📤 返回值解释:int,非空字段的个数,入参为 null 给 0
💡 边界口径:
- 计数范围与方法1 一致,含父类实例字段,跳过静态与合成字段
- 数组长度为 0 才算空,有一个元素就算非空
- record 的两个分量按实例字段算,能正常判
- 字段值自己的
toString()抛异常时按原样往外抛,本类不吞
🧪 方法示例:
- 没填的行拿到
0 个 - 只填客户名的行拿到
1 个,填了两个的行是2 个 - 空集合、空 Map、长度 0 的数组、空 Optional、纯空格字符串凑成的一行拿到
0 个非空字段 - 同一行只把数组换成一个元素,拿到
1 个非空字段 - record 两个分量都空时拿到
0 个非空 - 同一个 record 一个分量有值时是
1 个非空 - 字段值
toString()自己抛异常时,异常原样上抛toString 自己炸了
四、工具类源码(可直接复制)
📦 源码文件