As classes que implementam a interface java.io.Closeable (desde JDK 1.5) e
java.lang.AutoCloseable (desde JDK 1.7) são consideradas como representando recursos
externos, que devem ser fechadas utilizando o método close(), quando já não são
necessárias.
O compilador Java do Eclipse consegue analisar se o código que utiliza esses tipos adere a esta política. Por exemplo, o fragmento seguinte representa uma fuga de recursos óbvia:
int len(File f) throws IOException {
InputStream stream = new FileInputStream(f);
return stream.available();
}
O compilador irá assinalar esta opção com "Fuga de recursos: 'stream' nunca é fechado".
A análise de fluxo detecta as seguintes situações:
Adicionalmente, a análise de fluxo tenta seguir os valores de recursos através de atribuições de variáveis. No entanto, se podem ser atribuídos diferentes recursos à mesma variável (em diferentes fluxos de controlo ou em sequência), a análise pode tornar-se menos exacta.
Nem todas as análises estão activadas por predefinição. Consulte as preferências do compilador relativas às opções de configuração individuais.
Sugestões: o código será gerado mais facilmente para analisar (e mais facilmente compreender por parte dos leitores humanos) se as variáveis de tipo de recurso não forem reutilizadas para diferentes fins. Idealmente, em programas Java 7 todos os recursos devem ser geridos com uma instrução try-with-resources.
Os diagnósticos em cima basicamente assumem que um método que cria uma instância de um tipo de recurso é também responsável por fechar este recurso. No entanto, alguns recursos serão partilhados entre vários métodos. Aqui a análise assume o seguinte:
nova, pode ou não
ser responsável; quaisquer problemas são apenas sinalizados como potenciais fugas de recursos.
O JDK define algumas classes que implementam Closeable, mas não representam directamente
um recurso ao nível do sistema operativo.
java.io.StringReader é um exemplo de um closeable que não requer o chamamento de close()
porque não são mantidos quaisquer recursos do sistema operativo que requeiram a limpeza.
A análise utilize uma lista branca explícita para detectar classes a partir de java.io que estão dentro desta categoria.
Não foram emitidos quaisquer avisos de fuga de recursos relativamente a estas classes.
As instâncias de classes como java.io.BufferedInputStream são translineadores em redor de outro recurso
(onde os translineadores podem ser aplicados em vários níveis).
Além disso, estes objectos não representam directamente um recurso do sistema operativo.
Se o recurso translineado estiver fechado, não é necessário fechar o translineador.
Ao invés, se um translineador estiver fechado, isto irá incluir o fechamento do recurso translineado.
A análise tem uma segunda lista branca para detectar recursos do translineador, e irá reconhecer se
o recurso real subjacente será fechado directamente ou indirectamente através do translineador.
Qualquer um é suficiente para silenciar avisos relativamente a fugas de recursos.
A lista branca contém classes a partir de java.io, java.util.zip, java.security, java.beans
e java.sound.sampled.
Sugestão: normalmente é preferível/mais seguro fechar o translineador mais exterior, não um recurso translineado.