Flutter 之 文件操作（二十九）

Dart的 IO 庫包含了文件讀寫的相關(guān)類，它屬于 Dart 語法標準的一部分，所以通過 Dart IO 庫，無論是 Dart VM 下的腳本還是 Flutter，都是通過 Dart IO 庫來操作文件的，不過和 Dart VM 相比，F(xiàn)lutter 有一個重要差異是文件系統(tǒng)路徑不同，這是因為Dart VM 是運行在 PC 或服務(wù)器操作系統(tǒng)下，而 Flutter 是運行在移動操作系統(tǒng)中，他們的文件系統(tǒng)會有一些差異。

1. APP目錄

Android 和 iOS 的應用存儲目錄不同，PathProvider插件提供了一種平臺透明的方式來訪問設(shè)備文件系統(tǒng)上的常用位置。該類當前支持訪問兩個文件系統(tǒng)位置：

  • 臨時目錄: 可以使用 getTemporaryDirectory() 來獲取臨時目錄； 系統(tǒng)可隨時清除的臨時目錄（緩存）。在 iOS 上，這對應于NSTemporaryDirectory()返回的值。在 Android上，這是getCacheDir()返回的值。

  • 文檔目錄: 可以使用getApplicationDocumentsDirectory()來獲取應用程序的文檔目錄，該目錄用于存儲只有自己可以訪問的文件。只有當應用程序被卸載時，系統(tǒng)才會清除該目錄。在 iOS 上，這對應于NSDocumentDirectory。在 Android 上，這是AppData目錄。

  • 外部存儲目錄：可以使用getExternalStorageDirectory()來獲取外部存儲目錄，如 SD 卡；由于 iOS不支持外部目錄，所以在 iOS 下調(diào)用該方法會拋出UnsupportedError異常，而在 Android 下結(jié)果是Android SDK 中getExternalStorageDirectory的返回值。

2. 文件操作基本使用

2.1 獲取文件操作對象File

File代表一個整體的文件,他有三個構(gòu)造函數(shù)，分別是：

factory File(String path) 
factory File.fromUri(Uri uri)
factory File.fromRawPath(Uint8List rawPath)

var file = File('file.txt');

2.2 讀取文件所有內(nèi)容

文件讀取本身有兩種形式，一種是文本，一種是二進制。

2.2.1 讀取文本內(nèi)容

如果是文本文件，F(xiàn)ile提供了readAsString、readAsLines、readAsStringSync、readAsLinesSync方法，讀取文本內(nèi)容

readAsString 一次性讀取所有文本

 Future<String> readAsString({Encoding encoding: utf8});

var stringContents = await file.readAsString();

readAsLines 一行行的讀取文本

Future<List<String>> readAsLines({Encoding encoding: utf8});

結(jié)果返回的是一個List，list中表示文件每行的內(nèi)容

var lines = await file.readAsLines();

readAsStringSync、readAsLinesSync同步讀取文本

String readAsStringSync({Encoding encoding: utf8});

List<String> readAsLinesSync({Encoding encoding: utf8});

2.2.2 讀取二進制內(nèi)容
如果文件是二進制，那么可以使用readAsBytes或者同步的方法readAsBytesSync:

Future<Uint8List> readAsBytes();

Uint8List readAsBytesSync();

dart中表示二進制有一個專門的類型叫做Uint8List,他實際上表示的是一個int的List。

2.3 以流的形式讀取文件

上面提到的讀取方式，都是一次性讀取整個文件，缺點就是如果文件太大的話，可能造成內(nèi)存空間的壓力。
所以File為我們提供了另外一種讀取文件的方法，流的形式來讀取文件.

 Stream<List<int>> openRead([int? start, int? end]);

示例

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

Future<void> main() async {
  var file = File('file.txt');
  Stream<List<int>> inputStream = file.openRead();

  var lines = utf8.decoder
      .bind(inputStream)
      .transform(const LineSplitter());
  try {
    await for (final line in lines) {
      print('Got ${line.length} characters from stream');
    }
    print('file is now closed');
  } catch (e) {
    print(e);
  }
}

2.4 隨機訪問

dart提供了open和openSync兩個方法來進行隨機文件讀寫：

  Future<RandomAccessFile> open({FileMode mode: FileMode.read});
  RandomAccessFile openSync({FileMode mode: FileMode.read});
  • FileMode.read 只讀
  • FileMode.write 可讀可寫，如果文件存在覆蓋，如果文件不存在創(chuàng)建
  • FileMode.append 可讀可寫，如果文件存在在末尾追加，如果文件不存在創(chuàng)建
  • FileMode.writeOnly 只寫，如果文件存在覆蓋，如果文件不存在創(chuàng)建
  • FileModel.writeOnlyAppend 只寫，如果文件存在在末尾追加，如果文件不存在創(chuàng)建

2.5 文件的寫入

寫入和文件讀取一樣，可以一次性寫入或者獲得一個寫入句柄，然后再寫入。
一次性寫入的方法有四種，分別對應字符串和二進制

 Future<File> writeAsBytes(List<int> bytes,
      {FileMode mode: FileMode.write, bool flush: false});

void writeAsBytesSync(List<int> bytes,
      {FileMode mode: FileMode.write, bool flush: false});

Future<File> writeAsString(String contents,
      {FileMode mode: FileMode.write,
      Encoding encoding: utf8,
      bool flush: false});

void writeAsStringSync(String contents,
      {FileMode mode: FileMode.write,
      Encoding encoding: utf8,
      bool flush: false});

句柄形式可以調(diào)用openWrite方法，返回一個IOSink對象，然后通過這個對象進行寫入：

IOSink openWrite({FileMode mode: FileMode.write, Encoding encoding: utf8});

var logFile = File('log.txt');
var sink = logFile.openWrite();
sink.write('FILE ACCESSED ${DateTime.now()}\n');
await sink.flush();
await sink.close();

默認情況下寫入是會覆蓋整個文件的，但是可以通過下面的方式來更改寫入模式：

var sink = logFile.openWrite(mode: FileMode.append);

2.6 處理異常

雖然dart中所有的異常都是運行時異常，但是和java一樣，要想手動處理文件讀寫中的異常，則可以使用try,catch:

Future<void> main() async {
  var config = File('config.txt');
  try {
    var contents = await config.readAsString();
    print(contents);
  } catch (e) {
    print(e);
  }
}

3. 示例

我們還是以計數(shù)器為例，實現(xiàn)在應用退出重啟后可以恢復點擊次數(shù)。 這里，我們使用文件來保存數(shù)據(jù)：

1.引入PathProvider插件；在pubspec.yaml文件中添加如下聲明：
執(zhí)行 flutter pub get

2.實現(xiàn)如下


class MSFileDemo extends StatefulWidget {
  const MSFileDemo({
    Key? key,
  }) : super(key: key);

  @override
  State<MSFileDemo> createState() => _MSFileDemoState();
}

class _MSFileDemoState extends State<MSFileDemo> {
  var _counter = 0;
  @override
  void initState() {
    super.initState();
    //從文件讀取點擊次數(shù)
    _readCounter().then((value) {
      setState(() {
        _counter = value;
      });
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: Text(
          "$_counter",
          style: TextStyle(
              fontSize: 20, color: Colors.red, fontWeight: FontWeight.bold),
        ),
      ),
      floatingActionButton: FloatingActionButton(
        child: Icon(Icons.add),
        onPressed: () {
          setState(() {
            _counter++;
          });
          _writeCounter();
        },
      ),
    );
  }

  // 獲取本地文件路徑
  Future<String> _getLocalFileDir() async {
    Directory tempDir = await getTemporaryDirectory();
    return tempDir.path;
  }

  // 獲取文件
  Future<File> _getLocalFile() async {
    String dir = await _getLocalFileDir();
    return File("$dir/counter.txt");
  }

  // 讀取內(nèi)容
  Future<int> _readCounter() async {
    try {
      File file = await _getLocalFile();
      // 讀取文本內(nèi)容
      String counterString = file.readAsStringSync();
      return int.parse(counterString);
    } on FileSystemException {
      return 0;
    }
  }

  // 寫入內(nèi)容
  void _writeCounter() async {
    File file = await _getLocalFile();
    file.writeAsString("$_counter"); // 覆蓋寫入
  }
}

參考：http://m.itdecent.cn/p/92b09aaecf17
https://book.flutterchina.club/chapter11/file_operation.html

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點，簡書系信息發(fā)布平臺，僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容