CKTIS / Java
try-with-resources — fermeture automatique des ressources
L’instruction try-with-resources appelle automatiquement close() sur les ressources AutoCloseable. Elle définit leur durée d’utilisation et le traitement des exceptions levées lors de la fermeture.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
try (Resource r = expression) {
// use r
}Dans try (Resource r = ...), Resource désigne le type déclaré de la ressource, qui doit être un sous-type d’AutoCloseable. Le type AutoCloseable lui-même satisfait à cette exigence. La notation ... représente une expression d’initialisation. À la sortie du bloc, y compris par return ou à cause d’une exception, Java appelle close() sur la ressource si elle n’est pas null.
Séparez les ressources par des points-virgules. L’initialisation se fait de gauche à droite ; la fermeture, dans l’ordre inverse. Si une initialisation échoue, les ressources initialisées auparavant sont fermées. L’échec d’un close() n’empêche pas les autres tentatives de fermeture.
Une variable déclarée dans l’en-tête est implicitement final. Vous pouvez aussi utiliser try (r) si la variable existante a été affectée au préalable et est final ou effectivement final, c’est-à-dire qu’elle n’est pas réaffectée.
Si le bloc lève une exception, celle-ci devient l’exception principale. Si close() lève un objet exception distinct, addSuppressed() ne l’enregistre comme exception supprimée, accessible avec getSuppressed(), que si la suppression est activée pour l’exception principale. Si elle est désactivée, l’exception de fermeture distincte n’est pas enregistrée. Si close() lève exactement le même objet exception que le bloc, addSuppressed() refuse d’ajouter l’exception à elle-même en levant une IllegalArgumentException, même si la suppression est désactivée. Cette IllegalArgumentException peut alors se propager à la place de l’exception d’origine. En l’absence d’exception antérieure, la première exception levée lors de la fermeture devient l’exception principale. Les clauses facultatives catch et finally s’exécutent après les tentatives de fermeture ; catch peut aussi traiter les erreurs d’initialisation et de fermeture.
Exemples
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");
}
}
}Résultat
work close B close A
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.