CKTIS / Java
AutoCloseable — fermeture des ressources
java.lang.AutoCloseable définit un contrat de fermeture des ressources au moyen de close(). Avec try-with-resources, Java appelle cette méthode à la sortie du bloc, y compris en cas d’exception, et ferme plusieurs ressources dans l’ordre inverse.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
public interface AutoCloseable {
void close() throws Exception;
}
try (Resource resource = new Resource()) {
// Use resource.
}java.lang.AutoCloseable est une interface destinée aux objets qui peuvent détenir des ressources à libérer, comme des descripteurs de fichiers. Le simple fait d’écrire implements AutoCloseable ne déclenche pas la fermeture : l’objet doit être géré par try-with-resources ou fermé explicitement.
AutoCloseable.close a pour signature void close() throws Exception. Une implémentation doit être public et peut déclarer une exception plus spécifique, ou aucune. Contrairement à java.io.Closeable, dont close() déclare IOException, AutoCloseable n’exige pas l’idempotence : une nouvelle fermeture peut avoir des effets de bord. L’idempotence est toutefois recommandée.
try-with-resources ferme les ressources non nulles initialisées correctement dans l’ordre inverse de leur déclaration, y compris lorsque l’on quitte le bloc avec return ou à cause d’une exception. Si le bloc et close() lèvent tous deux une exception, l’appel généré à addSuppressed tente d’ajouter l’exception de fermeture à l’exception principale. Si le bloc et close() lèvent la même instance de Throwable, cet appel lève IllegalArgumentException, même si la suppression est désactivée. Si les instances sont distinctes et que la suppression est activée, le tableau renvoyé par getSuppressed() sur l’exception principale contient l’exception de fermeture. Si la suppression est désactivée, l’exception de fermeture n’est pas ajoutée et getSuppressed() renvoie un tableau vide.
L’exemple simule deux ressources sans accès à des fichiers ni au réseau. Il affiche d’abord work, puis close second et close first. L’implémentation de Resource.close() ne déclare aucune exception ; main n’a donc pas à gérer d’exception de fermeture vérifiée.
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 first = new Resource("first");
Resource second = new Resource("second")) {
System.out.println("work");
}
}
}Résultat
work close second close first
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.