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

CKTIS / Java

AutoCloseable.close(): fecho automático de recursos

`close()` liberta os recursos de um objeto. Uma instrução try-with-resources chama-o automaticamente, mas a interface não exige que uma segunda chamada seja inócua.

Versão: Java SE 21

Sintaxe

void close() throws Exception;

// In a class implementing AutoCloseable, when closing needs no checked exception:
@Override
public void close() { /* release the resource */ }

// With an already initialized final or effectively final resource variable:
try (resource) {
    // use the resource
}

AutoCloseable.close é o método sem argumentos da interface java.lang.AutoCloseable. Não devolve nenhum valor (void): fecha o objeto e liberta os recursos que este gere. A declaração throws Exception permite lançar uma exceção verificada se o fecho falhar. A implementação pode declarar um tipo de exceção mais específico ou não declarar nenhuma exceção verificada. Numa chamada manual através de uma referência do tipo AutoCloseable, é preciso capturar ou declarar Exception, mesmo que a implementação concreta não a declare.

Uma instrução try-with-resources invoca close() nos recursos inicializados com sucesso cujo valor não seja null, pela ordem inversa à da inicialização. Isto acontece tanto se o bloco terminar normalmente como se lançar uma exceção. Se o bloco e close() lançarem instâncias distintas de Throwable, a exceção do bloco continua a ser a principal. Se a supressão estiver ativada nessa exceção, a do fecho é-lhe associada como exceção suprimida e pode ser consultada com getSuppressed(). Se o bloco e close() lançarem exatamente a mesma instância de Throwable, a chamada implícita a addSuppressed() tenta associar a exceção a si própria como exceção suprimida. O método lança então uma IllegalArgumentException, que se propaga em vez da exceção original. Se o bloco terminar normalmente, uma exceção de fecho pode propagar-se.

Aqui, idempotência significa que chamar close() num recurso já fechado não tem qualquer efeito adicional. AutoCloseable recomenda-o, mas não o exige. Já java.io.Closeable estende AutoCloseable, exige que uma chamada após o fecho não tenha efeito e declara IOException em vez de Exception. No exemplo, é MemoryBuffer que garante a idempotência: o primeiro fecho remove a referência ao array e as chamadas seguintes terminam imediatamente. Remover essa referência não força a recuperação imediata da memória.

Exemplos

public class Main {
    private static final class MemoryBuffer implements AutoCloseable {
        private int[] data = {42};

        int read() {
            if (data == null) {
                throw new IllegalStateException("Buffer is closed");
            }
            return data[0];
        }

        @Override
        public void close() {
            if (data == null) {
                return;
            }
            data = null;
            System.out.println("Buffer closed");
        }
    }

    public static void main(String[] args) {
        MemoryBuffer buffer = new MemoryBuffer();
        try (buffer) {
            System.out.println("Value: " + buffer.read());
        }
        buffer.close();
        System.out.println("Done");
    }
}

Resultado

Value: 42
Buffer closed
Done

Como não é reatribuída, a variável `buffer` é efetivamente final e pode ser usada em `try (buffer)`. O fecho automático escreve `Buffer closed`; a chamada manual posterior a `buffer.close()` não faz nada.

Lições relacionadas

  • Java · Lição 31 · Intermédio · Versão: 2

Fontes