Android四组件之ContentProvider架构&Demo
2015-11-26 16:08
519 查看
Android中的Content provider机制可支持在多个应用中存储和读取数据。这也是跨应用共享数据的唯一方式。在Android系统中,没有一个公共的内存区域,供多个应用共享存储数据。
Android提供了一些主要数据类型的Content provider,比如音频、视频、图片和私人通讯录等。可在android.provider包下面找到一些android提供的Content provider。可以获得这些Content provider,查询它们包含的数据,当然前提是已获得适当的读取权限。
如果想公开自己的数据,那么可有两种办法:
1、创建自己的Content provider,需要继承ContentProvider类;
2、如果你的数据和已存在的Content provider数据结构一致,可以将数据写到已存在的Content provider中,当然前提是获取写该Content provider的权限。比如把OA中的成员通讯信息加入到系统的联系人Content provider中。
Content provider基础:所有Content provider都需要实现相同的接口用于查询Content provider并返回数据,也包括增加、修改和删除数据。
一、简介
Android使用一种称为ContentProvider的概念来将数据抽象为服务,这种内容提供程序的理念看起来像启用了REST的数据提供程序。
(tag:REST–Representational State Transfer)
要从ContentProvider检索数据或将数据保存到ContentProvider,需要使用一组类似REST的URI。例如,要从封装图书数据库的ContentProvider获取一组图书,需要使用以下形式的URI:
要从图书数据库获得指定图书(如编号为:88图书),则要使用以下类似URI:
设备上的任何应用程序都可以通过这些URI来访问或操作数据,所以在应用程序之间的数据共享上ContentProvider扮演着非常主要的角色。
二、Android中内置的 ContentProvider
Android中存在大量的内置ContentProvider,他们记录在SDK的android.provider包中,如:
其中顶级项数据库,较低级的项是表。所以Browser、CAllog,MediaStore和Settings都是封装为ContentProvider的独立SQLite数据库.这些数据库通常具有扩展名.db。仅能从实现包访问,任何来自外部的访问都要通过ContentProvider接口。
三、ContentProvider的架构
与网站一样,设备上的每个ContentProvider都会使用字符串注册本身,这个字符串类似网站域名,但称为:授权(Authority)。授权的注册则AndroidManifest.xml中进行。如:
在进行了授权后,ContentProvider就拥有了以授权前缀开头的URI:
注意:Android内置的ContentProvider可能没有完全限定的授权名,只有在使用第三方提供的时才使用完全限定名。这也就是为什么有时候仅使用Contacts来引用联系人ContentProvider。
1、Android内容URI的结构
Android中的内容URI类似于Http URL,但他们以content://开头具有一下通用形式:
2、Android MIME类型的结构
就像网站返回给指定URI的MIME类型一样,ContentProvider也负责返回给URI的MIME类型。MIME类型包括两部分:类型和子类型。如:
类型和子类型对于他们所表示的内容必须是唯一的,且如果类型和子类型不是标准的,则需要在他们前面加上VND。
(tag:VND虚拟网络磁盘系统(Virtual Network Disk System))
3、使用URI读取数据
要从ContentProvider获取数据,需要使用该ContentProvider提供的URI。
如下:为从联系人提供程序获取单行联系人信息
在上面的基础上我们来看看,如何获取一个游标,这个游标包含来自contactsContentProvider的People表的一组特定的列。
4、使用游标
在使用Android游标前,先了解一些关于游标的的知识。
游标是一个行集合;
读取数据之前,需要使用moveToFirst(),因为游标放在第一行之前;
需要知道列的名称和类型;
所有字段访问都基于列编号,所以必须首先将列名称转换为列编号;
游标可以随意移动;
可以使用游标获取行计数;
使用while循环导航游标:
使用for循环导航游标
5、使用Where子句
ContentProvider提供两种方式来传递where子句:
通过URI:
通过String子句与一组可替换的字符串数组参数的组合。
6、插入记录
android使用ContentValues来保存将插入的单一记录的值,要插入记录,由android.content.ContentResolver使用URI插入记录。下面是个例子:
7、更新和删除
更新类似插入,方法签名为:
类似的删除的方法为:
干货来了,前面的看的晕晕乎乎的,现在看会这个例子就可以了。
8、下面我们自己实现一个ContentProvider Demo,并进行CRUD操作;
我们将按如下流程来实现:
(1)计划数据库、URI、列名称,创建元数据类来定义所有的这些元数据元素的常量;
(2)扩展抽象类ContentProvider
(3)实现方法:query、insert、update、delete和getType
(4)在描述文件中注册提供程序
具体代码如下:
布局文件:
元数据类:(NotePad.java)
扩展ContentProvider类(NotePadProvider.java)
在描述文件中注册提供程序:AndroidManifest.xml
欢迎吐槽和指正,谢谢!
Android提供了一些主要数据类型的Content provider,比如音频、视频、图片和私人通讯录等。可在android.provider包下面找到一些android提供的Content provider。可以获得这些Content provider,查询它们包含的数据,当然前提是已获得适当的读取权限。
如果想公开自己的数据,那么可有两种办法:
1、创建自己的Content provider,需要继承ContentProvider类;
2、如果你的数据和已存在的Content provider数据结构一致,可以将数据写到已存在的Content provider中,当然前提是获取写该Content provider的权限。比如把OA中的成员通讯信息加入到系统的联系人Content provider中。
Content provider基础:所有Content provider都需要实现相同的接口用于查询Content provider并返回数据,也包括增加、修改和删除数据。
一、简介
Android使用一种称为ContentProvider的概念来将数据抽象为服务,这种内容提供程序的理念看起来像启用了REST的数据提供程序。
(tag:REST–Representational State Transfer)
要从ContentProvider检索数据或将数据保存到ContentProvider,需要使用一组类似REST的URI。例如,要从封装图书数据库的ContentProvider获取一组图书,需要使用以下形式的URI:
content://com.android.book.BookProvider/books
要从图书数据库获得指定图书(如编号为:88图书),则要使用以下类似URI:
content://com.android.book.BookProvider/books/88
设备上的任何应用程序都可以通过这些URI来访问或操作数据,所以在应用程序之间的数据共享上ContentProvider扮演着非常主要的角色。
二、Android中内置的 ContentProvider
Android中存在大量的内置ContentProvider,他们记录在SDK的android.provider包中,如:
Browser Package Calllog Package Contacts Package: -People -Phones -Photos -Groups MediaStore Package: -Audio -Albums -Artists -Playlists -Images -Video Settings
其中顶级项数据库,较低级的项是表。所以Browser、CAllog,MediaStore和Settings都是封装为ContentProvider的独立SQLite数据库.这些数据库通常具有扩展名.db。仅能从实现包访问,任何来自外部的访问都要通过ContentProvider接口。
三、ContentProvider的架构
与网站一样,设备上的每个ContentProvider都会使用字符串注册本身,这个字符串类似网站域名,但称为:授权(Authority)。授权的注册则AndroidManifest.xml中进行。如:
<provider android:name="BookProvider" android:authorities="com.myCompany.BookProvider"/>
在进行了授权后,ContentProvider就拥有了以授权前缀开头的URI:
content://com.myCompany.BookProvider/
注意:Android内置的ContentProvider可能没有完全限定的授权名,只有在使用第三方提供的时才使用完全限定名。这也就是为什么有时候仅使用Contacts来引用联系人ContentProvider。
1、Android内容URI的结构
Android中的内容URI类似于Http URL,但他们以content://开头具有一下通用形式:
Content://*/*/ 或者 content://authority-name/path-segment1/path-segment2/etc......
2、Android MIME类型的结构
就像网站返回给指定URI的MIME类型一样,ContentProvider也负责返回给URI的MIME类型。MIME类型包括两部分:类型和子类型。如:
text/html text/css text/xml application/pdf application/vnd.ms-excel
类型和子类型对于他们所表示的内容必须是唯一的,且如果类型和子类型不是标准的,则需要在他们前面加上VND。
(tag:VND虚拟网络磁盘系统(Virtual Network Disk System))
3、使用URI读取数据
要从ContentProvider获取数据,需要使用该ContentProvider提供的URI。
如下:为从联系人提供程序获取单行联系人信息
Uri baseUri = Contacts.People.CONTENT_URI; uri myPersonUri = baseUri.withAppendedPath(Contacts.People.CONTENT_URI,"80"); Cursor cur = manageQuery(myPersonUri,null,null,null);
在上面的基础上我们来看看,如何获取一个游标,这个游标包含来自contactsContentProvider的People表的一组特定的列。
String[] projection = new String[]{ People._ID, People.NAME, People.NUMBER }; Uri mContactsURi = Contacts.People.CONTENT_URI; Cursor managedCursor = managedQuery( projection, null, Contacts.People.NAME + "ASC" );
4、使用游标
在使用Android游标前,先了解一些关于游标的的知识。
游标是一个行集合;
读取数据之前,需要使用moveToFirst(),因为游标放在第一行之前;
需要知道列的名称和类型;
所有字段访问都基于列编号,所以必须首先将列名称转换为列编号;
游标可以随意移动;
可以使用游标获取行计数;
使用while循环导航游标:
if (cur.moveToFirst == false){ return; } int nameColumnIndex = cur.getColumnIndex(People.NAME); String name = cur.getString(nameColumnIndex); while (cur.moveToNext()){ //获取属性值 }
使用for循环导航游标
int nameColumn = cur.getColumnIndex(People.NAME); int ploneColumn = cur.getColumnIndex(People.NUMBER); for(cur.moveToFirst();!cur.isAfterLast();cur.moveToNext()){ String name = cur.getString(nameColumn); String phoneNumber = cur.getString(phoneColumn);
5、使用Where子句
ContentProvider提供两种方式来传递where子句:
通过URI:
String noteUri = "content://com.google.provider.NotePad.notes.80"; Cursor managedCursor = managedQuery(noteUri, projection,//返回的列 null,//where子句 Contacts.People.NAME + "ASC"//排序方式 );
通过String子句与一组可替换的字符串数组参数的组合。
String noteUri = "content://com.google.provider.NotePad.notes"; Cursor managedCursor = managedQuery(noteUri, projection,//返回的列 "_id=?",//where子句 new String[]{80}, Contacts.People.NAME + "ASC"//排序方式 );
6、插入记录
android使用ContentValues来保存将插入的单一记录的值,要插入记录,由android.content.ContentResolver使用URI插入记录。下面是个例子:
ContentValues values = new ContentValues(); values.put("title","new Note"); values.put("note","this is a new Note"); ContentResolver cr = activity.getContentResolver(); Uri uri = cr.insert(Notepad.Notes.CONTENT_URI,values);
7、更新和删除
更新类似插入,方法签名为:
int numberOfRowsUpdated = activity.getContentResolver().update( Uri uri, ContentValues values, String whereClause, String[] selectionArgs );
类似的删除的方法为:
int numberOfRowsDeleted = activity.getContentResolver().delete( Uri uri, String whereClause, String[] selectionArgs );
干货来了,前面的看的晕晕乎乎的,现在看会这个例子就可以了。
8、下面我们自己实现一个ContentProvider Demo,并进行CRUD操作;
我们将按如下流程来实现:
(1)计划数据库、URI、列名称,创建元数据类来定义所有的这些元数据元素的常量;
(2)扩展抽象类ContentProvider
(3)实现方法:query、insert、update、delete和getType
(4)在描述文件中注册提供程序
具体代码如下:
布局文件:
<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="vertical" android:layout_width="fill_parent" android:layout_height="fill_parent" > <TextView android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="@string/hello" /> </LinearLayout>
元数据类:(NotePad.java)
public class NotePad { //授权 public static final String AUTHORITY = "com.google.provider.NotePad"; private NotePad(){ } public static final class Notes implements BaseColumns{ private Notes(){ } //uri = "content://" + AUTHORITY + "/notes" public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/notes"); //新的MiMe类型-多个 public static final String CONTENT_ITEM = "vnd.android.cursor.dir/vnd.google.note"; //新的MiMe类型-单个 public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/vnd.google.note"; //排序方式 public static final String DEFAULT_SORT_ORDER = "modified DESC"; //字段 public static final String TITLE = "title"; public static final String NOTE = "note"; public static final String CREATEDDATE = "created"; public static final String MODIFIEDDATE = "modified"; } }
扩展ContentProvider类(NotePadProvider.java)
public class NotePadProvider extends ContentProvider{ private static final String TAG = "NotePadProvider"; //数据库名 private static final String DATABASE_NAME = "notepad.db"; private static final int DATABASE_VERSION = 2; //表名 private static final String TABLE_NAME = "notes"; private static HashMap<String,String> noteProjectionMap; private static final int NOTES = 1; private static final int NOTE_ID = 2; //uri匹配器 private static final UriMatcher urimatcher; private DatabaseHelper openHelper; private static final String CREATE_TABLE = "CREATE TABLE " + TABLE_NAME + "(" +Notes._ID + " INTEGER PRIMARY KEY," + Notes.TITLE + " TEXT," + Notes.NOTE + " TEXT," + Notes.CREATEDDATE + " INTEGER," + Notes.MODIFIEDDATE + " INTEGER" + ")"; static{ urimatcher = new UriMatcher(UriMatcher.NO_MATCH); urimatcher.addURI(NotePad.AUTHORITY, "notes",NOTES); urimatcher.addURI(NotePad.AUTHORITY, "notes/#", NOTE_ID); //列别名 noteProjectionMap = new HashMap<String,String>(); noteProjectionMap.put(Notes._ID,Notes._ID); noteProjectionMap.put(Notes.TITLE, Notes.TITLE); noteProjectionMap.put(Notes.NOTE, Notes.NOTE); noteProjectionMap.put(Notes.CREATEDDATE, Notes.CREATEDDATE); noteProjectionMap.put(Notes.MODIFIEDDATE,Notes.MODIFIEDDATE); } private static class DatabaseHelper extends SQLiteOpenHelper{ public DatabaseHelper(Context context){ super(context, DATABASE_NAME, null, DATABASE_VERSION); } //创建表 @Override public void onCreate(SQLiteDatabase db) { Log.i(TAG, CREATE_TABLE); db.execSQL(CREATE_TABLE); } //更新数据库 @Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { db.execSQL("drop table if exists notes"); onCreate(db); } } //删除数据 @Override public int delete(Uri uri, String selection, String[] selectionArgs) { return 0; } //获取MIME类型 @Override public String getType(Uri uri) { switch (urimatcher.match(uri)){ case NOTES: return Notes.CONTENT_ITEM; case NOTE_ID: return Notes.CONTENT_ITEM_TYPE; default: throw new IllegalArgumentException("Unknow Uri" + uri); } } @Override public Uri insert(Uri uri, ContentValues values) { if (urimatcher.match(uri) != NOTES){ throw new IllegalArgumentException("Unknow Uri" + uri); } ContentValues contentValues; if (null != values){ contentValues = new ContentValues(values); }else{ contentValues = new ContentValues(); } Long now = Long.valueOf(System.currentTimeMillis()); if (!contentValues.containsKey(NotePad.Notes.CREATEDDATE)){ contentValues.put(NotePad.Notes.CREATEDDATE, now); } if (contentValues.containsKey(NotePad.Notes.MODIFIEDDATE) == false){ contentValues.put(NotePad.Notes.MODIFIEDDATE, now); } if (contentValues.containsKey(NotePad.Notes.TITLE) == false){ Resources r = Resources.getSystem(); contentValues.put(NotePad.Notes.TITLE, r.getString(android.R.string.untitled)); } if (contentValues.containsKey(NotePad.Notes.NOTE) == false){ contentValues.put(NotePad.Notes.NOTE, ""); } SQLiteDatabase db = openHelper.getWritableDatabase(); long rowId = db.insert(TABLE_NAME, Notes.NOTE, contentValues); System.out.println(rowId); if (rowId > 0){ Uri noteUri = ContentUris.withAppendedId(NotePad.Notes.CONTENT_URI, rowId); getContext().getContentResolver().notifyChange(noteUri, null); return noteUri; } throw new SQLException("insert row into failed " + uri); } @Override public boolean onCreate() { openHelper = new DatabaseHelper(getContext()); return false; } @Override public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) { SQLiteQueryBuilder qb = new SQLiteQueryBuilder(); switch (urimatcher.match(uri)){ case NOTES: qb.setTables(TABLE_NAME); qb.setProjectionMap(noteProjectionMap); break; case NOTE_ID: qb.setTables(TABLE_NAME); qb.setProjectionMap(noteProjectionMap); qb.appendWhere(Notes._ID + "=" + uri.getPathSegments().get(1)); break; default: throw new IllegalArgumentException("Unknow Uri" + uri); } String orderBy; if (TextUtils.isEmpty(sortOrder)){ orderBy = NotePad.Notes.DEFAULT_SORT_ORDER; }else{ orderBy = sortOrder; } SQLiteDatabase db = openHelper.getReadableDatabase(); Cursor cursor = qb.query(db, projection, selection, selectionArgs, null, null, orderBy); cursor.setNotificationUri(getContext().getContentResolver(),uri); return cursor; } @Override public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) { return 0; } } 活动类(ContentProviderTest.java) public class ContentProviderTest extends Activity { /** Called when the activity is first created. */ @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); //插入数据 ContentValues contentValues = new ContentValues(); contentValues.put(NotePad.Notes.TITLE, "title1"); contentValues.put(NotePad.Notes.NOTE, "NOTENOTE1"); getContentResolver().insert(NotePad.Notes.CONTENT_URI, contentValues); contentValues.clear(); contentValues.put(NotePad.Notes.TITLE, "title2"); contentValues.put(NotePad.Notes.NOTE, "NOTENOTE2"); getContentResolver().insert(NotePad.Notes.CONTENT_URI, contentValues); displayNote(); } private void displayNote(){ String[] columns = new String[]{NotePad.Notes._ID ,NotePad.Notes.TITLE ,NotePad.Notes.NOTE ,NotePad.Notes.CREATEDDATE ,NotePad.Notes.MODIFIEDDATE}; Uri myUri = NotePad.Notes.CONTENT_URI; Cursor cursor = managedQuery(myUri, columns, null, null, null); if (cursor.moveToFirst()){ String id = null; String title = null; do{ id = cursor.getString(cursor.getColumnIndex(NotePad.Notes._ID)); title = cursor.getString(cursor.getColumnIndex(NotePad.Notes.TITLE)); Toast toast = Toast.makeText(this, "TITLE:" + id + "NOTES" + title, Toast.LENGTH_SHORT); toast.setGravity(Gravity.TOP|Gravity.CENTER, 0, 40); toast.show(); }while(cursor.moveToNext()); } } }
在描述文件中注册提供程序:AndroidManifest.xml
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.test.contentProvider" android:versionCode="1" android:versionName="1.0"> <application android:icon="@drawable/icon" android:label="@string/app_name"> <provider android:name="NotePadProvider" android:authorities="com.google.provider.NotePad"/> <activity android:name=".ContentProviderTest" android:label="@string/app_name"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> <intent-filter> <data android:mimeType="vnd.android.cursor.dir/vnd.google.note"></data> </intent-filter> <intent-filter> <data android:mimeType="vnd.android.cursor.item/vnd.google.note"></data> </intent-filter> </activity> </application> </manifest>
欢迎吐槽和指正,谢谢!
相关文章推荐
- 使用C++实现JNI接口需要注意的事项
- Android IPC进程间通讯机制
- Android Manifest 用法
- [转载]Activity中ConfigChanges属性的用法
- Android之获取手机上的图片和视频缩略图thumbnails
- Android之使用Http协议实现文件上传功能
- Android学习笔记(二九):嵌入浏览器
- android string.xml文件中的整型和string型代替
- i-jetty环境搭配与编译
- android之定时器AlarmManager
- android wifi 无线调试
- Android Native 绘图方法
- Android java 与 javascript互访(相互调用)的方法例子
- android 代码实现控件之间的间距
- android FragmentPagerAdapter的“标准”配置
- Android"解决"onTouch和onClick的冲突问题
- android:installLocation简析
- android searchView的关闭事件