Klassen die de interface java.io.Closeable (sinds JDK 1.5) en de interface java.lang.AutoCloseable (sinds JDK 1.7) implementeren, worden geacht externe resources te vertegenwoordigen. Deze moeten, als ze niet meer nodig zijn, worden gesloten met behulp van de methode close().
Het Eclipse Java-compileerprogramma kan analyseren of de code die deze typen gebruikt, zich aan dit beleid houdt. Zo laat de volgende snippet bijvoorbeeld een duidelijk resourcelek zien:
int len(File f) throws IOException {
InputStream stream = new FileInputStream(f);
return stream.available();
}
Het compileerprogramma markeert dit met "Resourcelek: 'stream' wordt nooit gesloten".
Bij analyse van de stroom worden de volgende situaties gedetecteerd:
Bovendien wordt er bij stroomanalyse geprobeerd de resourcewaarden te volgen bij de toewijzing van variabelen. Als er echte verschillende resources kunnen worden toegewezen aan één en dezelfde variabele (in verschillende stuurstromen of in volgorde), wordt de analyse vaak wat minder nauwkeurig.
Standaard wordt niet alle analyse uitgevoerd. Raadpleeg de voorkeuren van het configuratieoptie met betrekking tot de afzonderlijke configuratieopties.
Tips: De code is gewoonlijk gemakkelijker te analyseren (en voor mensen eenvoudiger te begrijpen) als resourcetypevariabelen niet worden hergebruikt voor verschillende doeleinden. In het ideale geval worden alle resources in Java 7-programma's beheerd met een try-with-resources instructie.
Bij de bovenstaande diagnose wordt ervan uitgegaan dat een methode die verantwoordelijk is voor het maken van een instance van een resource, ook verantwoordelijk is voor het sluiten van die resource. Sommige resources worden echter gemeenschappelijk gebruikt door meerdere methoden. In dat geval wordt bij de analyse uitgegaan van de volgende aannames:
new), is het niet duidelijk of die methode verantwoordelijk is. Problemen worden gemarkeerd als potentiële resourcelekken.
De JDK definieert enkele klassen die Closeable implementeren maar die op het niveau van het besturingssysteem niet rechtstreeks een resource vertegenwoordigen.
java.io.StringReader is een voorbeeld van een closeable die close() niet hoeft aan te roepen omdat er geen resources van het besturingssysteem zijn die opgeschoond zouden moeten worden. Bij de analyse wordt er gebruikgemaakt van een expliciete witte lijst om klassen in java.io te detecteren die in deze categorie vallen. Bij deze klassen worden er geen waarschuwingen met betrekking tot resourcelekken gemeld.
Instances van klassen zoals java.io.BufferedInputStream zijn wrappers rond een andere resource (waarbij er op meerdere niveaus wrappers kunnen worden aangebracht). Bovendien vertegenwoordigen deze objecten niet rechtstreeks een resource van het besturingssysteem. Als de ingesloten of "wrapped" resource gesloten is, hoeft de wrapper niet te worden gesloten. Andersom geldt dat als de wrapper gesloten is, de ingesloten of "wrapped" resource eveneens gesloten is. Bij de analyse wordt er nog een tweede witte lijst gebruikt, voor het detecteren van wrapperresources. Daarmee kan worden vastgesteld of de onderliggende feitelijke resource direct of indirect wordt gesloten via de wrapper. In beide gevallen is dat voldoende om waarschuwingen met betrekking tot resourcelekken te voorkómen. De witte lijst bevat klassen uit java.io, java.util.zip, java.security, java.beans en java.sound.sampled.
Tip: Het is meestal het veiligst om de buitenste wrapper te sluiten, niet de ingesloten resources.