Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

AutoCloseable.close(): chiusura automatica delle risorse

`close()` rilascia le risorse di un oggetto. Un’istruzione try-with-resources lo chiama in automatico, ma l’interfaccia non richiede che una chiamata successiva sia priva di effetti.

Versione: Java SE 21

Sintassi

void close() throws Exception;

// In a class implementing AutoCloseable, when closing needs no checked exception:
@Override
public void close() { /* release the resource */ }

// With an already initialized final or effectively final resource variable:
try (resource) {
    // use the resource
}

AutoCloseable.close è il metodo senza argomenti dell’interfaccia java.lang.AutoCloseable. Non restituisce alcun valore (void): chiude l’oggetto e rilascia le risorse che gestisce. La dichiarazione throws Exception consente di lanciare un’eccezione controllata se la chiusura non riesce. Una ridefinizione può dichiarare un tipo di eccezione più specifico oppure non dichiarare alcuna eccezione controllata. Se si chiama il metodo manualmente tramite un riferimento di tipo AutoCloseable, bisogna catturare o dichiarare Exception, anche se l’implementazione concreta non la dichiara.

Un’istruzione try-with-resources invoca close() sulle risorse inizializzate correttamente e diverse da null, in ordine inverso rispetto all’inizializzazione. Questo avviene sia se il blocco termina normalmente sia se lancia un’eccezione. Se il blocco e close() lanciano istanze distinte di Throwable, l’eccezione del blocco rimane quella principale. Se la soppressione è abilitata per quell’eccezione, quella di chiusura vi viene aggiunta come eccezione soppressa ed è accessibile tramite getSuppressed(). Se il blocco e close() lanciano esattamente la stessa istanza di Throwable, la chiamata implicita ad addSuppressed() tenta di aggiungere l’eccezione a sé stessa come eccezione soppressa. Il metodo lancia quindi un’IllegalArgumentException, che si propaga al posto dell’eccezione originale. Se il blocco termina normalmente, un’eccezione di chiusura può propagarsi.

Qui, idempotenza significa che chiamare close() su una risorsa già chiusa non produce altri effetti. AutoCloseable lo raccomanda, ma non lo impone. Invece, java.io.Closeable estende AutoCloseable, impone che una chiamata dopo la chiusura non abbia effetto e dichiara IOException al posto di Exception. Nell’esempio, è MemoryBuffer a garantire l’idempotenza: la prima chiusura elimina il riferimento all’array e le chiamate successive terminano subito. Eliminare quel riferimento non forza il recupero immediato della memoria.

Esempi

public class Main {
    private static final class MemoryBuffer implements AutoCloseable {
        private int[] data = {42};

        int read() {
            if (data == null) {
                throw new IllegalStateException("Buffer is closed");
            }
            return data[0];
        }

        @Override
        public void close() {
            if (data == null) {
                return;
            }
            data = null;
            System.out.println("Buffer closed");
        }
    }

    public static void main(String[] args) {
        MemoryBuffer buffer = new MemoryBuffer();
        try (buffer) {
            System.out.println("Value: " + buffer.read());
        }
        buffer.close();
        System.out.println("Done");
    }
}

Risultato

Value: 42
Buffer closed
Done

`buffer` non viene mai riassegnata, quindi è effettivamente finale e si può usare in `try (buffer)`. La chiusura automatica stampa `Buffer closed`; la successiva chiamata manuale a `buffer.close()` non fa nulla.

Lezioni correlate

  • Java · Lezione 31 · Intermedio · Versione: 2

Fonti