CKTIS / Java
AutoCloseable.close(): resources expliciet en automatisch sluiten
`AutoCloseable.close()` geeft een resource vrij. Je kunt de methode zelf op het object aanroepen of dit bij het verlaten van het blok aan `try-with-resources` overlaten.
Versie: Java SE 21
Syntax
void close() throws Exception;
resource.close();
try (AutoCloseable resource = acquireResource()) {
// Use the resource here.
} catch (Exception e) {
// Handle the exception.
}In Java SE 21 verwijzen AutoCloseable.close en AutoCloseable.close() naar dezelfde instantiemethode van java.lang.AutoCloseable. De methode neemt geen argumenten aan en geeft geen waarde terug (void). Om een resource expliciet vrij te geven, roep je de methode aan op het object: resource.close().
Gebruik try-with-resources als een resource bij het verlaten van een blok moet worden gesloten. Java probeert resources die met succes zijn geïnitialiseerd en niet null zijn, in omgekeerde volgorde van initialisatie te sluiten. Dat gebeurt ook als het blok een uitzondering veroorzaakt of als een volgende resource niet kan worden geïnitialiseerd. Sluit een resource die dezelfde instructie nog zal sluiten niet ook handmatig: AutoCloseable garandeert geen idempotentie. Daarentegen heeft java.io.Closeable.close() geen effect op een al gesloten resource.
De interface declareert throws Exception, maar een implementatie mag een specifiekere gecontroleerde uitzondering declareren of helemaal geen. Vang bij expliciete en automatische aanroepen de gecontroleerde uitzonderingen af of declareer ze op basis van het type van de resource tijdens compilatie. Als zowel het blok als het sluiten een uitzondering veroorzaakt, blijft die van het blok normaal gesproken de primaire uitzondering. De uitzondering van het sluiten kan alleen als onderdrukt worden vastgelegd en via getSuppressed() worden opgevraagd als onderdrukking voor de primaire uitzondering is ingeschakeld. Als er geen eerdere uitzondering is, wordt de uitzondering van het sluiten doorgegeven.
Voorbeelden
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());
}
}Resultaat
Active before manual close: 2 Active after manual close: 1 Caught: simulated close failure Active after try: 0
`Subscription` is een voorbeeldklasse en geen onderdeel van de standaard-API. `manual.close()` verwijdert slechts één abonnement. Het automatisch sluiten verwijdert het tijdelijke abonnement en werpt daarna een gesimuleerde `IOException` op die het `catch`-blok afvangt.
Gerelateerde lessen
- Java · Les 47 · Gevorderd · Versie: 2
- Java · Les 52 · Basis · Versie: 2