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
使用说明
- 方便查看源码
- 并不是强制实现,只是约定