Java – ファイルの存在チェックをして無ければ作成する方法

2025-04-15更新日: 2025-04-15

Javaでは、java.io.Fileクラスを使用してファイルの存在を確認し、存在しない場合は新たに作成できます。

Fileオブジェクトのexists()メソッドでファイルの存在を確認し、createNewFile()メソッドで新しいファイルを作成します。

これにより、指定したパスにファイルが存在しない場合にのみ新規作成が行われます。

エラーハンドリングにはIOExceptionを使用します。

目次から探す

ファイルの存在チェック方法
ファイルが存在しない場合の新規作成方法
実装例：ファイルの存在チェックと作成
応用：ディレクトリの自動作成とファイル作成
よくあるエラーとその対処法
まとめ

ファイルの存在チェック方法

Javaでファイルの存在をチェックするには、java.nio.fileパッケージを使用します。

このパッケージには、ファイルやディレクトリの操作に便利なクラスが含まれています。

特に、Filesクラスのexistsメソッドを利用することで、指定したパスにファイルが存在するかどうかを簡単に確認できます。

以下に、ファイルの存在をチェックするためのサンプルコードを示します。

import java.nio.file.Files; // Filesクラスをインポート
import java.nio.file.Path;  // Pathクラスをインポート
import java.nio.file.Paths; // Pathsクラスをインポート
import java.io.IOException;  // IOExceptionクラスをインポート
public class App {
    public static void main(String[] args) {
        // チェックするファイルのパスを指定
        String filePath = "example.txt"; 
        Path path = Paths.get(filePath); // Pathオブジェクトを作成
        // ファイルの存在をチェック
        if (Files.exists(path)) {
            System.out.println("ファイルは存在します。");
        } else {
            System.out.println("ファイルは存在しません。");
        }
    }
}

このコードでは、example.txtというファイルが存在するかどうかを確認しています。

Files.exists(path)メソッドがtrueを返す場合、ファイルは存在し、falseの場合は存在しないことを示します。

ファイルは存在しません。

このように、Javaを使って簡単にファイルの存在をチェックすることができます。

次のステップでは、ファイルが存在しない場合に新たに作成する方法について解説します。

ファイルが存在しない場合の新規作成方法

Javaでファイルが存在しない場合に新たにファイルを作成するには、java.nio.fileパッケージのFilesクラスを使用します。

具体的には、Files.createFileメソッドを利用して新しいファイルを作成します。

このメソッドは、指定したパスにファイルが存在しない場合にのみファイルを作成します。

以下に、ファイルが存在しない場合に新規作成するためのサンプルコードを示します。

import java.nio.file.Files; // Filesクラスをインポート
import java.nio.file.Path;  // Pathクラスをインポート
import java.nio.file.Paths; // Pathsクラスをインポート
import java.io.IOException;  // IOExceptionクラスをインポート
public class App {
    public static void main(String[] args) {
        // チェックするファイルのパスを指定
        String filePath = "example.txt"; 
        Path path = Paths.get(filePath); // Pathオブジェクトを作成
        // ファイルの存在をチェック
        if (Files.exists(path)) {
            System.out.println("ファイルは存在します。");
        } else {
            System.out.println("ファイルは存在しません。新規作成します。");
            try {
                // 新しいファイルを作成
                Files.createFile(path); 
                System.out.println("ファイルを作成しました: " + filePath);
            } catch (IOException e) {
                System.out.println("ファイルの作成に失敗しました: " + e.getMessage());
            }
        }
    }
}

このコードでは、example.txtというファイルが存在しない場合に新たにファイルを作成します。

Files.createFile(path)メソッドを呼び出すことで、指定したパスにファイルが作成されます。

もしファイルの作成に失敗した場合は、IOExceptionがスローされ、そのエラーメッセージが表示されます。

ファイルは存在しません。新規作成します。
ファイルを作成しました: example.txt

このように、Javaを使ってファイルが存在しない場合に新たにファイルを作成することができます。

次のステップでは、ディレクトリが存在しない場合に自動的に作成し、その中にファイルを作成する方法について解説します。

実装例：ファイルの存在チェックと作成

ここでは、ファイルの存在をチェックし、存在しない場合には新たにファイルを作成する一連の処理を実装した例を示します。

この例では、指定したディレクトリ内にファイルを作成することも考慮しています。

以下のサンプルコードでは、example.txtというファイルをmyDirectoryというディレクトリ内に作成します。

ディレクトリが存在しない場合は、先にディレクトリを作成します。

import java.nio.file.Files; // Filesクラスをインポート
import java.nio.file.Path;  // Pathクラスをインポート
import java.nio.file.Paths; // Pathsクラスをインポート
import java.io.IOException;  // IOExceptionクラスをインポート
public class App {
    public static void main(String[] args) {
        // ディレクトリとファイルのパスを指定
        String directoryPath = "myDirectory"; 
        String filePath = directoryPath + "/example.txt"; 
        Path dirPath = Paths.get(directoryPath); // ディレクトリのPathオブジェクトを作成
        Path filePathObj = Paths.get(filePath); // ファイルのPathオブジェクトを作成
        try {
            // ディレクトリの存在をチェック
            if (!Files.exists(dirPath)) {
                // ディレクトリが存在しない場合は作成
                Files.createDirectory(dirPath); 
                System.out.println("ディレクトリを作成しました: " + directoryPath);
            }
            // ファイルの存在をチェック
            if (Files.exists(filePathObj)) {
                System.out.println("ファイルは存在します。");
            } else {
                System.out.println("ファイルは存在しません。新規作成します。");
                // 新しいファイルを作成
                Files.createFile(filePathObj); 
                System.out.println("ファイルを作成しました: " + filePath);
            }
        } catch (IOException e) {
            System.out.println("エラーが発生しました: " + e.getMessage());
        }
    }
}

このコードでは、まず指定したディレクトリが存在するかどうかを確認します。

存在しない場合は、Files.createDirectory(dirPath)メソッドを使用して新しいディレクトリを作成します。

その後、指定したファイルが存在するかどうかをチェックし、存在しない場合には新たにファイルを作成します。

ディレクトリを作成しました: myDirectory
ファイルは存在しません。新規作成します。
ファイルを作成しました: myDirectory/example.txt

このように、Javaを使ってファイルとディレクトリの存在をチェックし、必要に応じて新たに作成することができます。

次のセクションでは、ディレクトリの自動作成とファイル作成の応用について解説します。

応用：ディレクトリの自動作成とファイル作成

Javaでは、ファイルを作成する際に必要なディレクトリが存在しない場合、自動的にそのディレクトリを作成することができます。

これを実現するためには、Files.createDirectoriesメソッドを使用します。

このメソッドは、指定したパスに必要なすべてのディレクトリを作成します。

以下に、指定したパスにディレクトリが存在しない場合に自動的に作成し、その中にファイルを作成するサンプルコードを示します。

import java.nio.file.Files; // Filesクラスをインポート
import java.nio.file.Path;  // Pathクラスをインポート
import java.nio.file.Paths; // Pathsクラスをインポート
import java.io.IOException;  // IOExceptionクラスをインポート
public class App {
    public static void main(String[] args) {
        // 作成するディレクトリとファイルのパスを指定
        String directoryPath = "myDirectory/subDirectory"; 
        String filePath = directoryPath + "/example.txt"; 
        Path dirPath = Paths.get(directoryPath); // ディレクトリのPathオブジェクトを作成
        Path filePathObj = Paths.get(filePath); // ファイルのPathオブジェクトを作成
        try {
            // 必要なディレクトリをすべて作成
            Files.createDirectories(dirPath); 
            System.out.println("ディレクトリを作成しました: " + directoryPath);
            // ファイルの存在をチェック
            if (Files.exists(filePathObj)) {
                System.out.println("ファイルは存在します。");
            } else {
                System.out.println("ファイルは存在しません。新規作成します。");
                // 新しいファイルを作成
                Files.createFile(filePathObj); 
                System.out.println("ファイルを作成しました: " + filePath);
            }
        } catch (IOException e) {
            System.out.println("エラーが発生しました: " + e.getMessage());
        }
    }
}

このコードでは、myDirectory/subDirectoryというパスに必要なディレクトリをすべて作成し、その中にexample.txtというファイルを作成します。

Files.createDirectories(dirPath)メソッドを使用することで、指定したパスに存在しないすべてのディレクトリが自動的に作成されます。

ディレクトリを作成しました: myDirectory/subDirectory
ファイルは存在しません。新規作成します。
ファイルを作成しました: myDirectory/subDirectory/example.txt

このように、Javaを使ってディレクトリを自動的に作成し、その中にファイルを作成することができます。

これにより、ファイル操作を行う際の手間を大幅に軽減することができます。

次のセクションでは、ファイル操作におけるよくあるエラーとその対処法について解説します。

よくあるエラーとその対処法

Javaでファイルやディレクトリを操作する際には、いくつかの一般的なエラーが発生することがあります。

ここでは、よくあるエラーとその対処法について解説します。

エラーの種類	説明	対処法
`NoSuchFileException`	指定したファイルが存在しない場合に発生します。	ファイルのパスを確認し、正しいパスを指定します。
`FileAlreadyExistsException`	同名のファイルが既に存在する場合に発生します。	ファイルを作成する前に、存在をチェックします。
`IOException`	入出力操作中に発生する一般的なエラーです。	エラーメッセージを確認し、原因を特定します。
`SecurityException`	ファイルやディレクトリへのアクセス権がない場合に発生します。	アクセス権を確認し、必要に応じて権限を変更します。