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

发布时间：2020-12-13 13:07:15 所属栏目：PHP教程来源：网络整理

导读：例如,考虑以下代码： /** * @param array $array * @param string $key * @return mixed * @throws InvalidArgumentException */private function getArrayEntry( $array,$key){ if (!array_key_exists($key,$array)) { throw new InvalidArgumentExceptio

例如,考虑以下代码：

/**
 * @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用于意外的参数类型.

（编辑：李大同）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!