一、notnulldefault简介

notnulldefault 是一个 Java 类库，用于解决在对象或属性非空和默认值之间的平衡问题。它允许开发人员定义一个默认值，当用户在使用时没有给定这个属性值，而且属性也不为空时，自动使用这个默认值。 notnulldefault 非常适合那些需要定义属性默认值，同时保证属性非空的情况。比如在一个用户注册页面中，姓名是一个非空属性，但是在这个页面中给出了默认值“匿名”，如果用户没有输入自己的姓名，就会自动使用“匿名”。在 notnulldefault 中，开发人员可以方便地设置默认值，同时根据自己的需求设定是否允许当前属性为空。

二、如何使用 notnulldefault

notnulldefault 库提供了一个注解 @NonnullDefault，用于修饰类或者属性。当修饰一个类时，所有属性都默认不能为空；当修饰一个属性时，只有这个属性不为空时才会使用默认值。

三、给定默认值的方式

notnulldefault 提供了多种设置默认值的方式：

使用默认构造函数（必须为 public）

@NonnullDefault
class User {
    String name = "匿名";
    public User() {}
}

使用静态工厂方法

@NonnullDefault
class User {
    String name;
    public static User create() {
        User user = new User();
        user.name = "匿名";
        return user;
    }
}

使用默认构造函数和 setter 指定属性值

@NonnullDefault
class User {
    String name;
    public User() {}
    public void setName(String name) {
        if (name == null) {
            return;
        }
        this.name = name;
    }
}

四、允许属性为空

notnulldefault 库中，默认情况下所有属性都不允许为空。但是有时候，我们需要允许某些属性为空。这时候，只需要在属性上添加 @AllowNull 注解即可。

@NonnullDefault
class User {
    @AllowNull
    String contact;
}

五、自定义默认值

notnulldefault 库中，默认值是一个硬编码的常数。但是有时候我们需要动态地生成默认值。这时候可以实现 DefaultValueProvider 接口，自定义生成默认值的方法。

interface DefaultValueProvider<T> {
    T get();
}
@NonnullDefault
class User {
    String name;
    String email;
    public User() {}
    public User(String name, String email) {
        this.name = name;
        this.email = email;
    }
    @SuppressWarnings("rawtypes")
    public static DefaultValueProvider<User> provider = new DefaultValueProvider<User>() {
        public User get() {
            return new User("匿名", "example@example.com");
        }
    };
}

六、错误处理

当使用 notnulldefault 时，有两种类型的错误需要处理：运行时错误和编译时错误。

运行时错误：如果某个属性已经被标记为非空，但是没有提供默认值，或者属性值为空，则会抛出 NullPointerException 异常。
编译时错误：如果一个方法返回类型被 @NonnullDefault 注解修饰，但是没有设置默认值提供者，则会导致编译错误。

七、使用 notnulldefault 的好处

使用 notnulldefault 可以帮助开发人员避免一些常见的空指针异常错误，特别是在一些初始化对象或者返回对象的方法中。同时，它还可以提高代码的可读性和可维护性，使得代码更加健壮和可靠。

八、总结

notnulldefault 是一个能够帮助开发人员平衡非空和默认值的 Java 类库。使用 notnulldefault 可以在保证属性非空的同时，方便设置默认值，并且可以允许某些属性为空。对于需要经常初始化对象的开发人员来说，notnulldefault 是一个很好用的 Java 类库。

notnulldefault：一个强制非空和默认值之间平衡的解决方案