Java 如何为类记录一个不变量?
我想知道评论应该放在哪里,我应该使用什么关键词,因为我似乎无法在网上找到一个例子,我应该这样做吗Java 如何为类记录一个不变量?,java,javadoc,invariants,Java,Javadoc,Invariants,我想知道评论应该放在哪里,我应该使用什么关键词,因为我似乎无法在网上找到一个例子,我应该这样做吗 /** * @invariant invariant example */ public class Example { } 有一些可能性 @合同注释 一些例子 @Contract(“\ux,null->null”)-如果第二个 参数为空 @合同(“\u0,null->null;\u0,!null->!null”)- 如果方法的第二个参数为null而不是null,则该方法返回null
/**
* @invariant invariant example
*/
public class Example {
}
有一些可能性 @合同注释 一些例子
- @Contract(“\ux,null->null”)-如果第二个 参数为空
- @合同(“\u0,null->null;\u0,!null->!null”)- 如果方法的第二个参数为null而不是null,则该方法返回null 否则
- @契约(“true->fail”)-一个典型的assertFalse()方法 如果将true传递给它,它将引发异常
Map.put
方法,对于无效参数(会破坏类不变量的参数),我们有以下异常
- @如果put操作失败,则引发UnsupportedOperationException
此映射不支持
- @如果指定键或值的类无效,则引发ClassCastException 防止将其存储在此地图中
- @如果指定的键或值为null,则引发NullPointerException 并且此映射不允许空键或值
- @如果指定键的某些属性 或值阻止它存储在此映射中
没有通用的标准方法来做这件事。