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:

<!-- language: lang-java -->

    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 o `close()` no `finally`, o recurso ficará aberto se uma exceção for lançada.

* Se o programador se esquecer de usar os `if`s no bloco `finally`, ele pode ter um `NullPointerException` como resultado.

* Se um dos métodos `close()` do bloco `finally` 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óprio `finally`.

* Se um dos métodos `close()` do bloco `finally` lançar uma exceção, essa exceção vai ser lançada e vai esconder qualquer exceção lançada no bloco `try`.

* Os métodos `close()` forçam você colocar um outro bloco `try-catch` dentro do bloco `finally`, mesmo já tendo um bloco `catch (SQLException e)` antes do `finally`, tendo que então duplicar o bloco `catch`.

Esses problemas aí mostram que mesmo seguindo as melhores práticas, o código resultante ainda é bastante feio, confuso, propenso a erros 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*:

<!-- language: lang-java -->

    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:

1. A palavra-chave `try`
2. Um abre parênteses `(`.
3. Uma ou mais declarações de recursos separadas/terminadas por ponto-e-vírgula.
4. Um fecha parênteses `)`.
5. Um abre chaves `{`.
6. Várias instruções que são executadas dentro do bloco `try`.
7. Um fecha chaves `}`.
8. Opcionalmente um ou mais blocos `catch`.
9. 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:

<!-- language: lang-java -->

    try (String x = "aaa") {
        // blablabla
    }

A resposta está na interface [`java.lang.AutoCloseable`](https://docs.oracle.com/javase/8/docs/api/java/lang/AutoCloseable.html). 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` herda de `java.lang.AutoCloseable`.

A interface `AutoCloseable` tem apenas um método:

<!-- language: lang-java -->

    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ífica (por exemplo, `SQLException` ou `IOException`).

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:

<!-- language: lang-java -->

    class MeuException extends Exception {}
    class Teste implements AutoCloseable {
        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:

<!-- language: lang-java -->

    class Principal {
        public void metodo1() throws MeuException {
            try (Teste t = new Teste()) {
                // ...
            }
        }

        public void metodo2() {
            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 [`addSupressed(Throwable)`](https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html#addSuppressed-java.lang.Throwable-) e [`getSupressed()`](https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html#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 a exceção do `close()`, então vai ser lançada a exceção do bloco `try` tendo a exceção do `close()` como suprimida. Assim, o *stacktrace* conterá informações também da exceção suprimida. Eis um exemplo:

<!-- language: lang-java -->

    class MeuException1 extends Exception {}
    class MeuException2 extends Exception {}

    class Teste implements AutoCloseable {
        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:

<!-- language: lang-none -->

    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