Dart File 类用法详解

Dart File 类

File 表示文件系统中某个文件的引用。

File 实例是个对象，它持有并对其进行操作。可以使用 parent getter 获取父目录，parent 属性继承自 FileSystemEntity。

使用 pathname 创建新的 File 对象来访问文件系统上的文件。

final myFile = File('file.txt');

File 类包含操作文件及其内容的方法。使用这些方法，可以打开和关闭文件，读写文件，创建和删除文件，以及检查文件是否存在。

读写文件时，可以使用 stream (通过 openRead)，随机访问操作 (通过 RandomAccessFile)，或者类似 readAsString 这样的便捷方法。

File 类中的方法大部分都有同步和异步两种形式，比如 readAsString 和 writeAsString。除非有特别的理由，通常应当使用异步方法以避免阻塞程序。

如果构造 File 对象的 path 是一个符号链接，而非文件，则 File 类的方法会操作链接指向的最终目标文件。不过，isLink 和 delete 方法除外，这两个方法是对符号链接进行操作。

读文件

下面示例代码使用异步的 readAsString 方法读取文件，它将整个文件内容视为一个字符串：

import 'dart:async';
import 'dart:io';

void main() {
  File('file.txt').readAsString().then((String contents) {
    print(contents);
  });
}

更灵活更有用的方法是使用 Stream 方式读文件。调用 openRead 方法打开文件，该方法返回 stream，这个 stream 以字节块的方式返回文件数据。可以监听 stream 来获取数据并进行必要的处理。可以继续使用不同的 transformer 操作数据来得到想要的数据格式。

可以使用 stream 方式来读取大文件，并提供 transformer 来操作数据。

import 'dart:io';
import 'dart:convert';
import 'dart:async';

main() {
  final file = File('file.txt');
  Stream<List<int>> inputStream = file.openRead();

  inputStream
    .transform(utf8.decoder)       // Decode bytes to UTF-8.
    .transform(LineSplitter())     // Convert stream to individual lines.
    .listen((String line) {        // Process results.
      print('$line: ${line.length} bytes');
    },
    onDone: () { print('File is now closed.'); },
    onError: (e) { print(e.toString()); });
}

写文件

使用 writeAsString 方法写文件。

import 'dart:io';

void main() {
  final filename = 'file.txt';
  File(filename).writeAsString('some content')
    .then((File file) {
      // Do something with the file.
    });
}

也可以使用 openWrite 来写入文件。调用 openWrite 方法打开文件，返回结果是 IOSink，可以向 IOSink 写入数据。记得操作完成后调用 close 关闭 sink。

import 'dart:io';

void main() {
  var file = File('file.txt');
  var sink = file.openWrite();
  sink.write('FILE ACCESSED ${DateTime.now()}\n');

  // Close the IOSink to free system resources.
  sink.close();
}