Главная » Java » @throws и @exception в Java

0

 

  Тэг @throws служит для документирования одного типа исключения, выбрасываемого методом. Для обозначения каждого типа исключения надлежит задавать отдельный тэг @throws. В список тэгов @throws, помимо описаний объявляемых исключений, перечисленных в предложении throws, часто добавляется информация и о других исключениях: неплохо упомянуть в throws все возможные исключения, которые могут быть сгенерированы при выполнении метода, — то же справедливо и при описании исключений посредством тэгов ©throws. Предположим, например, что некий метод проверяет значения переданных параметров и выбрасывает исключение типа NullPointerException, если любое из них равно null. В этом случае следует указать тип NullPointerException в предложении throws объявления метода и привести данные о нем в списке тэгов @throws:

@throws             unknownName      наименование не известно,

@throws             java.io.lOException

                       Ошибка чтения из  потока ввода;   это исключение

                        потоком ввода пропускается,

@throws             NullPointerException

                Значение равно <code>null</code>.

 Тэги ©exception и ©throws равнозначны.

 

Источник: Арнолд, Кен, Гослинг, Джеймс, Холмс, Дэвид. Язык программирования Java. 3-е изд .. : Пер. с англ. – М. : Издательский дом «Вильяме», 2001. – 624 с. : ил. – Парал. тит. англ.

По теме:

  • Комментарии