KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

try-with-resources — resources automatisch sluiten

De try-with-resources-instructie roept automatisch close() aan op AutoCloseable-resources. Ze bepaalt hoelang de resources worden gebruikt en hoe uitzonderingen bij het sluiten worden afgehandeld.

Versie: Java SE 21; repository runtime, production runtime not attested

Syntax

try (Resource r = expression) {
    // use r
}

In try (Resource r = ...) staat Resource voor het gedeclareerde type van de resource, dat een subtype van AutoCloseable moet zijn. Het type AutoCloseable zelf voldoet ook aan deze eis. De notatie ... staat voor een initialisatie-expressie. Bij het verlaten van het blok, ook via return of een uitzondering, roept Java close() aan op de resource als deze niet null is.

Scheid resources met puntkomma’s. Initialisatie gebeurt van links naar rechts; sluiten gebeurt in omgekeerde volgorde. Als een initialisatie mislukt, worden eerder geïnitialiseerde resources gesloten. Als een close() mislukt, worden de overige sluitpogingen niet overgeslagen.

Een variabele die in de header wordt gedeclareerd, is impliciet final. Je kunt ook try (r) gebruiken als de bestaande variabele al een waarde heeft gekregen en final of effectief final is, wat betekent dat er geen nieuwe waarde aan wordt toegewezen.

Als het blok een uitzondering gooit, wordt dat de primaire uitzondering. Gooit close() een ander uitzonderingsobject, dan legt addSuppressed() het alleen als onderdrukte uitzondering vast als onderdrukking voor de primaire uitzondering is ingeschakeld. De vastgelegde uitzondering is op te vragen via getSuppressed(). Als onderdrukking is uitgeschakeld, wordt het andere uitzonderingsobject niet vastgelegd. Gooit close() hetzelfde uitzonderingsobject als het blok, dan weigert addSuppressed() de uitzondering aan zichzelf toe te voegen en gooit het IllegalArgumentException, ook als onderdrukking is uitgeschakeld. De IllegalArgumentException kan dan worden doorgegeven in plaats van de oorspronkelijke uitzondering. Zonder eerdere uitzondering wordt de eerste uitzondering bij het sluiten de primaire uitzondering. Optionele catch- en finally-clausules worden na de sluitpogingen uitgevoerd; catch kan ook fouten bij initialisatie en sluiten afhandelen.

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 a = new Resource("A");
             Resource b = new Resource("B")) {
            System.out.println("work");
        }
    }
}

Resultaat

work
close B
close A

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.

Bronnen