Copy File with Files.copy() Method in Java

📘 Premium Read: Access my best content on Medium member-only articles — deep dives into Java, Spring Boot, Microservices, backend architecture, interview preparation, career advice, and industry-standard best practices.

✅ Some premium posts are free to read — no account needed. Follow me on Medium to stay updated and support my writing.

🎓 Top 10 Udemy Courses (Huge Discount): Explore My Udemy Courses — Learn through real-time, project-based development.

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

Introduction

In Java, the Files.copy() method is part of the java.nio.file package and is used to copy files or directories. This method provides a flexible way to copy files, offering various options to control the copying process, such as whether to overwrite existing files or to copy file attributes. This guide will demonstrate how to use the Files.copy() method to copy a file from one location to another.

Table of Contents

1. Importing Required Packages
2. Copying a File with Files.copy()
3. Handling Exceptions
4. Copying Files with Different Options
5. Complete Example
6. Conclusion

Importing Required Packages

To use the Files.copy() method, you need to import the necessary classes from the java.nio.file package.

Example

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.StandardCopyOption;
import java.io.IOException;

Copying a File with Files.copy()

To copy a file, you need to specify the source path and the target path. The Files.copy() method takes these paths as arguments and copies the file from the source to the target location.

Example

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.io.IOException;

public class CopyFileExample {
    public static void main(String[] args) {
        Path sourcePath = Paths.get("source.txt");
        Path targetPath = Paths.get("target.txt");
        try {
            Files.copy(sourcePath, targetPath);
            System.out.println("File copied successfully: " + targetPath.toAbsolutePath());
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

In the example above, the Files.copy() method copies a file named source.txt to target.txt in the same directory.

Handling Exceptions

When copying a file, several exceptions might be thrown:

• FileAlreadyExistsException: If the target file already exists and the REPLACE_EXISTING option is not specified.
• DirectoryNotEmptyException: If the target file is a directory and it is not empty.
• IOException: If an I/O error occurs.
• SecurityException: If a security manager exists and denies read or write access to the file.

Example with Exception Handling

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.FileAlreadyExistsException;
import java.io.IOException;

public class CopyFileWithExceptionHandlingExample {
    public static void main(String[] args) {
        Path sourcePath = Paths.get("source.txt");
        Path targetPath = Paths.get("target.txt");
        try {
            Files.copy(sourcePath, targetPath);
            System.out.println("File copied successfully: " + targetPath.toAbsolutePath());
        } catch (FileAlreadyExistsException e) {
            System.err.println("Target file already exists: " + targetPath.toAbsolutePath());
        } catch (IOException e) {
            System.err.println("I/O error: " + e.getMessage());
        } catch (SecurityException e) {
            System.err.println("Access denied: " + e.getMessage());
        }
    }
}

In the example above, different exceptions are caught and handled appropriately, providing informative messages.

Copying Files with Different Options

The Files.copy() method can take an additional argument specifying copy options, such as whether to replace an existing file or to copy file attributes.

Example

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.StandardCopyOption;
import java.io.IOException;

public class CopyFileWithOptionsExample {
    public static void main(String[] args) {
        Path sourcePath = Paths.get("source.txt");
        Path targetPath = Paths.get("target.txt");
        try {
            Files.copy(sourcePath, targetPath, StandardCopyOption.REPLACE_EXISTING);
            System.out.println("File copied successfully with options: " + targetPath.toAbsolutePath());
        } catch (IOException e) {
            System.err.println("I/O error: " + e.getMessage());
        }
    }
}

In the example above, the Files.copy() method copies the file and replaces the target file if it already exists.

Complete Example

Here is a complete example demonstrating the creation, copying, and handling of files using the Files.copy() method with proper exception handling.

CopyFileExample.java

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.StandardCopyOption;
import java.nio.file.FileAlreadyExistsException;
import java.io.IOException;

public class CopyFileExample {
    public static void main(String[] args) {
        Path sourcePath = Paths.get("source.txt");
        Path targetPath = Paths.get("target.txt");
        try {
            Files.copy(sourcePath, targetPath, StandardCopyOption.REPLACE_EXISTING);
            System.out.println("File copied successfully: " + targetPath.toAbsolutePath());
        } catch (FileAlreadyExistsException e) {
            System.err.println("Target file already exists: " + targetPath.toAbsolutePath());
        } catch (IOException e) {
            System.err.println("I/O error: " + e.getMessage());
        } catch (SecurityException e) {
            System.err.println("Access denied: " + e.getMessage());
        }
    }
}

In this example, a file named source.txt is copied to target.txt in the same directory. The code handles exceptions to ensure that informative messages are displayed if an error occurs.

Conclusion

The Files.copy() method in Java provides a simple and efficient way to copy files in the file system. By understanding how to use this method and handle potential exceptions, you can effectively manage file copying operations in your Java applications. Remember to always handle exceptions appropriately to ensure your application can respond to errors gracefully.