在Java程序中复制文件时，可能会遇到java.nio.file.InvalidPathException，提示“Illegal char”错误。这通常是由于目标文件路径包含了在文件系统中不允许使用的字符导致的。本文将详细介绍如何避免此类错误，并提供清晰的代码示例和注意事项，帮助开发者安全有效地复制文件。
问题分析
java.nio.file.InvalidPathException 异常表明你尝试创建的文件路径包含非法字符。在Windows系统中，常见非法字符包括 <、>、:、"、/、、|、?、* 等。在提供的代码示例中，异常信息显示非法字符为 :，位于时间格式化后的字符串中。
Exception in thread "AWT-EventQueue-0" java.nio.file.InvalidPathException: Illegal char <:> at index 2: D:\DOFN Materials\App\LMSystem\Copy\back14-11-2022 12:19:06_LMSystem
这段错误信息表明，由于在文件名中直接使用了包含冒号的时间字符串（例如 "12:19:06"），导致创建文件路径失败。
解决方案
要解决此问题，需要确保生成的文件名不包含任何非法字符。以下是推荐的解决方案：
立即学习“Java免费学习笔记（深入）”；
- 使用java.time API进行日期时间格式化：避免使用SimpleDateFormat，推荐使用java.time包下的类，例如LocalDateTime和DateTimeFormatter。
- 移除或替换非法字符：在将日期时间字符串添加到文件名之前，移除或替换所有非法字符。例如，可以将冒号替换为下划线或连字符。
- 使用Paths.get()创建Path对象：使用Paths.get()替代new File()来创建文件路径，这是新API推荐的做法。
- 检查路径中的空格：确保文件路径中没有多余的空格，因为空格也是路径问题的一个常见来源。
代码示例
以下是修改后的代码示例，展示了如何安全地复制文件并避免InvalidPathException：
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.StandardCopyOption;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
import java.util.logging.Level;
import java.util.logging.Logger;
import javax.swing.JOptionPane;
public class FileCopyExample {
public void copyFile() {
try {
// 1. 使用 java.time API 获取当前时间并格式化
LocalDateTime now = LocalDateTime.now();
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd-MM-yyyy_HH-mm-ss");
String formattedDate = now.format(formatter);
// 2. 定义源文件和目标文件路径
Path sourceFile = Paths.get("D:\DOFN Materials\App\LMSystem\LMSystem.sqlite");
//注意：这里使用Paths.get()替代new File()
// 3. 构建目标文件路径，并使用格式化后的日期时间字符串
Path destinationFile = Paths.get("D:\DOFN Materials\App\LMSystem\Copy\back" + formattedDate + "_LMSystem");
// 4. 复制文件
Files.copy(sourceFile, destinationFile, StandardCopyOption.REPLACE_EXISTING);
System.out.println("File copied successfully!");
JOptionPane.showMessageDialog(null, formattedDate + " Copy Successfully !!");
} catch (IOException ex) {
Logger.getLogger(FileCopyExample.class.getName()).log(Level.SEVERE, null, ex);
JOptionPane.showMessageDialog(null, "Error copying file: " + ex.getMessage(), "Error", JOptionPane.ERROR_MESSAGE);
}
}
public static void main(String[] args) {
FileCopyExample example = new FileCopyExample();
example.copyFile();
}
}代码解释：
- 使用LocalDateTime.now()获取当前日期和时间。
- 使用DateTimeFormatter定义日期时间格式，并使用format()方法将其转换为字符串。注意，格式化字符串中避免使用冒号等非法字符。
- 使用Paths.get()创建Path对象，指定源文件和目标文件路径。
- 使用Files.copy()方法复制文件，并指定StandardCopyOption.REPLACE_EXISTING选项，表示如果目标文件已存在，则覆盖它。
- 添加了异常处理，并在发生错误时显示错误信息。
注意事项
- 文件权限：确保程序具有读取源文件和写入目标文件的权限。
- 文件存在性：在复制文件之前，可以先检查源文件是否存在。
- 目标目录：确保目标目录存在，如果不存在，则需要先创建它。
- 异常处理：始终包含适当的异常处理代码，以便在出现问题时能够及时发现并解决。
- 资源释放：如果使用了InputStream或OutputStream等资源，务必在使用完毕后关闭它们，以避免资源泄漏。
总结
通过使用java.time API进行日期时间格式化，移除或替换文件名中的非法字符，以及使用Paths.get()创建Path对象，可以有效地避免java.nio.file.InvalidPathException异常。同时，确保程序具有适当的文件权限和异常处理机制，可以提高程序的稳定性和可靠性。
