ContentProvider再探——文档提供者


本节引言:

学完上一节,相信你已经知道如何去使用系统提供的ContentProvider或者自定义ContentProvider了, 已经基本满足日常开发的需求了,有趣的是,我在官方文档上看到了另外这几个Provider:

1.png

Calendar Provider:日历提供者,就是针对针对日历相关事件的一个资源库,通过他提供的API,我们 可以对日历,时间,会议,提醒等内容做一些增删改查!
Contacts Provider:联系人提供者,这个就不用说了,这个用得最多~后面有时间再回头翻译下这篇文章吧!
Storage Access Framework(SAF):存储访问框架,4.4以后引入的一个新玩意,为用户浏览手机中的 存储内容提供了便利,可供访问的内容不仅包括:文档,图片,视频,音频,下载,而且包含所有由 由特定ContentProvider(须具有约定的API)提供的内容。不管这些内容来自于哪里,不管是哪个应 用调用浏览系统文件内容的命令,系统都会用一个统一的界面让你去浏览。
其实就是一个内置的应用程序,叫做DocumentsUI,因为它的IntentFilter不带有LAUNCHER,所以我们并没有 在桌面上找到这个东东!嘿嘿,试下下面的代码,这里我们选了两个手机来对比: 分别是4.2的Lenovo S898T 和 5.0.1的Nexus 5做对比,执行下述代码:

 Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
        intent.addCategory(Intent.CATEGORY_OPENABLE);
        intent.setType("image/*");
        startActivity(intent);
下面是运行结果:

2.png3.png

右面这个就是4.4给我们带来的新玩意了,一般我们获取文件Url的时候就可以用到它~ 接下来简单的走下文档吧~


2.简单走下文档:

1)SAF框架的组成:

  • Document provider:一个特殊的ContentProvider,让一个存储服务(比如Google Drive)可以 对外展示自己所管理的文件。它是DocumentsProvider的子类,另外,document-provider的存储格式 和传统的文件存储格式一致,至于你的内容如何存储,则完全决定于你自己,Android系统已经内置了几个 这样的Document provider,比如关于下载,图片以及视频的Document provider!
  • Client app:一个普通的客户端软件,通过触发ACTION_OPEN_DOCUMENT 和/或ACTION_CREATE_DOCUMENT就可以接收到来自于Document provider返回的内容,比如选择一个图片, 然后返回一个Uri。
  • Picker:类似于文件管理器的界面,而且是系统级的界面,提供额访问客户端过滤条件的 Document provider内容的通道,就是起说的那个DocumentsUI程序!

一些特性:

  • 用户可以浏览所有document provider提供的内容,而不仅仅是单一的应用程序
  • 提供了长期、持续的访问document provider中文件的能力以及数据的持久化, 用户可以实现添加、删除、编辑、保存document provider所维护的内容
  • 支持多用户以及临时性的内容服务,比如USB storage providers只有当驱动安装成功才会出现

2)概述:

SAF的核心是实现了DocumentsProvider的子类,还是一个ContentProvider。在一个document provider 中是以传统的文件目录树组织起来的:

4.png

3)流程图:

如上面所述,document provider data是基于传统的文件层次结构的,不过那只是对外的表现形式, 如何存储你的数据,取决于你自己,只要你对海外的接口能够通过DocumentsProvider的api访问就可以。 下面的流程图展示了一个photo应用使用SAF可能的结构:

5.png

分析:

从上图,我们可以看出Picker是链接调用者和内容提供者的一个桥梁!他提供并告诉调用者,可以选择 哪些内容提供者,比如这里的DriveDocProvider,UsbDocProvider,CloundDocProvider。
当客户端触发了ACTION_OPEN_DOCUMENTACTION_CREATE_DOCUMENT的Intent,就会发生上述交互。 当然我们还可以在Intent中增加过滤条件,比如限制MIME type的类型为"image"!

6.png

就是上面这些东西,如果你还安装了其他看图的软件的话,也会在这里看到! 简单点说就是:客户端发送了上面两种Action的Intent后,会打开Picker UI,在这里会显示相关可用的 Document Provider,供用户选择,用户选择后可以获得文件的相关信息!


4)客户端调用,并获取返回的Uri

实现代码如下:

公共类 MainActivity 扩展 AppCompatActivity 实现 View.OnClickListener {
    private static final int READ_REQUEST_CODE = 42;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main );
        按钮 btn_show = (按钮) findViewById(R.id.btn_show);
        btn_show.setOnClickListener(this);
    }

    @Override
    public void onClick(View v) {
        意图意图=新意图(意图。 ACTION_OPEN_DOCUMENT);
        intent.addCategory(Intent.CATEGORY_OPENABLE);
        intent.setType("image/*");
        startActivityForResult(intent, READ_REQUEST_CODE);
    }

   @Override
    protected void onActivityResult(int requestCode, int resultCode,意图数据) {
        if (requestCode == READ_REQUEST_CODE && resultCode == Activity.RESULT_OK) {
           Uri uri;
            if (data != null) {
                 uri = data.getData();
                Log.e("呵呵" , "Uri: " + uri.toString());
            }
        }
    }
}

运行结果:比如我们选中那只狗,然后Picker UI自己会关掉,然后Logcat上可以看到这样一个uri:

7.png


5)根据uri获取文件参数

核心代码如下:

public void dumpImageMetaData(Uri uri) {
    Cursor cursor = getContentResolver()
            .query(uri, null, null, null, null, null);
    try {
        if (cursor != null && cursor.moveToFirst()) {
            String displayName = cursor.getString(
                    cursor.getColumnIndex(OpenableColumns.DISPLAY_NAME));
            Log.e("HeHe", "Display Name: " + displayName);
            int sizeIndex = cursor.getColumnIndex(OpenableColumns.SIZE);
            String size = null;
            if (!cursor.isNull(sizeIndex)) {
                size = cursor.getString(sizeIndex);
            }else {
                size = "Unknown";
            }
            Log.e("HeHe", "Size: " + size);
        }
    }finally {
        cursor.close();
    }
}

运行结果:还是那只狗,调用方法后会输入文件名以及文件大小,以byte为单位

8.png


6)根据Uri获得Bitmap

核心代码如下:

private Bitmap getBitmapFromUri(Uri uri) throws IOException {
        ParcelFileDescriptor parcelFileDescriptor =
        getContentResolver().openFileDescriptor(uri, "r");
        FileDescriptor fileDescriptor = parcelFileDescriptor.getFileDescriptor();
        Bitmap image = BitmapFactory.decodeFileDescriptor(fileDescriptor);
        parcelFileDescriptor.close();
        return image;
}

运行结果

9.gif

7)根据Uri获取输入流

核心代码如下:

private String readTextFromUri(Uri uri) throws IOException {
    InputStream inputStream = getContentResolver().openInputStream(uri);
    BufferedReader reader = new BufferedReader(new InputStreamReader(
            inputStream));
    StringBuilder stringBuilder = new StringBuilder();
    String line;
    while ((line = reader.readLine()) != null) {
        stringBuilder.append(line);
    }
    fileInputStream.close();
    parcelFileDescriptor.close();
    return stringBuilder.toString();
}

上述的内容只告诉你通过一个Uri你可以知道什么,而Uri的获取则是通过SAF得到的!


8) 创建新文件以及删除文件:

创建文件:

private void createFile(String mimeType, String fileName) {
    Intent intent = new Intent(Intent.ACTION_CREATE_DOCUMENT);
    intent.addCategory(Intent.CATEGORY_OPENABLE);
    intent.setType(mimeType);
    intent.putExtra(Intent.EXTRA_TITLE, fileName);
    startActivityForResult(intent, WRITE_REQUEST_CODE);
}

可在onActivityResult()中获取被创建文件的uri

删除文件:

前提是Document.COLUMN_FLAGS包含SUPPORTS_DELETE

DocumentsContract.deleteDocument(getContentResolver(), uri);

9)编写一个自定义的Document Provider

如果你希望自己应用的数据也能在documentsui中打开,你就需要写一个自己的document provider。 下面介绍自定义DocumentsProvider的步骤:

  • API版本为19或者更高
  • 在manifest.xml中注册该Provider
  • Provider的name为类名加包名,比如:com.example.android.storageprovider.MyCloudProvider
  • Authority为包名+provider的类型名,如:com.example.android.storageprovider.documents
  • android:exported属性的值为ture

下面是Provider的例子写法:

<manifest... >
    ...
    <uses-sdk
        android:minSdkVersion="19"
        android:targetSdkVersion="19" />
        ....
        <provider
            android:name="com.example.android.storageprovider.MyCloudProvider"
            android:authorities="com.example.android.storageprovider.documents"
            android:grantUriPermissions="true"
            android:exported="true"
            android:permission="android.permission.MANAGE_DOCUMENTS"
            android:enabled="@bool/atLeastKitKat">
            <intent-filter>
                <action android:name="android.content.action.DOCUMENTS_PROVIDER" />
            </intent-filter>
        </provider>
    </application>

</manifest>

10 )DocumentsProvider的子类

至少实现如下几个方法:

  • queryRoots()
  • queryChildDocuments()
  • queryDocument()
  • openDocument()

还有些其他的方法,但并不是必须的。下面演示一个实现访问文件(file)系统的 DocumentsProvider的大致写法。

Implement queryRoots

@Override
public Cursor queryRoots(String[] projection) 抛出 FileNotFoundException {

    // 使用请求的字段或默认
    //如果“projection”为空,则创建一个 Curs 或 。
    最终矩阵光标结果=
new MatrixCursor(resolveRootProjection(projection));

    //如果用户未登录,则返回空根光标。  这会将我们的
    // 提供商从列表中完全删除。
    if (!isUserLoggedIn()) {
        返回结果;
    }

    // 可以有多个根(例如
    //同一应用程序中的多个帐户) -- 只需添加多个光标行。
    // 为名为“MyCloud”的根构造一行。
    final MatrixCursor.RowBuilder row = result.newRow();
    row.add(Root.COLUMN_ROOT_ID, ROOT);
    row. add(Root.COLUMN_SUMMARY, getContext().getString(R.string.root_summary));

    // FLAG_SUPPORTS_CREATE 表示根目录下至少有一个目录支持
    // 创建文档。 FLAG_SUPPORTS_RECENTS 表示您的应用程序最
    // 最近使用的文档将显示在“最近”类别中。
    // FLAG_SUPPORTS_SEARCH 允许用户搜索应用程序
    // 共享的所有文档。
    row.add(Root.COLUMN_FLAGS, Root.FLAG_SUPPORTS_CREATE |
            Root.FLAG_SUPPORTS_RECENTS |
            Root.FLAG_SUPPORTS_SEARCH);

    // COLUMN_TITLE 是根标题(例如,图库、驱动器)。
    row.add(Ro ot.COLUMN_TITLE, getContext().getString(R.string.title)) ;

    // 此文档 ID 一旦共享就无法更改。
    row.add(Root.COLUMN_DOCUMENT_ID, getDocIdForFile(mBaseDir));

    // 子 MIME 类型用于过滤根,并且仅呈现给
    // 用户 根在其文件层次结构中的某个位置包含所需的类型。
    row.add(Root.COLUMN_MIME_TYPES, getChildMimeTypes(mBaseDir));
    row.add(Root.COLUMN_AVAILABLE_BYTES, mBaseDir.getFreeSpace());
    row.add(Ro ot.COLUMN_ICON , R.drawable.ic_launcher);

    返回结果;
}

实现queryChildDocuments

public Cursor queryChildDocuments(String parentDocumentId, String[] projection,
                              String sortOrder) 抛出 FileNotFoundException {

    最终 MatrixCursor 结果 = new
            MatrixCursor(resolveDocumentProjection(projection));
    final File parent = getFileForDocId(parentDocumentId);
    for (File file : parent.listFiles()) {
         // 添加文件的显示名称, MIME 类型、大小等.
        includeFile(result, null, file);
    }
    return 结果;
}

实现queryDocument

@Override
public Cursor queryDocument(String documentId, String[] project ion) 抛出
        FileNotFoundException {

// 使用请求的投影或默认投影创建光标。
    最终 MatrixCursor 结果 = new
            MatrixCursor(resolveDocumentProjection(projection));
    includeFile(result, documentId, null);
    return结果;
}

好吧,文档中的内容大概就是这些了: 一开始是想自己翻译的,后来在泡在网上的日子上找到了这一篇文档的中文翻译,就偷下懒了~

中文翻译链接:android存储访问框架Storage Access Framework


3.Android 4.4 获取资源路径问题:

其实这个SAF我们用得较多的地方无非是获取图片的Uri而已,而从上面的例子我们也发现了: 我们这样获取的链接是这样的:

content://com.android.providers.media.documents/document/image%3A69983

这样的链接,我们直接通过上面的方法获得uri即可!

当然,这个是4.4 或者以上版本的~!

如果是以前的版本:uri可能是这样的:

content://media/external/images/media/image%3A69983

这里贴下在别的地方看到的一个全面的方案,原文链接:Android4.4中获取资源路径问题

public static String getPath(final Context context, Final Uri uri) {
    final boolean isKitKat = Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT;
    // DocumentProvider  
    if (isKitKat && Docu mentsContract.isDocumentUri(上下文, uri)) {
        // ExternalStorageProvider  
        if (isExternalStorageDocument(uri)) {
            final String docId = DocumentsContract.getDocumentId(uri);
            final String[] sp lit = docId.split(":");
            最终字符串类型 = split [0];

如果(“主” .equalalsignorecase(type)){
返回环境。getExternalStorageDirectory()+“/”+split [1];
}

//
        // DownloadsProvider  
        else if (isDownloadsDocument(uri)) {

           final String id = DocumentsContract.getDocumentId(uri);
            final Uri contentU ri = ContentUris.withAppishedId(
                    Uri.parse("content://downloads/public_downloads" ), Long.valueOf(id));

            return getDataColumn(context, contentUri, null, null);
        }
        // MediaProvider  
        else if (isMediaDocument(uri)) {
            最终 String docId = DocumentsContract.getDocumentId(uri );
            Final String[] split = docId.split(":");
            final String type = split[0];
            Uri contentUri = null;
            if ("image".equals(type)) {
                 contentUri = MediaStore.Images .Media.EXTERNAL_CONTENT_URI;
            } else if ("video".equals(type)) {
                contentUri = MediaStore.Video.Media.EXTERNAL_CONTENT_URI;
            } else if ("音频".equals(type)) {
                contentUri = MediaStore .Audio.Media.EXTERNAL_CONTENT_URI;
            }
            最终 字符串选择 = "_id=?";
            final String[] selectionArgs = 新 String[] {
                     split[1]
            };
             return getDataColumn(context, contentUri, selection, SelectionArgs);
        }
    }
    // MediaStore (和通用)  
    else if ("content".equalsIgnoreCase(uri.getScheme())) {
        return getDataColumn(context, uri, null, null);
    }
    / / File  
    else if ("file".equalsIgnoreCase(uri.getScheme())) {
        return uri.getPath();
    }
    return null;
}

/**
 * 获取数据的值 专栏对于这个 Uri。 这对
很有用 * MediaStore Uris 和其他基于文件的 ContentProvider。 
 *
 * @param context 上下文。 
*@param uri 要查询的 Uri。 
*@param Selection(可选)查询中使用的过滤器。 
*@paramselectionArgs(可选)查询中使用的选择参数。 
*@return _data 列的值,通常是文件路径。 
 */
public static String getDataColumn(Context context, Uri uri, String 选择,
                                   String[] selectionArgs) {

    光标 光标 = null;
   最终字符串列=“_data”;
    最终字符串[]投影={
column
    };

    尝试 {
        cursor = context.getContentResolver().query(uri, projection, selection, selectionArgs,
                null);
        if (cursor != null && cursor.moveToFirst()) {
            final int column_index = cursor.getColumnIndexOrThrow(column);
            return cursor.getString(column_index);
        }
    } 最后 {
        if (cursor != null)
            光标。 close();
    }
    返回 null;
}


/ **
*@param uri 要检查的 Uri。 
*@return Uri 权限是否为ExternalStorageProvider。 
 */
public static boolean isExternalStorageDocument(Uri uri) {
    return "com.android.externalstorage.documents".equals(uri.getAuthority());
}

/**
 * @param uri The Uri to check. 
 * @return Whether the Uri authority is DownloadsProvider. 
 */
public static boolean isDownloadsDocument(Uri uri) {
    return "com.android.providers.downloads.documents".equals(uri.getAuthority());
}

/**
*@param uri 要检查的 Uri。 
*@return Uri 权限是否为 MediaProvider。 
 */
public static boolean isMediaDocument(Uri uri) {
    return "com.android.providers.media.documents".equals(uri.getAuthority());
}

本节小结:

好的,关于本节android存储访问框架SAF就到这里吧,没什么例子,后面用到再深入研究吧, 知道下就好,4.4后获取文件路径就简单多了~