Java : NoSuchFileException with Examples

NoSuchFileException (Java SE 21 & JDK 21) with Examples.
You will find code examples on most NoSuchFileException methods.

Summary

Checked exception thrown when an attempt is made to access a file that does not exist.

Class diagram

final var file = Path.of("R:", "java-work", "aaa.txt");
System.out.println(file); // R:\java-work\aaa.txt
System.out.println(Files.notExists(file)); // true

try {
    System.out.println("-- delete --");
    Files.delete(file);
} catch (NoSuchFileException e) {
    System.out.println(e);
}

// Result
// ↓
//-- delete --
//java.nio.file.NoSuchFileException: R:\java-work\aaa.txt

final var src = Path.of("R:", "java-work", "aaa.txt");
final var dst = Path.of("R:", "java-work", "bbb.txt");

System.out.println(src); // R:\java-work\aaa.txt
System.out.println(dst); // R:\java-work\bbb.txt
System.out.println(Files.notExists(src)); // true
System.out.println(Files.notExists(dst)); // true

try {
    System.out.println("-- copy --");
    Files.copy(src, dst);
} catch (NoSuchFileException e) {
    System.out.println(e);
}

// Result
// ↓
//-- copy --
//java.nio.file.NoSuchFileException: R:\java-work\aaa.txt

Constructors

NoSuchFileException (String file)

Constructs an instance of this class.

final var e = new NoSuchFileException("aaa.txt");
System.out.println(e); // java.nio.file.NoSuchFileException: aaa.txt
System.out.println(e.getFile()); // aaa.txt

NoSuchFileException (String file, String other, String reason)

Constructs an instance of this class.

final var e = new NoSuchFileException("aaa.txt", "bbb.txt", "Reason!");
System.out.println(e); // java.nio.file.NoSuchFileException: aaa.txt -> bbb.txt: Reason!
System.out.println(e.getFile()); // aaa.txt
System.out.println(e.getOtherFile()); // bbb.txt
System.out.println(e.getReason()); // Reason!
System.out.println(e.getMessage()); // aaa.txt -> bbb.txt: Reason!