リソース・リークの回避

インターフェース 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 ステートメントで管理するようにしてください。

所有権 / 責務

基本的に上記の診断方法では、リソース・タイプのインスタンスを作成するメソッドはこのリソースのクローズに対しても責任があると想定しています。 しかし、一部のリソースは、複数のメソッド間で共有されます。ここで、分析は、次のような想定で実施されます。

リソース・ラッパーおよびリソース・フリーの Closeable

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 のクラスが含まれます。

ヒント: 通常、ラップされるリソースではなく最外部のラッパーをクローズするのが最も安全で望ましい方法です。