Java创建文件夹

传统API创建文件夹

Java传统的IO API种使用java.io.File类中的file.mkdir()file.mkdirs()方法创建文件夹

file.mkdir()创建文件夹成功返回true,失败返回false。如果被创建文件夹的父文件夹不存在也返回false.没有异常抛出。
file.mkdirs()创建文件夹连同该文件夹的父文件夹,如果创建成功返回true,创建失败返回false。创建失败同样没有异常抛出。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
@Test
void testCreateDir1() {
//“D:\data111”目录现在不存在
String dirStr = "D:\\data111\\test";
File directory = new File(dirStr);

//mkdir
boolean hasSucceeded = directory.mkdir();
System.out.println("创建文件夹结果(不含父文件夹):" + hasSucceeded);

//mkdirs
hasSucceeded = directory.mkdirs();
System.out.println("创建文件夹结果(包含父文件夹):" + hasSucceeded);

}

输出结果如下:使用mkdir创建失败,使用mkdirs创建成功。

创建文件夹结果(不含父文件夹):false
创建文件夹结果(包含父文件夹):true

可以看到,mkdirmkdirs虽然可以创建文件,但是它们在异常处理的环节做的非常不友好。创建失败之后统一返回false,创建失败的原因没有说明。是父文件夹不存在所以创建失败?还是文件夹已经存在所以创建失败?还是因为磁盘IO原因导致创建文件夹失败?

Java NIO创建文件夹

为了解决传统IO创建文件夹中异常失败处理问题不明确的问题,在Java的NIO中进行了改进。

Files.createDirectory创建文件夹

如果被创建文件夹的父文件夹不存在,则抛出NoSuchFileException
如果被创建的文件夹已经存在,则抛出FileAlreadyExistsException
如果因为磁盘IO出现异常,则抛出IOException

1
2
Path path = Paths.get("D:\\data222\\test");
Path pathCreate = Files.createDirectory(path);
Files.createDirectories创建文件夹及其父文件夹

如果被创建文件夹的父文件夹不存在,就创建它;
如果被创建的文件夹已经存在,就是用已经存在的文件夹,不会重复创建,没有异常抛出;
如果因为磁盘IO出现异常,则抛出IOException.

所以,可以使用Files.createDirectories的地方不使用Files.createDirectory,尽量更少的遇到异常。

1
2
Path path = Paths.get("D:\\data222\\test");
Path pathCreate = Files.createDirectorys(path);

另外:NIO的API创建的文件夹返回值是Path,这样方便我们在创建完成文件夹之后继续向文件夹里面写入文件数据等操作。比传统IO只返回一个boolean值要好得多。

小结

Java语言中,创建指定目录包含四种方法,涉及两个不同类 java.io.File类 和 java.nio.file.Files

file.mkdir()创建文件夹成功返回true,失败返回false。如果被创建文件夹的父文件夹不存在也返回false.没有异常抛出。

file.mkdirs()创建文件夹连同该文件夹的父文件夹,如果创建成功返回true,创建失败返回false。创建失败同样没有异常抛出。

Files.createDirectory创建文件夹
如果被创建文件夹的父文件夹不存在,则抛出NoSuchFileException.
如果被创建的文件夹已经存在,则抛出FileAlreadyExistsException.
如果因为磁盘IO出现异常,则抛出IOException.

Files.createDirectories创建文件夹及其父文件夹
如果被创建文件夹的父文件夹不存在,就创建它;
如果被创建的文件夹已经存在,就是用已经存在的文件夹,不会重复创建,没有异常抛出;
如果因为磁盘IO出现异常,则抛出IOException.

四种方式中,最优方式使用 Files.createDirectories 创建文件夹。