CKTIS / Java
AutoCloseable — resources sluiten
java.lang.AutoCloseable definieert met close() een contract voor het sluiten van resources. Bij try-with-resources roept Java deze methode aan wanneer het blok wordt verlaten, ook door een uitzondering, en worden meerdere resources in omgekeerde volgorde gesloten.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
public interface AutoCloseable {
void close() throws Exception;
}
try (Resource resource = new Resource()) {
// Use resource.
}java.lang.AutoCloseable is een interface voor objecten die resources kunnen bevatten die moeten worden vrijgegeven, zoals bestandshandles. Alleen implements AutoCloseable schrijven zorgt niet voor sluiten: het object moet met try-with-resources worden beheerd of expliciet worden gesloten.
AutoCloseable.close heeft de signatuur void close() throws Exception. Een implementatie moet public zijn en mag een specifiekere uitzondering declareren of helemaal geen. Anders dan java.io.Closeable, waarvan close() IOException declareert, vereist AutoCloseable geen idempotentie: opnieuw sluiten kan bijwerkingen hebben. Idempotentie wordt desondanks aanbevolen.
try-with-resources sluit correct geïnitialiseerde, niet-null resources in omgekeerde volgorde van declaratie, ook wanneer het blok wordt verlaten via return of door een uitzondering. Als zowel het blok als close() een uitzondering gooit, probeert de gegenereerde aanroep van addSuppressed de uitzondering bij het sluiten aan de primaire uitzondering toe te voegen. Als beide dezelfde Throwable-instantie gooien, gooit die aanroep IllegalArgumentException, zelfs als onderdrukking is uitgeschakeld. Als de instanties verschillen en onderdrukking is ingeschakeld, bevat de array die getSuppressed() op de primaire uitzondering retourneert ook de uitzondering bij het sluiten. Als onderdrukking is uitgeschakeld, wordt de uitzondering bij het sluiten niet toegevoegd en retourneert getSuppressed() een lege array.
Het voorbeeld simuleert twee resources zonder toegang tot bestanden of het netwerk. Het drukt eerst work af, gevolgd door close second en close first. De implementatie van Resource.close() declareert geen uitzonderingen, dus main hoeft geen gecontroleerde sluituitzondering af te handelen.
Voorbeelden
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");
}
}
}Resultaat
work close second close first
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.