OpenJDK源码研究笔记系列文章,是我在阅读OpenJDK7源码的过程中的一些体会、收获、看法。
把研究过程中的成长和收获一点点地整理出来,是对自己研究学习的一个小结,也有可能给学习Java的一些同学带来一些启发。
我打算每篇只讲解一点,这样篇幅较小,读起来没有太大压力。
写起来压力也小,抽出10到20分钟就可以写1篇。
本篇简要介绍,方法(函数)体内的参数检查,遇到不合法的输入参数时,抛出带关键错误提示信息的异常。
/** * Initializes a new instance of this class. * * @param channel * The channel upon whose file this lock is held * * @param position * The position within the file at which the locked region * starts; must be non-negative * * @param size * The size of the locked region; must be non-negative, and the * sum <tt>position</tt> + <tt>size</tt> must be * non-negative * * @param shared * <tt>true</tt> if this lock is shared, <tt>false</tt> if it is * exclusive * * @throws IllegalArgumentException * If the preconditions on the parameters do not hold * * @since 1.7 */ protected FileLock(AsynchronousFileChannel channel, long position, long size, boolean shared) { if (position < 0) throw new IllegalArgumentException("Negative position"); if (size < 0) throw new IllegalArgumentException("Negative size"); if (position + size < 0) throw new IllegalArgumentException("Negative position + size"); this.channel = channel; this.position = position; this.size = size; this.shared = shared; }
当输入参数position<0的时候,抛出IllegalArgumentException(postion为负数)。
当输入参数size<0的时候,抛出IllegalArgumentException(size为负数)。
当输入参数position和size的和<0的时候,抛出IllegalArgumentException(position+size为负数)。
这样,当输入参数不合法的时候,程序就不会再顺序执行下去。
通过抛出异常的方式,避免了程序进一步不合理的执行。
从异常的类型IllegalArgumentException来看,一看就知道是参数不合法造成的。
从异常的错误提示信息来看,“postion为负数”、“size为负数”、“position+size为负数”,准确地告诉了我们哪个参数不合法。
简而言之,异常的构造非常准确和友好,值得学习。
原文参见:http://FansUnion.cn/articles/2772