KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

AutoCloseable.close(): resources automatisch sluiten

`close()` geeft de resources van een object vrij. Een try-with-resources-instructie roept de methode automatisch aan, maar de interface vereist niet dat herhaalde aanroepen geen effect hebben.

Versie: Java SE 21

Syntax

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 is de methode zonder argumenten van de interface java.lang.AutoCloseable. De methode geeft geen waarde terug (void): ze sluit het object en geeft de resources vrij die het beheert. De declaratie throws Exception staat een gecontroleerde exceptie toe als het sluiten mislukt. Een overschrijvende methode mag een specifieker exceptietype declareren of helemaal geen gecontroleerde exceptie declareren. Bij een handmatige aanroep via een referentie van het type AutoCloseable moet je Exception afvangen of declareren, ook als de concrete implementatie die niet declareert.

Een try-with-resources-instructie roept close() aan voor succesvol geïnitialiseerde resources die niet null zijn, in omgekeerde initialisatievolgorde. Dat gebeurt zowel als het blok normaal afloopt als wanneer het een exceptie gooit. Als het blok en close() verschillende Throwable-instanties gooien, blijft de exceptie uit het blok de primaire exceptie. Als onderdrukking voor die exceptie is ingeschakeld, wordt de exceptie van het sluiten eraan toegevoegd als onderdrukte exceptie en kun je die opvragen met getSuppressed(). Als het blok en close() exact dezelfde Throwable-instantie gooien, probeert de impliciete aanroep van addSuppressed() de exceptie aan zichzelf toe te voegen als onderdrukte exceptie. De methode gooit dan een IllegalArgumentException, die in plaats van de oorspronkelijke exceptie wordt doorgegeven. Als het blok normaal afloopt, kan een exceptie van het sluiten worden doorgegeven.

Idempotentie betekent hier dat een aanroep van close() na het sluiten geen verder effect heeft. AutoCloseable beveelt dit aan, maar stelt het niet verplicht. java.io.Closeable breidt AutoCloseable uit, vereist juist dat een aanroep na het sluiten geen effect heeft en declareert IOException in plaats van Exception. In het voorbeeld zorgt MemoryBuffer voor idempotentie: de eerste aanroep wist de verwijzing naar de array en latere aanroepen keren direct terug. Het wissen van die verwijzing dwingt geen onmiddellijke garbagecollection af.

Voorbeelden

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");
    }
}

Resultaat

Value: 42
Buffer closed
Done

`buffer` krijgt nooit opnieuw een waarde toegewezen en is dus effectief final. Daarom kun je de variabele gebruiken in `try (buffer)`. De automatische aanroep drukt `Buffer closed` af; de latere handmatige aanroep van `buffer.close()` doet niets.

Gerelateerde lessen

  • Java · Les 31 · Gemiddeld · Versie: 2

Bronnen