4.4.2 ContentProvider再探——Document Provider

本节引言：学完上一节，相信你已经知道如何去使用系统提供的ContentProvider或者自定义ContentProvider了，已经基本满足日常开发的需求了，有趣的是，我在官方文档上看到了另外这几个Provider：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);下面是运行结果： 右面这个就是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中是以传统的文件目录树组织起来的：3）流程图：如上面所述，document provider data是基于传统的文件层次结构的，不过那只是对外的表现形式，如何存储你的数据，取决于你自己，只要你对海外的接口能够通过DocumentsProvider的api访问就可以。下面的流程图展示了一个photo应用使用SAF可能的结构：分析：从上图，我们可以看出Picker是链接调用者和内容提供者的一个桥梁！他提供并告诉调用者，可以选择哪些内容提供者，比如这里的DriveDocProvider，UsbDocProvider，CloundDocProvider。当客户端触发了ACTION_OPEN_DOCUMENT或ACTION_CREATE_DOCUMENT的Intent，就会发生上述交互。当然我们还可以在Intent中增加过滤条件，比如限制MIME type的类型为"image"!就是上面这些东西，如果你还安装了其他看图的软件的话，也会在这里看到！简单点说就是：客户端发送了上面两种Action的Intent后，会打开Picker UI，在这里会显示相关可用的Document Provider，供用户选择，用户选择后可以获得文件的相关信息！4）客户端调用，并获取返回的Uri实现代码如下：public class MainActivity extends AppCompatActivity implements View.OnClickListener { private static final int READ_REQUEST_CODE = 42; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); Button btn_show = (Button) findViewById(R.id.btn_show); btn_show.setOnClickListener(this); } @Override public void onClick(View v) { Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT); intent.addCategory(Intent.CATEGORY_OPENABLE); intent.setType("image/*"); startActivityForResult(intent, READ_REQUEST_CODE); } @Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { if (requestCode == READ_REQUEST_CODE && resultCode == Activity.RESULT_OK) { Uri uri; if (data != null) { uri = data.getData(); Log.e("HeHe", "Uri: " + uri.toString()); } } }}运行结果：比如我们选中那只狗，然后Picker UI自己会关掉，然后Logcat上可以看到这样一个uri: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"; }