第38条：检查参数的有效性

绝大多数方法和构造器对于传递给它们的参数值都会有某些限制。如索引值不能为负数，对象引用不能为null。应该在文档中清楚指明限制，并且在方法体的开头处检查参数，以强制施加这些限制，以便在错误发生之后尽快检测出错误和确定错误根源。

对于公有方法，要用javadoc的@throws标签在文档中说明违法参数限制时会抛出的异常，就像这样：

/*** Returns a BigInteger whose value is {@code (this mod m}).  This method* differs from {@code remainder} in that it always returns a* <i>non-negative</i> BigInteger.** @param  m the modulus.* @return {@code this mod m}* @throws ArithmeticException {@code m} &le; 0* @see    #remainder*/public BigInteger mod(BigInteger m) {if (m.signum <= 0)throw new ArithmeticException("BigInteger: modulus not positive");BigInteger result = this.remainder(m);return (result.signum >= 0 ? result : result.add(m));
}

对于未被导出的方法，作为包的创建者，可以控制方法在那些情况下被调用，因此，非公有方法通常应该使用断言来检查参数。

考虑为对象排序的方法，列表中所有的对象必须是可以互相比较的，如果对象不能相互比较，某个比较操作会抛出ClassCastException，这正是sort方法要做的事，因此，提前检查列表是否可以互相比较无太大意义，但这样会失去失败原子性（没有在出错的时候马上抛出异常或错误，对于这个例子，出错的时候应该是传入的参数不能互相比较，而不是在比较的时候）。

在设计方法时，应该使它们尽可能地通用，对参数的限制应该越少越好。

转载于:https://www.cnblogs.com/13jhzeng/p/5743115.html

第38条：检查参数的有效性相关推荐

Effective Java之检查参数的有效性(三十八)
检查参数的有效性实际上是满足了这一条普遍原则: 应该在发生错误之后尽快检测出错误. 例子: 有个数据库查询的例子,传入一个id,查出一个Student对象,然而返回null,如果没有及时检查这个实例是 ...
方法——检查参数的有效性
检查参数的有效性绝大多数方法和构造方法对于传递给它们的参数都会有某些限制,比如对象引用不能为null,比如必须是正数等.你应该在文档中(或者注释中)清楚地指出所有这些限制,并且在方法体的开头检查参数 ...
Effective-Java 检查参数有效性
49. 检查参数有效性本章(第 8 章)讨论了方法设计的几个方面:如何处理参数和返回值,如何设计方法签名以及如何记载方法文档. 本章中的大部分内容适用于构造方法和其他普通方法. 与第 4 章一样,本 ...
R语言在读取数据的时候自动加上X. 检查列名的有效性
最近在用R代码进行长宽数据转换的时候出现了X.问题,经过一番搜索才发现是R会检查列名的有效性. 使用read.Table或者read.csv系列函数的时候有一个参数check.names参数,默认为T ...
linux信号检查参数相同,linux信号函数
alarm(设置信号传送闹钟) 相关函数 signal,sleep 表头文件 #include 定义函数 unsigned int alarm(unsigned int seconds); 函数说明 ...
SQL Server 2008 R2 系统配置检查器的检查参数和妨碍性问题的解决办法
在安装SQL Server的时候经常会遇到安装失败,这是很伤脑筋的事情,花费很多时间和精力也不一定能够解决. 针对于规则检查导致的安装错误,如果有一份列表能够说明规则以及解决办法将会给我们提高极大的帮 ...
JS逆向：【硬干货】手把手实战某条_signature参数破解（下）——WebSocket与JS函数
本文仅供学习交流使用,请勿用于商业用途或不正当行为如果侵犯到贵公司的隐私或权益,请联系我立即删除前两篇文章: js逆向:[硬干货]手把手实战某条_signature参数破解(上) js逆向:[硬干 ...
基于 RICS-V 架构的单周期 38 条指令处理器设计（含源码及实验报告）
一.概述之前有专门的写过两篇博文来介绍基于 RICS-V 架构的单周期九条指令处理器设计,并提供了相关的代码结构介绍,之后我又对其进行了拓展,且修补了之前源码中存在的一些小问题,并将指令集从九条 ...
你如何检查参数的合法性？
点击上方"服务端思维",选择"设为星标" 回复"669"获取独家整理的精选资料集回复"加群"加入全国服务端高端社群「后 ...
【卡法常用 ckl.js 库】： js汇合表单验证 cookie设置日期格式电话手机号码 email 整数小数金额检查参数长度...
[卡法常用js库]: js汇合表单验证 cookie设置日期格式电话手机号码 email 整数小数金额检查参数长度 // +---------------------- ...

第38条：检查参数的有效性

第38条：检查参数的有效性相关推荐

最新文章

热门文章