The Java Tutorials have been written for JDK 8. Examples and practices described in this page don't take advantage of improvements introduced in later releases and might use technology no longer available.
SeeDev.java for updated tutorials taking advantage of the latest releases.
SeeJava Language Changes for a summary of updated language features in Java SE 9 and subsequent releases.
SeeJDK Release Notes for information about new features, enhancements, and removed or deprecated options for all JDK releases.

Legacy File I/O Code

Interoperability With Legacy Code

Prior to the Java SE 7 release, thejava.io.File class was the mechanism used for file I/O, but it had several drawbacks.

• Many methods didn't throw exceptions when they failed, so it was impossible to obtain a useful error message. For example, if a file deletion failed, the program would receive a "delete fail" but wouldn't know if it was because the file didn't exist, the user didn't have permissions, or there was some other problem.
• Therename method didn't work consistently across platforms.
• There was no real support for symbolic links.
• More support for metadata was desired, such as file permissions, file owner, and other security attributes.
• Accessing file metadata was inefficient.
• Many of theFile methods didn't scale. Requesting a large directory listing over a server could result in a hang. Large directories could also cause memory resource problems, resulting in a denial of service.
• It was not possible to write reliable code that could recursively walk a file tree and respond appropriately if there were circular symbolic links.

Perhaps you have legacy code that usesjava.io.File and would like to take advantage of thejava.nio.file.Path functionality with minimal impact to your code.

Thejava.io.File class provides thetoPath method, which converts an old styleFile instance to ajava.nio.file.Path instance, as follows:

Path input = file.toPath();

You can then take advantage of the rich feature set available to thePath class.

For example, assume you had some code that deleted a file:

file.delete();

You could modify this code to use theFiles.delete method, as follows:

Path fp = file.toPath();Files.delete(fp);

Conversely, thePath.toFile method constructs ajava.io.File object for aPath object.

Mapping java.io.File Functionality to java.nio.file

Because the Java implementation of file I/O has been completely re-architected in the Java SE 7 release, you cannot swap one method for another method. If you want to use the rich functionality offered by thejava.nio.file package, your easiest solution is to use theFile.toPath method as suggested in the previous section. However, if you do not want to use that approach or it is not sufficient for your needs, you must rewrite your file I/O code.

There is no one-to-one correspondence between the two APIs, but the following table gives you a general idea of what functionality in thejava.io.File API maps to in thejava.nio.file API and tells you where you can obtain more information.