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