Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

AutoCloseable.close() : fermer une ressource explicitement ou automatiquement

`AutoCloseable.close()` libère une ressource. On peut appeler cette méthode sur l’objet ou laisser `try-with-resources` l’appeler à la sortie du bloc.

Version : Java SE 21

Syntaxe

void close() throws Exception;

resource.close();

try (AutoCloseable resource = acquireResource()) {
    // Use the resource here.
} catch (Exception e) {
    // Handle the exception.
}

Dans Java SE 21, AutoCloseable.close et AutoCloseable.close() désignent la même méthode d’instance de java.lang.AutoCloseable. Elle ne prend aucun argument et ne renvoie rien (void). Pour libérer explicitement une ressource, appelez la méthode sur l’objet : resource.close().

Utilisez try-with-resources si une ressource doit être fermée à la sortie d’un bloc. Java tente de fermer les ressources initialisées avec succès et différentes de null dans l’ordre inverse de leur initialisation, même si le bloc lève une exception ou si l’initialisation d’une ressource suivante échoue. Ne fermez pas manuellement une ressource que la même instruction fermera : AutoCloseable ne garantit pas l’idempotence. À l’inverse, java.io.Closeable.close() est sans effet sur une ressource déjà fermée.

L’interface déclare throws Exception, mais une implémentation peut déclarer une exception vérifiée plus spécifique ou n’en déclarer aucune. Pour les appels explicites et automatiques, interceptez ou déclarez les exceptions vérifiées selon le type de la ressource connu à la compilation. Si le bloc et la fermeture lèvent chacun une exception, celle du bloc reste normalement l’exception principale. L’exception de fermeture ne peut être enregistrée comme exception supprimée et récupérée via getSuppressed() que si la suppression est activée sur l’exception principale. En l’absence d’exception antérieure, l’exception de fermeture se propage.

Exemples

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

Résultat

Active before manual close: 2
Active after manual close: 1
Caught: simulated close failure
Active after try: 0

`Subscription` est une classe d’exemple, pas une classe de l’API standard. `manual.close()` retire un seul abonnement. La fermeture automatique retire l’abonnement temporaire, puis lève une `IOException` simulée que le bloc `catch` intercepte.

Leçons associées

  • Java · Leçon 47 · Avancé · Version : 2
  • Java · Leçon 52 · Débutant · Version : 2

Sources