Javaのlist()メソッドとlistFiles()メソッドの違いをわかりやすく解説

java.ioパッケージに含まれるFileクラスは、システム上のファイルやディレクトリ（パス名）を抽象的に表現するためのクラスです。特定のディレクトリ内に存在するすべてのファイルやフォルダの一覧を取得したい場合、このクラスが提供するlist()メソッドとlistFiles()メソッドを利用できます。

両者の主な違いは次のとおりです。

• list()メソッド：指定したディレクトリ内の全ファイル・ディレクトリの「名前」を、String型の配列として返します。

• listFiles()メソッド：指定したディレクトリ内の全ファイル・ディレクトリを表すFileオブジェクトを、File型の配列として返します。

つまり、ディレクトリ内のファイル名だけが必要な場合はlist()メソッドで十分ですが、ファイル名や絶対パスなどの詳細情報が必要な場合は、listFiles()メソッドでFileオブジェクトを取得し、getName()やgetAbsolutePath()などの各種メソッドを呼び出して必要な情報を取り出すことになります。

両メソッドの比較一覧

list()メソッドの使用例

import java.io.File;
import java.io.IOException;

public class ListOfFiles {
    public static void main(String args[]) throws IOException {
        // ディレクトリを表すFileオブジェクトを作成
        File path = new File("D:\\ExampleDirectory");
        // ファイルとディレクトリの一覧を取得
        String contents[] = path.list();
        System.out.println("指定されたディレクトリ内のファイル・ディレクトリ一覧：");
        for(int i = 0; i < contents.length; i++) {
            System.out.println(contents[i]);
        }
    }
}

実行結果

指定されたディレクトリ内のファイル・ディレクトリ一覧：
SampleDirectory1
SampleDirectory2
SampleFile1.txt
SampleFile2.txt
SapmleFile3.txt

このように、list()メソッドを使えば、ファイル名やディレクトリ名だけを文字列として手軽に取得できます。

listFiles()メソッドの使用例

import java.io.File;
import java.io.IOException;

public class ListOfFiles {
    public static void main(String args[]) throws IOException {
        // ディレクトリを表すFileオブジェクトを作成
        File path = new File("D:\\ExampleDirectory");
        // 一覧をFileオブジェクトとして取得
        File files[] = path.listFiles();
        System.out.println("指定されたディレクトリ内のファイル・ディレクトリ一覧：");
        for(File file : files) {
            System.out.println("ファイル名：" + file.getName());
            System.out.println("ファイルパス：" + file.getAbsolutePath());
            System.out.println(" ");
        }
    }
}

実行結果

指定されたディレクトリ内のファイル・ディレクトリ一覧：
ファイル名：SampleDirectory1
ファイルパス：D:\ExampleDirectory\SampleDirectory1

ファイル名：SampleDirectory2
ファイルパス：D:\ExampleDirectory\SampleDirectory2

ファイル名：SampleFile1.txt
ファイルパス：D:\ExampleDirectory\SampleFile1.txt

ファイル名：SampleFile2.txt
ファイルパス：D:\ExampleDirectory\SampleFile2.txt

ファイル名：SapmleFile3.txt
ファイルパス：D:\ExampleDirectory\SapmleFile3.txt

listFiles()メソッドはFileオブジェクトを返すため、上記のようにgetName()でファイル名を、getAbsolutePath()で絶対パスを取得するなど、各ファイルに対して柔軟に操作や情報取得を行えます。

まとめ

list()とlistFiles()はどちらもディレクトリ内の一覧を取得するメソッドですが、list()は名前だけを持つString配列を、listFiles()は詳細情報を持つFileオブジェクトの配列を返す点が最大の違いです。単純に名前一覧が必要ならlist()、ファイルの属性や詳細を扱いたいならlistFiles()と、目的に応じて使い分けるとよいでしょう。