Flutter系列之Dart文件IO操作

这一部分学习下Dart语法怎么进行IO文件操作。

本身而言，Dart语法进行文件操作是十分简便的，下图是简单写入操作；

final filePath = r"E:\back.txt";

try {
  File file = new File(filePath);
  file.writeAsString("$file");
} catch(e) {
  print(e);
}

但是往往存在多个文件写入、读取同步、异步的问题，因此这些需要进行考虑；

Directory.create函数是异步模式，返回值是Future

如果要等待函数执行完毕后，再执行之后的代码
那么一般有以下3种方法：
直接调用同步模式函数，如：Directory.createSync
将执行的之后的代码放到then函数中
使用关键字await，外层函数用async声明返回值为Future

举个例子，下面的代码中
fun1、fun2和fun3三个函数结果一样

import 'dart:io';

void main(){
  fun1();
  fun2();
  fun3();
}

void fun1() {
  var directory = new Directory("temp1");
  directory.createSync();
  //absolute返回path为绝对路径的Directory对象
  print(directory.absolute.path);
}

void fun2() {
  new Directory("temp2").create().then(
      (dir) => print(dir.absolute.path)
  );
}

//Dart中变量的类型可以省略，包括函数
fun3() async {
  var directory = await new Directory("temp3").create();
  print(directory.absolute.path);
}

运行结果：

E:\DartProject\Note16\temp1
E:\DartProject\Note16\temp2
E:\DartProject\Note16\temp3

1.针对目录，主要有以下几个操作：

• 创建指定目录
• 重命名目录
• 删除目录
• 创建临时文件夹
• 获取父目录
• 列出目录的内容

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

void main() {
  handleDir();
}

handleDir() async {
  //可以用Platform.pathSeparator代替路径中的分隔符"/"
  //效果和"dir/subdir"一样
  //如果有子文件夹，需要设置recursive: true
  var directory = await new Directory("dir${Platform.pathSeparator}one").create(recursive: true);

  assert(await directory.exists() == true);
  //输出绝对路径
  print("Path: ${directory.absolute.path}");

  //重命名文件夹
  directory = await directory.rename("dir/subdir");
  print("Path: ${directory.absolute.path}\n");

  //创建临时文件夹
  //参数是文件夹的前缀，后面会自动添加随机字符串
  //参数可以是空参数
  var tempDir = await Directory.systemTemp.createTemp('temp_dir');
  assert(await tempDir.exists() == true);
  print("Temp Path: ${tempDir.path}");

  //返回上一级文件夹
  var parentDir = tempDir.parent;
  print("Parent Path: ${parentDir.path}");

  //列出所有文件，不包括链接和子文件夹
  Stream<FileSystemEntity> entityList = parentDir .list(recursive: false, followLinks: false);
  await for(FileSystemEntity entity in entityList) {

    //文件、目录和链接都继承自FileSystemEntity
    //FileSystemEntity.type静态函数返回值为FileSystemEntityType
    //FileSystemEntityType有三个常量：
    //Directory、FILE、LINK、NOT_FOUND
    //FileSystemEntity.isFile .isLink .isDerectory可用于判断类型
    print(entity.path);
  }

  //删除目录
  await tempDir.delete();
  assert(await tempDir.exists() == false);
}

运行结果：

Path: E:\DartProject\Note16\dir\one
Path: E:\DartProject\Note16\dir/subdir

Temp Path: C:\Users\King\AppData\Local\Temp\temp_dir7aa9c6f5-106b-11e6-a55f-ac220b7553ea
Parent Path: C:\Users\King\AppData\Local\Temp
C:\Users\King\AppData\Local\Temp\%@DH19{R%DFDKB85J)D~UR6.png
C:\Users\King\AppData\Local\Temp\0RCT3Y_IOUNT2`)27FJ9U`R.xml
C:\Users\King\AppData\Local\Temp\360newstmp.dat
……

 2.针对文件，主要有以下几个操作：

• 创建文件
• 将string写入文件
• 读取文件到String
• 以行为单位读取文件到List<String>
• 将bytes写入文件
• 读取文件到bytes
• 数据流Stream写入文件
• 数据流Stream读取文件
• 删除文件

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

void main() {
  //文件操作演示
  handleFile();
}

handleFile() async {
  //提示：pub中有ini库可以方便的对ini文件进行解析
  File file = new File("default.ini");

  //如果文件存在，删除
  if(!await file.exists()) {
    //创建文件
    file = await file.create();
  }

  print(file);

  //直接调用File的writeAs函数时
  //默认文件打开方式为WRITE:如果文件存在，会将原来的内容覆盖
  //如果不存在，则创建文件

  //写入String，默认将字符串以UTF8进行编码
  file = await file.writeAsString("[General]\nCode=UTF8");
  //readAsString读取文件，并返回字符串
  //默认返回的String编码为UTF8
  //相关的编解码器在dart:convert包中
  //包括以下编解码器：ASCII、LANTI1、BASE64、UTF8、SYSTEM_ENCODING
  //SYSTEM_ENCODING可以自动检测并返回当前系统编码
  print("\nRead Strings:\n${await file.readAsString()}");

  //以行为单位读取文件到List<String>，默认为UTF8编码
  print("\nRead Lines:");
  List<String> lines = await file.readAsLines();
  lines.forEach(
      (String line) => print(line)
  );

  //如果是以字节方式写入文件
  //建议设置好编码，避免汉字、特殊符号等字符出现乱码、或无法读取
  //将字符串编码为Utf8格式，然后写入字节
  file = await file.writeAsBytes(UTF8.encode("编码=UTF8"));
  //读取字节，并用Utf8解码
  print("\nRead Bytes:");
  print(UTF8.decode(await file.readAsBytes()));

//  //删除文件
//  await file.delete();
}

运行结果：

File: 'default.ini'

Read Strings:
[General]
Code=UTF8

Read Lines:
[General]
Code=UTF8

Read Bytes:
编码=UTF8

读写文件的话，常用的函数就是readAs和writeAs
但是如果我们要对某个字符进行处理，或读写某个区域等操作时
就需要用到open函数

open类型的函数有3个：
open({FileMode mode: FileMode.READ}) → Future<RandomAccessFile>
openRead([int start, int end]) → Stream<List<int>>
openWrite({FileMode mode: FileMode.WRITE, Encoding encoding: UTF8}) → IOSink

open和openSync一样，不过一个是异步、一个同步
可以返回RandomAccessFile类
openRead用于打开数据流
openWrite用于打开数据缓冲池
详细的内容可以查看API

3.针对链接，主要有以下几个操作：

• 创建链接
• 获取链接文件的路径
• 获取链接指向的目标
• 重命名链接
• 删除链接

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

void main() {
  handleLink();
}

handleLink() async {
  //创建文件夹
  var dir = await new Directory("linkDir").create();
  //创建链接
  //Link的参数为该链接的Path，create的参数为链接的目标文件夹
  var link = await new Link("shortcut").create("linkDir");

  //输出链接文件的路径
  print(link.path);
  //输出链接目标的路径
  print(await link.target());

  //重命名链接
  link = await link.rename("link");
  print(link.path);

  //删除链接
  //link.delete();
}

运行结果：

shortcut
E:\DartProject\Note16\linkDir
link

需要说明的是，Dart中的Link
链接的是文件夹，而不能链接文件
并且，Dart中的链接和通常意义的快捷方式不同：

1. 首先，这里的链接只能指向文件夹
   快捷方式可以指向文件夹或文件
2. 链接不能剪切移动
   快捷方式可以剪切移动
3. 在命令行中，链接可以作为普通文件夹进行 cd、dir(ls)等操作
   快捷方式在命令行中可以看到，只是一个lnk文件，运行然后打开目标资源
4. 打开链接的时候，资源管理器的地址栏显示的是链接名
   而快捷方式打开的时候，资源管理器显示的是目标文件夹名
   

 

4.针对数据流，主要有以下几个操作：

原本是准备在文件操作一节中提一下就完事的
但是测试了解下来，有点复杂，于是单独列一节

Stream是dart:async库中的类，并非dart:io
从它的位置可以看出，Stream是一个异步数据事件的提供者
它提供了一种接收事件序列（数据或错误信息）的方式

因此，我们可以通过listen来监听并开始产生事件
当我们开始监听Stream的时候，会接收到一个StreamSubscription对象
通过该对象可以控制Stream进行暂停、取消等操作

数据流Stream有两种类型：

• Single-subscription单一订阅数据流
• broadcast广播数据流

Stream默认关闭广播数据流，可以通过isBroadcast测试
如果要打开，需在Stream子类中重写 isBroadcast返回true
或调用asBroadcastStream

Single-subscription对象不能监听2次
即使第1次的数据流已经被取消

同时，为了保证系统资源被释放
在使用数据流的时候
必须等待读取完数据，或取消

关于数据流Stream，虽然抽象，但也不是不能理解
问题在于很多人不知道【Dart中】数据流的好处，何时该用
我所理解的是一般用于处理较大的连续数据，如文件IO操作

下面的实例是用数据流来复制文件，只能算是抛砖引玉吧！
File.copy常用来复制文件到某路径，但是看不到复制的过程、进度
这里用Stream来实现复制文件的功能，并添加进度显示的功能

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

void main() {
  //复制文件演示
  copyFileByStream();
}

copyFileByStream() async {
  //电子书文件大小：10.9 MB (11,431,697 字节)
  File file = new File(r"E:\全职高手.txt");
  assert(await file.exists() == true);
  print("源文件：${file.path}");

  //以只读方式打开源文件数据流
  Stream<List<int>> inputStream = file.openRead();
  //数据流监听事件，这里onData是null
  //会在后面通过StreamSubscription来修改监听函数
  StreamSubscription subscription = inputStream.listen(null);

  File target = new File(r"E:\全职高手.back.txt");
  print("目标文件：${target.path}");
  //以WRITE方式打开文件，创建缓存IOSink
  IOSink sink = target.openWrite();

  //常用两种复制文件的方法，就速度来说，File.copy最高效
//  //经测试，用时21毫秒
//  await file.copy(target.path);
//  //输入流连接缓存，用时79毫秒，比想象中高很多
//  //也许是数据流存IOSink缓存中之后，再转存到文件中的原因吧！
//  await sink.addStream(inputStream);

  //手动处理输入流
  //接收数据流的时候，涉及一些简单的计算
  //如：当前进度、当前时间、构造字符串
  //但是最后测试下来，仅用时68毫秒，有些不可思议

  //文件大小
  int fileLength = await file.length();
  //已读取文件大小
  int count = 0;
  //模拟进度条
  String progress = "*";

  //当输入流传来数据时，设置当前时间、进度条，输出信息等
  subscription.onData((List<int> list) {
    count = count + list.length;
    //进度百分比
    double num = (count*100)/fileLength;
    DateTime time = new DateTime.now();

    //输出样式：[1:19:197]**********[20.06%]
    //进度每传输2%，多一个"*"
    //复制结束进度为100%，共50个"*"
    print("[${time.hour}:${time.second}:${time.millisecond}]${progress*(num ~/ 2)}[${num.toStringAsFixed(2)}%]");

    //将数据添加到缓存池
    sink.add(list);
  });

  //数据流传输结束时，触发onDone事件
  subscription.onDone(() {
    print("复制文件结束！");
    //关闭缓存释放系统资源
    sink.close();
  });
}

运行结果：

源文件：E:\全职高手.txt
目标文件：E:\全职高手.back.txt
[1:19:177][0.57%]
[1:19:185][1.15%]
[1:19:186][1.72%]
[1:19:187]*[2.29%]
[1:19:187]*[2.87%]
……
[1:19:245]*************************************************[99.75%]
[1:19:245]**************************************************[100.00%]
复制文件结束！

 

 

本文图片资料来源出自“Dart语言中文社区”，允许转载，转载时请务必以超链接形式标明文章原始出处 。