Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

AutoCloseable.close(): fecho explícito e automático de recursos

`AutoCloseable.close()` liberta um recurso. Pode invocar o método no objeto ou deixar que `try-with-resources` o invoque automaticamente à saída do bloco.

Versão: Java SE 21

Sintaxe

void close() throws Exception;

resource.close();

try (AutoCloseable resource = acquireResource()) {
    // Use the resource here.
} catch (Exception e) {
    // Handle the exception.
}

Em Java SE 21, AutoCloseable.close e AutoCloseable.close() designam o mesmo método de instância de java.lang.AutoCloseable. Não recebe argumentos e não devolve valor (void). Para libertar explicitamente um recurso, invoque o método no objeto: resource.close().

Use try-with-resources quando um recurso tiver de ser fechado à saída de um bloco. O Java tenta fechar os recursos inicializados com êxito e diferentes de null pela ordem inversa da inicialização, mesmo que o bloco lance uma exceção ou que a inicialização de um recurso posterior falhe. Não feche manualmente um recurso que a mesma instrução vai fechar: AutoCloseable não garante a idempotência. Em contrapartida, java.io.Closeable.close() não tem efeito num recurso já fechado.

A interface declara throws Exception, mas uma implementação pode declarar uma exceção verificada mais específica ou não declarar nenhuma. Nas chamadas explícitas e automáticas, capture ou declare as exceções verificadas consoante o tipo do recurso conhecido em tempo de compilação. Se tanto o bloco como o fecho lançarem uma exceção, a do bloco normalmente mantém-se como principal. A exceção do fecho só pode ser registada como suprimida e obtida através de getSuppressed() se a supressão estiver ativada na exceção principal. Se não houver uma exceção anterior, a exceção do fecho propaga-se.

Exemplos

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());
    }
}

Resultado

Active before manual close: 2
Active after manual close: 1
Caught: simulated close failure
Active after try: 0

`Subscription` é uma classe do exemplo, não faz parte da API padrão. `manual.close()` remove apenas uma subscrição. O fecho automático remove a subscrição temporária e, em seguida, lança uma `IOException` simulada, que o bloco `catch` captura.

Lições relacionadas

  • Java · Lição 47 · Avançado · Versão: 2
  • Java · Lição 52 · Básico · Versão: 2

Fontes