База знанияИзпитен център
BGБългарски
Избери език13

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

Източници