### FileUtils 的方法大全
本文将详细介绍 `FileUtils` 类中提供的各种文件操作方法，这些方法在 Java 开发中非常实用，能够帮助开发者高效地完成文件处理任务。
#### 一、获取系统的临时目录路径
**方法名**: `getTempDirectoryPath`
**功能**: 返回系统的临时目录路径。
**代码实现**:
```java
public static String getTempDirectoryPath() {
return System.getProperty("java.io.tmpdir");
}
```
**说明**: 此方法通过调用 `System.getProperty("java.io.tmpdir")` 来获取系统临时文件夹的位置。这个位置通常是操作系统用来存放临时文件的地方。
#### 二、获取代表系统临时目录的文件对象
**方法名**: `getTempDirectory`
**功能**: 返回一个表示系统临时目录的 `File` 对象。
**代码实现**:
```java
public static File getTempDirectory() {
return new File(getTempDirectoryPath());
}
```
**说明**: 该方法首先调用 `getTempDirectoryPath()` 获取到临时目录的路径字符串，然后通过构造函数 `new File(path)` 创建一个对应的 `File` 对象。
#### 三、获取用户的主目录路径
**方法名**: `getUserDirectoryPath`
**功能**: 返回用户的主目录路径。
**代码实现**:
```java
public static String getUserDirectoryPath() {
return System.getProperty("user.home");
}
```
**说明**: 此方法通过调用 `System.getProperty("user.home")` 来获取用户的主目录路径。这通常指的是当前登录用户的主目录。
#### 四、获取代表用户主目录的文件对象
**方法名**: `getUserDirectory`
**功能**: 返回一个表示用户主目录的 `File` 对象。
**代码实现**:
```java
public static File getUserDirectory() {
return new File(getUserDirectoryPath());
}
```
**说明**: 与 `getTempDirectory()` 方法类似，该方法先调用 `getUserDirectoryPath()` 获取用户的主目录路径，然后通过 `new File(path)` 创建对应的 `File` 对象。
#### 五、根据指定的文件获取一个新的文件输入流
**方法名**: `openInputStream`
**功能**: 根据给定的文件路径打开一个新的文件输入流。
**代码实现**:
```java
public static FileInputStream openInputStream(File file) throws IOException {
if (file.exists()) {
if (file.isDirectory()) {
throw new IOException("File '" + file + "' exists but is a directory");
}
if (!file.canRead()) {
throw new IOException("File '" + file + "' cannot be read");
}
} else {
throw new FileNotFoundException("File '" + file + "' does not exist");
}
return new FileInputStream(file);
}
```
**说明**: 在此方法中，首先检查文件是否存在；如果存在，则进一步检查是否为目录或是否可读。如果文件不存在，则抛出 `FileNotFoundException` 异常。返回一个 `FileInputStream` 对象用于读取文件。
#### 六、根据指定的文件获取一个新的文件输出流
**方法名**: `openOutputStream`
**功能**: 根据给定的文件路径打开一个新的文件输出流。
**代码实现**:
```java
public static FileOutputStream openOutputStream(File file) throws IOException {
if (file.exists()) {
if (file.isDirectory()) {
throw new IOException("File '" + file + "' exists but is a directory");
}
if (!file.canWrite()) {
throw new IOException("File '" + file + "' cannot be written to");
}
} else {
File parent = file.getParentFile();
if (parent != null && !parent.exists()) {
if (!parent.mkdirs()) {
throw new IOException("File '" + file + "' could not be created");
}
}
}
return new FileOutputStream(file);
}
```
**说明**: 在打开文件输出流前，此方法会检查文件是否存在、是否为目录以及是否可写。如果文件不存在且其父目录也不存在，则尝试创建父目录。如果所有条件满足，则返回 `FileOutputStream` 对象用于写入文件。
#### 七、节数转换成直观带单位的值
**方法名**: `byteCountToDisplaySize`
**功能**: 将字节数量转换为更易于理解的形式，例如 GB、MB、KB 或者字节。
**代码实现**:
```java
public static String byteCountToDisplaySize(long size) {
String displaySize;
if (size / ONE_GB > 0) {
displaySize = String.valueOf(size / ONE_GB) + "GB";
} else if (size / ONE_MB > 0) {
displaySize = String.valueOf(size / ONE_MB) + "MB";
} else if (size / ONE_KB > 0) {
displaySize = String.valueOf(size / ONE_KB) + "KB";
} else {
displaySize = String.valueOf(size) + "bytes";
}
return displaySize;
}
```
**说明**: 这个方法将一个长整型的字节数转换为 GB、MB 或 KB 的形式，并以字符串返回。它通过简单的条件判断来决定应该使用哪种单位来表示字节数。
#### 八、创建一个空文件或更新文件的最近修改时间
**方法名**: `touch`
**功能**: 如果文件不存在，则创建一个空文件；如果文件已存在，则更新文件的最近修改时间。
**代码实现**:
```java
public static void touch(File file) throws IOException {
if (!file.exists()) {
OutputStream out = openOutputStream(file);
IOUtils.closeQuietly(out); // 关闭输出流
}
}
```
**说明**: 该方法首先检查文件是否存在。如果不存在，则调用 `openOutputStream` 方法创建文件。文件创建后，立即关闭输出流。如果文件已经存在，则不执行任何操作。这样就确保了文件的存在并且更新了其最后修改时间。
### 总结
通过以上介绍可以看出，`FileUtils` 提供了一系列强大的文件操作方法，可以方便地完成文件的读写、创建、删除等常见操作。这些方法不仅简化了文件处理流程，还提高了代码的可读性和可维护性。希望本文能够帮助大家更好地理解和使用 `FileUtils`。
