Android 文件管理分区存储 ( 创建与查询图片文件 )

Posted 2021-05-24 韩曙亮

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Android 文件管理分区存储 ( 创建与查询图片文件 )相关的知识，希望对你有一定的参考价值。

文章目录

一、分区存储模式下使用 MediaStore 插入图片
二、分区存储模式下使用 MediaStore 查询图片
三、相关文档资料

在这里插入图片描述

Android 分区存储系列博客 :

一、分区存储模式下使用 MediaStore 插入图片

在上一篇博客【Android 文件管理】分区存储 ( MediaStore 文件操作 ) 中 , 创建了一个文本文件 , 并向其写出一个字符串 ;

创建文件时注意 , 使用 MediaStore 向 " external.db " 数据库中插入了文件数据 , 只是生成了文件索引 , 如果不向文件中写出数据 , 并不会真正的创建文件 ; 插入数据后 , 依据返回的 android.net.Uri 类型打开输出流 , 然后通过该输出流写出数据 , 文件创建完成 ;

图片创建流程 :

首先 , 获取操作数据库的 Uri ;

// 操作 external.db 数据库
// 获取 Uri 路径
var uri: Uri = MediaStore.Images.Media.EXTERNAL_CONTENT_URI

其次 , 构造插入数据库的 ContentValues 数据结构 , 设置的 “external.db” 数据库中的 “files” 数据表的各个字段与 MediaStore 中的常量对应关系如下 :

MediaStore.Downloads.RELATIVE_PATH : relative_path
MediaStore.Downloads.DISPLAY_NAME : display_ame
MediaStore.Downloads.TITLE : tittle
MediaStore.Downloads.MIME_TYPE : mime_type

// 将要新建的文件的文件索引插入到 external.db 数据库中
// 需要插入到 external.db 数据库 files 表中, 这里就需要设置一些描述信息
var contentValues: ContentValues = ContentValues()

// 设置插入 external.db 数据库中的 files 数据表的各个字段的值
// 设置存储路径 , files 数据表中的对应 relative_path 字段在 MediaStore 中以常量形式定义
contentValues.put(MediaStore.Downloads.RELATIVE_PATH, "${Environment.DIRECTORY_MOVIES}/image")
// 设置文件名称
contentValues.put(MediaStore.Downloads.DISPLAY_NAME, "image.jpg")
// 设置文件标题, 一般是删除后缀, 可以不设置
contentValues.put(MediaStore.Downloads.TITLE, "image")
// 设置 MIME_TYPE
contentValues.put(MediaStore.Downloads.MIME_TYPE, "image/jpg")

再次 , 获取该上下文对应的 ContentResolver , 调用 insert 方法 , 将上述构建的 ContentValues 插入到数据库中 , 返回 Uri ;

// uri 表示操作哪个数据库 , contentValues 表示要插入的数据内容
var insert: Uri = contentResolver.insert(uri, contentValues)!!

最后 , 根据插入数据返回的 Uri , 打开输出流 , 然后向输出流中写出图片数据 ;

// 向 Download/hello/hello.jpg 文件中插入数据
var os: OutputStream = contentResolver.openOutputStream(insert)!!
var bitmap: Bitmap = BitmapFactory.decodeResource(resources, R.drawable.icon)
bitmap.compress(Bitmap.CompressFormat.JPEG, 100, os)
os.close()

图片数据写出完成 , 输出流正式关闭 , 图片创建成功 ;

创建完成后 , 可以在 " Device Explorer " 面板中显示新创建的图片 ;

在这里插入图片描述

关于图片 MIME_TYPE :

图片文件创建与文本文件创建唯一的区别就是需要设置 MIME_TYPE 字段 , 根据传入的图片格式设置不同的 mimetype , 如 : 传入 jpeg 图片 , 则设置字段值为 “image/jpg” ;

保存图片文件时 , 传入的 MIME_TYPE 为 “image/jpg” , 如果传错了 , 写成 “vedio/mp3” , 创建文件时不会抛出异常 , 但是使用该文件时会出错 ;

图片创建部分代码示例 :

    /**
     * 创建图片文件
     * 在 Download 目录下创建 hello.txt
     */
    fun createImageFile(){

        // 操作 external.db 数据库
        // 获取 Uri 路径
        var uri: Uri = MediaStore.Images.Media.EXTERNAL_CONTENT_URI

        // 将要新建的文件的文件索引插入到 external.db 数据库中
        // 需要插入到 external.db 数据库 files 表中, 这里就需要设置一些描述信息
        var contentValues: ContentValues = ContentValues()

        // 设置插入 external.db 数据库中的 files 数据表的各个字段的值

        // 设置存储路径 , files 数据表中的对应 relative_path 字段在 MediaStore 中以常量形式定义
        contentValues.put(MediaStore.Downloads.RELATIVE_PATH, "${Environment.DIRECTORY_MOVIES}/image")
        // 设置文件名称
        contentValues.put(MediaStore.Downloads.DISPLAY_NAME, "image.jpg")
        // 设置文件标题, 一般是删除后缀, 可以不设置
        contentValues.put(MediaStore.Downloads.TITLE, "image")
        // 设置 MIME_TYPE
        contentValues.put(MediaStore.Downloads.MIME_TYPE, "image/jpg")

        // uri 表示操作哪个数据库 , contentValues 表示要插入的数据内容
        var insert: Uri = contentResolver.insert(uri, contentValues)!!

        // 向 Download/hello/hello.jpg 文件中插入数据
        var os: OutputStream = contentResolver.openOutputStream(insert)!!
        var bitmap: Bitmap = BitmapFactory.decodeResource(resources, R.drawable.icon)
        bitmap.compress(Bitmap.CompressFormat.JPEG, 100, os)
        os.close()
    }

二、分区存储模式下使用 MediaStore 查询图片

首先 , 根据查询的位置 , 获取其对应的数据库操作 Uri ; 这里获取外置 SD 卡 Pictures 目录对应的 Uri 对象 ;

// 获取外置 SD 卡 Pictures 对应的 Uri 对象
var externalContentUri: Uri = MediaStore.Images.Media.EXTERNAL_CONTENT_URI;

然后 , 使用 SQLite 查询机制 , 查询对应图片的 Uri ; 查询 Pictures 目录下的 image.jpg 图片 ;

// 拼接查询语句
var selection: String = "${MediaStore.Images.Media.DISPLAY_NAME}=?";

// 查询语句参数
var selectionArgs: Array<String> = arrayOf("image.jpg");

// 查询 SQLite 数据库
var cursor = contentResolver.query(
        // 指定要查询的 Uri
        externalContentUri,
        // 指定要查询的列
        null,
        // 指定查询语句
        selection,
        // 指定查询参数
        selectionArgs,
        // 排序规则
        null
)

最后 , 通过 Cursor 查询数据表中各个字段的信息 , 如 id 字段 , relative_path 相对路径字段 , data 绝对路径字段 , _display_name 文件名称字段 ;

// 先获取该图片在数据库中的 id , 然后通过 id 获取 Uri
if (cursor != null && cursor.moveToFirst()){
    // 获取第 0 行 _id 所在列的值
    var id = cursor.getLong(
            // 获取 _id 所在列的索引
            cursor.getColumnIndexOrThrow(MediaStore.Images.Media._ID)
    )
    var path = cursor.getString(
            // 获取 relative_path 所在列的索引
            cursor.getColumnIndexOrThrow(MediaStore.Images.Media.RELATIVE_PATH)
    )
    var name = cursor.getString(
            // 获取 _display_name 所在列的索引
            cursor.getColumnIndexOrThrow(MediaStore.Images.Media.DISPLAY_NAME)
    )
    // 绝对路径
    var absolutePath = cursor.getString(
            // 获取 data 所在列的索引
            cursor.getColumnIndexOrThrow(MediaStore.Images.Media.DATA)
    )
    // 通过 _id 字段获取图片 Uri
    var uri = ContentUris.withAppendedId(externalContentUri, id);
    Log.i(TAG, "查询到的 Uri = $uri , 路径 = $path , 文件名称 = $name , 绝对路径 = $absolutePath")
    // 关闭游标
    cursor.close()
}

查询文件代码示例 :

    /**
     * 查询所有的图片
     */
    fun queryImages(){
        // 获取外置 SD 卡 Pictures 对应的 Uri 对象
        var externalContentUri: Uri = MediaStore.Images.Media.EXTERNAL_CONTENT_URI;

        // 拼接查询语句
        var selection: String = "${MediaStore.Images.Media.DISPLAY_NAME}=?";

        // 查询语句参数
        var selectionArgs: Array<String> = arrayOf("image.jpg");

        // 查询 SQLite 数据库
        var cursor = contentResolver.query(
                // 指定要查询的 Uri
                externalContentUri,

                // 指定要查询的列
                null,

                // 指定查询语句
                selection,

                // 指定查询参数
                selectionArgs,

                // 排序规则
                null
        )

        // 先获取该图片在数据库中的 id , 然后通过 id 获取 Uri
        if (cursor != null && cursor.moveToFirst()){
            // 获取第 0 行 _id 所在列的值
            var id = cursor.getLong(
                    // 获取 _id 所在列的索引
                    cursor.getColumnIndexOrThrow(MediaStore.Images.Media._ID)
            )

            var path = cursor.getString(
                    // 获取 relative_path 所在列的索引
                    cursor.getColumnIndexOrThrow(MediaStore.Images.Media.RELATIVE_PATH)
            )

            var name = cursor.getString(
                    // 获取 _display_name 所在列的索引
                    cursor.getColumnIndexOrThrow(MediaStore.Images.Media.DISPLAY_NAME)
            )

            // 绝对路径
            var absolutePath = cursor.getString(
                    // 获取 data 所在列的索引
                    cursor.getColumnIndexOrThrow(MediaStore.Images.Media.DATA)
            )

            // 通过 _id 字段获取图片 Uri
            var uri = ContentUris.withAppendedId(externalContentUri, id);

            Log.i(TAG, "查询到的 Uri = $uri , 路径 = $path , 文件名称 = $name , 绝对路径 = $absolutePath")

            // 关闭游标
            cursor.close()
        }
    }

执行打印的结果 :

查询到的 Uri = content://media/external/images/media/42 , 路径 = Pictures/image/ , 文件名称 = image.jpg , 绝对路径 = /storage/emulated/0/Pictures/image/image.jpg

注意 : 该文件的 Uri 是 " content://media/external/images/media/42 " , 绝对路径是 " /storage/emulated/0/Pictures/image/image.jpg " ;

Uri 最后的 42 数字 , 就是在 " external.db " 数据库中 files 数据表中该 image.jpg 文件对应的 _id 字段数据 ;

绝对路径在 Android 11 的分区存储机制中不能用来做任何操作 , 否则会产生崩溃 ;

对文件的操作 , 如 : 访问图片 , 删除图片等操作 , 必须使用 Uri 进行操作 ;

三、相关文档资料

Android 文件处理参考文档 :

数据和文件存储概览 : https://developer.android.google.cn/training/data-storage
访问应用专属文件 : https://developer.android.google.cn/training/data-storage/app-specific#kotlin
保存到共享的存储空间 : https://developer.android.google.cn/training/data-storage/shared
管理存储设备上的所有文件 : https://developer.android.google.cn/training/data-storage/manage-all-files
分享文件 : https://developer.android.google.cn/training/secure-file-sharing
应用安装位置 : https://developer.android.google.cn/guide/topics/data/install-location
Android 存储用例和最佳做法 : https://developer.android.google.cn/training/data-storage/use-cases
FileProvider : https://developer.android.google.cn/reference/androidx/core/content/FileProvider

博客源码 :

GitHub : https://github.com/han1202012/File
CSDN : https://download.csdn.net/download/han1202012/18932254

在这里插入图片描述

以上是关于Android 文件管理分区存储 ( 创建与查询图片文件 )的主要内容，如果未能解决你的问题，请参考以下文章

Android 文件管理分区存储 ( 修改与删除图片文件 )

Android - 文件系统与Android11 分区存储

Android 文件管理分区存储 ( 分区存储机制和文件索引数据 )

Android 文件管理分区存储 ( MediaStore 文件操作 )

错误记录Android 低版本使用分区存储错误 ( 低版本存储不得使用 MediaStore )

hive外部表分区