CKTIS / Java
AutoCloseable — zatvaranje resursa
java.lang.AutoCloseable definira ugovor za zatvaranje resursa metodom close(). Uz try-with-resources Java poziva tu metodu pri izlasku iz bloka, uključujući izlazak zbog iznimke, a više resursa zatvara obrnutim redoslijedom.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
public interface AutoCloseable {
void close() throws Exception;
}
try (Resource resource = new Resource()) {
// Use resource.
}java.lang.AutoCloseable sučelje je za objekte koji mogu sadržavati resurse koje treba osloboditi, primjerice datotečne ručice. Sam zapis implements AutoCloseable ne pokreće zatvaranje: objektom mora upravljati try-with-resources ili ga treba izričito zatvoriti.
AutoCloseable.close ima potpis void close() throws Exception. Implementacija mora biti public i može deklarirati užu iznimku ili nijednu. Za razliku od java.io.Closeable, čiji close() deklarira IOException, AutoCloseable ne zahtijeva idempotentnost: ponovno zatvaranje može imati nuspojave. Ipak, idempotentnost se preporučuje.
try-with-resources zatvara uspješno inicijalizirane resurse koji nisu null obrnutim redoslijedom deklariranja, uključujući izlazak pomoću return ili zbog iznimke. Ako i blok i close() bace iznimku, generirani poziv metode addSuppressed pokušava dodati iznimku pri zatvaranju glavnoj iznimci. Ako blok i close() bace istu instancu tipa Throwable, taj poziv baca IllegalArgumentException, čak i ako je potiskivanje iznimki onemogućeno. Ako su instance različite i potiskivanje je omogućeno, polje koje getSuppressed() vrati za glavnu iznimku sadrži iznimku pri zatvaranju. Ako je potiskivanje onemogućeno, iznimka pri zatvaranju ne dodaje se i getSuppressed() vraća prazno polje.
Primjer simulira dva resursa bez pristupa datotekama ili mreži. Najprije ispisuje work, a zatim close second i close first. Implementacija Resource.close() ne deklarira iznimke, pa main ne mora obrađivati provjerenu iznimku zatvaranja.
Primjeri
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");
}
}
}Rezultat
work close second close first
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.