Abrir e fechar recursos no Java, até o Java 6, era uma tarefa muito tediosa de se fazer e muito propensa a erros. Fechar os recursos abertos (invocando o método close()
) frequentemente é algo que ou acaba sendo esquecido de ser feito ou que o programador o faz de forma inadequada, pois há vários complicadores para se fazer isso.
Por exemplo, veja este código:
public class ConexaoFalhouException extends Exception {
public ConexaoFalhouException(Throwable cause) {
super(cause);
}
}
public class AlunoDAO {
private static final String SQL_ALUNOS_POR_TURMA =
"SELECT id, nome, telefone FROM alunos WHERE id_turma = ?";
public static void localizarAlunos(String turma) throws ConexaoFalhouException {
Connection c = null;
PreparedStatement ps = null;
ResultSet rs = null;
try {
Connection c = Conexao.obter();
PreparedStatement ps = c.prepareStatement(SQL_ALUNOS_POR_TURMA);
ps.setString(1, turma);
rs = ps.executeQuery();
List<Aluno> alunos = new ArrayList<Aluno>();
while (rs.next()) {
Aluno a = new Aluno();
a.setInt(rs.getInt(1));
a.setNome(rs.getString(2));
a.setTelefone(rs.getString(3));
alunos.add(a);
}
return alunos;
} catch (SQLException e) {
throw new ConexaoFalhouException(e);
} finally {
try {
if (rs != null) rs.close();
if (ps != null) ps.close();
if (c != null) c.close();
} catch (SQLException e) {
throw new ConexaoFalhouException(e);
}
}
}
}
Este é o código que um programador experiente em Java 6 tipicamente escreveria. Apesar de tudo, ainda há umas coisas chatas nele:
O programador sempre tem que ter o cuidado de se lembrar de chamar o
close()
manualmente.Se o programador não usar o bloco
try-finally
, colocando oclose()
nofinally
, o recurso ficará aberto se uma exceção for lançada.Se o programador se esquecer de usar os
if
s no blocofinally
, ele pode ter umNullPointerException
como resultado.Se um dos métodos
close()
do blocofinally
lançar uma exceção, os demais recursos não serão fechados adequadamente, a menos que cada um deles esteja isolado dentro do seu própriofinally
.Se um dos métodos
close()
do blocofinally
lançar uma exceção, essa exceção vai ser lançada e vai esconder qualquer exceção lançada no blocotry
.Os métodos
close()
forçam você colocar um outro blocotry-catch
dentro do blocofinally
, mesmo já tendo um blococatch (SQLException e)
antes dofinally
, tendo que então duplicar o blococatch
. Isso é contornável ao se usar um blocotry-finally
dentro dotry-catch
, mas mesmo assim, qualquer solução desse tipo é mais complicada do que o que deveria ser.
Esses problemas aí mostram que mesmo seguindo as melhores práticas, o código resultante ainda é bastante feio, confuso, propenso a erros, polui a lógica de negócio e é fácil de quebrar. E grande quantidade desse código é dedicado a lidar com a forma adequada de fechar o recurso prevendo todos os casos especiais possíveis que muitas vezes acaba ficando maior do que a parte que usa o recursos para fazer algum trabalho útil.
Pensando-se nesse problema, é que a sintaxe do try-with-resources foi concebida. A finalidade dessa sintaxe é exatamente a de livrar o programador da necessidade e da complexidade de fechar explicitamente os recursos abertos, além de lidar com todos esses casos especiais automaticamente sem que o programador precise se preocupar com eles.
Eis como fica o mesmo código usando o try-with-resources:
public class ConexaoFalhouException extends Exception {
public ConexaoFalhouException(Throwable cause) {
super(cause);
}
}
public class AlunoDAO {
private static final String SQL_ALUNOS_POR_TURMA =
"SELECT id, nome, telefone FROM alunos WHERE id_turma = ?";
public static void localizarAlunos(String turma) throws ConexaoFalhouException {
try (
Connection c = Conexao.obter();
PreparedStatement ps = c.prepareStatement(SQL_ALUNOS_POR_TURMA);
) {
ps.setString(1, turma);
try (ResultSet rs = ps.executeQuery()) {
List<Aluno> alunos = new ArrayList<>();
while (rs.next()) {
Aluno a = new Aluno();
a.setInt(rs.getInt(1));
a.setNome(rs.getString(2));
a.setTelefone(rs.getString(3));
alunos.add(a);
}
return alunos;
}
} catch (SQLException e) {
throw new ConexaoFalhouException(e);
}
}
}
Observe que usando o try-with-resources, não é mais necessário colocar-se um bloco finally
para se fechar os recursos e nem mesmo chamar o método close()
e você não precisa mais codificar toda essa parafernália. Um bloco finally
adequado é acrescentado automagicamente pelo compilador, e ele já sabe lidar com todos os casos bizarros citados acima. Note também que apenas um catch (SQLException e)
é necessário.
A sintaxe do try-with-resources é assim:
- A palavra-chave
try
- Um abre parênteses
(
. - Uma ou mais declarações de recursos separadas/terminadas por ponto-e-vírgula.
- Um fecha parênteses
)
. - Um abre chaves
{
. - Várias instruções que são executadas dentro do bloco
try
. - Um fecha chaves
}
. - Opcionalmente um ou mais blocos
catch
. - Opcionalmente um bloco
finally
.
Os itens 8 e 9 acima significam que o fato de você estar usando um bloco try-with-resources não significa que você perde a capacidade de usar os blocos catch
ou finally
. Você pode continuar usando-os se quiser.
Quanto ao item 3, você deve estar imaginando como o compilador sabe o que é ou não um recurso. Por exemplo, isso daqui dá erro de compilação porque String
não é um recurso válido:
try (String x = "aaa") {
// blablabla
}
A resposta está na interface java.lang.AutoCloseable
. Esta interface foi acrescentada no Java 7 para denotar quais são as classes que representam recursos que podem ser usados dentro dos parênteses do try-with-resources. A interface java.io.Closeable
que já existia antes passou a herdar de java.lang.AutoCloseable
.
A interface AutoCloseable
tem apenas um método:
void close() throws Exception;
E é esse o método que vai ser invocado no bloco finally
. Implementações podem refinar ele ao substituir a exceção lançada por outras mais específicas (por exemplo, SQLException
ou IOException
). Isso também significa que se você quiser criar a sua classe personalizada e específica de recurso e usar ela no try-with-resources, basta implementar a interface AutoCloseable
.
Como o bloco finally
acrescentado automaticamente pode lançar essas exceções de dentro do método close()
, elas também tem que ser capturadas ou relançadas tais como seriam com quaisquer outras checked-exceptions. Por exemplo, veja o seguinte código:
class MeuException extends Exception {}
class Teste implements AutoCloseable {
@Override
public void close() throws MeuException {}
}
class Principal {
public void metodo() {
try (Teste t = new Teste()) {
// ...
}
}
}
Ele gera o seguinte erro de compilação:
Unhandled exception type MeuException thrown by automatic close() invocation on t.
Que traduzindo, seria isso:
Exceção não-tratada do tipo MeuException lançada pela invocação automática do close() no t.
Assim sendo, essa exceção também tem que ser ou capturada ou relançada:
class Principal {
public void metodoQueRelancaExcecoes() throws MeuException {
try (Teste t = new Teste()) {
// ...
}
}
public void metodoQueTrataExcecoes() {
try (Teste t = new Teste()) {
// ...
} catch (MeuException e) {
// Trata a exceção.
}
}
}
Por fim, ainda há mais um detalhe. O que ocorre quando o bloco try
lança uma exceção e o close()
também? O que é feito para evitar-se que a exceção original seja perdida?
A resposta está no conceito de exceções suprimidas (suppressed exceptions), que foi criado no Java 7 para lidar com este tipo de problema. Uma exceção pode ter uma causa (desde o Java 1.4) e várias outras exceções que ela suprime (desde o Java 7). Na classe Throwable
, os métodos addSuppressed(Throwable)
e getSuppressed()
foram adicionados. No bloco finally
gerado automagicamente, se o bloco try
tiver lançado uma exceção e o método close()
lançar outra exceção, então a exceção que vai ser lançada para fora do finally
será a exceção do bloco try
tendo a exceção gerada no close()
como suprimida. Assim, o stacktrace conterá informações também da exceção suprimida. Eis um exemplo:
class MeuException1 extends Exception {}
class MeuException2 extends Exception {}
class Teste implements AutoCloseable {
@Override
public void close() throws MeuException1 {
throw new MeuException1();
}
}
public class Principal {
public static void main(String[] args) throws MeuException1, MeuException2 {
try (Teste t = new Teste()) {
throw new MeuException2();
}
}
}
Eis a saída:
MeuException2
at Main.foo(Main.java:21)
at Main.main(Main.java:13)
Suppressed: MeuException1
at Teste.close(Main.java:6)
at Main.foo(Main.java:22)
... 1 more