存储访问框架SAF的增删改查

Android

2023-08-25 14:54:11

存储访问框架（SAF）：Android 文件管理的强大工具

SAF 的诞生：告别传统 File API

在 Android 的世界中，访问外部存储器上的文件曾是一项艰巨的任务。传统的 File API 虽然简单易用，但存在安全性和灵活性等诸多限制。

为了应对这些挑战，Android 推出了存储访问框架 (SAF)，一种革新性的解决方案，旨在提供更安全、更强大且更灵活的文件管理方式。

SAF 的优势：安全性、强大性和灵活性

SAF 的主要优势包括：

增强安全性： 通过权限系统，SAF 确保应用程序只能访问其具有读取或写入权限的文件，从而最大限度地提高安全性。
强大功能： SAF 允许应用程序访问外部存储器上的所有文件，包括位于私有目录中的文件，从而扩展了其访问范围。
灵活性多样： SAF 提供了多种访问文件的方法，包括 URI、文件符和文件输入/输出流，满足不同的应用程序需求。

使用 SAF：赋予应用程序访问外部存储器的权限

要使用 SAF，应用程序必须在清单文件中声明访问外部存储器的权限：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

增删改查：使用 SAF 管理文件

SAF 提供了一套全面的增删改查操作，允许应用程序有效管理文件：

创建文件： 使用 SAF.createDocument() 方法创建具有指定 MIME 类型和显示名称的文件。
读取文件： 使用 SAF.openDocument() 方法打开具有指定 MIME 类型的文件。
更新文件： 通过从 ContentResolver 获得 OutputStream，使用 SAF.openDocument() 方法打开文件进行更新。
删除文件： 使用 context.getContentResolver().delete(uri) 删除指定的文件。

示例代码：增删改查操作

以下是增删改查操作的示例代码：

// 创建文件
Uri uri = SAF.createDocument(context, "text/plain", "MyFile.txt");

// 读取文件
Uri uri = SAF.openDocument(context, "text/plain");
InputStream inputStream = context.getContentResolver().openInputStream(uri);

// 更新文件
Uri uri = SAF.openDocument(context, "text/plain");
OutputStream outputStream = context.getContentResolver().openOutputStream(uri);

// 删除文件
Uri uri = SAF.openDocument(context, "text/plain");
context.getContentResolver().delete(uri);