2024-01-10  阅读(78)
原文作者:猫巳 原文地址: https://moonce.blog.csdn.net/article/details/121788811

一、简介

@NonNulllombok v0.11.10中被引入。

你可以在一个记录组件上使用@NonNull,或者一个方法或构造函数的参数。lombok将为你生成一个null检查语句。

Lombok始终将字段上通常命名为@NonNull的各种注释视为一个信号,以便在Lombok为您生成整个方法或构造函数时生成null检查,例如通过@Data。但是,对参数或记录组件使用lombok自己的@lombok.NonNull会导致在该方法的顶部插入null检查。

null检查看起来像if (param == null) throw new NullPointerException("param is marked @NonNull but is null"); 并将被插入到方法的最顶端。对于构造函数,null检查将被插入到任何明确的this()super()调用之后。对于记录组件,null检查将被插入到 "紧凑构造函数 "中(完全没有参数列表的构造函数),如果你没有构造函数,它将被生成。如果你已经写出了长形式的记录构造函数(参数与你的组件完全匹配),那么什么也不会发生–你将不得不注释这个长形式构造函数的参数。

如果顶部已经有一个null检查,则不会产生额外的null检查。

二、示例比较

1. Lombok 写法

    import lombok.NonNull;
    
    public class NonNullExample extends Something {
      private String name;
      
      public NonNullExample(@NonNull Person person) {
        super("Hello");
        this.name = person.getName();
      }
    }

2. Java 标准写法

    import lombok.NonNull;
    
    public class NonNullExample extends Something {
      private String name;
      
      public NonNullExample(@NonNull Person person) {
        super("Hello");
        if (person == null) {
          throw new NullPointerException("person is marked @NonNull but is null");
        }
        this.name = person.getName();
      }
    }

三、支持的配置项

lombok.nonNull.exceptionType = [NullPointerException | IllegalArgumentException | JDK | Guava | Assertion] (默认: NullPointerException).

lombok生成一个null检查if语句时,默认情况下,会抛出一个java.lang.NullPointerException,并将 "字段名 is marked non-null but is null"作为异常信息。然而,你可以在这个配置键中使用IllegalArgumentException,让lombok用这个消息来代替抛出这个异常。通过使用Assertion,将生成一个具有相同消息的assert语句。JDKGuava键的结果是调用这两个框架的标准null检查方法:java.util.Objects.requireNonNull([field name], "[field name] is marked non-null but is null");或者com.google.common.base.Preconditions.checkNotNull([field name], [field name] is marked non-null but is null");分别。

lombok.nonNull.flagUsage = [warning | error] (默认: 未设置)

如果配置了,Lombok会将@NonNull的任何使用标记为warningerror

四、附属说明

Lombok对于已经存在null检查的检测方案,包括扫描if语句或assert语句,这些语句看起来就像lombok自己的。任何作为if语句的 "then "部分的 "throws "语句,无论是否在大括号中,都算在内。对任何名为requireNonNullcheckNotNull的方法的调用都算。if语句的条件必须与PARAMNAME == null完全一致;assert语句必须与PARAMNAME != null完全一致。对requireNonNull风格的方法的调用必须是独立的(一个只是调用该方法的语句),或者必须是赋值或变量声明语句的表达。你的方法中的第一个语句如果不是这样的null检查,就会停止检查null检查的过程。

虽然@Data和其他方法生成的lombok注解会在各种众所周知的注解上触发,这些注解标志着字段决不能是@NonNull,但这个功能只在lombok包中的lombok自己的@NonNull注解上触发。

在一个原始参数上的@NonNull会导致一个警告。将不会生成空值检查。

在一个抽象方法的参数上的@NonNull曾经产生一个警告;从1.16.8版本开始,这种情况不再出现,以承认@NonNull也有文档作用的概念。出于同样的原因,你可以将一个方法注释为@NonNull;这是允许的,不产生警告,也不产生任何代码。

参考文献

【1】@NonNull

阅读全文
  • 点赞