20230313 JetBrains Annotations

简介

使用参考：java.util.List

Maven 依赖：

<dependency>
    <groupId>org.jetbrains</groupId>
    <artifactId>annotations</artifactId>
    <version>24.0.1</version>
</dependency>

注解列表

注解	描述
@Nullable, @NotNull	检查可空性
@Contract	定义方法必须满足的契约
@Flow	描述方法参数和容器之间的数据流向
@Range	为整数类型指定允许值范围

@Contract

• value：调用参数和返回值之间的约定，参考官网
• pure：用于不更改其对象状态而是返回新值的方法
• mutates：述在方法调用期间可以更改哪些值，包括对象本身和参数值

JRS305

<dependency>
    <groupId>com.google.code.findbugs</groupId>
    <artifactId>jsr305</artifactId>
    <version>3.0.2</version>
</dependency>

@ParametersAreNonnullByDefault ：定义类或包中的所有方法参数都具有@NotNull语义，除非它们被显式注释@Nullable

使用说明

• 方便查看源码
• 并不是强制实现，只是约定

参考资料

• JetBrains / java-annotations - GitHub
• Annotations - JetBrains