OpenJDK源码研究笔记(一)参数检查&抛出带关键错误提示信息的异常

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 position + size must be
* non-negative
*
* @param shared
* true if this lock is shared, false 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