Android内容提供者ContentProvider总结

转载 2017年08月12日 16:10:03

一.ContentProvider基础知识

       ContentProvider作为Android四大组件之一,相对其他组件来说,应用的场合是最少的了,但是它是有自己独特的作用的,比如为其他程序提供数据。ContentProvider和其他四个组件一样,使用自己编写的类时,要在AndroidManifest里面注册。
       ContentProvider内部如何保存数据由其设计者决定 .但所有的ContentProvider都实现了一组通的方法来提供数据的增删改查功能.
       客户端通常不会直接使用这些方法,大多数据是通过ContentResolver对象实现对ContentProvider的操作.开发人员可以通过调用Activity或者其它应用程序组伯的实现类中的 getContentResolver()方法来获得Content Provider对象,
如: ContentResolver cr=getContentResolver();
       使用ContentResolver提供的方法可以获得Content Provider中任何感兴趣的数据.
不同进程之间通信由 ContentProvider类和ContentResolver类处理.

(一)数据模型

ContentProvider使用基本数据库模型的简单表格来提供其中的数据,这里每行代表一条记录, 每列代表特定类型和含义的数据.例如,联系人的信息可以如下

_ID NAME NUMBER EMAIL
001 张三 123****** 123******@163.com
002 李四 132****** 132******@google.com
003 王五 414****** 414******@qq.com

每条记录包含一个数值型的_ID字段,它用于在表格中唯一标记该记录.ID
每条记录包含一个数值型的_ID字段,它用于在表格中唯一标记该记录.ID能用于匹配相关表格中 的记录,例如在一个表格中查询联系人电话,在另一个表格中查询照片 查询返回一个Cursor对象,它能遍历各行各列来读取各个字段的值.对于各个类型的数据,Cursor 对象都提供专用的方法. 因此,为了读取字段的数据,开发人员必须知道当前字段包含的数据类型。
其实这个增删改查的操作实现和android数据库的操作是底层实现是一样的,只是我们客户端操作调用的是写好的方法来实现,基本的数据的关键字还是要我们自己来填写的。

(二)URI的用法

       对于ContentProvider来说Uri是非常需要理解的知识。
       在电脑术语中,统一资源标识符(Uniform Resource Identifier,或URI)是一个用于标识某一 互联网资源名称的字符串。 该种标识允许用户对任何(包括本地和互联网)的资源通过特定 的协议进行交互操作。URI由包括确定语法和相关协议的方案所定义。
每个ContentProvider提供公共的URI来唯一标识其数据集,管理多个数据集(多个表格)的 ContentProvider为每个都提供了单独的URI.
       也就是说每一个Uri对于一个表格,我们可以通过某个Uri来实现对某个表格进行相应的操作,比如找到电话号码表格的Uri才能读取里面的通话数据。
所提供的URI都以content://作为前 缀”content://”模式表示数据由Content Provider来管理 如果自定义Content Provider,则应该也是其URI定义一个常量,以简化客户端代码并让日后更 新更加简洁.
       Android为当前平台提供的Content Provider定义了CONTENT_URI常量.匹配电 话号码到联系人表格的URI和匹配保存联系人照片表格的URI分别如下. android.provider.Contacts.Phones.CONTENT.URI; android.provider.Contacts.Photos.CONTENT.URI;
URI常量用于所有与Content Provider的交互中.每个ContentResolver方法使用URI作为其第 一个参数.它标识ContentResolver应该使用哪个provider以及其中的哪个表格.
下面是Content URI重要部分的总结
比如Uri:content://com.hua.employeeprovider/dba/001
上面的URI分四部分
第一部分:标准的前缀(content://),用于标识该数据由Content Provider管理,它永远不用修改。
第二部分:URI的authority部分,它标识该Content Provider.对于第三方应用,该部分一般是完整的包名(小写)来保证唯一性。
如果是自定义的ContentProvider要在AndroidManifest中的provider声明authority.
第三部分: Content Provider的路径部分,用于决定哪类数据被请求,如果ContentProvider仅提供一种数据类型,这部分可以没有.如果提供几种类型,包括子类型,这部分可以由几部分组成.比如对数据库不同表格或对表格的不同操作都可以使用路径来区分。
第四部分:被请求的特定的记录的ID值.这是被请求记录的_ID值.如果请求不仅限于单条记录该部分及前面的斜线应该删除。

二.系统中预定义的ContentProvider

       Android系统为常用数据类型提供了很多预定义的ContentProvider(声音,视频,图片,联系人), 它他大部分位于android.provider包中,开发人员可以查询这些provider经获得其中包含的信息.android系统提供的常见Content Provider说明如下
1.Browser:读取或修改书签,浏览历史或网络搜索.
2.CallLog:查看或更新通话历史.
3.Contacts:获取、修改或保存联系人
4.LiveFolders:由Content Provider提供 内容的特定文件夹
5.MediaStrore:访问声音,视频和图片
6.Setting:查看和获取蓝牙设置,铃声和其它设备偏好. 7.earchRecentSuggestions:该类能为应用程序创建简单的查询建议提供者,它基于近期查询提供建议.
8.SyncStateContract:用于使用数据数组帐号关联数据的Content Provider约束, 希望使用标准方式保存数据的provider可以使用它.
9.UserDictionary:在可以预测文本输入时,提供用户定义的单词给输入法使用.应用程 序和输入法能增加到该字典,单词能关联频率信息和本地化信息.
其中上面大部分的ContentProvider并不常用,常看联系人信息是比较常用的。

三.查询数据

在ContentProvider中查询数据,开发人员需要知道以下信息:

(一)标识该Content Provider的URI

(二)需要查询的数据字段名称和字段中数据的类型 如果需要查询特定记录,那么还需要知道该记录的ID值.

一般使用ContentResolver对象的query()方法完成查询功能,都返回Cursor对象.
query()方法的声明如下
Public final Cursor query(Uri uri,String[] projection,String selection, String[] selectionArgs,String sortOrder)
参数一:Uri:用于查询的Content Providerr URI值
参数二:Projection:由需要查询的列名组成的数组,如果为NULL则不胜枚举查询全部列
参数三:Selection:类似SQL中的WHERE子句,用于增加条件来完成数据过虑
参数四:SelectionArgs:用于替换selection中可以使用?表示的变量值
参数五:sortOrder:类似SQL中的ORDER BY 子句,用于实现排序功能
返回值:Cursor对象,它位于第一条记录之前,或者为NULL
为了限制仅返回一条记录,可以在URL结尾加该记录的_ID值,即将匹配ID值的字符串作为URI路径部分的结尾片段.

四.自定义ContentProvider

如果开发人员希望共享自己的数据,可以自定义Content Provider 步骤如下
建立数据存储系统,大多数ContentProvider使用Android文件存储方法或者SQLite数据库保存数据,但是开发人员可以使用任何方式存储.

(一)使用自定义的ContentProvider必须要做的:

1.继承ContentProvider类来提供数据访问方式。

实现ContentProvider里面的六个方法,
(1)重写onCreate方法里面创建数据库
(2)重写增删改查操作的方法,也可以不用全部重写,比如你只想让其他程序访问本程序的数据,而不能进行其他的操作,只需要重写query方法就可以了,其他方法可以不重写。

2.在应用程序的AndroidManifest文件中声明ContentProvider。

代码如下:

(二)UriMatcher

UriMatcher类主要用于规范匹配Uri。
比如给Uri添加路径和ID号。
系统判断到相应的类别就做相应的操作。
使用方法如下。

1.初始化:

UriMatcher matcher = new UriMatcher(UriMatcher.NO_MATCH);

2.注册需要的Uri:

matcher.addURI(“com.whunf”, “people”, PEOPLE);
或matcher.addURI(“com.whunf”, “person/#”, PEOPLE_ID);
一个表的不同操作可以注册多个Uri。

3.与已经注册的Uri进行匹配:

(1) Uri uri = Uri.parse(“content://” + “com.whunf” + “/people”); 这个uri是访问者填写的。
(2)int match = matcher.match(uri);
这里的match是在ContentProvider里面定义的,做判断和匹配也是在ContentProvider里面进行的。
switch (match) {
case PEOPLE:
return “vnd.android.cursor.dir/people”;
case PEOPLE_ID:
return “vnd.android.cursor.item/people”;
default:
return null;  
}
match方法匹配后会返回一个匹配码Code,即在使用注册方法addURI时传入的第三个参数。 上述方法会返回”vnd.android.cursor.dir/person”.
总结:
常量 UriMatcher.NO_MATCH 表示不匹配任何路径的返回码
# 号为通配符 * 号为任意字符

官方SDK说明中关于Uri的注册是这样写的:
private static final UriMatcher sURIMatcher = new UriMatcher(UriMatcher.NO_MATCH);
static {
sURIMatcher.addURI(“contacts”, “/people”, PEOPLE); sURIMatcher.addURI(“contacts”, “/people/#”, PEOPLE_ID);
sURIMatcher.addURI(“contacts”, “/people/#/phones”, PEOPLE_PHONE S);
sURIMatcher.addURI(“contacts”, “/people/#/phones/#”, PEOPLE_PHO NES_ID);
sURIMatcher.addURI(“contacts”,”/people/#/contact_methods”,PEO PLE_CONTACTMETHODS);
sURIMatcher.addURI(“contacts”, “/people/#/contact_methods/#”, P EOPLE_CONTACTMETHODS_ID);
sURIMatcher.addURI(“contacts”, “/deleted_people”, DELETED_PEOPL E); sURIMatcher.addURI(“contacts”, “/phones”, PHONES); sURIMatcher.addURI(“contacts”, “/phones/filter/“, PHONES_FILTE R); sURIMatcher.addURI(“contacts”, “/phones/#”, PHONES_ID); sURIMatcher.addURI(“contacts”, “/contact_methods”, CONTACTMETHO DS); sURIMatcher.addURI(“contacts”, “/contact_methods/#”, CONTACTMET HODS_ID); sURIMatcher.addURI(“call_log”, “/calls”, CALLS); sURIMatcher.addURI(“call_log”, “/calls/filter/“, CALLS_FILTER) ; sURIMatcher.addURI(“call_log”, “/calls/#”, CALLS_ID);
}
其实上面只是提供一种书写的规范,提供我们参考。也可以按照自己的思路来注册Uri。

(三)ContentUris

ContentUris 类用于获取Uri路径后面的ID部分
为路径加上ID的方法: withAppendedId(uri, id)
比如有这样一个Uri
Uri uri = Uri.parse(“content://com.whunf/people”)
通过withAppendedId方法,为该Uri加上ID
1. Uri resultUri = ContentUris.withAppendedId(uri, 10);
最后resultUri的字符串为: content://com.whunf/people/10
从路径中获取ID: parseId(uri)
1. Uri uri = Uri.parse(“content://com.whunf/people/10”)
2. long personid = ContentUris.parseId(uri);
最后personid 为 :10

五.下面是一个访问手机联系人的信息的使用示例

程序分析:
手机联系人的信息是在Android中某个固定的位置的,
它的Uri也是系统规定好的,需要我们去查。
手机联系人里面不止一个表,字段也很多,这个也是需要我们了解后,才能取得它对应的信息。
里面很多信息我们可以把手机电话信息的数据导出后再,研究里面的元素,这里打开手机数据库文件的工具一般使用的是:SQLite Expert Professional视图根据。
下面是查询所有用户的姓名和号码的Java代码

package com.lwz.provider;

import android.content.ContentResolver;
import android.content.ContentValues;
import android.database.Cursor;
import android.net.Uri;
import android.os.Bundle;
import android.provider.ContactsContract;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;

import java.util.ArrayList;
import java.util.List;

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        //操作电话本数据
        selectPhone();

    }


    private void selectPhone() {
        //获得ContentResolver对象
        ContentResolver resolver = getContentResolver();
        //获得系统定义的电话某一个表格的Uri(这里对应的是数据库的contacts表,这个表主要数存放用户的ID)
        Uri uri = ContactsContract.Contacts.CONTENT_URI;//这是系统类定义好的字符串的Uri
        //等同 Uri uri =Uri.parse("content://com.android.contacts/contacts" );
        //获取该Uri下的信息
        Cursor cursor = resolver.query(uri, null, null, null, null);
        //创建一个List集合存放用户对象的数据
        List<User> list = new ArrayList<>();
        //遍历取出数据,这里涉及到多表查询,因为数据存储是分类在多个表中
        while (cursor.moveToNext()) {
            //获得用户的Id,参数数字段名称的字符串
            long id = cursor.getLong(cursor.getColumnIndex("name_raw_contact_id"));
            //Log.e("Tag", "id=" + id);
            //创建一个User来存储信息
            User user = new User();
            user.id = id;
            //根据获取的到的用户的ID,来分别获取它的数据,这些数据又是在另一个表中
            //获得系统定义的电话某一个表格的Uri(这里对应的是数据库的data表,这个表里面有最全面的信息)
            //正是因为由于data表里面的数据最多,所以显示或排列的顺序不一定正常,需要我们提供一个ID来查找对应的数据
            Uri uri2 = ContactsContract.Data.CONTENT_URI;
            //等同 Uri uri2 =Uri.parse("content://com.android.contacts/data" );
            //根据刚才获得的用户的ID值来分别获取对应的数据
            //获取该Uri2下的信息
            // String d=ContactsContract.Contacts.Data.RAW_CONTACT_ID;这里的字符串d等同于"raw_contact_id"
            Cursor cursor2 = resolver.query(uri2, null, "raw_contact_id=?", new String[]{id + ""}, null);
            //获取每一个用户ID里面某些信息
            while (cursor2.moveToNext()) {
                //获取用户的姓名
                //ContactsContract.Contacts.DISPLAY_NAME-->"display_name"
                user.name = cursor2.getString(cursor2.getColumnIndex("display_name"));
                // ContactsContract.Data.DATA1-->"data1"
                user.phone.add(cursor2.getString(cursor2.getColumnIndex("data1")));
            }
            list.add(user);
        }
        //打印输出内容
        for (int i = 0; i < list.size(); i++) {
            Log.e("TAG", list.get(i).toString());
        }
    }

    //创建一个用户信息类
    class User {
        long id;//用户的ID
        String name;//用户的姓名
        List<String> phone = new ArrayList<>();//用户的多个号码

        //显示用户的数据
        @Override
        public String toString() {
            return "User{" +
                    "id=" + id +
                    ", name='" + name + '\'' +
                    ", phone=" + phone +
                    '}';
        }
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86

       在手机联系人中,每添加一个用户信息都会对应一个ID,但是这条信息可以包含多个用户的名称或多个号码,我们只需要取其中的一部分就可以了。
       为了更好的去熟悉相关数据的操作,最好是把数据库的文件,导出来,看看数据的结构。
Android程序安装的文件都放在/data/date路径下,
系统的提供的所有ContentProvider也在这个包下:
c1
       上面的几个包名,都有providers,这是系统的ContentProvider程序包,里面包含相关的数据库文件。比如:联系人的信息在com.android.provider.contacts包内。其他的包有的是下载过得文件数据,有的是手机拨号记录数据,有的是浏览器历史记录数据等等。。。
导出手机联系人的数据库方法:
c2

使用视图工具,打开手机联系人数据库的显示界面:
c3

       上面就是ContentProvider的简单介绍和使用。
       其中自定义的ContentProvider涉及到的内容多一点,单独抽出来做例子性的总结。

相关文章推荐

Android组件之ContentProvider(内容提供者)

1,ContentProvider(内容提供者)是Android中的四大组件之一。主要用于对外共享数据,也就是通过ContentProvider把应用中的数据共享给其他应用访问,其他应用可以通过Con...

【Android基础】内容提供者ContentProvider的使用详解

1.什么是ContentProvider 首先,ContentProvider(内容提供者)是android中的四大组件之一,但是在一般的开发中,可能使用的比较少。 ContentProvider...

android之ContentProvider(内容提供者)

ContentProvider(内容提供者)在我的理解就是把自己应用的数据暴露出来供第三方来使用。我们的应用也可以查询安卓手机自带的应用的数据,比如短信,联系人。下面我们就简单学下怎么自己来实现一个内...

Android里内容提供者ContentProvider的使用

定义 在Android中,ContentProvider也是四大组件之一,它被翻译成内容提供者。如果在开发中需要实现跨包数据共享,那就需要使用ContentProvider,它存储数据的方式和使用它...
  • lyz_zyx
  • lyz_zyx
  • 2017年03月02日 10:43
  • 142

Android 四大组件之一 :ContentProvider内容提供者从入门到精通

转自: http://www.jianshu.com/p/f5ec75a9cfea前言ContentProvider虽然与Activity、Service、BroadcastReceiver齐名为A...

android内容提供者contentProvider_短信备份

一、项目目录结构 二、activity_main.xml界面 三、activity_main.xml代码

android 内容提供者(ContentProvider)共享SQLite

android 内容提供者(ContentProvider)共享SQLiteContentProvider为android提供了一种不同应用之间共享数据的可能,次列提供ContentProvider将...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:Android内容提供者ContentProvider总结
举报原因:
原因补充:

(最多只允许输入30个字)