Rajapinnan java.io.Closeable (JDK 1.5:stä lähtien) ja
java.lang.AutoCloseable (JDK 1.7:stä lähtien) toteuttavien luokkien ajatellaan
edustavan ulkoisia resursseja, jotka on suljettava metodin close() avulla, kun niitä
ei enää tarvita.
Eclipse Java -kääntäjä voi analysoida, noudattaako tällaisia tyyppejä käyttävä koodi tätä käytäntöä. Seuraava koodikatkelma esimerkiksi edustaa selvää resurssivuotoa:
int len(File f) throws IOException {
InputStream stream = new FileInputStream(f);
return stream.available();
}
Kääntäjä liputtaa tämän merkinnällä Resurssivuoto: virtaa ei ole suljettu.
Virta-analyysi tunnistaa seuraavat tilanteet:
Lisäksi virta-analyysi yrittää seurata resurssin arvoja muuttujan esittelyjen avulla. Jos samalle muuttujalle (joka on eri ohjausvirrassa tai sarjassa) voidaan kuitenkin määrittää eri resursseja, analyysista tulee epätarkempi.
Kaikki analyysit eivät ole käytössä oletusarvon mukaan. Lisätietoja yksittäisistä kokoonpanoasetuksista on kääntäjän oletusasetuksissa.
Vihjeitä: Koodia on yleensä helpompi analysoida (ja ihmisten vaivattomampi ymmärtää), jos resurssityypin muuttujia ei käytetä uudelleen eri tarkoituksiin. Parhaassa tapauksessa kaikkia resursseja ohjataan Java 7 -ohjelmissa try-with-resources-lauseen avulla.
Edellä oleva vianmääritys olettaa periaatteessa, että resurssityypin ilmentymän luova metodi on myös vastuussa resurssin sulkemisesta. Jotkin resurssit jaetaan kuitenkin useiden metodien kesken. Tässä analyysi olettaa seuraavaa:
new-lausekkeen asemesta, se saattaa olla vastuussa sulkemisesta. Ongelmat liputetaan vain mahdollisina resurssivuotoina.
JDK määrittää muutaman luokan, jotka toteuttavat Closeable-rajapinnan, mutta eivät suoraan
edusta resurssia käyttöjärjestelmän tasolla.
Java.io.StringReader on esimerkki closeable-rajapinnasta, joka ei edellytä close()-metodin kutsua, koska puhdistusta vaativia käyttöjärjestelmän resursseja ei ole.
Analyysi tunnistaa tähän luokkaan kuuluvat luokat java.io-paketista eksplisiittisen valkoisen luettelon avulla.
Näitä luokkia koskevia resurssivuotovaroituksia ei anneta.
Luokkien, kuten java.io.BufferedInputStream, ilmentymät ovat liittymäobjekteja toisen resurssin (jossa liittymäobjekteja voidaan käyttää monella tasolla) ympärillä.
Nämä objektit eivät myöskään edusta suoraan käyttöjärjestelmän resurssia.
Jos liittymäobjektiresurssi on suljettu, liittymäobjektia ei tarvitse sulkea.
Jos taas liittymäobjekti on suljettu, se käsittää myös liittymäobjektiresurssin sulkemisen.
Analyysilla on toinen valkoinen luettelo liittymäobjektiresurssien tunnistukseen, ja analyysi tunnistaa, suljetaanko pohjana oleva todellinen resurssi suoraan vai epäsuoraan liittymäobjektin kautta.
Molemmat ovat riittäviä resurssivuotoja koskevien varoitusten estämiseen.
Valkoinen luettelo sisältää luokkia java.io-, java.util.zip-, java.security-, java.beans-
ja java.sound.sampled-paketeista.
Vihje: yleensä on parempi tai turvallisempi sulkea uloin liittymäobjekti eikä liittymäobjektiresurssia.