Java Notes

File Class in Java

Complete guide to the java.io.File class — creating File objects, checking file properties, creating/deleting files and directories, listing contents, and file path operations.

What is the File Class?

The java.io.File class represents a file or directory path in the file system. It does NOT represent the file's content — it represents the abstract pathname (name and location) of a file or directory.

Important: The File class doesn't actually read or write file content. It handles file metadata operations:

Check if a file exists
Create/delete files and directories
Get file size, permissions, modification time
List directory contents
Rename and move files

Creating File Objects

java example

import java.io.File;

public class FileCreation {
    public static void main(String[] args) {
        // Method 1: Absolute path
        File file1 = new File("C:\\Users\\data\\report.txt");  // Windows
        File file1Unix = new File("/home/user/data/report.txt");  // Linux/Mac
        
        // Method 2: Relative path (relative to project directory)
        File file2 = new File("data.txt");
        
        // Method 3: Parent directory + filename
        File file3 = new File("C:\\Users\\data", "report.txt");
        
        // Method 4: Parent File + child name
        File parentDir = new File("C:\\Users\\data");
        File file4 = new File(parentDir, "report.txt");
        
        // Important: Creating a File object does NOT create the file on disk!
        File ghost = new File("nonexistent.txt");
        System.out.println("File object created: " + ghost.getName());
        System.out.println("Actually exists on disk? " + ghost.exists());
    }
}

Output:

Example

File object created: nonexistent.txt Actually exists on disk? false

Checking File Properties

java example

import java.io.File;
import java.util.Date;

public class FileProperties {
    public static void main(String[] args) {
        File file = new File("src/Main.java");  // Adjust path to an existing file
        
        System.out.println("=== File Properties ===\n");
        
        // Basic info
        System.out.println("Name:           " + file.getName());
        System.out.println("Path:           " + file.getPath());
        System.out.println("Absolute Path:  " + file.getAbsolutePath());
        System.out.println("Parent:         " + file.getParent());
        
        // Existence checks
        System.out.println("\n--- Existence ---");
        System.out.println("Exists?         " + file.exists());
        System.out.println("Is File?        " + file.isFile());
        System.out.println("Is Directory?   " + file.isDirectory());
        System.out.println("Is Hidden?      " + file.isHidden());
        
        // Size and time
        System.out.println("\n--- Size & Time ---");
        System.out.println("Size (bytes):   " + file.length());
        System.out.println("Last Modified:  " + new Date(file.lastModified()));
        
        // Permissions
        System.out.println("\n--- Permissions ---");
        System.out.println("Can Read?       " + file.canRead());
        System.out.println("Can Write?      " + file.canWrite());
        System.out.println("Can Execute?    " + file.canExecute());
        
        // Disk space (of the partition)
        System.out.println("\n--- Disk Space ---");
        System.out.printf("Total Space:    %.2f GB%n", file.getTotalSpace() / 1e9);
        System.out.printf("Free Space:     %.2f GB%n", file.getFreeSpace() / 1e9);
        System.out.printf("Usable Space:   %.2f GB%n", file.getUsableSpace() / 1e9);
    }
}

Output (example):

Name	Main.java
Path	src\Main.java
Absolute Path	C:\Projects\MyApp\src\Main.java
Parent	src
Size (bytes)	2456
Last Modified	Mon Jan 15 10:30:45 IST 2024
Total Space	476.94 GB
Free Space	234.12 GB
Usable Space	234.12 GB

Creating Files and Directories

java example

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

public class CreateFilesAndDirs {
    public static void main(String[] args) {
        System.out.println("=== Creating Files and Directories ===\n");
        
        // 1. Create a new file
        File newFile = new File("test_output.txt");
        try {
            if (newFile.createNewFile()) {
                System.out.println("✓ File created: " + newFile.getName());
            } else {
                System.out.println("✗ File already exists: " + newFile.getName());
            }
        } catch (IOException e) {
            System.out.println("Error creating file: " + e.getMessage());
        }
        
        // 2. Create a single directory
        File dir = new File("output");
        if (dir.mkdir()) {
            System.out.println("✓ Directory created: " + dir.getName());
        } else {
            System.out.println("✗ Directory exists or parent missing: " + dir.getName());
        }
        
        // 3. Create nested directories (parent + child)
        File nestedDirs = new File("output/reports/2024/january");
        if (nestedDirs.mkdirs()) {  // Note: mkdirS (plural)
            System.out.println("✓ Nested directories created: " + nestedDirs.getPath());
        } else {
            System.out.println("✗ Directories already exist: " + nestedDirs.getPath());
        }
        
        // 4. Create a temporary file
        try {
            File tempFile = File.createTempFile("myapp_", ".tmp");
            System.out.println("✓ Temp file: " + tempFile.getAbsolutePath());
            tempFile.deleteOnExit();  // Auto-delete when JVM exits
        } catch (IOException e) {
            System.out.println("Error creating temp file: " + e.getMessage());
        }
        
        // Cleanup
        newFile.delete();
    }
}

Output:

✓ File created	test_output.txt
✓ Directory created	output
✓ Nested directories created	output\reports\2024\january
✓ Temp file	C:\Users\user\AppData\Local\Temp\myapp_1234567890.tmp

Listing Directory Contents

Example

import java.io.File; import java.util.Arrays; public class ListDirectory { public static void main(String[] args) { File dir = new File("."); // Current directory System.out.println("Current directory: " + dir.getAbsolutePath()); System.out.println("\n=== All Files and Directories ==="); // Method 1: list() returns String array of names String[] names = dir.list(); if (names != null) { Arrays.sort(names); for (String name : names) { System.out.println(" " + name); } } System.out.println("\n=== Detailed Listing ==="); // Method 2: listFiles() returns File array (more useful) File[] files = dir.listFiles(); if (files != null) { Arrays.sort(files); System.out.printf("%-30s %-10s %10s%n", "Name", "Type", "Size"); System.out.println("-".repeat(55)); for (File f : files) { String type = f.isDirectory() ? "[DIR]" : "[FILE]"; String size = f.isFile() ? f.length() + " B" : "-"; System.out.printf("%-30s %-10s %10s%n", f.getName(), type, size); } } System.out.println("\n=== Only .java Files (Filtered) ==="); // Method 3: listFiles with filter File[] javaFiles = dir.listFiles((d, name) -> name.endsWith(".java")); if (javaFiles != null) { for (File f : javaFiles) { System.out.println(" " + f.getName() + " (" + f.length() + " bytes)"); } System.out.println(" Total: " + javaFiles.length + " Java files"); } } }

Recursive Directory Traversal

Example

import java.io.File; public class RecursiveListing { static void listRecursive(File dir, String indent) { File[] files = dir.listFiles(); if (files == null) return; // Sort: directories first, then files java.util.Arrays.sort(files, (a, b) -> { if (a.isDirectory() && !b.isDirectory()) return -1; if (!a.isDirectory() && b.isDirectory()) return 1; return a.getName().compareToIgnoreCase(b.getName()); }); for (File file : files) { if (file.isDirectory()) { System.out.println(indent + "📁 " + file.getName() + "/"); listRecursive(file, indent + " "); } else { System.out.printf("%s📄 %s (%s)%n", indent, file.getName(), formatSize(file.length())); } } } static String formatSize(long bytes) { if (bytes < 1024) return bytes + " B"; if (bytes < 1024 * 1024) return String.format("%.1f KB", bytes / 1024.0); return String.format("%.1f MB", bytes / (1024.0 * 1024.0)); } // Count files and total size recursively static long[] getStats(File dir) { long fileCount = 0, totalSize = 0; File[] files = dir.listFiles(); if (files != null) { for (File f : files) { if (f.isFile()) { fileCount++; totalSize += f.length(); } else if (f.isDirectory()) { long[] subStats = getStats(f); fileCount += subStats[0]; totalSize += subStats[1]; } } } return new long[]{fileCount, totalSize}; } public static void main(String[] args) { File projectDir = new File("."); System.out.println("📁 " + projectDir.getAbsolutePath()); listRecursive(projectDir, " "); long[] stats = getStats(projectDir); System.out.printf("%n--- Total: %d files, %s ---%n", stats[0], formatSize(stats[1])); } }

Renaming and Moving Files

java example

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

public class RenameMove {
    public static void main(String[] args) throws IOException {
        // Setup: create test files
        File original = new File("original.txt");
        original.createNewFile();
        
        File dir = new File("backup");
        dir.mkdir();
        
        System.out.println("=== Rename and Move Operations ===\n");
        
        // Rename (same directory)
        File renamed = new File("renamed.txt");
        if (original.renameTo(renamed)) {
            System.out.println("✓ Renamed: original.txt → renamed.txt");
        }
        
        // Move (different directory) — renameTo can also move
        File moved = new File("backup/renamed.txt");
        if (renamed.renameTo(moved)) {
            System.out.println("✓ Moved: renamed.txt → backup/renamed.txt");
        }
        
        // Cleanup
        moved.delete();
        dir.delete();
        
        System.out.println("\n✓ Cleanup complete");
    }
}

Deleting Files and Directories

java example

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

public class DeleteOperations {
    
    // Recursively delete a directory and all contents
    static boolean deleteRecursive(File file) {
        if (file.isDirectory()) {
            File[] children = file.listFiles();
            if (children != null) {
                for (File child : children) {
                    deleteRecursive(child);
                }
            }
        }
        boolean deleted = file.delete();
        System.out.println((deleted ? "  ✓ Deleted: " : "  ✗ Failed: ") + file.getPath());
        return deleted;
    }
    
    public static void main(String[] args) throws IOException {
        // Create test structure
        new File("testdir/sub1/deep").mkdirs();
        new File("testdir/sub2").mkdirs();
        new File("testdir/file1.txt").createNewFile();
        new File("testdir/sub1/file2.txt").createNewFile();
        new File("testdir/sub1/deep/file3.txt").createNewFile();
        
        System.out.println("Created test directory structure.");
        System.out.println("\n=== Deleting recursively ===");
        
        // Note: file.delete() only works on EMPTY directories!
        File testDir = new File("testdir");
        System.out.println("Can delete non-empty dir directly? " + testDir.delete());
        
        System.out.println("\nRecursive delete:");
        deleteRecursive(testDir);
    }
}

Output:

✓ Deleted	testdir\sub1\deep\file3.txt
✓ Deleted	testdir\sub1\deep
✓ Deleted	testdir\sub1\file2.txt
✓ Deleted	testdir\sub1
✓ Deleted	testdir\sub2
✓ Deleted	testdir\file1.txt
✓ Deleted	testdir

File Path Operations

java example

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

public class PathOperations {
    public static void main(String[] args) throws IOException {
        File file = new File("./src/../data/./report.txt");
        
        System.out.println("=== Path Operations ===\n");
        System.out.println("Original path:      " + file.getPath());
        System.out.println("Absolute path:      " + file.getAbsolutePath());
        System.out.println("Canonical path:     " + file.getCanonicalPath());
        // Canonical path resolves . and .. to give the true path
        
        System.out.println("\n--- Path Components ---");
        System.out.println("getName():          " + file.getName());
        System.out.println("getParent():        " + file.getParent());
        
        System.out.println("\n--- Separators ---");
        System.out.println("File.separator:     '" + File.separator + "'");
        System.out.println("File.pathSeparator: '" + File.pathSeparator + "'");
        // separator: / (Unix) or \ (Windows) — for file paths
        // pathSeparator: : (Unix) or ; (Windows) — for PATH variable
        
        System.out.println("\n--- System Roots ---");
        File[] roots = File.listRoots();
        for (File root : roots) {
            System.out.printf("Root: %s | Total: %.1f GB | Free: %.1f GB%n",
                root.getPath(),
                root.getTotalSpace() / 1e9,
                root.getFreeSpace() / 1e9);
        }
    }
}

Output (Windows):

Original path	.\src\..\data\.\report.txt
Absolute path	C:\Projects\MyApp\.\src\..\data\.\report.txt
Canonical path	C:\Projects\MyApp\data\report.txt
getName()	report.txt
getParent()	.\src\..\data\.
File.separator	'\'
File.pathSeparator	';'
Root	C:\ \| Total: 476.9 GB \| Free: 234.1 GB
Root	D:\ \| Total: 931.5 GB \| Free: 567.2 GB

Real-World Example: File Organizer

Example

import java.io.File; import java.util.HashMap; import java.util.Map; public class FileOrganizer { private static final Map<String, String> EXTENSION_FOLDERS = new HashMap<>(); static { EXTENSION_FOLDERS.put("jpg", "Images"); EXTENSION_FOLDERS.put("png", "Images"); EXTENSION_FOLDERS.put("gif", "Images"); EXTENSION_FOLDERS.put("pdf", "Documents"); EXTENSION_FOLDERS.put("doc", "Documents"); EXTENSION_FOLDERS.put("docx", "Documents"); EXTENSION_FOLDERS.put("txt", "Documents"); EXTENSION_FOLDERS.put("mp3", "Music"); EXTENSION_FOLDERS.put("wav", "Music"); EXTENSION_FOLDERS.put("mp4", "Videos"); EXTENSION_FOLDERS.put("avi", "Videos"); EXTENSION_FOLDERS.put("zip", "Archives"); EXTENSION_FOLDERS.put("rar", "Archives"); EXTENSION_FOLDERS.put("java", "Code"); EXTENSION_FOLDERS.put("py", "Code"); EXTENSION_FOLDERS.put("js", "Code"); } static String getExtension(String filename) { int lastDot = filename.lastIndexOf('.'); if (lastDot == -1 || lastDot == filename.length() - 1) { return ""; } return filename.substring(lastDot + 1).toLowerCase(); } static void organizeFolder(File sourceDir) { if (!sourceDir.isDirectory()) { System.out.println("Not a directory: " + sourceDir.getPath()); return; } File[] files = sourceDir.listFiles(File::isFile); if (files == null || files.length == 0) { System.out.println("No files to organize."); return; } int moved = 0, skipped = 0; for (File file : files) { String ext = getExtension(file.getName()); String folderName = EXTENSION_FOLDERS.getOrDefault(ext, "Others"); File targetDir = new File(sourceDir, folderName); if (!targetDir.exists()) { targetDir.mkdir(); } File targetFile = new File(targetDir, file.getName()); if (file.renameTo(targetFile)) { System.out.printf(" %-25s → %s/%n", file.getName(), folderName); moved++; } else { System.out.printf(" %-25s → FAILED%n", file.getName()); skipped++; } } System.out.printf("%nDone! Moved: %d | Failed: %d%n", moved, skipped); } public static void main(String[] args) { System.out.println("=== File Organizer ===\n"); // For demo, we just show what WOULD happen File downloads = new File("Downloads"); // Change to real path if (downloads.exists()) { organizeFolder(downloads); } else { System.out.println("Demo: Would organize files by extension into folders:"); System.out.println(" photo.jpg → Images/"); System.out.println(" report.pdf → Documents/"); System.out.println(" song.mp3 → Music/"); System.out.println(" Main.java → Code/"); System.out.println(" archive.zip → Archives/"); System.out.println(" unknown.xyz → Others/"); } } }

Common Mistakes

1. Assuming File object creation creates the file

java example

// ❌ WRONG assumption
File file = new File("data.txt");
// File does NOT exist on disk yet!
// You must call createNewFile() or write to it

// ✅ CORRECT
File file = new File("data.txt");
file.createNewFile();  // Now it exists

2. Not checking if operations succeeded

java example

// ❌ BAD: Ignoring return value
file.delete();  // Did it actually delete? We don't know!

// ✅ GOOD: Check the result
if (!file.delete()) {
    System.err.println("Failed to delete: " + file.getPath());
}

3. Using hardcoded path separators

java example

// ❌ BAD: Won't work on Linux/Mac
File file = new File("C:\\Users\\data\\file.txt");

// ✅ GOOD: Use File.separator or forward slashes
File file = new File("data" + File.separator + "file.txt");
// OR: Java accepts forward slashes on all platforms
File file = new File("data/file.txt");

File Class vs NIO (java.nio.file.Path)

Feature	File (java.io)	Path (java.nio)
Introduced	Java 1.0	Java 7
Symbolic links	No support	Full support
File attributes	Limited	Comprehensive
Error handling	Returns boolean	Throws descriptive exceptions
Watch service	Not available	Available
Performance	Good	Better for large operations
Recommendation	Legacy code	New code should use this

Interview Questions

Q1: Does creating a File object create the file on disk?

Answer: No. new File("test.txt") only creates an in-memory object representing the path. To actually create the file, call file.createNewFile() or write to it using a stream.

Q2: What is the difference between `mkdir()` and `mkdirs()`?

Answer: mkdir() creates only the specified directory and fails if parent directories don't exist. mkdirs() creates all necessary parent directories along with the target directory (like mkdir -p in Linux).

Q3: What is the difference between `getPath()`, `getAbsolutePath()`, and `getCanonicalPath()`?

Answer: getPath() returns the path as specified in the constructor. getAbsolutePath() resolves relative paths against the current directory but keeps . and ... getCanonicalPath() resolves ., .., symbolic links and returns the unique, normalized path.

Q4: Why does `File.delete()` return a boolean instead of throwing an exception?

Answer: It's a design choice from Java 1.0. The boolean return makes it easy to ignore failures (which is actually bad practice). The newer Files.delete() in NIO throws an IOException with details about why deletion failed, which is the preferred approach in modern Java.

Q5: How do you delete a non-empty directory?

Answer: You must first recursively delete all files and subdirectories inside it, then delete the directory itself. File.delete() only works on empty directories. Alternatively, use Files.walk() from NIO for a cleaner approach.

Exam Focus

Revise definitions, diagrams, examples, and short-answer points for File Class in Java.

Interview Use

Prepare one clear explanation, one practical example, and one common mistake for this Java Master Course topic.

Search Terms

java-master-course, java master course, java, master, course, file, handling, class

Continue learning this concept

File HandlingBuffered Streams in JavaComplete guide to Buffered Streams in Java — BufferedInputStream, BufferedOutputStream, BufferedReader, BufferedWriter, performance benefits, line-by-line reading, and real-world file processing.File HandlingByte Streams in JavaComplete guide to Byte Streams in Java — FileInputStream, FileOutputStream, reading and writing binary data, copying files, and understanding byte-level I/O operations.File HandlingCharacter Streams in JavaComplete guide to Character Streams in Java — FileReader, FileWriter, handling Unicode text, character encoding, reading/writing text files with proper internationalization support.File HandlingDeserialization in JavaComplete guide to Deserialization in Java — ObjectInputStream, reading objects from files, type safety, version compatibility, security risks, and best practices for safe deserialization.File HandlingJava NIO PackageComplete guide to Java NIO (New I/O) — Path, Files, Channels, Buffers, non-blocking I/O, WatchService, and modern file operations that replace traditional java.io approaches.File HandlingSerialization in JavaComplete guide to Serialization in Java — converting objects to byte streams, Serializable interface, ObjectOutputStream, transient keyword, serialVersionUID, and custom serialization.

PreviousDeserialization in Java NextJava NIO Package

Java Notes

File Class in Java

Complete guide to the java.io.File class — creating File objects, checking file properties, creating/deleting files and directories, listing contents, and file path operations.

What is the File Class?

Important: The File class doesn't actually read or write file content. It handles file metadata operations:

Check if a file exists
Create/delete files and directories
Get file size, permissions, modification time
List directory contents
Rename and move files

Creating File Objects

java example

import java.io.File;

public class FileCreation {
    public static void main(String[] args) {
        // Method 1: Absolute path
        File file1 = new File("C:\\Users\\data\\report.txt");  // Windows
        File file1Unix = new File("/home/user/data/report.txt");  // Linux/Mac
        
        // Method 2: Relative path (relative to project directory)
        File file2 = new File("data.txt");
        
        // Method 3: Parent directory + filename
        File file3 = new File("C:\\Users\\data", "report.txt");
        
        // Method 4: Parent File + child name
        File parentDir = new File("C:\\Users\\data");
        File file4 = new File(parentDir, "report.txt");
        
        // Important: Creating a File object does NOT create the file on disk!
        File ghost = new File("nonexistent.txt");
        System.out.println("File object created: " + ghost.getName());
        System.out.println("Actually exists on disk? " + ghost.exists());
    }
}

Output:

Example

File object created: nonexistent.txt Actually exists on disk? false

Checking File Properties

java example

import java.io.File;
import java.util.Date;

public class FileProperties {
    public static void main(String[] args) {
        File file = new File("src/Main.java");  // Adjust path to an existing file
        
        System.out.println("=== File Properties ===\n");
        
        // Basic info
        System.out.println("Name:           " + file.getName());
        System.out.println("Path:           " + file.getPath());
        System.out.println("Absolute Path:  " + file.getAbsolutePath());
        System.out.println("Parent:         " + file.getParent());
        
        // Existence checks
        System.out.println("\n--- Existence ---");
        System.out.println("Exists?         " + file.exists());
        System.out.println("Is File?        " + file.isFile());
        System.out.println("Is Directory?   " + file.isDirectory());
        System.out.println("Is Hidden?      " + file.isHidden());
        
        // Size and time
        System.out.println("\n--- Size & Time ---");
        System.out.println("Size (bytes):   " + file.length());
        System.out.println("Last Modified:  " + new Date(file.lastModified()));
        
        // Permissions
        System.out.println("\n--- Permissions ---");
        System.out.println("Can Read?       " + file.canRead());
        System.out.println("Can Write?      " + file.canWrite());
        System.out.println("Can Execute?    " + file.canExecute());
        
        // Disk space (of the partition)
        System.out.println("\n--- Disk Space ---");
        System.out.printf("Total Space:    %.2f GB%n", file.getTotalSpace() / 1e9);
        System.out.printf("Free Space:     %.2f GB%n", file.getFreeSpace() / 1e9);
        System.out.printf("Usable Space:   %.2f GB%n", file.getUsableSpace() / 1e9);
    }
}

Output (example):

Name	Main.java
Path	src\Main.java
Absolute Path	C:\Projects\MyApp\src\Main.java
Parent	src
Size (bytes)	2456
Last Modified	Mon Jan 15 10:30:45 IST 2024
Total Space	476.94 GB
Free Space	234.12 GB
Usable Space	234.12 GB

Creating Files and Directories

java example

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

public class CreateFilesAndDirs {
    public static void main(String[] args) {
        System.out.println("=== Creating Files and Directories ===\n");
        
        // 1. Create a new file
        File newFile = new File("test_output.txt");
        try {
            if (newFile.createNewFile()) {
                System.out.println("✓ File created: " + newFile.getName());
            } else {
                System.out.println("✗ File already exists: " + newFile.getName());
            }
        } catch (IOException e) {
            System.out.println("Error creating file: " + e.getMessage());
        }
        
        // 2. Create a single directory
        File dir = new File("output");
        if (dir.mkdir()) {
            System.out.println("✓ Directory created: " + dir.getName());
        } else {
            System.out.println("✗ Directory exists or parent missing: " + dir.getName());
        }
        
        // 3. Create nested directories (parent + child)
        File nestedDirs = new File("output/reports/2024/january");
        if (nestedDirs.mkdirs()) {  // Note: mkdirS (plural)
            System.out.println("✓ Nested directories created: " + nestedDirs.getPath());
        } else {
            System.out.println("✗ Directories already exist: " + nestedDirs.getPath());
        }
        
        // 4. Create a temporary file
        try {
            File tempFile = File.createTempFile("myapp_", ".tmp");
            System.out.println("✓ Temp file: " + tempFile.getAbsolutePath());
            tempFile.deleteOnExit();  // Auto-delete when JVM exits
        } catch (IOException e) {
            System.out.println("Error creating temp file: " + e.getMessage());
        }
        
        // Cleanup
        newFile.delete();
    }
}

Output:

✓ File created	test_output.txt
✓ Directory created	output
✓ Nested directories created	output\reports\2024\january
✓ Temp file	C:\Users\user\AppData\Local\Temp\myapp_1234567890.tmp

Listing Directory Contents

Example

Recursive Directory Traversal

Example

Renaming and Moving Files

java example

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

public class RenameMove {
    public static void main(String[] args) throws IOException {
        // Setup: create test files
        File original = new File("original.txt");
        original.createNewFile();
        
        File dir = new File("backup");
        dir.mkdir();
        
        System.out.println("=== Rename and Move Operations ===\n");
        
        // Rename (same directory)
        File renamed = new File("renamed.txt");
        if (original.renameTo(renamed)) {
            System.out.println("✓ Renamed: original.txt → renamed.txt");
        }
        
        // Move (different directory) — renameTo can also move
        File moved = new File("backup/renamed.txt");
        if (renamed.renameTo(moved)) {
            System.out.println("✓ Moved: renamed.txt → backup/renamed.txt");
        }
        
        // Cleanup
        moved.delete();
        dir.delete();
        
        System.out.println("\n✓ Cleanup complete");
    }
}

Deleting Files and Directories

java example

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

public class DeleteOperations {
    
    // Recursively delete a directory and all contents
    static boolean deleteRecursive(File file) {
        if (file.isDirectory()) {
            File[] children = file.listFiles();
            if (children != null) {
                for (File child : children) {
                    deleteRecursive(child);
                }
            }
        }
        boolean deleted = file.delete();
        System.out.println((deleted ? "  ✓ Deleted: " : "  ✗ Failed: ") + file.getPath());
        return deleted;
    }
    
    public static void main(String[] args) throws IOException {
        // Create test structure
        new File("testdir/sub1/deep").mkdirs();
        new File("testdir/sub2").mkdirs();
        new File("testdir/file1.txt").createNewFile();
        new File("testdir/sub1/file2.txt").createNewFile();
        new File("testdir/sub1/deep/file3.txt").createNewFile();
        
        System.out.println("Created test directory structure.");
        System.out.println("\n=== Deleting recursively ===");
        
        // Note: file.delete() only works on EMPTY directories!
        File testDir = new File("testdir");
        System.out.println("Can delete non-empty dir directly? " + testDir.delete());
        
        System.out.println("\nRecursive delete:");
        deleteRecursive(testDir);
    }
}

Output:

✓ Deleted	testdir\sub1\deep\file3.txt
✓ Deleted	testdir\sub1\deep
✓ Deleted	testdir\sub1\file2.txt
✓ Deleted	testdir\sub1
✓ Deleted	testdir\sub2
✓ Deleted	testdir\file1.txt
✓ Deleted	testdir

File Path Operations

java example

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

public class PathOperations {
    public static void main(String[] args) throws IOException {
        File file = new File("./src/../data/./report.txt");
        
        System.out.println("=== Path Operations ===\n");
        System.out.println("Original path:      " + file.getPath());
        System.out.println("Absolute path:      " + file.getAbsolutePath());
        System.out.println("Canonical path:     " + file.getCanonicalPath());
        // Canonical path resolves . and .. to give the true path
        
        System.out.println("\n--- Path Components ---");
        System.out.println("getName():          " + file.getName());
        System.out.println("getParent():        " + file.getParent());
        
        System.out.println("\n--- Separators ---");
        System.out.println("File.separator:     '" + File.separator + "'");
        System.out.println("File.pathSeparator: '" + File.pathSeparator + "'");
        // separator: / (Unix) or \ (Windows) — for file paths
        // pathSeparator: : (Unix) or ; (Windows) — for PATH variable
        
        System.out.println("\n--- System Roots ---");
        File[] roots = File.listRoots();
        for (File root : roots) {
            System.out.printf("Root: %s | Total: %.1f GB | Free: %.1f GB%n",
                root.getPath(),
                root.getTotalSpace() / 1e9,
                root.getFreeSpace() / 1e9);
        }
    }
}

Output (Windows):

Original path	.\src\..\data\.\report.txt
Absolute path	C:\Projects\MyApp\.\src\..\data\.\report.txt
Canonical path	C:\Projects\MyApp\data\report.txt
getName()	report.txt
getParent()	.\src\..\data\.
File.separator	'\'
File.pathSeparator	';'
Root	C:\ \| Total: 476.9 GB \| Free: 234.1 GB
Root	D:\ \| Total: 931.5 GB \| Free: 567.2 GB

Real-World Example: File Organizer

Example

Common Mistakes

1. Assuming File object creation creates the file

java example

// ❌ WRONG assumption
File file = new File("data.txt");
// File does NOT exist on disk yet!
// You must call createNewFile() or write to it

// ✅ CORRECT
File file = new File("data.txt");
file.createNewFile();  // Now it exists

2. Not checking if operations succeeded

java example

// ❌ BAD: Ignoring return value
file.delete();  // Did it actually delete? We don't know!

// ✅ GOOD: Check the result
if (!file.delete()) {
    System.err.println("Failed to delete: " + file.getPath());
}

3. Using hardcoded path separators

java example

// ❌ BAD: Won't work on Linux/Mac
File file = new File("C:\\Users\\data\\file.txt");

// ✅ GOOD: Use File.separator or forward slashes
File file = new File("data" + File.separator + "file.txt");
// OR: Java accepts forward slashes on all platforms
File file = new File("data/file.txt");

File Class vs NIO (java.nio.file.Path)

Feature	File (java.io)	Path (java.nio)
Introduced	Java 1.0	Java 7
Symbolic links	No support	Full support
File attributes	Limited	Comprehensive
Error handling	Returns boolean	Throws descriptive exceptions
Watch service	Not available	Available
Performance	Good	Better for large operations
Recommendation	Legacy code	New code should use this

Interview Questions

Q1: Does creating a File object create the file on disk?

Answer: No. new File("test.txt") only creates an in-memory object representing the path. To actually create the file, call file.createNewFile() or write to it using a stream.

Q2: What is the difference between `mkdir()` and `mkdirs()`?

Q3: What is the difference between `getPath()`, `getAbsolutePath()`, and `getCanonicalPath()`?

Q4: Why does `File.delete()` return a boolean instead of throwing an exception?

Q5: How do you delete a non-empty directory?

Exam Focus

Revise definitions, diagrams, examples, and short-answer points for File Class in Java.

Interview Use

Prepare one clear explanation, one practical example, and one common mistake for this Java Master Course topic.

Search Terms

java-master-course, java master course, java, master, course, file, handling, class

Continue learning this concept

PreviousDeserialization in Java NextJava NIO Package

What is the File Class?

Creating File Objects

Checking File Properties

Creating Files and Directories

Listing Directory Contents

Recursive Directory Traversal

Renaming and Moving Files

Deleting Files and Directories

File Path Operations

Real-World Example: File Organizer

Common Mistakes

1. Assuming File object creation creates the file

2. Not checking if operations succeeded

3. Using hardcoded path separators

File Class vs NIO (java.nio.file.Path)

Interview Questions

Q1: Does creating a File object create the file on disk?

Q2: What is the difference between mkdir() and mkdirs()?

Q3: What is the difference between getPath(), getAbsolutePath(), and getCanonicalPath()?

Q4: Why does File.delete() return a boolean instead of throwing an exception?

Q5: How do you delete a non-empty directory?

Continue learning this concept

What is the File Class?

Creating File Objects

Checking File Properties

Creating Files and Directories

Listing Directory Contents

Recursive Directory Traversal

Renaming and Moving Files

Deleting Files and Directories

File Path Operations

Real-World Example: File Organizer

Common Mistakes

1. Assuming File object creation creates the file

2. Not checking if operations succeeded

3. Using hardcoded path separators

File Class vs NIO (java.nio.file.Path)

Interview Questions

Q1: Does creating a File object create the file on disk?

Q2: What is the difference between mkdir() and mkdirs()?

Q3: What is the difference between getPath(), getAbsolutePath(), and getCanonicalPath()?

Q4: Why does File.delete() return a boolean instead of throwing an exception?

Q5: How do you delete a non-empty directory?

Continue learning this concept

Q2: What is the difference between `mkdir()` and `mkdirs()`?

Q3: What is the difference between `getPath()`, `getAbsolutePath()`, and `getCanonicalPath()`?

Q4: Why does `File.delete()` return a boolean instead of throwing an exception?

Q2: What is the difference between `mkdir()` and `mkdirs()`?

Q3: What is the difference between `getPath()`, `getAbsolutePath()`, and `getCanonicalPath()`?

Q4: Why does `File.delete()` return a boolean instead of throwing an exception?