我应该使用抛出异常的函数将PHPDoc中的@throws添加到函数中吗?

发布时间:2022-04-30 发布网站:脚本宝典
脚本宝典收集整理的这篇文章主要介绍了我应该使用抛出异常的函数将PHPDoc中的@throws添加到函数中吗?脚本宝典觉得挺不错的,现在分享给大家,也给大家做个参考。
例如,考虑以下代码
/**
 * @param array $array
 * @param string $key
 * @return mixed
 * @throws \InvalidargumentException
 */
PRivate function getArrayEntry(& $array,$key)
{
    if (!array_key_exists($key,$array)) {
        throw new \InvalidargumentException(
            'Invalid array of values for location. Missing '.$key.'.'
        );
    }

    return $array[$key];
}

/**
 * @param array $data
 * @return Location
 */
public function createFromArray(array $data)
{
    $this->getArrayEntry($data,'name');
}

第二种方法是否应该在doc bloc中使用@throws?

与具有’throws’关键字的Java相比,如何使用它?

@throws应该只放在抛出异常的方法的docBlock中.
如果你把它放在堆栈上它将是多余的,将违反 DRY原则!

在java中,您可以选择@throws和@exception ..see here

顺便说一下:你正在抛出错误的异常类型.你应该抛出\OutOfBoundsException.否则就违反了POLA.
\InvalidArgumentException用于意外的参数类型.

脚本宝典总结

以上是脚本宝典为你收集整理的我应该使用抛出异常的函数将PHPDoc中的@throws添加到函数中吗?全部内容,希望文章能够帮你解决我应该使用抛出异常的函数将PHPDoc中的@throws添加到函数中吗?所遇到的问题。

如果觉得脚本宝典网站内容还不错,欢迎将脚本宝典推荐好友。

本图文内容来源于网友网络收集整理提供,作为学习参考使用,版权属于原作者。
如您有任何意见或建议可联系处理。小编QQ:384754419,请注明来意。