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