Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

throws — dichiarare le eccezioni

La parola chiave throws nella dichiarazione di un metodo o di un costruttore specifica i tipi di eccezione che possono propagarsi al di fuori del suo corpo. È particolarmente importante per le eccezioni controllate: il codice chiamante deve gestirle o dichiarare che possono propagarsi ulteriormente.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

throws ExceptionType1, ExceptionType2

throws è una parola chiave riservata. La clausola compare dopo l’elenco dei parametri di un metodo o di un costruttore, prima del corpo o del punto e virgola che conclude la dichiarazione. Separa i tipi con virgole; ciascuno deve essere un sottotipo di Throwable. Sono ammesse anche variabili di tipo con vincoli adeguati.

Se un’eccezione controllata può propagarsi al di fuori del corpo, la dichiarazione deve elencarne il tipo o un supertipo. Il codice chiamante deve intercettarla con try/catch oppure dichiararla nella propria clausola throws. I sottotipi di RuntimeException e Error non sono controllati: è consentito elencarli, ma non è obbligatorio.

Non confondere throws con throw: il primo dichiara una possibile propagazione, mentre il secondo lancia effettivamente un’eccezione. Una clausola throws non lancia né gestisce nulla e non garantisce che si verifichi un’eccezione.

Quando si sovrascrive un metodo (JLS §8.4.8.3), ogni tipo di eccezione controllata dichiarato deve coincidere con un tipo nella clausola throws del metodo sovrascritto dopo la cancellazione dei tipi, oppure esserne un sottotipo. In caso contrario si verifica un errore di compilazione. Se la condizione è soddisfatta solo dopo la cancellazione, il compilatore emette un avviso di tipo unchecked. Per esempio, un metodo non generico void run() throws Exception può sovrascrivere <E extends Exception> void run() throws E con tale avviso anziché con un errore: E diventa Exception dopo la cancellazione, ma prima della cancellazione Exception non è un sottotipo di E.

Nell’esempio, check(false) lancia l’eccezione controllata Exception, che main intercetta e il cui messaggio stampa. Il tipo generale Exception mantiene semplice la dimostrazione; in un’API reale, è preferibile usare tipi specifici che descrivano i possibili errori.

Esempi

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());
        }
    }
}

Risultato

Invalid input

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti