Evitando faltas de recurso

As classes que implementam a interface java.io.Closeable (desde o JDK 1.5) e java.lang.AutoCloseable (desde o JDK 1.7) são consideradas para representar os recursos externos, que deverão ser encerrados usando o método close(), quando não forem mais necessários.

O compilador Java Eclipse é capaz de analisar se um código que usa esses tipos está em conformidade com essa política. Por exemplo, o fragmento a seguir representa uma falta óbvia de recurso:

    int len(File f) throws IOException {
        InputStream stream = new FileInputStream(f);
        return stream.available();
    }

O compilador sinalizará com "Vazamento de recurso: 'stream' nunca é fechado".

Análise básica de fluxo para faltas de recurso

A análise de fluxo detecta as seguintes situações:

Além disso, a análise de fluxo tenta seguir os valores do recurso por meio de designações de variável. No entanto, se diferentes recursos precisarem ser designados à mesma variável (em diferentes fluxos de controle ou em sequência), a análise poderá ficar menos precisa.

Nem toda análise está ativada por padrão. Consulte as preferências de compilador em relação às opções de configuração individuais.

Sugestões: O código geralmente será mais fácil de analisar (e mais fácil de ser entendido por leitores humanos) se as variáveis de tipo de recurso não forem reutilizadas para propósitos diferentes. De modo ideal, em programas Java 7, todos os recursos devem ser gerenciados com uma instrução try-with-resources.

Propriedade/responsabilidade

Os diagnósticos acima assumem basicamente que um método que cria uma instância de um tipo de recurso também é responsável pelo encerramento desse recurso. No entanto, alguns recursos serão compartilhados entre vários métodos. Aqui a análise faz as seguintes suposições:

Wrappers de recurso e closeables livres de recurso

O JDK define algumas classes que implementam Closeable, mas não representam diretamente um recurso no nível do sistema operacional.

java.io.StringReader é um exemplo de um closeable que não requer a chamada de close() porque nenhum recurso do sistema operacional é mantido para precisar de limpeza. A análise usa uma lista de desbloqueio explícita para detectar as classes do java.io que caem nessa categoria. Nenhum aviso de falta de recurso é emitido com relação a essas classes.

As instâncias de classes como java.io.BufferedInputStream são wrappers que agrupam outro recurso (no qual os wrappers podem ser aplicados em diversos níveis). Além disso, esses objetos não representam diretamente um recurso de sistema operacional. Se o recurso agrupado for encerrado, o wrapper não precisará ser encerrado. Por outro lado, se um wrapper for encerrado, isso incluirá o encerramento do recurso agrupado. A análise possui uma segunda lista de desbloqueio para detectar recursos de wrapper e reconhecerá se o recurso real subjacente será encerrado diretamente ou indiretamente por meio do wrapper. Qualquer um será suficiente para impedir os avisos relacionados a faltas de recurso. A lista de desbloqueio contém classes de java.io, java.util.zip, java.security, java.beans e java.sound.sampled.

Sugestão: Geralmente é preferível/mais seguro encerrar o wrapper mais externo, não um recurso agrupado.