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

原创

韩曙亮_ 2022-03-08 11:14:22 博主文章分类：Android 文件管理 ©著作权

文章标签 分区存储 Android 创建文件查询文件 MediaStore 文章分类 代码人生

©著作权归作者所有：来自51CTO博客作者韩曙亮_的原创作品，请联系作者获取转载授权，否则将追究法律责任

文章目录

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

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

Android 分区存储系列博客 :

【Android 文件管理】应用可访问的存储空间 ( 存储空间分类 | 存储空间访问权限 | 分区存储 )
【Android 文件管理】分区存储 ( 分区存储机制和文件索引数据 )
【Android 文件管理】分区存储 ( MediaStore 文件操作 )

一、分区存储模式下使用 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 " 面板中显示新创建的图片 ;

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

关于图片 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

博客源码 :