インターフェース java.io.Closeable (JDK 1.5 以降) および java.lang.AutoCloseable (JDK 1.7 以降) を実装するクラスは、外部リソースを表すと見なされ、これらが必要なくなったときにはメソッド close() を使用してクローズする必要があります。
Eclipse Java コンパイラーは、そのような型を使用するコードがこのポリシーに準拠するどうかを分析することができます。 例えば、次のスニペットでは明らかにリソース・リークが発生します。
int len(File f) throws IOException {
InputStream stream = new FileInputStream(f);
return stream.available();
}
コンパイラーによりこれにフラグが立てられ、「リソース・リーク: 'stream' は決してクローズされません」が表示されます。
フロー分析では、以下の状況が検出されます。
さらにフロー分析では、変数割り当てを使ってリソース値の追跡が試行されます。 ただし、異なるリソースが異なる制御フローまたはシーケンス内で同じ変数に割り当てられる可能性がある場合、分析の精度が低くなる場合があります。
デフォルトでは、すべての分析が使用可能になっているわけではありません。個々の構成オプションについては、コンパイラー設定を参照してください。
ヒント: リソース・タイプ変数が他の目的で再利用されない場合には、一般的に、コードの分析は容易になります (目で見て読む場合でも理解しやすくなります)。 理想的には、Java 7 プログラムでは、すべてのリソースを try-with-resources ステートメントで管理するようにしてください。
基本的に上記の診断方法では、リソース・タイプのインスタンスを作成するメソッドはこのリソースのクローズに対しても責任があると想定しています。 しかし、一部のリソースは、複数のメソッド間で共有されます。ここで、分析は、次のような想定で実施されます。
new 式によるものではなくメソッド呼び出しによるものである場合、そのメソッドの責任の有無はその時により異なり、問題がある場合には、単にリソース・リークの可能性があるものとしてフラグが立てられる。
JDK で定義されるクラスの中には、Closeable を実装してはいても、オペレーティング・システム・レベルのリソースを直接には表さないものがいくつかあります。
close() の呼び出しを必要としない Closeable の例として java.io.StringReader があります。
その場合、オペレーティング・システム・リソースが保持されないため、クリーンアップは必要ありません。
分析では、明示的なホワイト・リストを使用して、このカテゴリーに分類されるクラスが java.io から検出されます。
これらのクラスについては、リソース・リーク警告は出されません。
java.io.BufferedInputStream などのクラスのインスタンスは、別のリソース (ラッパーを複数のレベルで適用可能) のラッパーになります。
また、これらのオブジェクトは、オペレーティング・システム・リソースを直接表すものではありません。
ラップされたリソースがクローズされる場合、ラッパーのクローズは必要ありません。
逆に、ラッパーがクローズされる場合、ラップされたリソースもクローズされます。
分析には、ラッパー・リソースを検出するための第 2 のホワイト・リストがあり、基礎となる実際のリソースが直接クローズされるのか、それともラッパーを介して間接的にクローズされるのかが認識されます。
そのいずれかにより、リソース・リークに関する警告は出なくなります。
このホワイト・リストには、java.io、java.util.zip、java.security、java.beans、および java.sound.sampled のクラスが含まれます。
ヒント: 通常、ラップされるリソースではなく最外部のラッパーをクローズするのが最も安全で望ましい方法です。