android Content provider 组件
Content Provider 属于Android应用程序的组件之一,作为应用程序之间唯一的共享数据的途径,Content Provider 主要的功能就是存储并检索数据以及向其他应用程序提供访问数据的借口。
Android 系统为一些常见的数据类型(如音乐、视频、图像、手机通信录联系人信息等)内置了一系列的 Content Provider, 这些都位于android.provider包下。持有特定的许可,可以在自己开发的应用程序中访问这些Content Provider。
让自己的数据和其他应用程序共享有两种方式:创建自己的Content Provier(即继承自ContentProvider的子类) 或者是将自己的数据添加到已有的Content Provider中去,后者需要保证现有的Content Provider和自己的数据类型相同且具有该 Content Provider的写入权限。对于Content Provider,最重要的就是数据模型(data model) 和 URI。
1.数据模型
Content Provider 将其存储的数据以数据表的形式提供给访问者,在数据表中每一行为一条记录,每一列为具有特定类型和意义的数据。每一条数据记录都包括一个 "_ID" 数值字段,改字段唯一标识一条数据。
2.URI
URI,每一个Content Provider 都对外提供一个能够唯一标识自己数据集(data set)的公开URI, 如果一个Content Provider管理多个数据集,其将会为每个数据集分配一个独立的URI。所有的Content Provider 的URI 都以"content://" 开头,其中"content:"是用来标识数据是由Content Provider管理的 schema。
在几乎所有的Content Provider 的操作中都会用到URI,因此一般来讲,如果是自己开发的Content Provider,最好将URI定义为常量,这样在简化开发的同时也提高了代码的可维护性。
首先来介绍如何访问Content Provider中的数据,访问 Content Provider中的数据主要通过ContentResolver对象,ContentResolver类提供了成员方法可以用来对Content Provider 中的数据进行查询、插入、修改和删除等操作。 以查询为例,查询一个 Content Provider 需要掌握如下的信息。
唯一标识Content Provider 的URI
需要访问的数据字段名称。
该数据字段的数据类型
提示: 如果需要访问特定的某条数据记录,只需该记录的ID 即可。
查询Content Provider的方法有两个:ContentResolver的query() 和 Activity 对象的 managedQuery(),二者接收的参数均相同,返回的都是Cursor 对象,唯一不同的是 使用managedQuery 方法可以让Activity 来管理 Cursor 的生命周期。
被管理的Cursor 会在 Activity进入暂停状态的时候调用自己的 deactivate 方法自行卸载,而在Activity回到运行状态时会调用自己的requery 方法重新查询生成的Cursor对象。如果一个未被管理的Cursor对象想被Activity管理,可以调用Activity的 startManagingCursor方法来实现。
Android应用程序可以使用文件或SqlLite数据库来存储数据。Content Provider提供了一种多应用间数据共享的方式,比如:联系人信息可以被多个应用程序访问。Content Provider是个实现了一组用于提供其他应用程序存取数据的标准方法的类。
应用程序可以在Content Provider中执行如下操作:
查询数据
修改数据
添加数据
删除数据
/Chapter10_ContentProvider_01_Test02/src/com/amaker/ch10/app/MainActivity.java
- 代码
- packagecom.amaker.ch10.app;
- importandroid.app.Activity;
- importandroid.content.ContentUris;
- importandroid.content.ContentValues;
- importandroid.database.Cursor;
- importandroid.net.Uri;
- importandroid.os.Bundle;
- importandroid.util.Log;
- importcom.amaker.ch10.app.Employees.Employee;
- publicclassMainActivityextendsActivity{
- @Override
- publicvoidonCreate(BundlesavedInstanceState){
- super.onCreate(savedInstanceState);
- setContentView(R.layout.main);
- //添加
- insert();
- //查询
- query();
- //更新
- update();
- //查询
- query();
- //删除
- del();
- //查询
- query();
- }
- //删除方法
- privatevoiddel(){
- //删除ID为1的记录
- Uriuri=ContentUris.withAppendedId(Employee.CONTENT_URI,1);
- //获得ContentResolver,并删除
- getContentResolver().delete(uri,null,null);
- }
- //更新
- privatevoidupdate(){
- //更新ID为1的记录
- Uriuri=ContentUris.withAppendedId(Employee.CONTENT_URI,1);
- ContentValuesvalues=newContentValues();
- //添加员工信息
- values.put(Employee.NAME,"hz.guo");
- values.put(Employee.GENDER,"male");
- values.put(Employee.AGE,31);
- //获得ContentResolver,并更新
- getContentResolver().update(uri,values,null,null);
- }
- //查询
- privatevoidquery(){
- //查询列数组
- String[]PROJECTION=newString[]{
- Employee._ID,//0
- Employee.NAME,//1
- Employee.GENDER,//2
- Employee.AGE//3
- };
- //查询所有备忘录信息
- Cursorc=managedQuery(Employee.CONTENT_URI,PROJECTION,null,
- null,Employee.DEFAULT_SORT_ORDER);
- //判断游标是否为空
- if(c.moveToFirst()){
- //遍历游标
- for(inti=0;i<c.getCount();i++){
- c.moveToPosition(i);
- //获得姓名
- Stringname=c.getString(1);
- Stringgender=c.getString(2);
- intage=c.getInt(3);
- //输出日志
- Log.i("emp",name+":"+gender+":"+age);
- }
- }
- }
- //插入
- privatevoidinsert(){
- //声明Uri
- Uriuri=Employee.CONTENT_URI;
- //实例化ContentValues
- ContentValuesvalues=newContentValues();
- //添加员工信息
- values.put(Employee.NAME,"amaker");
- values.put(Employee.GENDER,"male");
- values.put(Employee.AGE,30);
- //获得ContentResolver,并插入
- getContentResolver().insert(uri,values);
- }
- }
/Chapter10_ContentProvider_01_Test02/src/com/amaker/ch10/app/Employees.java
- 代码
- packagecom.amaker.ch10.app;
- importandroid.net.Uri;
- importandroid.provider.BaseColumns;
- /**
- *通讯录常量类
- */
- publicfinalclassEmployees{
- //授权常量
- publicstaticfinalStringAUTHORITY="com.amaker.provider.Employees";
- privateEmployees(){}
- //内部类
- publicstaticfinalclassEmployeeimplementsBaseColumns{
- //构造方法
- privateEmployee(){}
- //访问Uri
- publicstaticfinalUriCONTENT_URI=Uri.parse("content://"+AUTHORITY+"/employee");
- //内容类型
- publicstaticfinalStringCONTENT_TYPE="vnd.android.cursor.dir/vnd.amaker.employees";
- publicstaticfinalStringCONTENT_ITEM_TYPE="vnd.android.cursor.item/vnd.amaker.employees";
- //默认排序常量
- publicstaticfinalStringDEFAULT_SORT_ORDER="nameDESC";//按姓名排序
- //表字段常量
- publicstaticfinalStringNAME="name";//姓名
- publicstaticfinalStringGENDER="gender";//性别
- publicstaticfinalStringAGE="age";//年龄
- }
- }
/Chapter10_ContentProvider_01_Test02/src/com/amaker/ch10/app/EmployeeProvider.java
- 代码
- packagecom.amaker.ch10.app;
- importjava.util.HashMap;
- importandroid.content.ContentProvider;
- importandroid.content.ContentUris;
- importandroid.content.ContentValues;
- importandroid.content.UriMatcher;
- importandroid.database.Cursor;
- importandroid.database.sqlite.SQLiteDatabase;
- importandroid.database.sqlite.SQLiteQueryBuilder;
- importandroid.net.Uri;
- importandroid.text.TextUtils;
- importcom.amaker.ch10.app.Employees.Employee;
- publicclassEmployeeProviderextendsContentProvider{
- //数据库帮助类
- privateDBHelperdbHelper;
- //Uri工具类
- privatestaticfinalUriMatchersUriMatcher;
- //查询、更新条件
- privatestaticfinalintEMPLOYEE=1;
- privatestaticfinalintEMPLOYEE_ID=2;
- //查询列集合
- privatestaticHashMap<String,String>empProjectionMap;
- static{
- //Uri匹配工具类
- sUriMatcher=newUriMatcher(UriMatcher.NO_MATCH);
- sUriMatcher.addURI(Employees.AUTHORITY,"employee",EMPLOYEE);
- sUriMatcher.addURI(Employees.AUTHORITY,"employee/#",EMPLOYEE_ID);
- //实例化查询列集合
- empProjectionMap=newHashMap<String,String>();
- //添加查询列
- empProjectionMap.put(Employee._ID,Employee._ID);
- empProjectionMap.put(Employee.NAME,Employee.NAME);
- empProjectionMap.put(Employee.GENDER,Employee.GENDER);
- empProjectionMap.put(Employee.AGE,Employee.AGE);
- }
- //创建是调用
- publicbooleanonCreate(){
- //实例化数据库帮助类
- dbHelper=newDBHelper(getContext());
- returntrue;
- }
- //添加方法
- publicUriinsert(Uriuri,ContentValuesvalues){
- //获得数据库实例
- SQLiteDatabasedb=dbHelper.getWritableDatabase();
- //插入数据,返回行ID
- longrowId=db.insert(DBHelper.EMPLOYEES_TABLE_NAME,Employee.NAME,values);
- //如果插入成功返回uri
- if(rowId>0){
- UriempUri=ContentUris.withAppendedId(Employee.CONTENT_URI,rowId);
- getContext().getContentResolver().notifyChange(empUri,null);
- returnempUri;
- }
- returnnull;
- }
- //删除方法
- publicintdelete(Uriuri,Stringselection,String[]selectionArgs){
- //获得数据库实例
- SQLiteDatabasedb=dbHelper.getWritableDatabase();
- //获得数据库实例
- intcount;
- switch(sUriMatcher.match(uri)){
- //根据指定条件删除
- caseEMPLOYEE:
- count=db.delete(DBHelper.EMPLOYEES_TABLE_NAME,selection,selectionArgs);
- break;
- //根据指定条件和ID删除
- caseEMPLOYEE_ID:
- StringnoteId=uri.getPathSegments().get(1);
- count=db.delete(DBHelper.EMPLOYEES_TABLE_NAME,Employee._ID+"="+noteId
- +(!TextUtils.isEmpty(selection)?"AND("+selection+')':""),selectionArgs);
- break;
- default:
- thrownewIllegalArgumentException("错误的URI"+uri);
- }
- getContext().getContentResolver().notifyChange(uri,null);
- returncount;
- }
- //获得类型
- publicStringgetType(Uriuri){
- returnnull;
- }
- //查询方法
- publicCursorquery(Uriuri,String[]projection,Stringselection,
- String[]selectionArgs,StringsortOrder){
- SQLiteQueryBuilderqb=newSQLiteQueryBuilder();
- switch(sUriMatcher.match(uri)){
- //查询所有
- caseEMPLOYEE:
- qb.setTables(DBHelper.EMPLOYEES_TABLE_NAME);
- qb.setProjectionMap(empProjectionMap);
- break;
- //根据ID查询
- caseEMPLOYEE_ID:
- qb.setTables(DBHelper.EMPLOYEES_TABLE_NAME);
- qb.setProjectionMap(empProjectionMap);
- qb.appendWhere(Employee._ID+"="+uri.getPathSegments().get(1));
- break;
- default:
- thrownewIllegalArgumentException("Uri错误!"+uri);
- }
- //使用默认排序
- StringorderBy;
- if(TextUtils.isEmpty(sortOrder)){
- orderBy=Employee.DEFAULT_SORT_ORDER;
- }else{
- orderBy=sortOrder;
- }
- //获得数据库实例
- SQLiteDatabasedb=dbHelper.getReadableDatabase();
- //返回游标集合
- Cursorc=qb.query(db,projection,selection,selectionArgs,null,null,orderBy);
- c.setNotificationUri(getContext().getContentResolver(),uri);
- returnc;
- }
- //更新方法
- publicintupdate(Uriuri,ContentValuesvalues,Stringselection,
- String[]selectionArgs){
- //获得数据库实例
- SQLiteDatabasedb=dbHelper.getWritableDatabase();
- intcount;
- switch(sUriMatcher.match(uri)){
- //根据指定条件更新
- caseEMPLOYEE:
- count=db.update(DBHelper.EMPLOYEES_TABLE_NAME,values,selection,selectionArgs);
- break;
- //根据指定条件和ID更新
- caseEMPLOYEE_ID:
- StringnoteId=uri.getPathSegments().get(1);
- count=db.update(DBHelper.EMPLOYEES_TABLE_NAME,values,Employee._ID+"="+noteId
- +(!TextUtils.isEmpty(selection)?"AND("+selection+')':""),selectionArgs);
- break;
- default:
- thrownewIllegalArgumentException("错误的URI"+uri);
- }
- getContext().getContentResolver().notifyChange(uri,null);
- returncount;
- }
- }
/Chapter10_ContentProvider_01_Test02/src/com/amaker/ch10/app/DBHelper.java
- 代码
- packagecom.amaker.ch10.app;
- importandroid.content.Context;
- importandroid.database.sqlite.SQLiteDatabase;
- importandroid.database.sqlite.SQLiteOpenHelper;
- importcom.amaker.ch10.app.Employees.Employee;
- /**
- *
- *数据库工具类
- */
- publicclassDBHelperextendsSQLiteOpenHelper{
- //数据库名称常量
- privatestaticfinalStringDATABASE_NAME="Employees.db";
- //数据库版本常量
- privatestaticfinalintDATABASE_VERSION=1;
- //表名称常量
- publicstaticfinalStringEMPLOYEES_TABLE_NAME="employee";
- //构造方法
- publicDBHelper(Contextcontext){
- //创建数据库
- super(context,DATABASE_NAME,null,DATABASE_VERSION);
- }
- //创建时调用
- publicvoidonCreate(SQLiteDatabasedb){
- db.execSQL("CREATETABLE"+EMPLOYEES_TABLE_NAME+"("
- +Employee._ID+"INTEGERPRIMARYKEY,"
- +Employee.NAME+"TEXT,"
- +Employee.GENDER+"TEXT,"
- +Employee.AGE+"INTEGER"
- +");");
- }
- //版本更新时调用
- publicvoidonUpgrade(SQLiteDatabasedb,intoldVersion,intnewVersion){
- //删除表
- db.execSQL("DROPTABLEIFEXISTSemployee");
- onCreate(db);
- }
- }
/Chapter10_ContentProvider_01_Test02/AndroidManifest.xml
- 代码
- <?xmlversion="1.0"encoding="utf-8"?>
- <manifestxmlns:android="http://schemas.android.com/apk/res/android"
- package="com.amaker.ch10.app"
- android:versionCode="1"
- android:versionName="1.0">
- <applicationandroid:icon="@drawable/icon"android:label="@string/app_name">
- <providerandroid:name="EmployeeProvider"
- android:authorities="com.amaker.provider.Employees"/>
- <activityandroid:name=".MainActivity"
- android:label="@string/app_name">
- <intent-filter>
- <actionandroid:name="android.intent.action.MAIN"/>
- <categoryandroid:name="android.intent.category.LAUNCHER"/>
- </intent-filter>
- </activity>
- </application>
- <uses-sdkandroid:minSdkVersion="3"/>
- </manifest>
更多相关文章
- 第一行代码读书笔记 Kotlin Android
- API Demos 2.2 研读笔记(5)——Window Feature
- [Android][Android(安卓)Studio] *.jar 与 *.aar 的生成与*.aar
- Android面试题笔记(一)
- Android(安卓)proguard混淆编译的问题
- [转]Android(安卓)Music和第三方应用
- 阅读《Android(安卓)从入门到精通》(3)——Activity 与界面
- 译:Android的一些基础问题(一)
- Launcher桌面点击&长按&拖动事件处理流程分析