转载

ContentProvider数据访问详解

ContentProvider数据访问详解

Android官方指出的数据存储方式总共有五种：Shared Preferences、网络存储、文件存储、外储存储、SQLite，这些存储方式一般都只是在一个单独的应用程序中实现数据的共享，而对于需要操作其他应用程序中的数据时（如媒体库、通讯录等），可能就需要借助ContentProvider了。

1、ContentProvider

ContentProvider为存储和获取数据提供了统一的接口，使用表的形式来对数据进行封装，使得开发者在后续的开发过程中不用关心数据存储的细节。使用ContentProvider可以在不同的应用程序之间共享数据，Android为常见的数据类型提供了默认的ContentProvider（包括音频、视频、图片和通讯录等）。

总的来说，利用ContentProvider来实现共享数据的好处是统一了数据的访问方式。

2、URI（Uniform Resource Identifier）

URI为系统中的每一个资源赋予一个名字，比方说通话记录。每一个ContentProvider都拥有一个公共的URI，用于表示ContentProvider所提供的数据。 Android所提供的ContentProvider都位于android.provider包中， 可以将URI分为A、B、C、D 4个部分来理解。如对于content://com.wang.provider.myprovider/tablename/id：

a、标准前缀——content://，用来说明一个Content Provider控制这些数据；

b、URI的标识——com.wang.provider.myprovider，用于唯一标识这个ContentProvider，外部调用者可以根据这个标识来找到它。对于第三方应用程序，为了保证URI标识的唯一性，它必须是一个完整的、小写的类名。这个标识在元素的authorities属性中说明，一般是定义该ContentProvider的包.类的名称；

c、路径——tablename，通俗的讲就是你要操作的数据库中表的名字，或者你也可以自己定义，记得在使用的时候保持一致就可以了；

d、记录ID——id，如果URI中包含表示需要获取的记录的ID，则返回该id对应的数据，如果没有ID，就表示返回全部；

对于第三部分路径（path）做进一步的解释，用来表示要操作的数据，构建时应根据实际项目需求而定。如：

a、操作tablename表中id为11的记录，构建路径：/tablename/11；

b、操作tablename表中id为11的记录的name字段：tablename/11/name；

c、操作tablename表中的所有记录：/tablename；

d、操作来自文件、xml或网络等其他存储方式的数据，如要操作xml文件中tablename节点下name字段：/ tablename/name；

e、若需要将一个字符串转换成Uri，可以使用Uri类中的parse()方法，如：

1 Uri uri = Uri.parse("content://com.wang.provider.myprovider/tablename")；

3、UriMatcher

Uri代表要操作的数据，在开发过程中对数据进行获取时需要解析Uri，Android提供了两个用于操作Uri的工具类，分别为UriMatcher和ContentUris 。掌握它们的基本概念和使用方法，对一个Android开发者来说是一项必要的技能。

UriMatcher类用于匹配Uri，它的使用步骤如下：

a、将需要匹配的Uri路径进行注册，代码如下：

1 //常量UriMatcher.NO_MATCH表示不匹配任何路径的返回码 2 UriMatcher  sMatcher = new UriMatcher(UriMatcher.NO_MATCH); 3 //如果match()方法匹配“content://com.wang.provider.myprovider/tablename”路径，返回匹配码为1 4 sMatcher.addURI("content://com.wang.provider.myprovider", " tablename ", 1); 5  //如果match()方法匹配content://com.wang.provider.myprovider/tablename/11路径，返回匹配码为2 6 sMatcher.addURI("com.wang.provider.myprovider", "tablename/#", 2);

注意，添加第二个URI时，路径后面的id采用了通配符形式“#”，表示只要前面三个部分都匹配上了就OK。

b、注册完需要匹配的Uri后，可以使用sMatcher.match(Uri)方法对输入的Uri进行匹配，如果匹配就返回对应的匹配码，匹配码为调用addURI()方法时传入的第三个参数。

 1 switch (sMatcher.match(Uri.parse("content://com.zhang.provider.yourprovider/tablename/100"))) {  2    case 1:  3      //match 1, todo something  4      break;  5    case 2  6      //match 2, todo something  7      break;  8    default:  9      //match nothing, todo something 10      break; 11 }

4、ContentUris

ContentUris类用于操作Uri路径后面的ID部分，它有两个比较实用的方法：withAppendedId(Uri uri, long id)和parseId(Uri uri)。

withAppendedId(Uri uri, long id)用于为路径加上ID部分：

1 Uri uri = Uri.parse("content://com.wang.provider.myprovider/tablename"); 2 Uri resultUri = ContentUris.withAppendedId(uri, 10);

parseId(Uri uri)则从路径中获取ID部分：

1 Uri uri = Uri.parse("content://com.zhang.provider.myprovider/tablename/10") 2 long personid = ContentUris.parseId(uri);

5、ContentProvider数据共享

ContentProvider类主要方法的介绍：

public boolean onCreate()，在ContentProvider创建后就会被调用，而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)，返回当前Uri所代表数据的MIME类型；

如果操作的数据属于集合类型，那么MIME类型字符串应该以vnd.android.cursor.dir/开头，如要得到所有tablename记录的Uri为content://com.wang.provider.myprovider/tablename，那么返回的MIME类型字符串应该为：vnd.android.cursor.dir/table。

如果要操作的数据属于非集合类型数据，那么MIME类型字符串应该以vnd.android.cursor.item/开头，如得到id为10的tablename记录，Uri为content://com.wang.provider.myprovider/tablename/10，那么返回的MIME类型字符串为：vnd.android.cursor.item/tablename 。

6、ContentResolver操作数据

当外部应用需要对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和对其中的什么数据进行操作，其实和ContentProvider里面的方法是一样的。他们所对应的数据，最终会被传到我们在之前程序里面定义的那个ContentProvider类的方法，假设给定的是：Uri.parse("content://com.wang.provider.myprovider/tablename/10")，那么将会对主机名为com.wang.provider.myprovider的ContentProvider进行操作，操作的数据为tablename表中id为10的记录。

使用ContentResolver对ContentProvider中的数据进行操作的代码如下：

 1 ContentResolver resolver = getContentResolver();  2 Uri uri = Uri.parse("content://com.wang.provider.myprovider/tablename");  3 //添加一条记录  4 ContentValues values = new ContentValues();  5 values.put("name", "wang1");  6 values.put("age", 28);  7 resolver.insert(uri, values);   8 //获取tablename表中所有记录  9 Cursor cursor = resolver.query(uri, null, null, null, "tablename data"); 10 while(cursor.moveToNext()){ 11    Log.i("ContentTest", "tablename_id="+ cursor.getInt(0)+ ", name="+ cursor.getString(1)); 12 } 13 //把id为1的记录的name字段值更改新为zhang1 14 ContentValues updateValues = new ContentValues(); 15 updateValues.put("name", "zhang1"); 16 Uri updateIdUri = ContentUris.withAppendedId(uri, 2); 17 resolver.update(updateIdUri, updateValues, null, null); 18 //删除id为2的记录，即字段age 19 Uri deleteIdUri = ContentUris.withAppendedId(uri, 2); 20 resolver.delete(deleteIdUri, null, null);

7、监听数据变化

如果ContentProvider的访问者需要知道数据发生的变化，可以在ContentProvider发生数据变化时调用getContentResolver().notifyChange(uri, null)来通知注册在此URI上的访问者。只给出类中监听部分的代码：

1 public class MyProvider extends ContentProvider { 2    public Uri insert(Uri uri, ContentValues values) { 3       db.insert("tablename", "tablenameid", values); 4       getContext().getContentResolver().notifyChange(uri, null); 5    } 6 }

而访问者必须使用ContentObserver对数据（数据采用uri描述）进行监听，当监听到数据变化通知时，系统就会调用ContentObserver的onChange()方法：

 1 getContentResolver().registerContentObserver(Uri.parse("content://com.ljq.providers.personprovider/person"),  2        true, new PersonObserver(new Handler()));  3 public class PersonObserver extends ContentObserver{  4    public PersonObserver(Handler handler) {  5       super(handler);  6    }  7    public void onChange(boolean selfChange) {  8       //to do something  9    } 10 }

8、完整项目代码

a、对于实际测试中的Uri——com.wang.provider.myprovider，需要在AndroidManifest.xml文件中进行说明：

1 <provider android:name="MyProvider" android:authorities="com.wang.provider.myprovider" />

b、定义Profile类，其主要负责定义Uri各组成部分名称对应的String常量：

 1 package com.wang.testcontentprovider;  2   3 import android.net.Uri;    4   5 public class Profile {    6         7     /**   8      * 表格名称   9      */   10     public static final String TABLE_NAME = "tablename";   11        12     /**  13      * 列表一，_ID，自动增加  14      */   15     public static final String COLUMN_ID = "_id";   16        17     /**  18      * 列表二，名称  19      */   20     public static final String COLUMN_NAME = "name";   21         22     public static final String AUTOHORITY = "com.wang.provider.myprovider";   23     public static final int ITEM = 1;   24     public static final int ITEM_ID = 2;   25         26     public static final String CONTENT_TYPE = "vnd.android.cursor.dir/vnd.wang.tablename";   27     public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/vnd.wang.tablename";   28         29     public static final Uri CONTENT_URI = Uri.parse("content://" + AUTOHORITY + "/tablename");   30 }

c、实现存放数据的DBHelper类，继承自SQLiteOpenHelper类，完成数据库的一些常规操作：

 1 package com.wang.testcontentprovider;  2   3 import android.content.Context;    4 import android.database.SQLException;    5 import android.database.sqlite.SQLiteDatabase;    6 import android.database.sqlite.SQLiteOpenHelper;    7     8 public class DBHelper extends SQLiteOpenHelper {    9    10     /**  11      * 数据库名称  12      */   13     private static final String DATABASE_NAME = "test.db";     14        15     /**  16      * 数据库版本  17      */   18     private static final int DATABASE_VERSION = 1;     19    20     public DBHelper(Context context) {   21         super(context, DATABASE_NAME, null, DATABASE_VERSION);   22     }   23    24     @Override   25     public void onCreate(SQLiteDatabase db)  throws SQLException {   26         //创建表格   27         db.execSQL("CREATE TABLE IF NOT EXISTS "+ Profile.TABLE_NAME + "("+ Profile.COLUMN_ID +" INTEGER PRIMARY KEY AUTOINCREMENT," + Profile.COLUMN_NAME +" VARCHAR NOT NULL);");   28     }   29    30     @Override   31     public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion)  throws SQLException {   32         //删除并创建表格   33         db.execSQL("DROP TABLE IF EXISTS "+ Profile.TABLE_NAME+";");   34         onCreate(db);   35     }   36 }

d、MyProvider类的实现，主要负责向ContentProvider中添加数据

 1 package com.wang.testcontentprovider;  2   3 import android.content.ContentProvider;      4 import android.content.ContentUris;      5 import android.content.ContentValues;      6 import android.content.UriMatcher;      7 import android.database.Cursor;      8 import android.database.SQLException;      9 import android.database.sqlite.SQLiteDatabase;     10 import android.net.Uri;     11      12 public class MyProvider extends ContentProvider {     13      14     DBHelper mDbHelper = null;     15     SQLiteDatabase db = null;     16      17     private static final UriMatcher mMatcher;     18     static{     19         mMatcher = new UriMatcher(UriMatcher.NO_MATCH);     20         mMatcher.addURI(Profile.AUTOHORITY,Profile.TABLE_NAME, Profile.ITEM);     21         mMatcher.addURI(Profile.AUTOHORITY, Profile.TABLE_NAME+"/#", Profile.ITEM_ID);     22     }     23      24     @Override     25     public int delete(Uri uri, String selection, String[] selectionArgs) {     26         // TODO Auto-generated method stub     27         return 0;     28     }     29      30     @Override     31     public String getType(Uri uri) {     32         switch (mMatcher.match(uri)) {     33         case Profile.ITEM:     34             return Profile.CONTENT_TYPE;     35         case Profile.ITEM_ID:     36             return Profile.CONTENT_ITEM_TYPE;     37         default:     38             throw new IllegalArgumentException("Unknown URI"+uri);     39         }     40     }     41      42     @Override     43     public Uri insert(Uri uri, ContentValues values) {     44         // TODO Auto-generated method stub     45         long rowId;     46         if(mMatcher.match(uri)!=Profile.ITEM){     47             throw new IllegalArgumentException("Unknown URI"+uri);     48         }     49         rowId = db.insert(Profile.TABLE_NAME,null,values);     50         if(rowId>0){     51             Uri noteUri=ContentUris.withAppendedId(Profile.CONTENT_URI, rowId);     52             getContext().getContentResolver().notifyChange(noteUri, null);     53             return noteUri;     54         }     55      56         throw new SQLException("Failed to insert row into " + uri);     57     }     58      59     @Override     60     public boolean onCreate() {     61         // TODO Auto-generated method stub     62         mDbHelper = new DBHelper(getContext());     63      64         db = mDbHelper.getReadableDatabase();     65      66         return true;     67     }     68      69     @Override     70     public Cursor query(Uri uri, String[] projection, String selection,     71             String[] selectionArgs, String sortOrder) {     72         // TODO Auto-generated method stub     73         Cursor c = null;     74         switch (mMatcher.match(uri)) {     75         case Profile.ITEM:     76             c =  db.query(Profile.TABLE_NAME, projection, selection, selectionArgs, null, null, sortOrder);     77             break;     78         case Profile.ITEM_ID:     79             c = db.query(Profile.TABLE_NAME, projection,Profile.COLUMN_ID + "="+uri.getLastPathSegment(), selectionArgs, null, null, sortOrder);     80             break;     81         default:     82             throw new IllegalArgumentException("Unknown URI"+uri);     83         }     84      85         c.setNotificationUri(getContext().getContentResolver(), uri);     86         return c;     87     }     88      89     @Override     90     public int update(Uri uri, ContentValues values, String selection,     91             String[] selectionArgs) {     92         // TODO Auto-generated method stub     93         return 0;     94     }     95      96 }

e、作为主程序的MainActivity类，对ContentProvider中的数据进行获取，并在界面上进行简单的显示：

 1 package com.wang.testcontentprovider;  2   3 import android.support.v7.app.ActionBarActivity;  4 import android.os.Bundle;  5 import android.view.Menu;  6 import android.view.MenuItem;  7   8 import android.app.ListActivity;    9 import android.content.ContentResolver;   10 import android.content.ContentUris;   11 import android.content.ContentValues;   12 import android.database.Cursor;   13 import android.database.SQLException;   14 import android.database.sqlite.SQLiteDatabase;   15 import android.net.Uri;   16 import android.widget.SimpleCursorAdapter;   17    18 public class MainActivity extends ListActivity {   19     private SimpleCursorAdapter adapter= null;   20     private Cursor mCursor = null;   21     private ContentResolver mContentResolver = null;   22    23     @Override   24     public void onCreate(Bundle savedInstanceState) {   25         super.onCreate(savedInstanceState);   26         initData();   27         initAdapter();   28     }   29    30     public void initData(){   31         mContentResolver = getContentResolver();   32         for (int i = 0; i < 100; i++) {   33             ContentValues values = new ContentValues();   34             values.put(Profile.COLUMN_NAME, "Wang "+i);   35             mContentResolver.insert(Profile.CONTENT_URI, values);   36         }   37     }   38    39     public void initAdapter(){   40         mCursor = mContentResolver.query(Profile.CONTENT_URI, new String[]{Profile.COLUMN_ID,Profile.COLUMN_NAME}, null, null, null);   41    42         startManagingCursor(mCursor);   43    44         //设置adapter   45         adapter = new SimpleCursorAdapter(this, android.R.layout.simple_list_item_2, mCursor, new String[]{Profile.COLUMN_ID,Profile.COLUMN_NAME}, new int[]{android.R.id.text1,android.R.id.text2});   46         setListAdapter(adapter);   47     }   48    49     @Override   50     public boolean onCreateOptionsMenu(Menu menu) {   51         getMenuInflater().inflate(R.menu.main, menu);   52         return true;   53     }   54    55 }

9、结果分析

先贴上一张不太美观的结果图：

ContentProvider数据访问详解

正文到此结束
所属分类： 编程技术

热门推荐

相关文章

阿里云首购8折
说给你听

本文目录
随机标签
书籍教程
springboot-demo Java入门教程 bootstrap3 CSS Apache基础教程 php ionic 教程 Python mysql教程 eclipse Ubuntu VPS系统配置 AngularJS 教程 MongoDB教程 Struts2教程 Redis教程 Spring教程 Git教程 Jenkins进阶系列 openfire参考指南 Java设计模式 HBase教程 java-demo Maven教程 springcloud-demo hibernate教程 Docker 教程 memcached教程 Quartz指南 Hive教程 ANTLR教程 SpringCloud Ant教程 java实例教程 Hazelcast教程 XStream教程 Elastic-Job-Lite 深入浅出MyBatis ibaties教程 SVN教程 rabittmq教程 Hadoop教程 solr教程 WebService CXF学习 JPA教程 ActiveMQ中文指南 Java内存模型 dubbo教程 python3-demo Linux入门视频教程
近期评论
  1. 1 使用 Docker 打包和运行 Vue 应用
  2. 2 Dependency Check命令行方式扫描jar包的安全漏洞
  3. 3 maven使用Dependency-Check来扫描安全漏洞
  4. 4 使用sonarqube分析代码质量
  5. 5 使用screw来对比数据库表和字段差异
  6. 6 Spring Boot 实现防盗链功能
  7. 7 在Spring Boot中的实现国际化（i18n）
  8. 8 一个用于 SMB/CIFS 网络的 Java 库-JCIFS
  9. 9 Spring Boot 3.x嵌入MongoDB 进行测试
  10. 10 java如何解析和生成yaml文件？
网站信息
  • 文章总数：82,737 篇
  • 文件总数：284,312 个
  • 标签总数：2,416 个
  • 分类总数：85 个
  • 留言数量：2,558 条
  • 在线人数：686 人
  • 运行天数：4,438天
  • 最后更新：2024年12月21日23点
Loading...

其他链接

关于本站

本站定位：个人技术类博客

本站作用：写博客、记日志、闲聊扯淡鼓捣技术。

问题交流

[HBLOG]公众号 HBLOG HBLOG