CKTIS / Java
AutoCloseable.close(): explicitní a automatické zavírání zdrojů
`AutoCloseable.close()` uvolní zdroj. Metodu můžeš zavolat přímo na objektu nebo ji při opuštění bloku nechat zavolat konstrukci `try-with-resources`.
Verze: Java SE 21
Syntaxe
void close() throws Exception;
resource.close();
try (AutoCloseable resource = acquireResource()) {
// Use the resource here.
} catch (Exception e) {
// Handle the exception.
}V Java SE 21 označují zápisy AutoCloseable.close a AutoCloseable.close() stejnou instanční metodu rozhraní java.lang.AutoCloseable. Nepřijímá žádné argumenty a nic nevrací (void). Chceš-li zdroj uvolnit explicitně, zavolej metodu na objektu: resource.close().
Použij try-with-resources, pokud se má zdroj zavřít při opuštění bloku. Java se pokusí zavřít úspěšně inicializované zdroje, které nejsou null, v opačném pořadí, než byly inicializovány. Platí to i tehdy, když blok vyhodí výjimku nebo se nepodaří inicializovat některý další zdroj. Nezavírej ručně zdroj, který má zavřít stejný příkaz: AutoCloseable nezaručuje idempotenci. Naproti tomu java.io.Closeable.close() nemá na již zavřený zdroj žádný účinek.
Rozhraní deklaruje throws Exception, ale implementace může deklarovat konkrétnější kontrolovanou výjimku nebo žádnou. Při explicitním i automatickém volání kontrolované výjimky zachyť nebo deklaruj podle typu zdroje známého při překladu. Pokud výjimku vyhodí blok i zavírání, výjimka z bloku obvykle zůstává hlavní. Výjimku ze zavírání lze zaznamenat jako potlačenou a získat přes getSuppressed() jen tehdy, je-li u hlavní výjimky povoleno potlačování. Pokud žádná dřívější výjimka neexistuje, šíří se výjimka ze zavírání.
Příklady
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());
}
}Výsledek
Active before manual close: 2 Active after manual close: 1 Caught: simulated close failure Active after try: 0
`Subscription` je ukázková třída, ne součást standardního API. `manual.close()` odstraní jediný odběr. Automatické zavření odstraní dočasný odběr a potom vyhodí simulovanou výjimku `IOException`, kterou zachytí blok `catch`.
Související lekce
- Java · Lekce 47 · Pokročilá · Verze: 2
- Java · Lekce 52 · Základní · Verze: 2