CKTIS / Java
throws — деклариране на изключения
Ключовата дума throws в декларация на метод или конструктор указва типовете изключения, които могат да излязат от тялото му. Тя е особено важна за проверяваните изключения: извикващият код трябва да ги обработи или да декларира, че могат да се предават нататък.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
throws ExceptionType1, ExceptionType2throws е запазена ключова дума. Клаузата се поставя след списъка с параметри на метод или конструктор, преди тялото или точката и запетаята, която завършва декларацията. Типовете се разделят със запетаи; всеки трябва да е подтип на Throwable. Разрешени са и променливи на тип с подходящи граници.
Ако проверявано изключение може да излезе от тялото, декларацията трябва да посочва неговия тип или надтип. Извикващият код трябва да прихване такова изключение с try/catch или да го декларира в собствена клауза throws. Подтиповете на RuntimeException и Error са непроверявани: разрешено е да бъдат посочени, но това не е задължително.
Не бъркайте throws с throw: първото декларира възможно предаване нататък, а второто действително хвърля изключение. Клауза throws сама по себе си нито хвърля, нито обработва нещо и не гарантира, че ще възникне изключение.
При предефиниране на метод (JLS §8.4.8.3) всеки деклариран тип проверявано изключение трябва да съвпада с тип в клаузата throws на предефинирания метод след изтриване на типовете или да е негов подтип. В противен случай възниква грешка при компилация. Ако условието е изпълнено едва след изтриването на типовете, компилаторът издава предупреждение от тип unchecked. Например негенеричният метод void run() throws Exception може да предефинира <E extends Exception> void run() throws E с такова предупреждение вместо грешка: при изтриването на типовете E се заменя с Exception, но преди изтриването Exception не е подтип на E.
В примера check(false) хвърля проверяваното изключение Exception, а main го прихваща и отпечатва съобщението му. Общият тип Exception опростява демонстрацията; в реален API предпочитайте конкретни типове, които описват възможните грешки.
Примери
public class ThrowsDemo {
static void check(boolean valid) throws Exception {
if (!valid) {
throw new Exception("Invalid input");
}
}
public static void main(String[] args) {
try {
check(false);
} catch (Exception e) {
System.out.println(e.getMessage());
}
}
}Резултат
Invalid input
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.
Източници
- The Java Language Specification, Java SE 21, §3.9 Keywords
- The Java Language Specification, Java SE 21, §8.4.6 Method Throws
- The Java Language Specification, Java SE 21, §11.2 Compile-Time Checking of Exceptions
- The Java Language Specification, Java SE 21, §8.4.8.3 Requirements in Overriding and Hiding