FileNotFoundException in Java

🎓 Top 15 Udemy Courses (80-90% Discount): My Udemy Courses - Ramesh Fadatare — All my Udemy courses are real-time and project oriented courses.

▶️ Subscribe to My YouTube Channel (178K+ subscribers): Java Guides on YouTube

▶️ For AI, ChatGPT, Web, Tech, and Generative AI, subscribe to another channel: Ramesh Fadatare on YouTube

In this blog post, we will learn what is FileNotFoundException, how it occurs, practical examples, potential solutions, and best practices.

Understanding FileNotFoundException 

The FileNotFoundException is a checked exception that indicates that a file with the specified pathname does not exist. Alternatively, in some scenarios, it can mean the application does not have adequate permissions to access the file. 

As FileNotFoundException is a checked exception in Java so you're required to handle it, either by catching it or declaring it in the method signature using the throws keyword.

FileNotFoundException Class Diagram

Why Does It Occur? 

File Doesn’t Exist: The most obvious reason. If you're trying to read a file that doesn't exist, you'll get this exception. 

No Read/Write Permissions: Even if the file exists, if your program doesn’t have appropriate permissions to read or write to the file, this exception will be thrown. 

Directory Instead of File: If you're trying to use a directory as if it was a regular file, you'll encounter this exception. 

Other I/O Issues: Issues such as a broken symbolic link can also lead to this exception.

Practical Example 

Let's demonstrate this exception through a simple Java program:

import java.io.FileReader;
import java.io.IOException;

public class FileNotFoundExceptionExample {
    public static void main(String[] args) {
        try {
            FileReader reader = new FileReader("non_existent_file.txt");
            int character;

            while ((character = reader.read()) != -1) {
                System.out.print((char) character);
            }
            reader.close();

        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

Output:

java.io.FileNotFoundException: non_existent_file.txt (The system cannot find the file specified)
	at java.base/java.io.FileInputStream.open0(Native Method)
	at java.base/java.io.FileInputStream.open(FileInputStream.java:219)
	at java.base/java.io.FileInputStream.<init>(FileInputStream.java:158)
	at java.base/java.io.FileInputStream.<init>(FileInputStream.java:112)
	at java.base/java.io.FileReader.<init>(FileReader.java:60)
	at com.javaguides.net.FileNotFoundExceptionExample.main(FileNotFoundExceptionExample.java:9)

How to Handle FileNotFoundException? 

Check File Path: Ensure the pathname provided is accurate. Relative paths can be tricky; always verify them. 

File Existence Check: Before performing any file operation, check if the file exists using the File.exists() method. 

Manage Permissions: If your application runs in an environment with restricted permissions, make sure it has the right to access the file or directory. 

Graceful Degradation: If your application can still function without the file, consider providing a fallback mechanism rather than terminating the operation. 

Clear User Messages: If a user input can cause this exception, ensure the error messages are user-friendly and guide them to resolve the issue. 

Best Practices 

When dealing with file paths, always prefer using libraries like java.nio.file.Paths or java.nio.file.Path which provides a more intuitive API. 

Regularly log and monitor file-related operations in applications, especially in dynamic environments where files can be moved or deleted. 

If the application heavily relies on external files, consider implementing automated tests to check file availability and permissions.

Conclusion 

In this blog post, we have learned what is FileNotFoundException, how it occurs, practical examples, potential solutions, and best practices.

Related Exceptions Posts

Java built-in checked exceptions:

• FileNotFoundException
• EOFException
• ClassNotFoundException
• SQLException
• NoSuchMethodException
• InterruptedException

Java built-in unchecked exceptions:

• NullPointerException
• ArrayIndexOutOfBoundsException
• StringIndexOutOfBoundsException
• ArithmeticException
• IllegalArgumentException
• NumberFormatException
• IllegalStateException
• ClassCastException

Java built-in errors:

• OutOfMemoryError
• StackOverflowError
• NoClassDefFoundError

My Top and Bestseller Udemy Courses. The sale is going on with a 70 - 80% discount. The discount coupon has been added to each course below:

Build REST APIs with Spring Boot 4, Spring Security 7, and JWT

🆕 High-Demand 80–90% OFF

[NEW] Learn Apache Maven with IntelliJ IDEA and Java 25

🆕 High-Demand 80–90% OFF

ChatGPT + Generative AI + Prompt Engineering for Beginners

🚀 Trending Now 80–90% OFF

Spring 7 and Spring Boot 4 for Beginners (Includes 8 Projects)

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Building Real-Time REST APIs with Spring Boot - Blog App

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Building Microservices with Spring Boot and Spring Cloud

🌟 Top Rated 80–90% OFF
Available in Udemy for Business

Java Full-Stack Developer Course with Spring Boot and React JS

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Build 5 Spring Boot Projects with Java: Line-by-Line Coding

🌟 Top Rated 80–90% OFF

Testing Spring Boot Application with JUnit and Mockito

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Spring Boot Thymeleaf Real-Time Web Application - Blog App

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Master Spring Data JPA with Hibernate

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Spring Boot + Apache Kafka Course - The Practical Guide

🎓 Student Favorite 80–90% OFF
Available in Udemy for Business

Java Testing: Mastering JUnit 5 Framework

🆕 New 80–90% OFF

Reactive Programming in Java: Spring WebFlux and Testing

🌟 Top Rated 80–90% OFF

Spring Boot + RabbitMQ Course - The Practical Guide

🌟 Top Rated 80–90% OFF
Available in Udemy for Business

Functional Programming in Java (Includes Java Collections)

🎓 Student Favorite 80–90% OFF

ChatGPT for Java Developers: Boost Your Productivity with AI

🚀 Trending Now 80–90% OFF