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.