//authority/数据部分,ContentResolver只是提供数据的拜访接口

Android四大组件之ContentProvider

为了在应用程序之间交流数据,Android提供了ContentProvider,它是例外应用程序之间展开数据交换的标准API,当1个应用程序必要把团结的多寡揭发给别的程序行使时,该应用程序就可透过提供ContentProvider来达成;其余应用程序就可由此ContentResolver来操作ContentResolver暴光的数量。

  1. ContentProvider:差异应用之间开展数据沟通的正经API,当3个应用程序要把温馨的数据暴露给别的使用时,就可以透过ContentProvider来完结,其余应用程序通过ContentResolver操作ContentProvider暴漏的数目
  2. 应用程序通过ContentProvider揭破了上下一心的多寡操作接口,那么不论采用是不是运行,其他应用都得以经过该接口来操作该应用程序的里边数据

ContentProvider简介

ContentProvider是不一致应用程序之间进行数据沟通的专业API,ContentProvider以某种Uri的花样对外提供数据,允许其余使用访问或涂改数据;其余应用程序使用COntentResolver依据Uri去拜访操作内定数量。

只要某些应用程序通过COntentProvider暴光了团结的数量操作接口,那么不管该应用程序是还是不是运营,其他应用程序都可通过该接口来操作该应用程序的中间数据,包蕴增添数量、删除数据、修改数据、查询数据等。

ContentResolver只是提供数据的造访接口,并不是像网站一律对外提供完整的页面。开发二个ContentProvider的步骤如下所示:

  1. 概念本身的ContentProvider类,该类需要继承Android提供的ContentProvider基类。
  2. 向Android系统注册ContentProvider,即在AndroidManifest.xml文件中登记那几个ContentProvider,就想注册Activity一样。注册ContentProvider时要求为它绑定一个Uri。

除了,自个儿定义的ContentProvider类还索要提供如下多少个章程:

  • public boolean
    onCreate():
    该办法在ContentProvider创设后会被调用,当其他应用程序第两回访问ContentProvider时,该ContentProvider会被创立出来,并马上回调该onCreate()方法。
  • public Uri insert(Uri uri ,ContentValues
    values):
    基于该Uri插入values对应的多少。
  • public int delete(Uri uri ,String selection ,String[]
    selectionArgs):
    依照Uri删除selection条件所匹配的百分之百记下。
  • public int update(Uri uri ,ContentValues values ,String selection
    ,String[]
    selectionArgs):
    根据Uri修改selection条件所匹配的万事记下。
  • public Cursor query(Uri uri ,String[] projection ,String
    selectionn ,String[] selectionArgs ,String
    sortOrder):
    据悉Uri查询出selection条件所匹配的漫天记录,其中projection就是1个列名列表,申明只采纳出钦赐的数据列。
  • public String getType(Uri
    uri):
    该措施用于重临当前Uri所代表的数据的MIME类型。假使该Uri对应的数量大概包罗多条记下,那么MIME类型字符串应该以vnd.android.cursor.dir/初阶;倘使该Uri对应的数码只含有一条记下,那么MIME类型字符串应该以vnd.android.cursor.item/伊始。
  1. ContentProvider以某种Uri的花样对外提供数据,开发ContentProvider的步骤:

Uri简介

ContentProvider必要的Uri与互连网的UEvoqueL类似,例如如下Uri:

content://org.crazyit.providers.dictprovider/words

它可以分成如下三局地:

  • content://:这几个有个别是Android的ContentProvider规定的,如同上网的商议暗中认同是http://一样。暴露ContentProvider、访问ContentProvider的协议默认是content://。
  • org.crazyit.providers.dictprovider:其一有个别就是COntentProvider的authorities。系统就是由这些局地来找到操作哪个ContentProvider的。只要访问钦定的ContentProvider,那些片段就是固定的,
  • words:财富部分(可能说数据部分)。当访问者需求拜访分裂财富时,那些有个别是动态改变的。

为了将三个字符串转换到Uri,Uri工具类提供了parse()静态方法。例如,如下代码即可将
字符串转换为Uri:

Uri  uri = Uri.parse("content://org.crazyit.providers.dictprovider/word/2")

概念本人的ContentProvider类,继承自Android提供的ContentProvider基类

ContentResolver操作数据

ContentProvider的效能是揭破可供操作的数量;其余应用程序则透过ContentProvider来操作ContentProvider所揭发的数码,ContentResolver相当于HttpClient。
Context提供了之类方法来博取ContentResolver对象:

  • getContentResolver():获取该接纳暗许的ContentResolver对象。

就算在先后中获取了ContentResolver对象之后,接下去就可调用ContentResolver的如下方法来操作数据了。

  • insert(Uri uri ,ContentValues
    values):
    向Uri对应的ContentProvider中插入values对应的数额。
  • delete(Uri uri ,String where ,String[]
    selectionArgs):
    删去Uri对应的ContentProvider中where提交匹配的多寡。
  • update(Uri uri ,ContentValues values ,String where ,String[]
    selectionArgs):
    创新Uri对应的ContentProvider中where提交匹配的数目。
  • query(Uri uri ,String[] projection ,STring selection ,String[]
    selectionArgs ,String
    sortOrder):
    查询Uri对应的ContentProvider中where提交匹配的多少。

诚如的话,ContentProvider是单实例形式的,当多个应用程序通过ContentResolver来操作ContentProvider提供的数额时,ContentResolver调用的多少操作将会委托给同一个ContentProvider处理。

向Android系统注册,约等于在AndroidManifest.xml中注册,注册ContentProvider时须求为它绑定3个Uri,并制定authorities属性,注意name值中有点,exported代表是还是不是同意其余使用调用

ContentProvider与ContentResolver的关系

从ContentResolver、ContentProvider和Uri的涉及来看,无论是ContentResolver,依然ContentProvider,它们所提供的增删改查方法的首先个参数都以Uri。约等于说,Uri是ContentProvider和ContentResolver进行数据沟通的标识。ContentResolver对点名Uri执行增删改查的数量操作,但Uri并不是实在的数目主导,由此这几个增删改查操作会委托给该Uri对应的ContentProvider来完毕。

ContentProvider、Uri、ContentResolver三者之间的关系如下图所示:

0.jpg

以内定Uri为标识,ContentResolver可以兑现“直接调用”ContentProvider的增删改查方法:

  1. 当A应用调用ContentResolver的insert()方法时,实际上约等于调用了该Uri对应的ContentProvider的insert()方法。
  2. 当A应用调用ContentResolver的update()方法时,实际上相当于调用了该Uri对应的ContentProvider的update()方法。
  3. 当A应用调用ContentResolver的delete()方法时,实际上相当于调用了该Uri对应的ContentProvider的delete()方法。
  4. 当A应用调用ContentResolver的query()方法时,实际上约等于调用了该Uri对应的ContentProvider的query()方法。

<Provider android:name=”.DictProvider”
android:authorities=”org.crazyit.providers.dictprovider”  
android:exported=”true” />

开发ContentProvider子类

开发ContentProvider只要如下两步:

  1. 付出3个ContentProvider子类,该子类须求贯彻query()、insert()、update()和delete()等措施。
  2. 在AndroidManifest.xml文件中注册该ContentProvider,指定android:authorities属性。

DictProvider还需兑现如下的情势:

配置ContentProvider

只要为<applicaton…/>元素添加了<provider…/>子成分即可配置ContentProvider。例如如下的陈设部分:

<provider
        android:name=".FirstProvider"
        android:authorities="org.crazyit.providers.firstprovider"
        android:exported="true"/>

布局ContentProvider时一般内定如下属性:

  • name:指定该ContentProvider的已毕类的类名。
  • authorities:点名该ContentProvider对应的Uri(也就是为该ContentProvider分配三个域名。)
  • android:exported:点名该ContentProvider是不是允许其余应用调用。如若将该属性设为false,那么该ContentProvider将不允许其余使用调用。

为了显然ContentProvider实际能处理的Uri,以及显然每一种方法中Uri参数所操作的多少,Android系统提供了UriMatcher工具类,主要提供了之类多个办法:

  • void addURI(String authority ,String path ,int
    code):
    该方式用于向UriMatcher对象注册Uri。其中authority和path组合成一个Uri,而code则意味着该Uri对应的标识码。
  • int match(Uri
    uri):
    依照后边注册的Uri来判断指定Uri对应的标识码。如若找不到卓殊的标识码,就会回去-1。

Android还提供了三个ContentUris工具类,它是二个操作Uri字符串的工具类,提供了如下几个工具方法:

  • withAppendedId(uri , id):用来为路径加上ID部分。
  • parseId(uri):用于从内定Uri中分析出所富含的ID值。
  • onCreate:其余应用程序第2回访问ContentProvider时,该ContentProvider会被创立出来,并马上调用onCreate方
  • Uri
    insert(Uri,ContentValues)方法:根据该Uri插入ContentValues对应的数目
  • int
    delete(Uri,String,String[])方法:依照Uri删除select条件所匹配的全方位记下
  • int
    update(Uri,ContentValues,String,String[])方法:依据Uri修改满意selection条件所匹配的有着记录
  • Cursor
    query(Uri,String[],String,String[],String):恩局Uri查询出满意select条件所匹配的整整笔录,其中projection就是一个列名列表,申明只采取出内定的列
  • String
    getType(Uri):重临当前Uri所代表的多寡的MIME类型,借使Uri对应数据包括多条记下,那么MIME类型字符串应该是以vnd.android.cursor.dir 开端,倘诺只对应一条记下,那么重临的MIME类型字符串应该以vnd.android.cursor.item开始

操作系统的ContentProvider

Android系统自身提供了汪洋的ContentProvider,使用ContentResolver操作系统的ContentProvider数据的步子也是两步:

  1. 调用Context的getContentResolver()获取ContentResolver对象;
  2. 基于必要调用ContentResolver的insert()、delete()、update()和query()方法操作数据。

Android系统用于管理挂钩人的ContentProvider的多少个Uri如下:

  • ContactsContract.Contacts.CONTENT_URI:管制挂钩人的Uri。
  • ContactsContract.CommonDataKinds.Phone.CONTENT_URI:治本挂钩人的电话的Uri。
  • ContactsContract.CommonDataKinds.Email.CONTENT_URI:管制挂钩人的E-mail的Uri。

Android为多媒体提供的ContentProvider的Uri如下所示:

  • MediaStore.Audio.Media.EXTERNAL_CONTENT_URI:仓储在外部存储其上的音频文件内容的ContentProvider的Uri。
  • MediaStore.Audio.Media.INTERNAL_CONTENT_URI:积存在表哥大内部存储器上的音频文件内容的ContentProvider的Uri。
  • MediaStore.Images.Media.EXTERNAL_CONTENT_URI:储存在表面存储器上的图样文件内容的ContentProvider的Uri。
  • MediaStore.Images.Audio.Media.INTERNAL_CONTENT_URI:储存在手机里面存储器上的图样文件内容的ContentProvider的Uri。
  • MediaStore.Video.Media.EXTERNAL_CONTENT_URI:存储在外表存储器上的视频文件内容的ContentProvider的Uri。
  • MediaStore.Video.Audio.Media.INTERNAL_CONTENT_URI:存储在四哥大内部存储器上的摄像文件内容的ContentProvider的Uri。

ContentProvider
Uri的格式:content://authority/数据部分,autority类似于Url中域名的作用,数据部分是可变的,后边是定点的格式,要小心数据部分的分解,因为三个ContentProvider大概提供三个Uri
对应分化数量的走访,但content://authority部分不变

监听ContentProvider的数额变动

在头里的牵线中,只要导致了ContentProvider数据发生了改变,程序中就调用如下代码:

getContext().getContentResolver(),notifyChange(uri ,null);

为了在应用程序中监听ContentProvider数据的改观,要求使用Android提供的ContentObserver基类。监听ContentProvider数据变动的监听器要求后续ContentObserver类,仁同一视写该基类所定义的onChange(boolean
selfChange)方法–当所监听的ContentProvider数据发生变更时,该onChange()方法将会被触发。

为了监听内定ContentProvider的数据变动,要求经过ContentResolver向内定Uri注册ContentObserver监听器。ContentResolver提供了如下方法来注册监听器:

  • registerContentObserver(Uri uri , boolean notifyForDescendents ,
    ContentObserver observer)

本条点子的多个参数分别表示:

  • uri:该监听器所监听的ContentProvider的Uri。
  • notifyForDescendents:假设该参数设为true,若是注册监听的Uri为content://abc,nameUri为contetn://abc/xyzcontent://abc/xyz/foo的多寡变动时也会触发该监听器;假使设为false,那么唯有content://abc的数目暴发变动时才会触发该监听器。
  • observer:监听器实例。

 数据的蕴藏系统可以由开发人士任意支配,一般来讲,半数以上的Content
Provider都经过Android的文本存储系统或SQLite
数据库建立和睦的数额存储系统。

提供程序访问的代表方式

提供程序访问的二种替代格局在动用开发的经过中相当最首要:

  • 批量访问:可以由此ContentProviderOperation类中的方法创设一批访问调用,然后通过ContentResolver.applyBatch()执行它们。
  • 异步查询:应该在单身线程中实践查询。
  • 透过Intent访问数据:尽管不可以直接向提供程序发送Intent,不过可以向提供程序的选用发送Intent,后者平常兼有修改提供程序数据的最佳配置。

好的,ContentProvider就介绍那么些呢!!欢迎关心作者的微信公众号!

作者的微信公众号.jpg

系统Uri示例:

  • content://media/internal/images:再次回到设备上囤积的保有图片
  • content://contacts/people:再次来到设备上具有联系人音信
  • content://contacts/people/45:重返联系人新闻中ID为45的关联人记录

Context提供了getContentResolver函数获取ContentResolver对象,之后方可调用它的方法,这一个方式都会转由Uri对应的ContentProvider的同名函数执行

  • insert(Uri,ContentValues):向Uri对应的ContentProvider中插入ContentValues数据
  • delete(Uri,String,String[]):删除Uri对应的ContentProvider中与标准同盟的数额
  • update(Uri,ContentValues,String,String[]):更新与规范协作的数据
  • query(Uri,String[],String,String[],String):查询与规则十三分的数目

UriMatcher工具类:

  • void addUri(String,String,int
    code):该方法用于向UriMatcher对应注册Uri,code代表Uri对应的标识码
  • int match(Uri
    uri):重返Uri的标识码,找不到重返-1

ContentUris工具类,常用语生成查询的Uri

  • withAppendedId(uri,id):用于给路径加上ID部分
  • parseId(Uri):用于从指定Uri中剖析出所包蕴的ID值

系统一般会把ContentProvider的Uri,数据列等新闻以常量格局公开出来,方便访问

操作系统的ContentProvider

Contacts(管理挂钩人的应用程序)的ContentProvider提供的多少个Uri:

  • ContactsContract.Contacts.CONTENT_UCR-VI:管理挂钩人的Uri
  • ContactsContract.CommonDataKinds.Phone.CONTENT_U途睿欧I:管理联系人电话的Uri
  • ContactsContract.CommonDataKinds.Email.CONTENT_U奥迪Q5I:管理挂钩人EMail的Uri

Android为多媒体提供的ContentProvider的Uri:

  • MediaStore.Audio.Media.EXTERNAL_CONTENT_UCRUISERI:存储在表面存储器上的音频文件内容的ContentProvider的Uri
  • MediaStore.Audio.Media.INTERNAL_CONTENT_U景逸SUVI:存储在手机内部存储器上的音频文件的ContentProvider的Uri
  • MediaStore.Images.Media.EXTERNAL_CONTENT_UOdysseyI:存储在外部存储器上的图形文件内容的ContentProvider的Uri
  • MediaStore.Images.Media.INTERNAL_CONTENT_UENCOREI:存储在大哥大内部存储器上的图纸内容的ContentProvider的Uri
  • MediaStore.Video.Media.EXTERNAL_CONTENT_URI
  • MediaStore.Video.Media.INTERNAL_CONTENT_UR

ContentObserver类:监听ContentProvider数据变动的监听器必要继续ContentObserver类,天公地道写
该基类所定义的onChange方法,当监听的ContentProvider的数目发生变动时,该onChange将会被触发注册监听器要拔取ContentResolver的registerContentObserver函数