Java – Fileクラスの使い方 – ファイルの基本的な操作方法

JavaのFileクラスは、ファイルやディレクトリの操作を行うためのクラスです。

主な機能として、ファイルの作成createNewFile()、削除delete()、存在確認exists()、読み取り・書き込み可能かの確認canRead()やcanWrite()、ファイル名やパスの取得getName()やgetPath()、ディレクトリ内のファイル一覧取得list()やlistFiles()などがあります。

ファイル操作時には例外処理(IOExceptionなど)を適切に扱う必要があります。

目次から探す

Fileクラスとは

JavaのFileクラスは、ファイルやディレクトリを操作するためのクラスです。

このクラスを使用することで、ファイルシステム上のファイルやディレクトリの情報を取得したり、ファイルの作成、削除、移動、コピーなどの操作を行うことができます。

Fileクラスは、java.ioパッケージに含まれており、ファイルのパスを表すためのオブジェクトを作成することができます。

主な機能

ファイルやディレクトリの存在確認
ファイルの作成、削除、移動
ファイルの情報取得(サイズ、最終更新日時など)
ディレクトリ内のファイル一覧取得

Fileクラスの基本操作

Fileクラスを使用することで、ファイルやディレクトリに対する基本的な操作を簡単に行うことができます。

以下では、ファイルの作成、削除、移動、コピー、情報取得などの基本操作について解説します。

ファイルの作成

ファイルを新規に作成するには、createNewFile()メソッドを使用します。

以下はそのサンプルコードです。

import java.io.File;
import java.io.IOException;
public class App {
    public static void main(String[] args) {
        // 新しいファイルのパスを指定
        File file = new File("newFile.txt");
        
        try {
            // ファイルを作成
            if (file.createNewFile()) {
                System.out.println("ファイルが作成されました。");
            } else {
                System.out.println("ファイルはすでに存在します。");
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

ファイルが作成されました。

ファイルの削除

ファイルを削除するには、delete()メソッドを使用します。

以下はそのサンプルコードです。

import java.io.File;
public class App {
    public static void main(String[] args) {
        // 削除するファイルのパスを指定
        File file = new File("newFile.txt");
        
        // ファイルを削除
        if (file.delete()) {
            System.out.println("ファイルが削除されました。");
        } else {
            System.out.println("ファイルの削除に失敗しました。");
        }
    }
}

ファイルが削除されました。

ファイルの移動

ファイルを移動するには、renameTo(File dest)メソッドを使用します。

以下はそのサンプルコードです。

import java.io.File;
public class App {
    public static void main(String[] args) {
        // 移動元ファイルのパスを指定
        File sourceFile = new File("newFile.txt");
        // 移動先ファイルのパスを指定
        File destFile = new File("movedFile.txt");
        
        // ファイルを移動
        if (sourceFile.renameTo(destFile)) {
            System.out.println("ファイルが移動されました。");
        } else {
            System.out.println("ファイルの移動に失敗しました。");
        }
    }
}

ファイルが移動されました。

ファイルの情報取得

ファイルの情報を取得するには、length()メソッドやlastModified()メソッドを使用します。

以下はそのサンプルコードです。

import java.io.File;
public class App {
    public static void main(String[] args) {
        // ファイルのパスを指定
        File file = new File("movedFile.txt");
        
        // ファイルのサイズを取得
        long fileSize = file.length();
        // 最終更新日時を取得
        long lastModified = file.lastModified();
        
        System.out.println("ファイルサイズ: " + fileSize + " バイト");
        System.out.println("最終更新日時: " + lastModified);
    }
}

ファイルサイズ: 0 バイト
最終更新日時: 1633036800000

これらの基本操作を通じて、Fileクラスを使ったファイル管理がどのように行えるかが理解できるでしょう。

ディレクトリ操作

Fileクラスを使用すると、ディレクトリの作成、削除、内容の一覧取得など、ディレクトリに関するさまざまな操作を行うことができます。

以下では、これらの基本的なディレクトリ操作について解説します。

ディレクトリの作成

新しいディレクトリを作成するには、mkdir()メソッドまたはmkdirs()メソッドを使用します。

mkdir()は単一のディレクトリを作成し、mkdirs()は親ディレクトリも含めて必要なすべてのディレクトリを作成します。

以下はそのサンプルコードです。

import java.io.File;
public class App {
    public static void main(String[] args) {
        // 新しいディレクトリのパスを指定
        File directory = new File("newDirectory");
        
        // ディレクトリを作成
        if (directory.mkdir()) {
            System.out.println("ディレクトリが作成されました。");
        } else {
            System.out.println("ディレクトリはすでに存在します。");
        }
    }
}

ディレクトリが作成されました。

ディレクトリの削除

ディレクトリを削除するには、delete()メソッドを使用します。

ただし、ディレクトリが空でない場合は削除できません。

以下はそのサンプルコードです。

import java.io.File;
public class App {
    public static void main(String[] args) {
        // 削除するディレクトリのパスを指定
        File directory = new File("newDirectory");
        
        // ディレクトリを削除
        if (directory.delete()) {
            System.out.println("ディレクトリが削除されました。");
        } else {
            System.out.println("ディレクトリの削除に失敗しました。ディレクトリが空であることを確認してください。");
        }
    }
}

ディレクトリの削除に失敗しました。ディレクトリが空であることを確認してください。

ディレクトリ内のファイル一覧取得

ディレクトリ内のファイルやサブディレクトリの一覧を取得するには、list()メソッドを使用します。

以下はそのサンプルコードです。

import java.io.File;
public class App {
    public static void main(String[] args) {
        // 対象のディレクトリのパスを指定
        File directory = new File("newDirectory");
        
        // ディレクトリ内のファイル一覧を取得
        String[] files = directory.list();
        
        if (files != null) {
            System.out.println("ディレクトリ内のファイル一覧:");
            for (String fileName : files) {
                System.out.println(fileName);
            }
        } else {
            System.out.println("ディレクトリが空または存在しません。");
        }
    }
}

ディレクトリが空または存在しません。

ディレクトリの情報取得

ディレクトリの情報を取得するには、isDirectory()メソッドやgetAbsolutePath()メソッドを使用します。

以下はそのサンプルコードです。

import java.io.File;
public class App {
    public static void main(String[] args) {
        // ディレクトリのパスを指定
        File directory = new File("newDirectory");
        
        // ディレクトリの存在確認
        if (directory.isDirectory()) {
            System.out.println("指定されたパスはディレクトリです。");
            System.out.println("絶対パス: " + directory.getAbsolutePath());
        } else {
            System.out.println("指定されたパスはディレクトリではありません。");
        }
    }
}

指定されたパスはディレクトリです。
絶対パス: /path/to/current/directory/newDirectory

これらの操作を通じて、Fileクラスを使用したディレクトリ管理がどのように行えるかが理解できるでしょう。

ファイルパスの操作

Fileクラスを使用すると、ファイルパスの操作が簡単に行えます。

ファイルパスの取得、正規化、親ディレクトリの取得など、さまざまな操作が可能です。

以下では、これらの基本的なファイルパス操作について解説します。

ファイルパスの取得

ファイルのパスを取得するには、getPath()メソッドやgetAbsolutePath()メソッドを使用します。

getPath()は相対パスを返し、getAbsolutePath()は絶対パスを返します。

以下はそのサンプルコードです。

import java.io.File;
public class App {
    public static void main(String[] args) {
        // ファイルのパスを指定
        File file = new File("example.txt");
        
        // 相対パスを取得
        String relativePath = file.getPath();
        // 絶対パスを取得
        String absolutePath = file.getAbsolutePath();
        
        System.out.println("相対パス: " + relativePath);
        System.out.println("絶対パス: " + absolutePath);
    }
}

相対パス: example.txt
絶対パス: /path/to/current/directory/example.txt

ファイルパスの正規化

ファイルパスを正規化するには、getCanonicalPath()メソッドを使用します。

このメソッドは、シンボリックリンクや相対パスを解決した絶対パスを返します。

以下はそのサンプルコードです。

import java.io.File;
import java.io.IOException;
public class App {
    public static void main(String[] args) {
        // ファイルのパスを指定
        File file = new File("example.txt");
        
        try {
            // 正規化されたパスを取得
            String canonicalPath = file.getCanonicalPath();
            System.out.println("正規化されたパス: " + canonicalPath);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

正規化されたパス: /path/to/current/directory/example.txt

親ディレクトリの取得

ファイルの親ディレクトリを取得するには、getParent()メソッドやgetParentFile()メソッドを使用します。

以下はそのサンプルコードです。

import java.io.File;
public class App {
    public static void main(String[] args) {
        // ファイルのパスを指定
        File file = new File("example.txt");
        
        // 親ディレクトリを取得
        String parentPath = file.getParent();
        File parentFile = file.getParentFile();
        
        System.out.println("親ディレクトリのパス: " + parentPath);
        System.out.println("親ディレクトリのFileオブジェクト: " + parentFile);
    }
}

親ディレクトリのパス: /path/to/current/directory
親ディレクトリのFileオブジェクト: /path/to/current/directory

ファイル名の取得

ファイル名を取得するには、getName()メソッドを使用します。

以下はそのサンプルコードです。

import java.io.File;
public class App {
    public static void main(String[] args) {
        // ファイルのパスを指定
        File file = new File("example.txt");
        
        // ファイル名を取得
        String fileName = file.getName();
        
        System.out.println("ファイル名: " + fileName);
    }
}

ファイル名: example.txt

これらの操作を通じて、Fileクラスを使用したファイルパスの管理がどのように行えるかが理解できるでしょう。

Fileクラスを使った応用例

Fileクラスは、ファイルやディレクトリの基本操作だけでなく、さまざまな応用にも利用できます。

ここでは、ファイルのコピー、移動、ディレクトリ内のファイルの検索、ファイルの読み書きなどの応用例を紹介します。

ファイルのコピー

Javaの標準ライブラリにはファイルコピーのためのメソッドはありませんが、FileInputStreamとFileOutputStreamを使用してファイルをコピーすることができます。

以下はそのサンプルコードです。

import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
public class App {
    public static void main(String[] args) {
        // コピー元ファイルとコピー先ファイルのパスを指定
        File sourceFile = new File("source.txt");
        File destFile = new File("copy.txt");
        
        try (FileInputStream in = new FileInputStream(sourceFile);
             FileOutputStream out = new FileOutputStream(destFile)) {
            
            byte[] buffer = new byte[1024];
            int length;
            
            // ファイルをコピー
            while ((length = in.read(buffer)) > 0) {
                out.write(buffer, 0, length);
            }
            
            System.out.println("ファイルがコピーされました。");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

ファイルがコピーされました。

ディレクトリ内の特定のファイルを検索

特定の拡張子を持つファイルをディレクトリ内で検索するには、再帰的にディレクトリを探索する方法があります。

以下はそのサンプルコードです。

import java.io.File;
public class App {
    public static void main(String[] args) {
        // 検索するディレクトリのパスを指定
        File directory = new File("targetDirectory");
        
        // 特定の拡張子を持つファイルを検索
        String extension = ".txt";
        searchFiles(directory, extension);
    }
    
    public static void searchFiles(File dir, String extension) {
        File[] files = dir.listFiles();
        
        if (files != null) {
            for (File file : files) {
                if (file.isDirectory()) {
                    // サブディレクトリを再帰的に検索
                    searchFiles(file, extension);
                } else if (file.getName().endsWith(extension)) {
                    System.out.println("見つかったファイル: " + file.getAbsolutePath());
                }
            }
        }
    }
}

見つかったファイル: /path/to/targetDirectory/example.txt

ファイルの読み書き

ファイルにデータを書き込むには、FileWriterを使用し、ファイルからデータを読み込むには、FileReaderを使用します。

以下はそのサンプルコードです。

import java.io.File;
import java.io.FileReader;
import java.io.FileWriter;
import java.io.IOException;
public class App {
    public static void main(String[] args) {
        // 書き込むファイルのパスを指定
        File file = new File("output.txt");
        
        // ファイルにデータを書き込む
        try (FileWriter writer = new FileWriter(file)) {
            writer.write("こんにちは、Javaのファイル操作！\n");
            writer.write("ファイルにデータを書き込みました。");
            System.out.println("データがファイルに書き込まれました。");
        } catch (IOException e) {
            e.printStackTrace();
        }
        
        // ファイルからデータを読み込む
        try (FileReader reader = new FileReader(file)) {
            int character;
            System.out.println("ファイルの内容:");
            while ((character = reader.read()) != -1) {
                System.out.print((char) character);
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

データがファイルに書き込まれました。
ファイルの内容:
こんにちは、Javaのファイル操作！
ファイルにデータを書き込みました。

これらの応用例を通じて、Fileクラスを使用したファイル管理の幅広い可能性が理解できるでしょう。

ファイル操作は、プログラムの中で非常に重要な役割を果たすため、これらの技術を活用してさまざまなアプリケーションを作成することができます。

Fileクラスと例外処理

Fileクラスを使用する際には、さまざまな例外が発生する可能性があります。

特に、ファイルやディレクトリの操作を行う場合、存在しないファイルを参照したり、アクセス権限がない場合などに例外が発生します。

ここでは、Fileクラスを使用する際の一般的な例外処理の方法について解説します。

例外の種類

Fileクラスを使用する際に考慮すべき主な例外は以下の通りです。

例外名	説明
`IOException`	入出力操作中に発生する一般的な例外
`FileNotFoundException`	指定したファイルが見つからない場合に発生
`SecurityException`	アクセス権限がない場合に発生

例外処理の基本

try-catchブロックを使用して、例外を適切に処理することが重要です。

以下は、ファイルの読み込み時に例外処理を行うサンプルコードです。

import java.io.File;
import java.io.FileReader;
import java.io.FileNotFoundException;
import java.io.IOException;
public class App {
    public static void main(String[] args) {
        // 読み込むファイルのパスを指定
        File file = new File("example.txt");
        
        // ファイルを読み込む
        try (FileReader reader = new FileReader(file)) {
            int character;
            System.out.println("ファイルの内容:");
            while ((character = reader.read()) != -1) {
                System.out.print((char) character);
            }
        } catch (FileNotFoundException e) {
            System.out.println("エラー: 指定したファイルが見つかりません。");
        } catch (IOException e) {
            System.out.println("エラー: 入出力操作中に問題が発生しました。");
        } catch (SecurityException e) {
            System.out.println("エラー: アクセス権限がありません。");
        }
    }
}

出力結果(ファイルが存在しない場合):

エラー: 指定したファイルが見つかりません。

複数の例外を処理する

Java 7以降では、複数の例外を一つのcatchブロックで処理することができます。

以下はそのサンプルコードです。

import java.io.File;
import java.io.FileReader;
import java.io.FileNotFoundException;
import java.io.IOException;
public class App {
    public static void main(String[] args) {
        // 読み込むファイルのパスを指定
        File file = new File("example.txt");
        
        // ファイルを読み込む
        try (FileReader reader = new FileReader(file)) {
            int character;
            System.out.println("ファイルの内容:");
            while ((character = reader.read()) != -1) {
                System.out.print((char) character);
            }
        } catch (FileNotFoundException | SecurityException e) {
            System.out.println("エラー: " + e.getMessage());
        } catch (IOException e) {
            System.out.println("エラー: 入出力操作中に問題が発生しました。");
        }
    }
}

出力結果(ファイルが存在しない場合):

エラー: example.txt (そのようなファイルはありません)

例外の詳細情報を取得する

例外が発生した場合、getMessage()メソッドを使用してエラーメッセージを取得することができます。

また、printStackTrace()メソッドを使用すると、例外のスタックトレースを表示することができます。

以下はそのサンプルコードです。

import java.io.File;
import java.io.FileReader;
import java.io.FileNotFoundException;
import java.io.IOException;
public class App {
    public static void main(String[] args) {
        // 読み込むファイルのパスを指定
        File file = new File("example.txt");
        
        // ファイルを読み込む
        try (FileReader reader = new FileReader(file)) {
            int character;
            System.out.println("ファイルの内容:");
            while ((character = reader.read()) != -1) {
                System.out.print((char) character);
            }
        } catch (FileNotFoundException e) {
            System.out.println("エラー: 指定したファイルが見つかりません。");
            e.printStackTrace(); // スタックトレースを表示
        } catch (IOException e) {
            System.out.println("エラー: 入出力操作中に問題が発生しました。");
            e.printStackTrace(); // スタックトレースを表示
        }
    }
}

出力結果(ファイルが存在しない場合):

エラー: 指定したファイルが見つかりません。
java.io.FileNotFoundException: example.txt (そのようなファイルはありません)
	at java.base/java.io.FileInputStream.open0(Native Method)
	at java.base/java.io.FileInputStream.open(FileInputStream.java:219)
	at java.base/java.io.FileReader.<init>(FileReader.java:65)
	at App.main(App.java:5)

これらの例外処理のテクニックを使用することで、Fileクラスを使ったファイル操作において、より堅牢で信頼性の高いプログラムを作成することができます。

例外が発生した場合でも、適切に処理することで、プログラムのクラッシュを防ぎ、ユーザーに有用な情報を提供することが可能です。