OpenJDK源码研究笔记(一)-参数检查&抛出带关键错误提示信息的异常
OpenJDK源码研究笔记(一)-参数检查&抛出带关键错误提示信息的异常
FansUnion 发表于2年前
OpenJDK源码研究笔记(一)-参数检查&抛出带关键错误提示信息的异常
  • 发表于 2年前
  • 阅读 4
  • 收藏 0
  • 点赞 0
  • 评论 0

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


版权声明:本文为博主原创文章,未经博主允许不得转载。

共有 人打赏支持
粉丝 52
博文 857
码字总数 825464
×
FansUnion
如果觉得我的文章对您有用,请随意打赏。您的支持将鼓励我继续创作!
* 金额(元)
¥1 ¥5 ¥10 ¥20 其他金额
打赏人
留言
* 支付类型
微信扫码支付
打赏金额:
已支付成功
打赏金额: