Android Content Provider 使用
Content Provider:一个组件，必须放在应用的主包或应用的子包之下；
组件的配置需要在清单文件中进行配置；content provider需要在application节点中进行配置；
内容提供者在应用中的作用是对外共享数据(任意类型的数据)使用的，别的程序可以对数据进行CRUD，如通讯录；
如果采用文件的方式对外共享数据，会因为文件的类型不同而需要使用不同的api访问方式导致访问繁杂，而内容提供者提供了统一的api对数据进行操作；
<provider android:name=".PersonProvider"<!-- 内容提供者类的名称 --> android:authorities="cn.wordtech.providers.personprovider" <!--为内容提供者指定一个唯一的标识，这样应用才唯一可以获取此provider--> android:exported="false" ><!-- 解决 android Permission Denial error！，在监听内容提供者数据发生变化时需要配置此项 --> </provider>
Uri 代表了要操作的数据；
Uri主要包含两部分的信息:
1>>需要操作的ContentProvider
2>>对ContentProvider中的什么数据进行操作
ContentProvider(内容提供者)的scheme已经由Android所规定，scheme为:content://
主机名(或Authority)用于唯一标识这个ContentProvider,外部调用者可以根据此标识来找到它，
路径(path)可以用来表示我们要操作的数据，路径的构建根据业务而定。
ex:
要操作person表中id为10的记录,可以构建这样的路径:/person/10
要操作person表中id为10的记录的name字段,可以构建这样的路径:/person/10/name
要操作person表中的所有记录,可以构建这样的路径:/person
要操作XXX表中的记录，可以构建这样的路径:/XXX
要操作的数据不一定是数据库中的文件，也可以是文件，xml或网络等其它方式
ex:
要操作xml文件中person节点下的name节点，可以构建这样的路径:/person/name
下面是一个ContentProvider实例
public class PersonProvider extends ContentProvider {// Content Provider需要继承自ContentProvider类 // 删改查中，都有两种情况: // person 对整个表进行操作 // person/id 对表中的与id对应记录进行操作 private DBOpenHelper dbOpenHelper; private static final UriMatcher MATCHER = new UriMatcher(UriMatcher.NO_MATCH);// new UriMatcher(code);code即为匹配不成功时返回的值； private static final int PERSONS = 1; private static final int PERSON = 2; // 设置匹配项 static { MATCHER.addURI("cn.wordtech.providers.personprovider", "person",PERSONS); MATCHER.addURI("cn.wordtech.providers.personprovider", "person/#",PERSON);// #号表示数字 } // content://cn.wordtech.providers.personprovider/person @Override public boolean onCreate() { // 由系统调用，当ContentProvider的实例被创建出来的时候被调用，Android开机后，当第一次有应用访问ContentProvider时才创建ContentProvider； dbOpenHelper = new DBOpenHelper(getContext(), 1); return false; } // 可以供外部的应用查询数据，返回查询得到的游标对象 @Override public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) { SQLiteDatabase db = dbOpenHelper.getWritableDatabase(); switch (MATCHER.match(uri)) { case 1: return db.query("person", projection, selection, selectionArgs, null, null, sortOrder); case 2: long rowid = ContentUris.parseId(uri);// 返回要操作的id String where = "personid=" + rowid; if (selection != null && !"".equals(selection.trim())) { where += "and" + selection; } return db.query("person", projection, where, selectionArgs, null, null, sortOrder); default: throw new IllegalArgumentException(""); } } // 此方法用于返回目前Uri所代表的数据的MIME类型， // 如果操作的数据属于集合类型，则MIME字符串就以"vnd.android.cursor.dir"开头 // 如果操作的数据属于非集合类型，则MIME字符串就以"vnd.android.cursor.item"开头 @Override public String getType(Uri uri) { switch (MATCHER.match(uri)) { case 1: return "vnd.android.cursor.dir/person"; case 2: return "vnd.android.cursor.item/person"; default: throw new IllegalArgumentException(""); } } // 此方法需要返回操作记录对应的Uri @Override public Uri insert(Uri uri, ContentValues values) { SQLiteDatabase db = dbOpenHelper.getWritableDatabase(); switch (MATCHER.match(uri)) { case 1: long rowid = db.insert("person", "", values);// 返回行号?主键值 // Uri insertUri = Uri // .parse("content://com.sqlite.PersonProvider/person/" // + rowid); Uri insertUri = ContentUris.withAppendedId(uri, rowid); return insertUri; default: throw new IllegalArgumentException("this is Unknow Uri:" + uri); } } // 返回受影响的行数 @Override public int delete(Uri uri, String selection, String[] selectionArgs) { SQLiteDatabase db = dbOpenHelper.getWritableDatabase(); int num = 0; switch (MATCHER.match(uri)) { case 1: num = db.delete("person", selection, selectionArgs);// 清空整个表 break; case 2: long rowid = ContentUris.parseId(uri);// 返回要操作的id String where = "personid=" + rowid; if (selection != null && !"".equals(selection.trim())) { where += "and" + selection; } num = db.delete("person", where, selectionArgs); break; default: throw new IllegalArgumentException(""); } return num; } @Override // 返回受影响的行数 public int update(Uri uri, ContentValues values, String selection,String[] selectionArgs) { SQLiteDatabase db = dbOpenHelper.getWritableDatabase(); int num = 0; switch (MATCHER.match(uri)) { case 1: num = db.update("person", values, selection, selectionArgs); break; case 2: long rowid = ContentUris.parseId(uri);// 返回要操作的id String where = "personid=" + rowid; if (selection != null && !"".equals(selection.trim())) { where += "and" + selection; } num = db.update("person", values, where, selectionArgs); break; default: throw new IllegalArgumentException(""); } return num; } }
下面是对前一个类进行测试
public class AccessContentProviderTest extends AndroidTestCase { public void testinsert() { Uri uri = Uri.parse("content://cn.wordtech.providers.personprovider/person");// 根据标识名得到内容提供者 ContentResolver cr = this.getContext().getContentResolver(); // This class provides applications access to the content model ContentValues values = new ContentValues(); values.put("name", "Livingstone"); values.put("phone", "110"); values.put("amount", "1111111111"); cr.insert(uri, values);// 在cr的内部会调用内容提供者的值； } public void testdelete() { Uri uri = Uri.parse("content://cn.wordtech.providers.personprovider/person/1");// 根据标识名得到内容提供者 ContentResolver cr = this.getContext().getContentResolver(); cr.delete(uri, null, null); } public void testupdate() { Uri uri = Uri.parse("content://cn.wordtech.providers.personprovider/person/2");// 根据标识名得到内容提供者 ContentResolver cr = this.getContext().getContentResolver(); ContentValues values = new ContentValues(); values.put("name", "Livingstone11"); cr.update(uri, values, null, null); } public void testquery() { Uri uri = Uri.parse("content://cn.wordtech.providers.personprovider/person");// 根据标识名得到内容提供者 ContentResolver cr = this.getContext().getContentResolver(); Cursor cursor = cr.query(uri, null, null, null, "personid asc"); while (cursor.moveToNext()) { String name = cursor.getString(cursor.getColumnIndex("name")); Log.i("Name", name); } } }
监听ContentProvider数据变化情况
如果ContentProvider的访问者需要知道ContentProvider中的数据的变化情况，可以在ContentProvider发生数据变化时调用getContentResolver().notifyChange(uri,null)来通知注册在此URI上的访问者。
public class PersonContentProvider extends ContentProvider[ public Uri insert(Uri uri,ContentValues values){ db.insert("person","personid",values); getContext().getContentResolver().notifyChange(uri,null); }//通知注册在此URI上的访问者，此外注册在insert方法上 }
如果ContentProvider的访问者需要得到数据变化通知，必须使用ContentObserver对数据(数据使用URI描述)进行监听，当监听到数据变化通知时，系统就会调用ContentObserver的onChange()方法。
public class MainActivity extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); Uri uri = Uri.parse("content://cn.wordtech.providers.personprovider/person"); this.getContentResolver().registerContentObserver(uri, true, new PersonContentdObserver(new Handler())); // 第三个对象为监听对象，当数据发生改变的时候通知此对象做相应的改变 } @Override public boolean onCreateOptionsMenu(Menu menu) { getMenuInflater().inflate(R.menu.main, menu); return true; } private class PersonContentdObserver extends ContentObserver { public PersonContentdObserver(Handler handler) { super(handler); } @Override public void onChange(boolean selfChange) { Uri uri = Uri.parse("content://cn.wordtech.providers.personprovider/person"); Cursor cursor = getContentResolver().query(uri, null, null, null,"personid desc limit 1"); while (cursor.moveToNext()) { String name = cursor.getString(cursor.getColumnIndex("name")); Log.i("Name", name); } super.onChange(selfChange); } } }
测试应用:
Uri uri = Uri.parse("content://cn.wordtech.providers.personprovider/person");// 根据标识名得到内容提供者
ContentResolver cr = MainActivity.this.getContentResolver();
ContentValues values = new ContentValues();
values.put("name", "Livingstone");
values.put("phone", "1101");
values.put("amount", "1111111111");
cr.insert(uri, values);
