Android--ContentProvider-低调大师

Android--ContentProvider

2017-11-14 476

前言

　　本篇博客讲讲ContentProvider，内容提供者。前面已经讲过了数据持久化，但是除了共享内存（SDCard）的数据外，其他包括SQLite、SharedPreferences都是仅限于被当前所创建的应用访问，而无法使它们的数据在应用程序之间交换数据，所以Android提供了ContentProvider，ContentProvider是不同应用程序之间进行数据交换的标准API。虽然Android附带了需要有用的内容提供者，但是本片博客不涉及这方面的内容，而是专注讲解如何创建自己的ContentProvider，并在其他应用中如何调用。

概述

　　ContentProvider可以理解为一个Android应用对外开放的接口，只要是符合它所定义的Uri格式的请求，均可以正常访问执行操作。其他的Android应用可以使用ContentResolver对象通过与ContentProvider同名的方法请求执行，被执行的就是ContentProvider中的同名方法。所以ContentProvider很多对外可以访问的方法，在ContentResolver中均有同名的方法，是一一对应的，如图：

Uri

　　在Android中，Uri是一种比较常见的资源访问方式。而对于ContentProvider而言，Uri也是有固定格式的：

　　　　<srandard_prefix>://<authority>/<data_path>/<id>

<srandard_prefix>：ContentProvider的srandard_prefix始终是content://。
<authority>：ContentProvider的名称。
<data_path>：请求的数据类型。
<id>：指定请求的特定数据。

ContentProvider

　　ContentProvider也是Android应用的四大组件之一，所以也需要在AndroidManifest.xml文件中进行配置。而且某个应用程序通过ContentProvider暴露了自己的数据操作接口，那么不管该应用程序是否启动，其他应用程序都可以通过这个接口来操作它的内部数据。

　　Android附带了许多有用的ContentProvider，但是本篇博客不会涉及到这些内容的，以后有时间会再讲解。Android附带的ContentProvider包括：

Browser：存储如浏览器的信息。
CallLog：存储通话记录等信息。
Contacts：存储联系人等信息。
MediaStore：存储媒体文件的信息。
Settings：存储设备的设置和首选项信息。

　　在Android中，如果要创建自己的内容提供者的时候，需要扩展抽象类ContentProvider，并重写其中定义的各种方法。然后在AndroidManifest.xml文件中注册该ContentProvider即可。

　　ContentProvider是内容提供者，实现Android应用之间的数据交互，对于数据操作，无非也就是CRUD而已。下面是ContentProvider必须要实现的几个方法：

onCreate()：初始化提供者。
query(Uri, String[], String, String[], String)：查询数据，返回一个数据Cursor对象。
insert(Uri, ContentValues)：插入一条数据。
update(Uri, ContentValues, String, String[])：根据条件更新数据。
delete(Uri, String, String[])：根据条件删除数据。
getType(Uri) 返回MIME类型对应内容的URI。

　　除了onCreate()和getType()方法外，其他的均为CRUD操作，这些方法中，Uri参数为与ContentProvider匹配的请求Uri，剩下的参数可以参见SQLite的CRUD操作，基本一致，SQLite的内容在另外一篇博客中有讲解：Android--数据持久化之SQLite。、

　　Tips:还有两个非常有意思的方法，必须要提一下，call()和bulkInsert()方法，使用call，理论上可以在ContentResolver中执行ContentProvider暴露出来的任何方法，而bulkInsert()方法用于插入多条数据。

　　在ContentProvider的CRUD操作，均会传递一个Uri对象，通过这个对象来匹配对应的请求。那么如何确定一个Uri执行哪项操作呢？需要用到一个UriMatcher对象，这个对象用来帮助内容提供者匹配Uri。它所提供的方法非常简单，仅有两个：

void addURI(String authority,String path,int code)：添加一个Uri匹配项，authority为AndroidManifest.xml中注册的ContentProvider中的authority属性；path为一个路径，可以设置通配符，#表示任意数字，*表示任意字符；code为自定义的一个Uri代码。
int match(Uri uri)：匹配传递的Uri，返回addURI()传递的code参数。

　　在创建好一个ContentProvider之后，还需要在AndroidManifest.xml文件中对ContentProvider进行配置，使用一个<provider.../>节点，一般只需要设置两个属性即可访问，一些额外的属性就是为了设置访问权限而存在的，后面会详细讲解：

android:name：provider的响应类。
android:authorities：Provider的唯一标识，用于Uri匹配，一般为ContentProvider类的全名。

　　下面通过一个示例来讲解一下ContentProvider，在这个例子中，需要用到SQLite数据库来存储数据，定义了一个StudentDAO类，用于进行对SQLite的CRUD操作，这里就不提供数据访问的源码了，有兴趣的朋友可以在下载源码查看：

　　ContentProvider实现：

  1 package com.example.contentproviderdemo;
  2 
  3 import com.example.dao.StudentDAO;
  4 import android.content.ContentProvider;
  5 import android.content.ContentUris;
  6 import android.content.ContentValues;
  7 import android.content.UriMatcher;
  8 import android.database.Cursor;
  9 import android.net.Uri;
 10 import android.os.Bundle;
 11 import android.util.Log;
 12 
 13 public class StudentProvider extends ContentProvider {
 14 
 15     private final String TAG = "main";
 16     private StudentDAO studentDao = null;
 17     private static final UriMatcher URI_MATCHER = new UriMatcher(
 18             UriMatcher.NO_MATCH);
 19     private static final int STUDENT = 1;
 20     private static final int STUDENTS = 2;
 21     static {
 22         //添加两个URI筛选
 23         URI_MATCHER.addURI("com.example.contentproviderdemo.StudentProvider",
 24                 "student", STUDENTS);
 25         //使用通配符#，匹配任意数字
 26         URI_MATCHER.addURI("com.example.contentproviderdemo.StudentProvider",
 27                 "student/#", STUDENT);        
 28     }
 29 
 30     public StudentProvider() {
 31 
 32     }    
 33     
 34     @Override
 35     public boolean onCreate() {
 36         // 初始化一个数据持久层
 37         studentDao = new StudentDAO(getContext());
 38         Log.i(TAG, "---->>onCreate()被调用");
 39         return true;
 40     }
 41 
 42     @Override
 43     public Uri insert(Uri uri, ContentValues values) {
 44         Uri resultUri = null;
 45         //解析Uri，返回Code
 46         int flag = URI_MATCHER.match(uri);
 47         if (flag == STUDENTS) {
 48             long id = studentDao.insertStudent(values);
 49             Log.i(TAG, "---->>插入成功, id="+id);
 50             resultUri = ContentUris.withAppendedId(uri, id);
 51         }
 52         return resultUri;
 53     }
 54 
 55     @Override
 56     public int delete(Uri uri, String selection, String[] selectionArgs) {
 57         int count = -1;
 58         try {
 59             int flag = URI_MATCHER.match(uri);
 60             switch (flag) {
 61             case STUDENT:
 62                 // delete from student where id=?
 63                 //单条数据，使用ContentUris工具类解析出结尾的Id
 64                 long id = ContentUris.parseId(uri);
 65                 String where_value = "id = ?";
 66                 String[] args = { String.valueOf(id) };
 67                 count = studentDao.deleteStudent(where_value, args);
 68                 break;
 69             case STUDENTS:
 70                 count = studentDao.deleteStudent(selection, selectionArgs);                
 71                 break;
 72             }
 73         } catch (Exception e) {
 74             e.printStackTrace();
 75         }
 76         Log.i(TAG, "---->>删除成功,count="+count);
 77         return count;
 78     }
 79 
 80     @Override
 81     public int update(Uri uri, ContentValues values, String selection,
 82             String[] selectionArgs) {
 83         int count = -1;
 84         try {            
 85             int flag = URI_MATCHER.match(uri);
 86             switch (flag) {
 87             case STUDENT:
 88                 long id = ContentUris.parseId(uri);
 89                 String where_value = " id = ?";
 90                 String[] args = { String.valueOf(id) };
 91                 count = studentDao.updateStudent(values, where_value, args);
 92                 break;
 93             case STUDENTS:
 94                 count = studentDao.updateStudent(values, selection,
 95                         selectionArgs);
 96                 break;
 97             }
 98         } catch (Exception e) {
 99             e.printStackTrace();
100         }
101         Log.i(TAG, "---->>更新成功，count="+count);
102         return count;
103     }
104 
105     @Override
106     public Cursor query(Uri uri, String[] projection, String selection,
107             String[] selectionArgs, String sortOrder) {
108         Cursor cursor = null;
109         try {
110             int flag = URI_MATCHER.match(uri);
111             switch (flag) {
112             case STUDENT:
113                 long id = ContentUris.parseId(uri);
114                 String where_value = " id = ?";
115                 String[] args = { String.valueOf(id) };
116                 cursor = studentDao.queryStudents(where_value, args);
117                 break;
118             case STUDENTS:
119                 cursor = studentDao.queryStudents(selection, selectionArgs);
120                 break;
121             }
122         } catch (Exception e) {
123             e.printStackTrace();
124         }
125         Log.i(TAG, "---->>查询成功，Count="+cursor.getCount());
126         return cursor;
127     }
128 
129 
130     @Override
131     public String getType(Uri uri) {
132         int flag = URI_MATCHER.match(uri);
133         String type = null;
134         switch (flag) {
135         case STUDENT:
136             type = "vnd.android.cursor.item/student";
137             Log.i(TAG, "----->>getType return item");
138             break;
139         case STUDENTS:
140             type = "vnd.android.cursor.dir/students";
141             Log.i(TAG, "----->>getType return dir");
142             break;
143         }
144         return type;
145     }
146     @Override
147     public Bundle call(String method, String arg, Bundle extras) {
148         Log.i(TAG, "------>>"+method);
149         Bundle bundle=new Bundle();
150         bundle.putString("returnCall", "call被执行了");
151         return bundle;
152     }
153 }

　　在AndroidManifest.xml中<application>节点中增加：

1         <provider
2             android:name=".StudentProvider" 
3             android:authorities="com.example.contentproviderdemo.StudentProvider" >
4         </provider>

ContentResolver

　　ContentResolver，内容访问者。可以通过ContentResolver来操作ContentProvider所暴露处理的接口。一般使用Content.getContentResolver()方法获取ContentResolver对象。上面已经提到ContentResolver的很多方法与ContentProvider一一对应，所以它也存在insert、query、update、delete等方法。

　　下面就通过一个简单的Demo来演示ContentResolver的使用，这里就不另外新建一个项目了，在原有项目上使用Android JUnit新建一个测试类，用于测试。在另外一个项目中的操作也是一样的。关于JUnit，不了解的朋友可以参见另外一篇博客：JUnit单元测试。

　　JUnit测试类：

  1 package com.example.contentproviderdemo;
  2 
  3 import android.content.ContentResolver;
  4 import android.content.ContentValues;
  5 import android.database.Cursor;
  6 import android.net.Uri;
  7 import android.os.Bundle;
  8 import android.test.AndroidTestCase;
  9 import android.util.Log;
 10 
 11 public class MyTest extends AndroidTestCase {
 12 
 13     public MyTest() {
 14         // TODO Auto-generated constructor stub
 15 
 16     }
 17 
 18     public void insert() {
 19         ContentResolver contentResolver = getContext().getContentResolver();
 20         Uri uri = Uri
 21                 .parse("content://com.example.contentproviderdemo.StudentProvider/student");
 22         ContentValues values = new ContentValues();
 23         values.put("name", "Demo");
 24         values.put("address", "HK");
 25         Uri returnuir = contentResolver.insert(uri, values);
 26         Log.i("main", "-------------->" + returnuir.getPath());
 27     }
 28 
 29     public void delete() {
 30         ContentResolver contentResolver = getContext().getContentResolver();
 31         // 删除多行：content://com.example.contentproviderdemo.StudentProvider/student
 32         Uri uri = Uri
 33                 .parse("content://com.example.contentproviderdemo.StudentProvider/student/2");
 34         contentResolver.delete(uri, null, null);
 35     }
 36 
 37     public void deletes() {
 38         ContentResolver contentResolver = getContext().getContentResolver();
 39         Uri uri = Uri
 40                 .parse("content://com.example.contentproviderdemo.StudentProvider/student");
 41         String where = "address=?";
 42         String[] where_args = { "HK" };
 43         contentResolver.delete(uri, where, where_args);
 44     }
 45 
 46     public void update() {
 47         ContentResolver contentResolver = getContext().getContentResolver();
 48         Uri uri = Uri
 49                 .parse("content://com.example.contentproviderdemo.StudentProvider/student/2");
 50         ContentValues values = new ContentValues();
 51         values.put("name", "李四");
 52         values.put("address", "上海");
 53         contentResolver.update(uri, values, null, null);
 54     }
 55 
 56     public void updates() {
 57         ContentResolver contentResolver = getContext().getContentResolver();
 58         Uri uri = Uri
 59                 .parse("content://com.example.contentproviderdemo.StudentProvider/student");
 60         ContentValues values = new ContentValues();
 61         values.put("name", "王五");
 62         values.put("address", "深圳");
 63         String where = "address=?";
 64         String[] where_args = { "beijing" };
 65         contentResolver.update(uri, values, where, where_args);
 66     }
 67 
 68     public void query() {
 69         ContentResolver contentResolver = getContext().getContentResolver();
 70         Uri uri = Uri
 71                 .parse("content://com.example.contentproviderdemo.StudentProvider/student/2");
 72         Cursor cursor = contentResolver.query(uri, null, null, null, null);
 73         while (cursor.moveToNext()) {
 74             Log.i("main",
 75                     "-------------->"
 76                             + cursor.getString(cursor.getColumnIndex("name")));
 77         }
 78     }
 79 
 80     public void querys() {
 81         ContentResolver contentResolver = getContext().getContentResolver();
 82         Uri uri = Uri
 83                 .parse("content://com.example.contentproviderdemo.StudentProvider/student");
 84         String where = "address=?";
 85         String[] where_args = { "深圳" };
 86         Cursor cursor = contentResolver.query(uri, null, where, where_args,
 87                 null);
 88         while (cursor.moveToNext()) {
 89             Log.i("main",
 90                     "-------------->"
 91                             + cursor.getString(cursor.getColumnIndex("name")));
 92         }
 93     }
 94 
 95     public void calltest() {
 96         ContentResolver contentResolver = getContext().getContentResolver();
 97         Uri uri = Uri
 98                 .parse("content://com.example.contentproviderdemo.StudentProvider/student");
 99         Bundle bundle = contentResolver.call(uri, "method", null, null);
100         String returnCall = bundle.getString("returnCall");
101         Log.i("main", "-------------->" + returnCall);
102     }
103 
104 }

　　效果演示：

　　执行insert()，数据库在创建的时候存在初始数据：

　　执行update():

　　执行updates():

　　执行query()

　　执行delete()

getType()中的MIME

　　MIME类型就是设定某种扩展名的文件用一种应用程序来打开的方式类型。在ContentProvider中的getType方法，返回的就是一个MIME类型的字符串。如果支持需要使用ContentProvider来访问数据，就上面这个Demo，getType()完全可以只返回一个Null，并不影响效果，但是覆盖ContentProvider的getType方法对于用new Intent(String action, Uri uri)方法启动activity是很重要的，如果它返回的MIME type和activity在<intent filter>中定义的data的MIME type不一致，将造成activity无法启动。这就涉及到Intent和Intent-filter的内容了，以后有机会再说，这里不再详解。

　　从官方文档了解到，getType返回的字符串，如果URI针对的是单条数据，则返回的字符串以vnd.android.cursor.item/开头；如果是多条数据，则以vnd.adroid.cursor.dir/开头。

访问权限

　　对于ContentProvider暴露出来的数据，应该是存储在自己应用内存中的数据，对于一些存储在外部存储器上的数据，并不能限制访问权限，使用ContentProvider就没有意义了。对于ContentProvider而言，有很多权限控制，可以在AndroidManifest.xml文件中对<provider>节点的属性进行配置，一般使用如下一些属性设置：

android:grantUriPermssions:临时许可标志。
android:permission:Provider读写权限。
android:readPermission:Provider的读权限。
android:writePermission:Provider的写权限。
android:enabled:标记允许系统启动Provider。
android:exported:标记允许其他应用程序使用这个Provider。
android:multiProcess:标记允许系统启动Provider相同的进程中调用客户端。

　　源码下载

总结

　　以上就讲解了内容提供者的简单使用，关于内容提供者的内容涉及面很多，一篇博客无法一一说明，这里只是简单的定义一个内容提供者，并且说明如何操作它。这个博客的示例源码中，声明的内容提供者和内容访问者均在一个项目中，可能不太利于大家理解，但是在另外一个项目中的操作，与JUnit类中的操作一致，所以这里就没有另外创建一个项目去说明它，不过源码中有另外一个小项目，只是实现了Insert的操作，有兴趣的朋友对照看一下就会发现其实是一样的。

本文转自承香墨影博客园博客，原文链接：http://www.cnblogs.com/plokmju/p/android_ContentProvider.html，如需转载请自行联系原作者

微信关注我们

原文链接：https://yq.aliyun.com/articles/394837

转载内容版权归作者及来源网站所有！

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。

Android--多线程之Looper

前言上一篇博客讲解了Handler实现线程间通信，这篇博客讲解一下Handler运行的原理，其中涉及到MessageQueue、Looper。简要来讲，Handler会把一个线程消息发送给当前线程的消息队列，从最后Handler会处理消息队列中的消息，这里的消息队列就是MessageQueue，而管理消息队列的，就是Looper。 Handler、MessageQueue、Looper三者间的关系如图：从上图可以看出，Handler发送线程消息到当前线程的MessageQueue中，而Looper用来管理MessageQueue，它从MessageQueue中取到消息交给Handler处理。 Looper Looper，通常运行在一个消息的循环队列当中，线程在默认的情况下，不会给我们提供一个消息循环去管理消息队列的。如果想管理消息队列，需要在线程当中调用Looper.prepare()方法使消息循环初始化，并且调用Looper.loop()使消息循环一直处于运行状态，直到停止循环。所以Looper主要就是完成MessageQueue与Handler进行交互的功能。在Activi...

2017-11-15

438

资源文件作为一枚coder，做界面，很多时候都是一场梦魇。很多时候，我们会感觉对于底层逻辑实现的很有把握性，哪怕需求一直在变，也可以通过不断的重构一直跟进，一切尽在掌握。但遭遇界面，往往就不再如此，它的好坏总是和审美、体验之类的词汇扯在一起，在凤姐芙蓉出没的年头，谈审美成为一件恐怖的事情。你可能会被要求不停的改代码，就为了移动一个像素，调整一枚按钮，琐碎而无聊。为了改变这样的状况，挽救coder们于水生活热之中，很多开发平台，都采用了类似于资源文件的解决方案。此类方案的基本思想是，将界面的实现与底层逻辑的实现完全剥离开来，用资源文件这样的东西来描述界面。资源文件的描述语言，往往是结构化很强，比如Html，Xml（及其变形体）之类的。于开发语言相比，此类语言逻辑性较弱但结构更好可读性更强更容易理解，并对自动化工具非常友好，可以于界面的拖拽配置结合的更加完美。这样的剥离，可以是的底层逻辑和上层界面独立变化，甚至不同的人员开发（这一点在web开发上表现的应该很明显...），两者之间的耦合性非常的小，coder们的负担，陡然减少（好吧，一个很挫的资源架构也会额外增加开发人员的负担，Symb...

2017-11-15

549

资源下载

更多资源

优质分享App

近一个月的开发和优化，本站点的第一个app全新上线。该app采用极致压缩，本体才4.36MB。系统里面做了大量数据访问、缓存优化。方便用户在手机上查看文章。后续会推出HarmonyOS的适配版本。

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长，特征是大鼻子、头戴帽子、身穿背带裤，还留着胡子。与他的双胞胎兄弟路易基一起，长年担任任天堂的招牌角色。

Nacos

Nacos /nɑ:kəʊs/ 是 Dynamic Naming and Configuration Service 的首字母简称，一个易于构建 AI Agent 应用的动态服务发现、配置管理和AI智能体管理平台。Nacos 致力于帮助您发现、配置和管理微服务及AI智能体应用。Nacos 提供了一组简单易用的特性集，帮助您快速实现动态服务发现、服务配置、服务元数据、流量管理。Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。

Rocky Linux

Rocky Linux（中文名：洛基）是由Gregory Kurtzer于2020年12月发起的企业级Linux发行版，作为CentOS稳定版停止维护后与RHEL（Red Hat Enterprise Linux）完全兼容的开源替代方案，由社区拥有并管理，支持x86_64、aarch64等架构。其通过重新编译RHEL源代码提供长期稳定性，采用模块化包装和SELinux安全架构，默认包含GNOME桌面环境及XFS文件系统，支持十年生命周期更新。