天天看点

ContentProvider介绍及与ContentResolver使用

在Android 应用程序之间数据共享—-ContentResolver中,已经说明了Android是如何实现应用程序之间数据共享的,并详细解析了如何获取其他应用程序共享的数据。ContentProviders存储和检索数据,通过它可以让所有的应用程序访问到,这也是应用程序之间唯一共享数据的方法。那么如何将应用程序的数据暴露出去?

通过以前文章的学习,知道ContentResolver是通过ContentProvider来获取其他与应用程序共享的数据,那么ContentResolver与ContentProvider的接口应该差不多的。

其中ContentProvider负责

  • 组织应用程序的数据;
  • 向其他应用程序提供数据;

ContentResolver则负责

  • 获取ContentProvider提供的数据;
  • 修改/添加/删除更新数据等;

ContentProvider 是如何向外界提供数据的?

Android提供了ContentProvider,一个程序可以通过实现一个ContentProvider的抽象接口将自己的数据完全暴露出去,而且ContentProviders是以类似数据库中表的方式将数据暴露,也就是说ContentProvider就像一个“数据库”。那么外界获取其提供的数据,也就应该与从数据库中获取数据的操作基本一样,只不过是采用URI来表示外界需要访问的“数据库”。至于如何从URI中识别出外界需要的是哪个“数据库”,这就是Android底层需要做的事情了,不在此详细说。简要分析下ContentProvider向外界提供数据操作的接口:

query(Uri, String[], String, String[], String)

insert(Uri, ContentValues)

update(Uri, ContentValues, String, String[])

delete(Uri, String, String[])

这些操作与数据库的操作基本上完全一样,在此不详细说,具体的解析可以参考Android Sqlite解析篇中的详细说明。需要特殊说明的地方是URI:

在URI的D部分可能包含一个_ID ,这个应该出现在SQL语句中的,可以以种特殊的方式出现,这就要求我们在提供数据的时候,需要来额外关注这个特殊的信息。Android  SDK推荐的方法是:在提供数据表字段中包含一个ID,在创建表时INTEGER PRIMARY KEY AUTOINCREMENT标识此ID字段。

ContentProvider 是如何组织数据的?

组织数据主要包括:存储数据,读取数据,以数据库的方式暴露数据。数据的存储需要根据设计的需求,选择合适的存储结构,首选数据库,当然也可以选择本地其他文件,甚至可以是网络上的数据。数据的读取,以数据库的方式暴露数据这就要求,无论数据是如何存储的,数据最后必须以数据的方式访问。

可能还有2个问题,是需要关注的。

  1. ContentProvider是什么时候创建的,是谁创建的?访问某个应用程序共享的数据,是否需要启动这个应用程序?这个问题在Android SDK中没有明确说明,但是从数据共享的角度出发,ContentProvider应该是Android在系统启动时就创建了,否则就谈不上数据共享了。这就要求在AndroidManifest.XML中使用<provider>元素明确定义。
  2. 可能会有多个程序同时通过ContentResolver访问一个ContentProvider,会不会导致像数据库那样的“脏数据”?这个问题一方面需要数据库访问的同步,尤其是数据写入的同步,在AndroidManifest.XML中定义ContentProvider的时候,需要考虑是<provider>元素multiprocess属性的值;另外一方面Android在ContentResolver中提供了notifyChange()接口,在数据改变时会通知其他ContentObserver,这个地方应该使用了观察者模式,在ContentResolver中应该有一些类似register,unregister的接口。

至此,已经对ContentProvider提供了比较全面的分析,至于如何创建ContentProvider,可通过2种方法:创建一个属于你自己的ContentProvider或者将你的数据添加到一个已经存在的ContentProvider中,当然前提是有相同数据类型并且有写入Content provider的权限。在Android SDK的sample中提供的Notepad具体实例中去看源代码!

使用 ContentProvider共享数据: 当应用继承 ContentProvider类,并重写该类用于提供数据和存储数据的方法,就可以向其他应用共享其数据。虽然使用其他方法也可以对外共享数据,但数据访问方式会因数据存储的方式而不同,如:采用文件方式对外共享数据,需要进行文件操作读写数据;采用 sharedpreferences共享数据,需要使用 sharedpreferences  API读写数据。而使用 ContentProvider共享数据的好处是统一了数据访问方式。 当应用需要通过 ContentProvider对外共享数据时, 第一步需要继承 ContentProvider并重写下面方法: public class PersonContentProvider extends ContentProvider{    public boolean onCreate()    public Uri insert(Uri uri, ContentValues values)    public int delete(Uri uri, String selection, String[] selectionArgs)    public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs)    public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)    public String getType(Uri uri) } 第二步需要在AndroidManifest.xml使用<provider>对该ContentProvider进行配置,为了能让其他应用找到该ContentProvider , ContentProvider 采用了authorities(主机名/域名)对它进行唯一标识,你可以把ContentProvider看作是一个网站(想想,网站也是提供数据者),authorities 就是他的域名: <manifest .... >     <application android:icon="@drawable/icon" android:label="@string/app_name">          <provider android:name=".PersonContentProvider" android:authorities="cn.itcast.provider.personprovider"/>     </application> </manifest> 注意:一旦应用继承了 ContentProvider类,后面我们就会把这个应用称为 ContentProvider (内容提供者)。 l

Uri介绍: Uri代表了要操作的数据, Uri主要包含了两部分信息: 1》需要操作的ContentProvider ,2》对ContentProvider中 的什么数据进行操作,一个 Uri由以下几部分组成: l

ContentProvider介绍及与ContentResolver使用

ContentProvider(内容提供者)的scheme已经由Android所规定, scheme为:content:// 主机名(或叫 Authority)用于唯一标识这个 ContentProvider,外部调用者可以根据这个标识来找到它。 路径(path)可以用来表示我们要操作的数据,路径的构建应根据业务而定,如下: 要操作 person表中 id为 10的记录,可以构建这样的路径 :/person/10 要操作 person表中 id为 10的记录的 name字段, person/10/name 要操作 person表中的所有记录,可以构建这样的路径 :/person 要操作 xxx表中的记录,可以构建这样的路径 :/xxx 当然要操作的数据不一定来自数据库,也可以是文件等他存储方式,如下 : 要操作 xml文件中 person节点下的 name节点,可以构建这样的路径: /person/name 如果要把一个字符串转换成Uri,可以使用Uri类中的parse()方法,如下: Uri uri = Uri.parse("content://cn.itcast.provider.personprovider/person")

l UriMatcher类使用介绍: 因为 Uri代表了要操作的数据,所以我们很经常需要解析 Uri ,并从 Uri中获取数据。 Android系统提供了两个用于操作 Uri的工具类,分别为 UriMatcher 和 ContentUris 。掌握它们的使用,会便于我们的开发工作。 UriMatcher类用于匹配Uri,它的用法如下: 首先第一步把你需要匹配Uri路径全部给注册上,如下: //常量 UriMatcher.NO_MATCH表示不匹配任何路径的返回码 UriMatcher  sMatcher = new UriMatcher(UriMatcher.NO_MATCH); //如果 match()方法匹配 content://cn.itcast.provider.personprovider/person路径,返回匹配码为 1 sMatcher.addURI( “ cn.itcast.provider.personprovider ” ,  “ person ” , 1);//添加需要匹配 uri,如果匹配就会返回匹配码 //如果 match()方法匹配 content://cn.itcast.provider.personprovider/person/230路径,返回匹配码为 2 sMatcher.addURI(“cn.itcast.provider.personprovider”, “person/#”, 2); //#号为通配符 switch (sMatcher.match( Uri.parse("content://cn.itcast.provider.personprovider/person/10" ) )) {    case 1     break;    case 2     break;    default://不匹配     break; } 注册完需要匹配的 Uri后,就可以使用 sMatcher.match(uri)方法对输入的 Uri进行匹配,如果匹配就返回匹配码,匹配码是调用 addURI()方法传入的第三个参数,假设匹配 content://cn.itcast.provider.personprovider/person路径,返回的匹配码为 1 l ContentUris类使用介绍: ContentUris类用于获取Uri路径后面的 ID部分,它有两个比较实用的方法: withAppendedId(uri, id)用于为路径加上 ID部分: Uri uri = Uri.parse("content://cn.itcast.provider.personprovider/person") Uri resultUri = ContentUris.withAppendedId(uri, 10); //生成后的 Uri为: content://cn.itcast.provider.personprovider/person/10 parseId(uri)方法用于从路径中获取 ID部分: Uri uri = Uri.parse("content://cn.itcast.provider.personprovider/person/10") long personid = ContentUris.parseId(uri);//获取的结果为 :10 l使用 ContentProvider共享数据: ContentProvider类主要方法的作用: public boolean onCreate() 该方法在 ContentProvider创建后就会被调用,  Android在系统启动时就会创建 ContentProvider 。 public Uri insert(Uri uri, ContentValues values) 该方法用于供外部应用往 ContentProvider添加数据。 public int delete(Uri uri, String selection, String[] selectionArgs) 该方法用于供外部应用从 ContentProvider删除数据。 public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) 该方法用于供外部应用更新 ContentProvider中的数据。 public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) 该方法用于供外部应用从 ContentProvider中获取数据。 public String getType(Uri uri) 该方法用于返回当前 Url所代表数据的 MIME类型。如果操作的数据属于集合类型,那么 MIME类型字符串应该以 vnd.android.cursor.dir/开头,例如:要得到所有 person记录的 Uri为 content://cn.itcast.provider.personprovider/person,那么返回的 MIME类型字符串应该为: “ vnd.android.cursor.dir/person ”。如果要操作的数据属于单一数据,那么 MIME类型字符串应该以 vnd.android.cursor.item/开头,例如:得到 id为 10的 person记录, Uri为 content://cn.itcast.provider.personprovider/person/10,那么返回的 MIME类型字符串应该为: “ vnd.android.cursor.item/person ”。 l使用 ContentResolver操作 ContentProvider中的数据: 当外部应用需要对 ContentProvider中的数据进行添加、删除、修改和查询操作时,可以使用 ContentResolver 类来完成,要获取 ContentResolver 对象,可以使用 Activity提供的 getContentResolver()方法。   ContentResolver类提供了与 ContentProvider类相同签名的四个方法: public Uri insert(Uri uri, ContentValues values) 该方法用于往 ContentProvider添加数据。 public int delete(Uri uri, String selection, String[] selectionArgs) 该方法用于从 ContentProvider删除数据。 public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) 该方法用于更新 ContentProvider中的数据。 public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) 该方法用于从 ContentProvider中获取数据。 这些方法的第一个参数为 Uri,代表要操作的是哪个 ContentProvider和对其中的什么数据进行操作,假设给定的是:  Uri.parse(“content://cn.itcast.provider.personprovider/person/10”),那么将会对主机名为 cn.itcast.provider.personprovider的 ContentProvider进行操作,操作的数据为 person表中 id为 10的记录

l使用 ContentResolver操作 ContentProvider中的数据: 使用 ContentResolver对 ContentProvider中的数据进行添加、删除、修改和查询操作: ContentResolver resolver =  getContentResolver(); Uri uri = Uri.parse("content://cn.itcast.provider.personprovider/person"); //添加一条记录 ContentValues values = new ContentValues(); values.put("name", "itcast"); values.put("age", 25); resolver.insert(uri, values); //获取 person表中所有记录 Cursor cursor = resolver.query(uri, null, null, null, "personid desc"); while(cursor.moveToNext()){ Log.i("ContentTest", "personid="+ cursor.getInt(0)+ ",name="+ cursor.getString(1)); } //把 id为 1的记录的 name字段值更改新为 liming ContentValues updateValues = new ContentValues(); updateValues.put("name", "liming"); Uri updateIdUri = ContentUris.withAppendedId(uri, 2); resolver.update(updateIdUri, updateValues, null, null); //删除 id为 2的记录 Uri deleteIdUri = ContentUris.withAppendedId(uri, 2); resolver.delete(deleteIdUri, null, null); [java]  view plain copy

  1. public class PersonContentProvider extends ContentProvider{  
  2.     private DataBaseOpenHelper dataBaseOpenHelper;  
  3.     private static final int ALLPERSON=1;  
  4.     private static final int PERSON=2;  
  5.     private static final UriMatcher uriMatcher=new UriMatcher(UriMatcher.NO_MATCH);  
  6.     static{  
  7.         uriMatcher.addURI("com.gao.provider.personprovider", "person", ALLPERSON);  
  8.         uriMatcher.addURI("com.gao.provider.personprovider", "person/#", PERSON);  
  9.     }  
  10.     @Override  
  11.     public int delete(Uri uri, String selection, String[] selectionArgs) {  
  12.         SQLiteDatabase database=dataBaseOpenHelper.getWritableDatabase();  
  13.         int count=0;  
  14.         switch (uriMatcher.match(uri)) {  
  15.         case ALLPERSON://content://com.gao.provider.personprovider/person  
  16.             count=database.delete("person", selection, selectionArgs);  
  17.             break;  
  18.         case PERSON://content://com.gao.provider.personprovider/person/100  
  19.             long id=ContentUris.parseId(uri);  
  20.             String where=TextUtils.isEmpty(selection)?"personid=?":selection+"and personid=?";  
  21.             String[] params=new String[]{String.valueOf(id)};  
  22.             if (!TextUtils.isEmpty(selection)&&selectionArgs!=null) {  
  23.                 params=new String[selectionArgs.length+1];  
  24.                 for (int i = 0; i < selectionArgs.length; i++) {  
  25.                     params[i]=selectionArgs[i];  
  26.                 }  
  27.                 params[selectionArgs.length+1]=String.valueOf(id);  
  28.             }  
  29.             count=database.delete("person", where, selectionArgs);  
  30.             break;  
  31.         default:  
  32.             throw new IllegalArgumentException("Unkonw uri:"+uri);  
  33.         }  
  34.         return count;  
  35.     }  
  36.     @Override  
  37.     public String getType(Uri uri) {  
  38.         switch (uriMatcher.match(uri)) {  
  39.         case ALLPERSON:  
  40.             return "vnd.android.cursor.dir/personprovider.person";  
  41.         case PERSON:  
  42.             return "vnd.android.cursor.item/personprovider.person";  
  43.         default:  
  44.             break;  
  45.         }  
  46.         return null;  
  47.     }  
  48.     @Override  
  49.     public Uri insert(Uri uri, ContentValues values) {  
  50.         SQLiteDatabase database=dataBaseOpenHelper.getWritableDatabase();  
  51.         long id=0;  
  52.         switch (uriMatcher.match(uri)) {  
  53.         case ALLPERSON://content://com.gao.provider.personprovider/person  
  54.             id=database.insert("person", "name", values);//返回记录的行号,主键是int,实际上就是主键值  
  55.             return ContentUris.withAppendedId(uri, id);  
  56.         case PERSON://content://com.gao.provider.personprovider/person/100  
  57.             id=database.insert("person", "name", values);  
  58.             String path=uri.toString();  
  59.             return Uri.parse(path.substring(0, path.lastIndexOf("/"))+"id");  
  60.         default:  
  61.             throw new IllegalArgumentException("Unkonw uri:"+uri);  
  62.         }  
  63.     }  
  64.     @Override  
  65.     public boolean onCreate() {  
  66.         dataBaseOpenHelper=new DataBaseOpenHelper(this.getContext());  
  67.         return false;  
  68.     }  
  69.     @Override  
  70.     public Cursor query(Uri uri, String[] projection, String selection,  
  71.             String[] selectionArgs, String sortOrder) {  
  72.         SQLiteDatabase database=dataBaseOpenHelper.getReadableDatabase();  
  73.         switch (uriMatcher.match(uri)) {  
  74.         case ALLPERSON:  
  75.             database.query("person", projection, selection, selectionArgs, null, null, sortOrder);  
  76.             break;  
  77.         case PERSON:  
  78.             long id=ContentUris.parseId(uri);  
  79.             String where=TextUtils.isEmpty(selection)?"personid=?":selection+"and personid=?";  
  80.             String[] params=new String[]{String.valueOf(id)};  
  81.             if (!TextUtils.isEmpty(selection)&&selectionArgs!=null) {  
  82.                 params=new String[selectionArgs.length+1];  
  83.                 for (int i = 0; i < selectionArgs.length; i++) {  
  84.                     params[i]=selectionArgs[i];  
  85.                 }  
  86.                 params[selectionArgs.length+1]=String.valueOf(id);  
  87.             }  
  88.             database.query("person", projection, where, params, null, null, sortOrder);  
  89.             break;  
  90.         default:  
  91.             break;  
  92.         }  
  93.         return null;  
  94.     }  
  95.     //update("content://com.gao.provider.personprovider/person/100",values,"name like ? and ...",new String[]{"%gao%"});  
  96.     @Override  
  97.     public int update(Uri uri, ContentValues values, String selection,  
  98.             String[] selectionArgs) {  
  99.         SQLiteDatabase database=dataBaseOpenHelper.getWritableDatabase();  
  100.         int count=0;  
  101.         switch (uriMatcher.match(uri)) {  
  102.         case ALLPERSON://content://com.gao.provider.personprovider/person  
  103.             count=database.update("person", values, selection,selectionArgs);  
  104.             break;  
  105.         case PERSON://content://com.gao.provider.personprovider/person/100  
  106.             long id=ContentUris.parseId(uri);  
  107.             String where=TextUtils.isEmpty(selection)?"personid=?":selection+"and personid=?";  
  108.             String[] params=new String[]{String.valueOf(id)};  
  109.             if (!TextUtils.isEmpty(selection)&&selectionArgs!=null) {  
  110.                 params=new String[selectionArgs.length+1];  
  111.                 for (int i = 0; i < selectionArgs.length; i++) {  
  112.                     params[i]=selectionArgs[i];  
  113.                 }  
  114.                 params[selectionArgs.length+1]=String.valueOf(id);  
  115.             }  
  116.             count=database.update("person", values, where,params);  
  117.             break;  
  118.         default:  
  119.             throw new IllegalArgumentException("Unkonw uri:"+uri);  
  120.         }  
  121.         return count;  
  122.     }  
  123. }  

  AndroidManifest.xml: <provider android:name="PersonContentProvider" android:authorities="com.gao.provider.personprovider" /> 在另一个程序ContentProviderUser中使用上面的内容提供者: [java]  view plain copy

  1. public void onCreate(Bundle savedInstanceState) {  
  2.        super.onCreate(savedInstanceState);  
  3.        setContentView(R.layout.main);  
  4.        ContentResolver contentResolver=this.getContentResolver();  
  5.        Uri allUri=Uri.parse("content://com.gao.provider.personprovider/person");  
  6.        ContentValues values=new ContentValues();  
  7.        values.put("name", "GGGGG");  
  8.        values.put("age", 19);  
  9.        contentResolver.insert(uri, values);  
  10.        values.put("name", "CCCCCC");  
  11.        values.put("age", 100);  
  12.        Uri uri=Uri.parse("content://com.gao.provider.personprovider/person/9");  
  13.       // contentResolver.update(uri, values, null, null);  
  14.        //contentResolver.delete(uri, null, null);  
  15.        Cursor cursor=contentResolver.query(uri, new String[]{"personid","name","age"}, null, null, "personid desc");  
  16.        while (cursor.moveToNext()) {  
  17.         Log.i(TAG, "psrsonid:"+cursor.getInt(0)+",name:"+cursor.getString(1)+",age"+cursor.getInt(2));  
  18.     }  
  19.        cursor.close();