Java多类型参数非空校验优化及统一方法实现咨询

问题背景 #

作为Java新手，我需要构建一个搜索API接口，根据传入的非空或非空字符串参数执行搜索逻辑，当前需判断是否所有参数均为空或空串。目前为每种参数类型编写校验方法（示例了String类型的实现），想找更优雅的实现方式，用一个方法兼容所有参数类型。

现有代码片段：

public Page<Customer> searchCustomer(Customer customer) {

    if (
            !isNullOrEmpty(customer.getCustomerId()) && //LONG
            !isNullOrEmpty(customer.getCustomerType()) && //STRING
            !isNullOrEmpty(customer.getCustNum()) && //STRING
            !isNullOrEmpty(customer.getStatus()) && //STRING
            !isNullOrEmpty(customer.getStatusDate()) && //DATE
            !isNullOrEmpty(customer.getBalance()) && //DOUBLE
            !isNullOrEmpty(customer.getEntryDate()) && //DATE
            !isNullOrEmpty(customer.getModificationDate()) && //DATE
            !isNullOrEmpty(customer.getDeceased()) && //BOOLEAN
            !isNullOrEmpty(customer.getPreferredCommunicationsChannel()) &&

    ) {
        // 执行查询
    } else {
        // 抛出提示信息...
    }
}

static boolean isNullOrEmpty(String s) {
    return s == null || s.isEmpty();
}

优雅实现方案 #

方案1：通用的isNullOrEmpty工具方法 #

编写一个泛型方法，兼容所有类型的空值判断：

• 对于String类型，判断是否为null或空串
• 对于其他类型（Long、Date、Double、Boolean等），仅判断是否为null（因为这些类型的"空"通常指未赋值的null，而非默认值如0、false）

public static <T> boolean isNullOrEmpty(T value) {
    if (value == null) {
        return true;
    }
    // 仅对String类型额外判断空串
    if (value instanceof String) {
        return ((String) value).isEmpty();
    }
    // 其他非null值均视为非空
    return false;
}

使用时无需为每种类型单独写方法，直接调用即可：

public Page<Customer> searchCustomer(Customer customer) {
    // 注：这里将原代码的&&改为||，因为搜索API通常允许传入任意非空参数；若需求是"所有参数都非空才允许查询"，可改回&&
    boolean hasValidParam = 
            !isNullOrEmpty(customer.getCustomerId())
            || !isNullOrEmpty(customer.getCustomerType())
            || !isNullOrEmpty(customer.getCustNum())
            || !isNullOrEmpty(customer.getStatus())
            || !isNullOrEmpty(customer.getStatusDate())
            || !isNullOrEmpty(customer.getBalance())
            || !isNullOrEmpty(customer.getEntryDate())
            || !isNullOrEmpty(customer.getModificationDate())
            || !isNullOrEmpty(customer.getDeceased())
            || !isNullOrEmpty(customer.getPreferredCommunicationsChannel());

    if (hasValidParam) {
        // 执行查询逻辑
    } else {
        throw new IllegalArgumentException("请至少传入一个有效的查询参数");
    }
}

方案2：反射自动遍历字段判断 #

如果Customer类字段较多，手动逐个判断容易遗漏或重复，可以用反射自动遍历所有字段，统一检查是否为空：

public static boolean isAllFieldsNullOrEmpty(Object obj) {
    if (obj == null) {
        return true;
    }
    // 遍历对象的所有声明字段
    for (Field field : obj.getClass().getDeclaredFields()) {
        field.setAccessible(true); // 允许访问私有字段
        try {
            Object fieldValue = field.get(obj);
            // 只要有一个字段非空，就返回false
            if (!isNullOrEmpty(fieldValue)) {
                return false;
            }
        } catch (IllegalAccessException e) {
            // 异常处理，比如记录日志
            e.printStackTrace();
        }
    }
    // 所有字段都为空或空串
    return true;
}

业务方法中直接调用即可，无需手动维护字段列表：

public Page<Customer> searchCustomer(Customer customer) {
    if (!isAllFieldsNullOrEmpty(customer)) {
        // 执行查询逻辑
    } else {
        throw new IllegalArgumentException("请至少传入一个有效的查询参数");
    }
}

反射方案的优化：排除特定字段

如果有不需要检查的字段（比如主键、内部维护的字段），可以自定义一个注解来标记：

@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
public @interface SkipCheck {
}

然后在反射方法中跳过标记了该注解的字段：

public static boolean isAllFieldsNullOrEmpty(Object obj) {
    if (obj == null) {
        return true;
    }
    for (Field field : obj.getClass().getDeclaredFields()) {
        // 跳过标记了SkipCheck的字段
        if (field.isAnnotationPresent(SkipCheck.class)) {
            continue;
        }
        field.setAccessible(true);
        try {
            Object fieldValue = field.get(obj);
            if (!isNullOrEmpty(fieldValue)) {
                return false;
            }
        } catch (IllegalAccessException e) {
            e.printStackTrace();
        }
    }
    return true;
}

在Customer类的字段上使用注解：

public class Customer {
    @SkipCheck
    private Long id; // 主键，无需检查
    
    private Long customerId;
    // 其他字段...
}

方案对比 #

内容的提问来源于stack exchange，提问作者Florin Giorgian