资源描述:
契约类
契约类定义了帮助应用使用content URIs的常量,列名,intent action们,和其它contentprovider特性。契约类不会被provider自动包含;provider开发者必须定义它们然后使它们对其它开发者生效。Android平台中包含的很多provider都在包android.provider中有对应的契约类。
契约类定义了帮助应用使用content URIs的常量,列名,intent action们,和其它contentprovider特性。契约类不会被provider自动包含;provider开发者必须定义它们然后使它们对其它开发者生效。Android平台中包含的很多provider都在包android.provider中有对应的契约类。
例如,用户词典Provider具有一个契约类UserDictionary,它包含了contentURI和columnname常量。"words"表的contentURI定义在常量UserDictionary.Words.CONTENT_URI上。UserDictionary.Words类也包含了列名常量,在下面的代码片段中就用到了。举例,一个查询projection可以如下定义:
String[]mProjection =
{
UserDictionary.Words._ID,
UserDictionary.Words.WORD,
UserDictionary.Words.LOCALE
};
{
UserDictionary.Words._ID,
UserDictionary.Words.WORD,
UserDictionary.Words.LOCALE
};
另一个契约类是用于联系人Provider的ContactsContract类。此类的参考文档中包含示例代码片段。它的一个子类,ContactsContract.Intents.Insert,也是一个契约类,它包含了用于intent和intent数据的契约。
引用MIME类型
Contentprovider可以返回标准的MIME类型或自定义的MIME类型字符串,或同时返回两者。
Contentprovider可以返回标准的MIME类型或自定义的MIME类型字符串,或同时返回两者。
MIME类型具有以下形式
type/subtype
例如,世人皆知的MIME类型text/html具有text类型和html子类型。如果provider从一个URI返回此类型,这表示面向此URI的查询将返回带有HTML标记的文本。
自定义的MIME字符串,也被叫做"vendor-specific"MIME类型,具有更复杂的类型和子类型值,此类型的值总是这样
vnd.android.cursor.dir
用于多行,或这样
vnd.android.cursor.item
用于单行。
而子类型是每个provider都不相同的。Android内置的provider通常具有一个间单的字类型。例如,当联系人应用为一个电话号码创建一个新行时,它为新行设置下面的MIME类型:
vnd.android.cursor.item/phone_v2
可以看到子类型的值只是简单的phone_v2.
其它provider开发者可能基于provider的authority和表名字创建他们自己的子类型式样。例如,假设一个provider含有列车时刻表,provider的authority是com.example.trains,并且它包含三个表:线路1,线路2,线路3。在URI的响应中,
content://com.example.trains/Line1
指向线路1表,provider返回对应的MIME类型为:
vnd.android.cursor.dir/vnd.example.line1
而content URI
content://com.example.trains/Line2/5
指向线路2表的第5行,provider返回的对应的MIME类型为:
vnd.android.cursor.item/vnd.example.line2
大多数contentproviders定义了契约类来包含它们所用到的MIME类型。例如,联系人Provider的契约类ContactsContract.RawContacts,定义了常量CONTENT_ITEM_TYPE,它对应于一行原始的联系人数据