Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

AutoCloseable — chiusura delle risorse

java.lang.AutoCloseable definisce un contratto per la chiusura delle risorse tramite close(). Con try-with-resources, Java chiama questo metodo quando si esce dal blocco, anche a causa di un’eccezione, e chiude più risorse in ordine inverso.

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

Sintassi

public interface AutoCloseable {
    void close() throws Exception;
}

try (Resource resource = new Resource()) {
    // Use resource.
}

java.lang.AutoCloseable è un’interfaccia per gli oggetti che possono contenere risorse da rilasciare, come gli handle di file. Scrivere soltanto implements AutoCloseable non avvia la chiusura: l’oggetto deve essere gestito con try-with-resources oppure chiuso esplicitamente.

AutoCloseable.close ha la firma void close() throws Exception. Un’implementazione deve essere public e può dichiarare un’eccezione più specifica oppure non dichiararne nessuna. A differenza di java.io.Closeable, il cui close() dichiara IOException, AutoCloseable non richiede l’idempotenza: una nuova chiusura può avere effetti collaterali. L’idempotenza è comunque consigliata.

try-with-resources chiude le risorse non nulle inizializzate correttamente nell’ordine inverso rispetto alla dichiarazione, anche quando si esce con return o a causa di un’eccezione. Se sia il blocco sia close() lanciano un’eccezione, la chiamata generata a addSuppressed tenta di aggiungere l’eccezione di chiusura a quella principale. Se entrambi lanciano la stessa istanza di Throwable, la chiamata lancia IllegalArgumentException, anche se la soppressione è disabilitata. Se le istanze sono distinte e la soppressione è abilitata, l’array restituito da getSuppressed() sull’eccezione principale contiene l’eccezione di chiusura. Se la soppressione è disabilitata, l’eccezione di chiusura non viene aggiunta e getSuppressed() restituisce un array vuoto.

L’esempio simula due risorse senza accedere a file o alla rete. Stampa prima work, poi close second e close first. L’implementazione di Resource.close() non dichiara eccezioni, quindi main non deve gestire un’eccezione di chiusura verificata.

Esempi

public class Main {
    static final class Resource implements AutoCloseable {
        private final String name;

        Resource(String name) {
            this.name = name;
        }

        @Override
        public void close() {
            System.out.println("close " + name);
        }
    }

    public static void main(String[] args) {
        try (Resource first = new Resource("first");
             Resource second = new Resource("second")) {
            System.out.println("work");
        }
    }
}

Risultato

work
close second
close first

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