CKTIS / Java
AutoCloseable.close() : fermeture automatique des ressources
`close()` libère les ressources d’un objet. Une instruction try-with-resources l’appelle automatiquement, mais l’interface n’exige pas qu’un nouvel appel soit sans effet.
Version : Java SE 21
Syntaxe
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 est la méthode sans argument de l’interface java.lang.AutoCloseable. Elle ne renvoie aucune valeur (void) : elle ferme l’objet et libère les ressources qu’il gère. La déclaration throws Exception autorise une exception contrôlée en cas d’échec de la fermeture. Une redéfinition peut déclarer un type d’exception plus précis ou ne déclarer aucune exception contrôlée. Lors d’un appel manuel via une référence de type AutoCloseable, il faut intercepter ou déclarer Exception, même si l’implémentation concrète ne la déclare pas.
Une instruction try-with-resources appelle close() sur les ressources initialisées avec succès et non null, dans l’ordre inverse de leur initialisation. Cela se produit que le bloc se termine normalement ou qu’il lève une exception. Si le bloc et close() lèvent des instances distinctes de Throwable, l’exception du bloc reste l’exception principale. Si la suppression est activée pour cette exception, celle de la fermeture lui est rattachée comme exception supprimée et peut être récupérée via getSuppressed(). Si le bloc et close() lèvent exactement la même instance de Throwable, l’appel implicite à addSuppressed() tente de rattacher l’exception à elle-même comme exception supprimée. La méthode lève alors une IllegalArgumentException, qui se propage à la place de l’exception d’origine. Si le bloc se termine normalement, une exception de fermeture peut se propager.
L’idempotence signifie ici qu’appeler close() sur une ressource déjà fermée n’a aucun effet supplémentaire. AutoCloseable le recommande sans l’imposer. À l’inverse, java.io.Closeable étend AutoCloseable, exige qu’un appel après la fermeture soit sans effet et déclare IOException au lieu de Exception. Dans l’exemple, c’est MemoryBuffer qui assure l’idempotence : le premier appel efface la référence au tableau, les suivants se terminent immédiatement. Effacer cette référence ne force pas la récupération immédiate de la mémoire.
Exemples
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");
}
}Résultat
Value: 42 Buffer closed Done
`buffer` n’est jamais réaffectée : cette variable est donc effectivement finale et peut être utilisée dans `try (buffer)`. La fermeture automatique affiche `Buffer closed` ; l’appel manuel ultérieur à `buffer.close()` ne fait rien.
Leçons associées
- Java · Leçon 31 · Intermédiaire · Version : 2