CKTIS / Java
AutoCloseable.close(): chiusura esplicita e automatica delle risorse
`AutoCloseable.close()` rilascia una risorsa. Puoi chiamare il metodo sull’oggetto oppure lasciare che `try-with-resources` lo chiami all’uscita dal blocco.
Versione: Java SE 21
Sintassi
void close() throws Exception;
resource.close();
try (AutoCloseable resource = acquireResource()) {
// Use the resource here.
} catch (Exception e) {
// Handle the exception.
}In Java SE 21, AutoCloseable.close e AutoCloseable.close() indicano lo stesso metodo di istanza di java.lang.AutoCloseable. Non accetta argomenti e non restituisce alcun valore (void). Per rilasciare esplicitamente una risorsa, chiama il metodo sull’oggetto: resource.close().
Usa try-with-resources quando una risorsa deve essere chiusa all’uscita da un blocco. Java tenta di chiudere le risorse inizializzate correttamente e diverse da null in ordine inverso rispetto all’inizializzazione, anche se il blocco lancia un’eccezione o se una risorsa successiva non si inizializza. Non chiudere manualmente una risorsa che sarà chiusa dalla stessa istruzione: AutoCloseable non garantisce l’idempotenza. Al contrario, java.io.Closeable.close() non ha effetto su una risorsa già chiusa.
L’interfaccia dichiara throws Exception, ma un’implementazione può dichiarare un’eccezione controllata più specifica o non dichiararne alcuna. Per le chiamate esplicite e automatiche, intercetta o dichiara le eccezioni controllate in base al tipo della risorsa noto in fase di compilazione. Se sia il blocco sia la chiusura lanciano un’eccezione, quella del blocco normalmente resta la principale. L’eccezione della chiusura può essere registrata come soppressa e recuperata tramite getSuppressed() solo se la soppressione è abilitata nell’eccezione principale. Se non c’è un’eccezione precedente, si propaga quella della chiusura.
Esempi
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;
public class Main {
private static final class Subscription implements AutoCloseable {
private final List<Subscription> active;
private final boolean failOnClose;
Subscription(List<Subscription> active, boolean failOnClose) {
this.active = active;
this.failOnClose = failOnClose;
active.add(this);
}
@Override
public void close() throws IOException {
if (active.remove(this) && failOnClose) {
throw new IOException("simulated close failure");
}
}
}
public static void main(String[] args) {
List<Subscription> active = new ArrayList<>();
try (Subscription temporary = new Subscription(active, true)) {
Subscription manual = new Subscription(active, false);
System.out.println("Active before manual close: " + active.size());
manual.close();
System.out.println("Active after manual close: " + active.size());
} catch (IOException e) {
System.out.println("Caught: " + e.getMessage());
}
System.out.println("Active after try: " + active.size());
}
}Risultato
Active before manual close: 2 Active after manual close: 1 Caught: simulated close failure Active after try: 0
`Subscription` è una classe di esempio, non fa parte dell’API standard. `manual.close()` rimuove un solo abbonamento. La chiusura automatica rimuove l’abbonamento temporaneo e poi lancia una `IOException` simulata, intercettata dal blocco `catch`.
Lezioni correlate
- Java · Lezione 47 · Avanzato · Versione: 2
- Java · Lezione 52 · Base · Versione: 2