CKTIS / Java
AutoCloseable.close(): явно и автоматично затваряне на ресурси
`AutoCloseable.close()` освобождава ресурс. Можеш да извикаш метода върху обекта или да оставиш `try-with-resources` да го извика при излизане от блока.
Версия: Java SE 21
Синтаксис
void close() throws Exception;
resource.close();
try (AutoCloseable resource = acquireResource()) {
// Use the resource here.
} catch (Exception e) {
// Handle the exception.
}В Java SE 21 записите AutoCloseable.close и AutoCloseable.close() означават един и същ метод на екземпляр от интерфейса java.lang.AutoCloseable. Методът не приема аргументи и не връща стойност (void). За да освободиш ресурс явно, извикай метода върху обекта: resource.close().
Използвай try-with-resources, когато ресурсът трябва да се затвори при излизане от блока. Java се опитва да затвори успешно инициализираните ресурси, които не са null, в обратен ред на инициализацията. Това важи и ако блокът хвърли изключение или инициализирането на следващ ресурс се провали. Не затваряй ръчно ресурс, който същата конструкция ще затвори: AutoCloseable не гарантира идемпотентност. За разлика от него java.io.Closeable.close() няма ефект върху вече затворен ресурс.
Интерфейсът декларира throws Exception, но реализацията може да декларира по-конкретно проверявано изключение или да не декларира такова. При явно и автоматично извикване прихващай или декларирай проверяваните изключения според типа на ресурса, известен при компилация. Ако и блокът, и затварянето хвърлят изключение, това от блока обикновено остава основно. Изключението от затварянето може да се запише като потиснато и да се получи чрез getSuppressed() само ако потискането е разрешено за основното изключение. Ако няма предходно изключение, изключението от затварянето се предава нататък.
Примери
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());
}
}Резултат
Active before manual close: 2 Active after manual close: 1 Caught: simulated close failure Active after try: 0
`Subscription` е примерен клас, а не част от стандартния API. `manual.close()` премахва само един абонамент. Автоматичното затваряне премахва временния абонамент, след което хвърля симулирано изключение `IOException`, което блокът `catch` прихваща.
Свързани уроци
- Java · Урок 47 · Напреднало · Версия: 2
- Java · Урок 52 · Начално · Версия: 2