【Java基础】Java7新特性—Files类,Path类,Paths类的用法

Java7新增文件IO类

Java7中文件IO发生了很大的变化,专门引入了不少新的类:java

java.nio.file.DirectoryStream;
java.nio.file.FileSystem;
java.nio.file.FileSystems;
java.nio.file.Files;
java.nio.file.Path;
java.nio.file.Paths;
java.nio.file.attribute.FileAttribute;
java.nio.file.attribute.PosixFilePermission;
java.nio.file.attribute.PosixFilePermissions;web

在java中文件或是目录习惯用java.io.File对象来表示,可是File类有不少缺陷安全

  • 它的不少方法不能抛出异常app

  • 它的delete方法常常莫名其妙的失败等,旧的File类常常是程序失败的根源。svg

  • 所以在Java7中有了更好的替代:java.nio.file.Pathjava.nio.file.Files工具

    • Path接口的名字很是恰当,就是表示路径的,API中讲Path对象能够是一个文件,一个目录,或是一个符号连接,也能够是一个根目录。 用法很简单。建立Path并不会建立物理文件或是目录path实例常常引用并不存在的物理对象,要真正建立文件或是目录,须要用到Files类测试

    • Files类是一个很是强大的类,它提供了处理文件和目录以及读取文件和写入文件的静态方法。 能够用它建立和删除路径。复制文件。检查路径是否存在等。 此外。Files还拥有建立流对象的方法。ui

一.Paths

Paths类仅由静态方法组成,经过转换路径字符串返回Path或URI编码

  • 由于就两个方法用来生成Path对象,以供Path和Files使用;而Path也常常由Paths来生成,又或者File类有一个toPath();方法可使用

1.建立Paths

static Path get(String first, String... more) 
//将路径字符串或链接到路径字符串的字符串序列转换为 Path,能够get("c:/abc");或者get("c:","abc"),注意这里能够有多个参数String... more表明n个参数,这个比较经常使用
static Path get(URI uri) 
//将给定的URI转换为Path对象

二.Path

Path就是取代File的,用于来表示文件路径和文件。能够有多种方法来构造一个Path对象来表示一个文件路径,或者一个文件:
- 该接口的实现是不可变且安全的,可供多个并行线程使用。spa

1.建立Path

Path toPath() 
//File类对象方法--返回一个java.nio.file.Path对象
abstract Path getPath(String first, String... more) 
//FileSystem对象方法--将路径字符串或从路径字符串链接起来的一系列字符串转换为 Path 。 

1.1.建立Path的三种方式

建立Path的三种方式

Path path=FileSystems.getDefault().getPath("d:/users/日记5.txt");    
//并无实际建立路径,而是一个指向d:/users/日记5.txt路径的引用

Path path=Paths.get("d:/users/日记5.txt");                                              //Paths类提供了这个快捷方法,直接经过它的静态get方法建立path

Path path= = new File("d:/users/日记5.txt").toPath();

2.Path经常使用方法

Path接口没什么判断方法,其实更多的判断和操做都在Files工具类里面

boolean isAbsolute() 
//告诉这条路是不是绝对的
boolean endsWith(Path other) 
//测试此路径是否以给定的路径结束
boolean endsWith(String other) 
//测试此路径是否以给定字符串结束,如"c:/a/banana/cat"能够以"/banana/cat"结尾,但不能以"t"结尾
boolean startsWith(Path other) 
//测试此路径是否以给定的路径开始。 
boolean startsWith(String other) 
//测试此路径是否以给定字符串开始,跟上面同样规律

Path getFileName() 
//将此路径表示的文件或目录的名称返回为 Path对象,文件名或文件夹名,不含路径
Path getName(int index) 
//返回此路径的名称元素做为 Path对象。目录中最靠近root的为0,最远的为(count-1),count由下面的方法得到
int getNameCount() 
//返回路径中的名称元素的数量。0则只有root
Path getParent() 
//返回 父路径,若是此路径没有父返回null,如/a/b/c返回/a/b,配合下面的方法消除"."或".."
Path normalize()
//返回一个路径,该路径是冗余名称元素的消除。如消除掉"."、".."
Path getRoot() 
//返回此路径的根组分做为 Path对象,或 null若是该路径不具备根组件。如返回"c:/"
Path relativize(Path other) 
//构造此路径和给定路径之间的相对路径。有点难理解,p1-"Topic.txt",p2-"Demo.txt",p3-"/Java/JavaFX/Topic.txt",p4-"/Java/2011";;那么p1和p2的结果是"../Demo.txt";;p2和p1的结果是"../Topic.txt";;p3和p4的结果是"../../2011";;p4和p3的结果是"../JavaFX/Topic.txt"
Path resolve(String other)
//将给定的路径字符串转换为 Path。如"c:/a/b"和字符串"c.txt"的结果是"c:/a/b/c.txt";更像是拼接
Path resolveSibling(String other) 
//将给定的路径字符串转换为 Path。如"c:/a/b.txt"和字符串"c.txt"的结果是"c:/a/c.txt";更像是替换
Path subpath(int beginIndex, int endIndex) 
//返回一个相对的 Path ,它是该路径的名称元素的子序列,如"d:/a/b/c.txt"参数为(1,3)返回一个"b/c.txt"
Path toAbsolutePath() 
//返回表示此路径的绝对路径的 Path对象。包括盘符和文件名或文件夹名

Iterator<Path> iterator() 
//返回此路径的名称元素的迭代器。"c:/a/b/c.txt"的迭代器能够next出如下"a""b""c.txt"
File toFile() 
//返回表示此路径的File对象

三.Files

Files类只包含对文件,目录或其余类型文件进行操做的静态方法。主要和Path接口的对象进行配合使用

1.判断方法:

static boolean exists(Path path, LinkOption... options) 
//测试文件是否存在。 
static boolean notExists(Path path, LinkOption... options) 
//测试此路径所在的文件是否不存在。 
static boolean isDirectory(Path path, LinkOption... options) 
//测试文件是不是目录。 
static boolean isExecutable(Path path) 
//测试文件是否可执行。 
static boolean isHidden(Path path) 
//告知文件是否被 隐藏 。 
static boolean isReadable(Path path) 
//测试文件是否可读。 
static boolean isRegularFile(Path path, LinkOption... options) 
//测试文件是不是具备不透明内容的常规文件。说实话,我也不太懂常规文件指的是啥
static boolean isSameFile(Path path, Path path2) 
//测试两个路径是否找到相同的文件。
static boolean isSymbolicLink(Path path) 
//测试文件是不是符号连接。//
static boolean isWritable(Path path) 
//测试文件是否可写。 

2.删除方法

static boolean deleteIfExists(Path path) 
//删除文件(若是存在)。 
static void delete(Path path) 
//删除文件。 

3.复制方法

static long copy(InputStream in, Path target, CopyOption... options) 
//将输入流中的全部字节复制到文件。
//关于CopyOption则是一个被继承的接口主要有枚举类StandardCopyOption和LinkOption
// 1.StandardCopyOption
// REPLACE_EXISTING(也就是替换覆盖)
// COPY_ATTRIBUTES(将源文件的文件属性信息复制到目标文件中)
// ATOMIC_MOVE(原子性的复制)都是字面意思
// 2.LinkOption
// NOFOLLOW_LINKS
static long copy(Path source, OutputStream out) 
//将文件中的全部字节复制到输出流。 
static Path copy(Path source, Path target, CopyOption... options) 
//将文件复制到目标文件。 

4.移动和重命名方法

static Path move(Path source, Path target, CopyOption... options) 
//将文件移动或重命名为目标文件。 

5.建立文件和文件夹方法

static Path createDirectories(Path dir, FileAttribute<?>... attrs) 
//首先建立全部不存在的父目录来建立目录。
static Path createDirectory(Path dir, FileAttribute<?>... attrs) 
//建立一个新的目录。 
static Path createFile(Path path, FileAttribute<?>... attrs) 
//建立一个新的和空的文件,若是该文件已存在失败。

6.文件属性方法

static <V extends FileAttributeView> V getFileAttributeView(Path path,<V> type, LinkOption... options) 
//返回给定类型的文件属性视图。指定六个视图其中一种,上面一开始有点到。拿到的xxxAttributeView会有一个跟下面同样名字的readAttributes方法来获得一个xxxAttributes真正的获取操做就全是在这个xxxAttributes类的对象里get啦
static <A extends BasicFileAttributes> A readAttributes(Path path,<A> type, LinkOption... options) 
//读取文件的属性做为批量操做。指定一个xxxAttributes,获得一个实例,经过里面的方法获得时间等基本属性

static Object getAttribute(Path path, String attribute, LinkOption... options) 
//读取文件属性的值。这个 String attributes 参数的语法固定是以 view-name:comma-separated-attributes 的形式;view-name指定视图名如basic,posix,acl等,不写默认为basic;有写默认要加":";能够用"basic:*"或"*"读取全部,又或者用"basic:size,lastModifiedTime"读取大小和修改时间。具体还有那些属性能够看具体指定的类,好比basic视图就看BasicFileAttributes这个接口都有哪些方法,能够读取哪些文件属性。同理,下面的 String attributes 同样是这个理
static Map<String,Object> readAttributes(Path path, String attributes, LinkOption... options) 
//读取一组文件属性做为批量操做。
static Path setAttribute(Path path, String attribute, Object value, LinkOption... options) 
//设置文件属性的值。 

/* 下面这些也是获取属性的方法,不过还没研究到是怎么用的 */
static FileTime getLastModifiedTime(Path path, LinkOption... options) 
//返回文件的上次修改时间。 
static UserPrincipal getOwner(Path path, LinkOption... options) 
//返回文件的全部者。 
static Set<PosixFilePermission> getPosixFilePermissions(Path path, LinkOption... options) 
//返回文件的POSIX文件权限。 
static Path setLastModifiedTime(Path path, FileTime time) 
//更新文件上次修改的时间属性。 
static Path setOwner(Path path, UserPrincipal owner) 
//更新文件全部者。 
static Path setPosixFilePermissions(Path path, Set<PosixFilePermission> perms) 
//设置文件的POSIX权限。 
static long size(Path path) 
//返回文件的大小(以字节为单位)。 

7.读取、编辑文件内容方法

static BufferedReader newBufferedReader(Path path) 
//打开一个文件进行阅读,返回一个 BufferedReader以高效的方式从文件读取文本。 
static BufferedReader newBufferedReader(Path path, Charset cs) 
//打开一个文件进行阅读,返回一个 BufferedReader ,能够用来以有效的方式从文件读取文本。 
static BufferedWriter newBufferedWriter(Path path, Charset cs, OpenOption... options) 
//打开或建立一个写入文件,返回一个 BufferedWriter ,能够用来以有效的方式将文本写入文件。 
static BufferedWriter newBufferedWriter(Path path, OpenOption... options) 
//打开或建立一个写入文件,返回一个 BufferedWriter以高效的方式写入文件。 
static SeekableByteChannel newByteChannel(Path path, OpenOption... options) 
//打开或建立文件,返回可访问的字节通道以访问该文件。 
static SeekableByteChannel newByteChannel(Path path, Set<? extends OpenOption> options, FileAttribute<?>... attrs) 
//打开或建立文件,返回可访问的字节通道以访问该文件。 
static InputStream newInputStream(Path path, OpenOption... options) 
//打开一个文件,返回输入流以从文件中读取。 
static OutputStream newOutputStream(Path path, OpenOption... options) 
//打开或建立文件,返回可用于向文件写入字节的输出流。 
static byte[] readAllBytes(Path path) 
//读取文件中的全部字节。 
static List<String> readAllLines(Path path) 
//从文件中读取全部行。 
static List<String> readAllLines(Path path, Charset cs) 
//从文件中读取全部行。
static Path write(Path path, byte[] bytes, OpenOption... options) 
//将字节写入文件。 
static Path write(Path path, Iterable<? extends CharSequence> lines, Charset cs, OpenOption... options) 
//将文本行写入文件。 
static Path write(Path path, Iterable<? extends CharSequence> lines, OpenOption... options) 
//将文本行写入文件。 

以上方法适用于处理中等长度的文本文件,若是要处理的文件长度比较大,或者是二进制文件,那么仍是应该使用流

8.遍历文件列表方法

  • newDirectoryStream只是遍历当前Path的子目录列表,或者写一个方法里面递归调用实现遍历到底;
  • walk则是能够经过maxDepth参数来决定遍历的深度,后面的FileVisitOption参数无关紧要;
  • list相似于newDirectoryStream,区别是walk和newDirectoryStream是递归的,list是非递归的
static DirectoryStream<Path> newDirectoryStream(Path dir) 
//打开一个目录,返回一个DirectoryStream以遍历目录中的全部条目。最好用 try-with-resources 构造,能够自动关闭资源。返回的 DirectoryStream<Path> 其实能够直接使用 Iterator或者for循环 遍历每个 dir 下面的文件或目录
static DirectoryStream<Path> newDirectoryStream(Path dir, DirectoryStream.Filter<? super Path> filter) 
//上面方法的重载,经过实现参数二(有一个 boolean accept(Path p) 方法来判断文件是否符合须要)来达到过滤的目的。如accept方法中写"return (Files.size(p) > 8192L);"来匹配大于8k的文件
static DirectoryStream<Path> newDirectoryStream(Path dir, String glob) 
//上面方法的重载,能够经过参数二做为过滤匹配出对应的文件。如 newDirectoryStream(dir, "*.java") 用于遍历目录里全部java后缀的文件

static Stream<Path> walk(Path start, FileVisitOption... options) 
//深度优先遍历。返回一个 Stream ,它经过 Path根据给定的起始文件的文件树懒惰地填充 Path 。 
static Stream<Path> walk(Path start, int maxDepth, FileVisitOption... options) 
//深度优先遍历。返回一个 Stream ,它是经过走根据给定的起始文件的文件树懒惰地填充 Path 。

static Stream<Path> list(Path dir) 
//返回一个懒惰的填充 Stream ,其元素是 Stream中的条目。返回的 Stream 里封装了一个 DirectoryStream 用于遍历。

四.Path和Files使用

import org.junit.Test;
import java.io.*;
import java.net.MalformedURLException;
import java.net.URI;
import java.net.URISyntaxException;
import java.nio.charset.StandardCharsets;
import java.nio.file.FileSystems;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.attribute.PosixFilePermission;
import java.util.HashSet;
import java.util.List;
import java.util.Set;
import java.util.stream.Stream;

public class PathAndFilesTest {
    /** * 建立Path */
    @Test
    public void createPath() throws URISyntaxException, MalformedURLException {
        //1.Paths
        Path path = Paths.get("F:/测试数据.csv");
        System.out.println(path.getFileName());
        Path path1 = Paths.get(new URI("file:///f:/测试数据.csv"));

        //2.FileSystems
        Path path2 = FileSystems.getDefault().getPath("F:/测试数据.csv");

        //3.File
        Path path3 = new File("F:/测试数据.csv").toPath();
    }


    /** * 建立一个空文件/文件夹 */
    @Test
    public void create() throws IOException {
        //文件夹
        Path path = Paths.get("F:/hello");
        if (!Files.exists(path)) {//若是不存在
            Files.createDirectory(path);
            //建立多个目录
            //Files.createDirectories(path);
        }

        //文件
        Path path1 = Paths.get("F:/helloFile.txt");
        if (!Files.exists(path1)) {//若是不存在
            Files.createFile(path1);
        }
    }

    /** * 文件属性 */
    @Test
    public void getFileProperties() throws IOException {
        Path path = Paths.get("F:/测试数据.csv");
        System.out.println(Files.getLastModifiedTime(path));//最后修改时间:2019-05-22T02:52:45.625094Z
        System.out.println(Files.getOwner(path));//拥有者:DESKTOP-GE36VVD\87772 (User)
        //System.out.println(Files.getPosixFilePermissions(path));//权限,非admin可能会报错
        System.out.println(Files.size(path));//文件大小: 34207517
    }

    /** * 读取一个文本文件 */
    @Test
    public void readText() throws IOException {
        Path path = Paths.get("F:/test.txt");
        //经过bufferedReader读取
        BufferedReader bufferedReader = Files.newBufferedReader(path, StandardCharsets.UTF_8);///该文件编码是什么newBufferedReader就必须指定什么字符集,不然报错

        StringBuilder sb = new StringBuilder();
        String tempString = null;
        while ((tempString = bufferedReader.readLine()) != null) {
            sb = sb.append(tempString + "\n");
        }
        System.out.println(sb);


        //经过Files方法readAllLines
        List<String> strings = Files.readAllLines(path);
        strings.forEach(System.out::println);
    }

    /** * 拿到文件输入流 * * @throws IOException */
    @Test
    public void getInputStream() throws IOException {
        Path path = Paths.get("F:/test.txt");
        InputStream inputStream = Files.newInputStream(path);

        //转换字符流后在包装成缓冲流
        BufferedReader bufferedReader = new BufferedReader(new InputStreamReader(inputStream, "UTF-8"));

        StringBuilder sb = new StringBuilder();
        String tempString = null;
        while ((tempString = bufferedReader.readLine()) != null) {
            sb = sb.append(tempString + "\n");
        }
        System.out.println(sb);
    }

    /** * 文件写操做 */
    @Test
    public void writeFile() throws IOException {
        Path path = Paths.get("F:/writeFile.txt");

        //获取写入流
        BufferedWriter bufferedWriter = Files.newBufferedWriter(path);

        //执行写入操做
        String str = "write file test";
        bufferedWriter.write(str);

        //关闭资源
        bufferedWriter.flush();
        bufferedWriter.close();
    }

    /** * 遍历一个文件夹 */
    @Test
    public void traverseDirectory() throws IOException {
        Path path = Paths.get("F:/test");
        Stream<Path> list = Files.list(path);
        list.forEach(p -> {
            System.out.println(p.getFileName());
        });
    }

    /** * 遍历文件树 */
    @Test
    public void traverseTree() throws IOException {
        Path path = Paths.get("F:/test/");
        Stream<Path> walk = Files.walk(path);
        walk.forEach(path1 -> {
// System.out.println(path1.getRoot());//根目录
            System.out.println(path1.getFileName());//文件名
// System.out.println(path1.getParent());//上级目录
// System.out.println(path1.getFileSystem());//文件系统
        });
        //还有种方式Files.walkFileTree()
    }

    /** * 文件复制 */
    @Test
    public void copyFile() throws IOException {
        Path src = Paths.get("F:/测试数据.csv");
        Path dest = Paths.get("F:/test/Copy测试数据.csv");
        Files.copy(src, dest);
    }

    /** * 读取权限见上面示例,设置权限 */
    @Test
    public void writePermission() throws IOException {
        Path path = Paths.get("F:/test/导出测试数据.xlsx");
        Set<PosixFilePermission> permissionSet = new HashSet<>();
        permissionSet.add(PosixFilePermission.GROUP_WRITE);
        permissionSet.add(PosixFilePermission.OWNER_EXECUTE);
        Files.setPosixFilePermissions(path, permissionSet);
    }

/** * 判断方法 * @throws IOException */
	@Test
	public void judge() throws IOException {
		Path path1 = Paths.get("f:\\test", "Copy测试数据.csv");
		Path path2 = Paths.get("f:\\测试数据.csv");
// boolean exists(Path path, LinkOption … opts) : 判断文件是否存在
		System.out.println(Files.exists(path2, LinkOption.NOFOLLOW_LINKS));//true

// boolean isDirectory(Path path, LinkOption … opts) : 判断是不是目录
		//不要求此path对应的物理文件存在。
		System.out.println(Files.isDirectory(path1, LinkOption.NOFOLLOW_LINKS));//false

// boolean isRegularFile(Path path, LinkOption … opts) : 判断是不是文件

// boolean isHidden(Path path) : 判断是不是隐藏文件
		//要求此path对应的物理上的文件须要存在。才可判断是否隐藏。不然,抛异常。
// System.out.println(Files.isHidden(path1));

// boolean isReadable(Path path) : 判断文件是否可读
		System.out.println(Files.isReadable(path1));//true
// boolean isWritable(Path path) : 判断文件是否可写
		System.out.println(Files.isWritable(path1));//true
// boolean notExists(Path path, LinkOption … opts) : 判断文件是否不存在
		System.out.println(Files.notExists(path1, LinkOption.NOFOLLOW_LINKS));//false
	}
}


	/** * StandardOpenOption.READ:表示对应的Channel是可读的。 * StandardOpenOption.WRITE:表示对应的Channel是可写的。 * StandardOpenOption.CREATE:若是要写出的文件不存在,则建立。若是存在,忽略 * StandardOpenOption.CREATE_NEW:若是要写出的文件不存在,则建立。若是存在,抛异常 */
	@Test
	public void ioStream() throws IOException {
		Path path1 = Paths.get("f:\\test", "copyTest.txt");

// InputStream newInputStream(Path path, OpenOption…how):获取 InputStream 对象
		InputStream inputStream = Files.newInputStream(path1, StandardOpenOption.READ);

// OutputStream newOutputStream(Path path, OpenOption…how) : 获取 OutputStream 对象
		OutputStream outputStream = Files.newOutputStream(path1, StandardOpenOption.WRITE, StandardOpenOption.CREATE);


// SeekableByteChannel newByteChannel(Path path, OpenOption…how) : 获取与指定文件的链接,how 指定打开方式。
		SeekableByteChannel channel = Files.newByteChannel(path1, StandardOpenOption.READ, StandardOpenOption.WRITE, StandardOpenOption.CREATE);

// DirectoryStream<Path> newDirectoryStream(Path path) : 打开 path 指定的目录
		Path path2 = Paths.get("f:\\test");
		DirectoryStream<Path> directoryStream = Files.newDirectoryStream(path2);
		Iterator<Path> iterator = directoryStream.iterator();
		while (iterator.hasNext()) {
			System.out.println(iterator.next());
		}
	}

五.FileTime对象

表示文件时间戳属性的值,可能会在设置文件最后更新属性时使用到:

static FileTime fromMillis(long value) 
//返回一个 FileTime以 FileTime单位表示给定值。 
long toMillis() 
//返回以毫秒为单位的值。
String toString() 
//返回此 FileTime的字符串表示 FileTime 。 

栗子:

/** * 可能你要从文件属性中的FileTime或者到一个Date对象 */
Path pathObj = Paths.get("C:/a/b/c.txt");
BasicFileAttributes attrs = Files.readAttributes(pathObj, BasicFileAttributes.class);
Data date = new Date(attrs.lastModifiedTime().toMillis());

/** * 又或者可能你要人为地修改这个文件时间属性,须要一个FileTime */
Path path = Paths.get("C:/a/b/c.txt");
long time = System.currentTimeMillis();
FileTime fileTime = FileTime.fromMillis(time);
try{
  Files.setAttribute(path, "basic:lastModifiedTime", fileTime,LinkOption.NOFOLLOW_LINKS);
}catch (IOException e) {
    System.err.println(e);
}