当我在 Kotlin 中学习新组件时,我遇到了requireNotNull
,checkNotNull
但我发现的唯一区别是requireNotNull
可以抛出一个IllegalArgumentException
whilecheckNotNull
可以抛出一个IllegalStateException
. 这是有两种方法的唯一原因,还是我缺少一些底层实现细节?
3 回答
就编译器而言,异常类型是唯一实际的区别——但是对于阅读代码的任何人来说,意图都有很大的不同:
•require…()
函数用于检查参数,以确认函数的输入履行其合同。所以你通常会在函数中首先调用它们。(当然,Kotlin 的不可为空的类型意味着您不需要调用requireNotNull()
单个参数;但您可能需要检查参数组合或其子对象的更复杂的条件。)这就是它们抛出的原因IllegalArgumentException
:它正在检查论点是否合法。
•check…()
函数用于检查相关属性,以确认对象或任何东西处于有效状态以便现在调用此函数。(同样,任何从不为null 的属性都将被相应地键入,因此checkNotNull()
更适合于属性、组合和/或子属性可以为 null 的情况,但当它们为 null 时不得调用此函数。)所以他们抛出IllegalStateException
:他们正在检查对象的当前状态是否允许调用该函数。
在这两种情况下,您当然可以编写标准if
检查(就像在 Java 中那样)。?:
或者,您可以在第一次使用可能为空的值时使用 Elvis 运算符进行检查。但是这些函数为您提供了一种更具声明性的替代方案:您通常会将它们放在函数的顶部,在那里它们说明了函数的合同是什么,以一种对任何看代码的人来说都是显而易见的方式。
正如一个链接的答案所指出的那样,还有一些assert…()
功能,它们在语义上的差异再次大于实际差异。这些用于检测远离函数调用边界的编程错误:用于确认不变量和其他条件,以及用于单元测试和其他自动化测试中的所有检查。
(断言还有另一个重要的区别:它们可以从命令行启用和禁用。尽管根据我的经验,这不是一件好事。如果检查很重要,则应始终运行:是强制性的;如果不是,则一旦代码被调试,它应该被移除,或者至少被转移到自动化测试中。)
这是语义上的差异,因此会引发不同的异常。RequireNotNull 用于检查输入值,通常在方法的开头,而 checkNotNull 用于检查当前状态的任何地方。
如果您正在寻找实现方面的差异,最好的去处是源代码。在这种情况下,除了抛出不同的异常之外似乎没有任何区别,这两种方法的来源是相同的。
checkNotNull
[...]
if (value == null) {
val message = lazyMessage()
throw IllegalStateException(message.toString())
} else {
return value
}
requireNotNull
[...]
if (value == null) {
val message = lazyMessage()
throw IllegalArgumentException(message.toString())
} else {
return value
}
因此,区别纯粹是语义上的。@gidds的答案详细说明了使用它们的一些好的场景。