File
类是 Java 中的一个重要类,它位于 java.io
包中。File
类代表文件和目录路径名的抽象表示形式。虽然 File
类可以表示文件或目录,但它本身不直接负责数据的读写操作;相反,它提供了检查文件属性(如大小、修改时间等)和管理文件(如创建、删除、重命名等)的方法。
创建 File 对象
你可以通过传递一个文件路径(字符串)给 File
类的构造函数来创建一个 File
对象。这个路径可以是绝对路径,也可以是相对于当前工作目录的相对路径。
java复制代码
File file = new File("example.txt"); // 相对于当前工作目录的文件 | |
File directory = new File("/path/to/directory"); // 绝对路径的目录 |
常用方法
createNewFile()
:当且仅当不存在具有此抽象路径名指定名称的文件时,创建一个新的空文件。delete()
:删除此抽象路径名表示的文件或目录。如果是一个目录,则必须为空才能删除。exists()
:测试此抽象路径名表示的文件或目录是否存在。isDirectory()
:测试此抽象路径名表示的文件是否是一个目录。isFile()
:测试此抽象路径名表示的文件是否是一个标准文件。getAbsolutePath()
:返回此抽象路径名的绝对路径名字符串。getParent()
:返回此抽象路径名父目录的路径名字符串;如果此路径名没有指定父目录,则返回null
。getName()
:返回由此抽象路径名表示的文件或目录的名称。length()
:返回由此抽象路径名表示的文件的长度,以字节为单位。list()
:返回一个字符串数组,这些字符串指定了此抽象路径名表示的目录中的文件和目录。listFiles()
:返回一个File
数组,这些File
表示此抽象路径名表示的目录中的文件和目录。
示例代码
import java.io.File; | |
public class FileExample { | |
public static void main(String[] args) { | |
File file = new File("example.txt"); | |
// 检查文件是否存在 | |
if (file.exists()) { | |
System.out.println("文件存在"); | |
// 获取并打印文件大小 | |
long fileSize = file.length(); | |
System.out.println("文件大小: " + fileSize + " 字节"); | |
// 假设我们要读取文件内容(这里只是示例,实际读取需要用到InputStream) | |
// ... | |
} else { | |
System.out.println("文件不存在"); | |
// 尝试创建文件 | |
try { | |
if (file.createNewFile()) { | |
System.out.println("文件已创建"); | |
} else { | |
System.out.println("文件创建失败(可能是文件已存在或其他原因)"); | |
} | |
} catch (Exception e) { | |
e.printStackTrace(); | |
} | |
} | |
// 检查并列出目录内容(假设我们有一个名为"testDir"的目录) | |
File dir = new File("testDir"); | |
if (dir.exists() && dir.isDirectory()) { | |
String[] files = dir.list(); | |
if (files != null) { | |
for (String fileName : files) { | |
System.out.println(fileName); | |
} | |
} | |
} | |
} | |
} |
注意事项
File
类的实例是不可变的;也就是说,一旦你创建了一个File
对象,你就不能改变它所表示的文件或目录的路径名。File
类的方法(如createNewFile()
,delete()
,exists()
等)可能会抛出IOException
或SecurityException
,尽管大多数File
方法实际上并不抛出IOException
(除了createNewFile()
在某些平台上可能会抛出)。- 当你尝试删除一个目录时,该目录必须为空,否则
delete()
方法将返回false
。要删除非空目录,你需要自己编写递归删除的代码,或者使用第三方库(如 Apache Commons IO)提供的工具方法。 File
类本身不提供读写文件内容的功能;要实现这一点,你需要使用InputStream
和OutputStream
的子类(如FileInputStream
,FileOutputStream
,BufferedReader
,BufferedWriter
等)。