Android数据存储(四)---ContentProvider

转载 2017年08月30日 10:05:27

           Content Provider为存储数据和获取数据提供了统一的接口,它可以完成在不同应用程序下的数据共享,而SQLite只能在同一个程序中共享数据。另外Android为一些常见的数据,比如说音频,视频,图片,通讯录等提供了Content Provider,这样我们就可以很方便的对这些类型的数据操作了。

      使用ContentProvider的好处是开发人员不需要考虑数据内部是怎么存储的,比如说如果我们想利用ContenProvider来存数据,只需告诉insert函数该ContentProvider的uri和想存入的数据(包括列名和数值),查询时也是一样,只需输入Uri和查询的表,列名和查询条件,至于ContentProvider里面是怎么进行这些操作的我们不需要知道。

      一个程序可以通过实现一个ContentProvider的抽象接口将自己的数据完全暴露出去,而且ContentProvider是以类似数据库中表的方式将数据暴露的。那么外界获取其提供的数据,也就应该与从数据库中获取数据的操作基本一样,只不过是采用URL来表示外界需要访问的“数据库”。

ContentProvider提供了一种多应用间数据共享的方式。

ContentProvider是个实现了一组用于提供其他应用程序存取数据的标准方法的类。应用程序可以在ContentProvider中执行如下操作:查询数据、修改数据、添加数据、删除数据。

标准的ContentProvider:Android提供了一些已经在系统中实现的标准ContentProvider,比如联系人信息,图片库等等,可以用这些ContentProvider来访问设备上存储的联系人信息、图片等等。

在ContentProvider中使用的查询字符串有别于标准的SQL查询,很多诸如select、add、delete、modify等操作都使用一种特殊的URL进行,这种URL由3部分组成,“content://”,代表数据的路径和一个可选的表示数据的ID。

content://media/internal/images 这个URL将返回设备上存储的所有图片

content://contacts/people/ 这个URL将返回设备上的所有联系人信息

content://contacts/people/45 这个URL返回单个结果(联系人信息中ID为45的联系人记录)


 如果想要存储字节型数据,比如位图文件等,那保存该数据的数据列其实是一个表示实际保存保存文件的URL字符串,客户端通过它来读取对应的文件数据,处理这种数据类型的ContentProvider需要实现一个名为_data的字段,_data字段列出了该文件在Android文件系统上的精确路径。这个字段不仅是供客户端使用,而且也可以供ContentResolver使用。客户端可以调用ContentResolver.openOutputStream()方法来处理该URL指向的文件资源,如果是ContentResolver本身的话,由于其持有的权限比客户端要高,所以它能直接访问该数据文件。


需要用到下面这几个跟ContentProvider有关的类。

UriMatcher:

要了解UriMatcher,首先需要了解android中的Uri表示方法,众所周知,Uri为通用资源标识符,它代表的是要操作的数据,Android中的每一种资源(比如文本,图像,视频等)都可以用Uri来表示。Android中的Uri由以下三部分组成:”content://”(即authory),数据的路径,资源标识ID(可选),其中如果存在ID,则表示某一个具体的资源,如果不存在ID,则表示路径下的整体。因此addUri()函数的3个参数也是对应上面的那3个。

UriMatcher的匹配过程分为3步,初始化UriMatcher;注册需要用的Uri;与已经注册的Uri进行匹配。

来自http://blog.csdn.NET/feng88724/article/details/6331396中关于这部分有下面介绍。

UriMatcher 类主要用于匹配Uri.使用方法如下。

首先第一步,初始化:

第二步注册需要的Uri:
第三部,与已经注册的Uri进行匹配:

match方法匹配后会返回一个匹配码Code,即在使用注册方法addURI时传入的第三个参数。

  上述方法会返回"vnd.android.cursor.dir/person".

 总结: 

--常量 UriMatcher.NO_MATCH 表示不匹配任何路径的返回码

--# 号为通配符

--* 号为任意字符

另外说一下,官方SDK说明中关于Uri的注册是这样写的:

这个说明估计已经是Google官方没有更新,首先是初始化方法,没有传参,那么现在初始化时,实际是必须传参的。 可以看一下Android2.2的源码,无参数的构造方法已经是private的了。

另外就是addURI这个方法,第二个参数开始时不需要"/", 否则是无法匹配成功的

ContentUris

ContentUris 类用于获取Uri路径后面的ID部分

1)为路径加上ID: withAppendedId(uri, id)

比如有这样一个Uri

通过withAppendedId方法,为该Uri加上ID


最后resultUri为: content://com.lwj/people/10

2)从路径中获取ID: parseId(uri) 

最后personid 为 :10

ContentResolver :

  当使用ContentProvider在不同的应用程序中共享数据时,其数据的暴露方式是采取类似数据库中表的方法。而ContentResolver 是恰好是采用类似数据库的方法来从ContentProvider中存取数据的,它是通过Uri来查询ContentProvider中提供的数据,查询时,还需知道目的数据库的名称,数据段的数据类型,或者说资源的ID。

 

  SQLiteQueryBuilder:

  SQLiteQueryBuilder是一个用来生产SQL查询语句的辅助类,可以方便的去访问SQLiteDatabase. 在构造SQL查询语句时,它同样也需要指定表名,指定列名,指定where条件等。

实验内容:实现ContentProvider步骤

1、定义一个CONTENT_URL常量

2、定义一个类,继承ContentProvider

3、实现query,insert,update,delete,getType,onCreate方法

4、在androidMainfext.xml中进行声明

程序中需要4个Java文件,下面就分别来介绍实现这些类需注意的事项:

  FirstProviderMetaData类:

  因为在继承类FirstContentProvider得到的子类中要用到很多常量,所以这里我们新建了一个类专门用来存储这些常量的,该类这里取名为FirstProviderMetaData,里面存着authorty名,数据库名,数据库版本号,表名,字表名,子表Uri,子表ContentProvider数据类型等等。其中字表是继承BaseColumns类的,而BaseColumns类中已经有_ID和_COUNT这2列了。

 

  DatabaseHelper类:

  与android中使用SQLite类似,这里同样需要一个继承SQLiteOpenHelper的子类,子类名为DatabaseHelper,我们在子类的回调函数onCreate()中建立了一个表,表名和表中的列名都是引用FirstProviderMetaData类中定义好了的常量的。

 

  FirstContentProvider类:

  新建一个类,名为FirstContentProvider,继承类ContentProvider这个类,且必须重写父类的下面5个方法,否则会报错。这5个方法分别为onCreate(), getType(), insert(), update(), delete().

  onCreate()为回调函数,是指当ContentProvider创建的时候调用,本程序在该函数中使用DatabaseHelper新建了一个SQLite数据库。

  在getType()方法完成的功能是根据传入的Uri,返回该Uri所表示的数据类型。函数内部是使用的UriMatcher来匹配该函数所传进来的参数,来得到其数据类型。

  insert()函数给指定的数据库表中插入一个指定的值,插入完成后必然会生成一个新的记录,然后利用该记录和表的Uri重新生成一个新的Uri,这个Uri就代表了插入成功的那条记录的Uri,该函数返回的也是这个Uri。

 

  MainActivity类:

  在MainActivity中,主要是有2个按钮,分为为它们绑定了监听器,来完成插入和查询操作。

  当单击插入按钮时,在监听器函数中会首先得到一个ContentResolver,然后当在执行ContentResolver的insert方法时会自动调用ContentProvider的insert方法,因为ContentResolver的insert方法中的第一个参数就为某个ContentProvider的Uri。

 

  AndroidManifest.xml:

  ContentProvider的使用需要在AndroidManifest.xml中进行注册,在activity标签外加入如下声明即可:



实验主要部分代码及注释:

MainActivity.java:


DatabaseHelper: 


FirstProviderMetaData.java:
FirstContentProvider.java:
package com.example.cptest;  
  
import java.util.HashMap;  
  
import android.content.ContentProvider;  
import android.content.ContentUris;  
import android.content.ContentValues;  
import android.content.UriMatcher;  
import android.database.Cursor;  
import android.database.SQLException;  
import android.database.sqlite.SQLiteDatabase;  
import android.database.sqlite.SQLiteQueryBuilder;  
import android.net.Uri;  
import android.text.TextUtils;  
  
import com.example.cptest.FirstProviderMetaData.UserTableMetaData;  
  
public class FirstContentProvider extends ContentProvider {  
  
    //定义一个UriMatcher类对象,用来匹配Uri的。  
    public static final UriMatcher uriMatcher;  
    //组时的ID  
    public static final int INCOMING_USER_COLLECTION = 1;  
    //单个时的ID  
    public static final int INCOMING_USER_SIGNAL = 2;  
    private DatabaseHelper dh;//定义一个DatabaseHelper对象  
    static{  
        uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);//UriMatcher.NO_MATCH表示不匹配任何路径的返回码  
        uriMatcher.addURI(FirstProviderMetaData.AUTHORTY, "users", INCOMING_USER_COLLECTION);  
        uriMatcher.addURI(FirstProviderMetaData.AUTHORTY, "users/#", INCOMING_USER_SIGNAL);//后面加了#表示为单个  
    }  
      
    public static HashMap<String, String> userProjectionMap;//新建一个HashMap,后面执行插入操作时有用  
    static  
    {  
        userProjectionMap = new HashMap<String, String>();  
        //这里可以直接调用另外一个类的public变量,这里put里面的2个参数一样,  
        //是因为这里是给数据库表中的列取别名,因此取的是一样的名字  
        userProjectionMap.put(UserTableMetaData._ID, UserTableMetaData._ID);  
        userProjectionMap.put(UserTableMetaData.USER_NAME, UserTableMetaData.USER_NAME);  
    }  
      
    //得到ContentProvider的数据类型,返回的参数Uri所代表的数据类型  
    @Override  
    public String getType(Uri arg0) {  
        // TODO Auto-generated method stub  
        System.out.println("getType");  
        switch(uriMatcher.match(arg0)){  
        //matcher满足Uri的前2项(即协议+路径)为第1种情况时,switch语句的值为Uri的第3项,此处为INCOMING_USER_COLLECTION  
        case INCOMING_USER_COLLECTION:  
            return UserTableMetaData.CONTENT_TYPE;  
        case INCOMING_USER_SIGNAL://同上  
            return UserTableMetaData.CONTENT_TYPE_ITEM;  
        default:  
            throw new IllegalArgumentException("Unknown URI" + arg0);//throw是处理异常的,java中的语法  
        }  
    }  
  
    @Override  
    public int delete(Uri uri, String selection, String[] selectionArgs) {  
        // TODO Auto-generated method stub  
        System.out.println("delete");  
        return 0;  
    }  
  
    @Override  
    public int update(Uri uri, ContentValues values, String selection,  
            String[] selectionArgs) {  
        // TODO Auto-generated method stub  
        System.out.println("update");  
        return 0;  
    }  
  
    @Override  
    public Uri insert(Uri uri, ContentValues values) {  
        // TODO Auto-generated method stub  
        System.out.println("insert");  
//        dh = new DatabaseHelper(getContext(), FirstProviderMetaData.DATABASE_NAME);  
        SQLiteDatabase db = dh.getWritableDatabase();  
        long rowId = db.insert(UserTableMetaData.TABLE_NAME, null, values);  
//        System.out.println("insert  OK");  
//        System.out.println("" + rowId);  
        if(rowId > 0){              
            //发出通知给监听器,说明数据已经改变  
            //ContentUris为工具类  
            Uri insertedUserUri = ContentUris.withAppendedId(UserTableMetaData.CONTENT_URI, rowId);  
            getContext().getContentResolver().notifyChange(insertedUserUri, null);  
              
            return insertedUserUri;  
        }  
        throw new SQLException("Failed to insert row into" + uri);  
    }  
  
    //回调函数,在ContentProvider创建的时候调用  
    @Override  
    public boolean onCreate() {  
        // TODO Auto-generated method stub  
        System.out.println("onCreate");  
        dh = new DatabaseHelper(getContext(), FirstProviderMetaData.DATABASE_NAME);//创建1个DatabaseHelper对象  
        return true;  
    }  
  
    @Override  
    public Cursor query(Uri uri, String[] projection, String selection,  
            String[] selectionArgs, String sortOrder) {  
        // TODO Auto-generated method stub  
        System.out.println("query");  
        SQLiteQueryBuilder qb = new SQLiteQueryBuilder();  
        switch(uriMatcher.match(uri)){  
        case INCOMING_USER_COLLECTION:  
            qb.setTables(UserTableMetaData.TABLE_NAME);//设置表的名称  
            qb.setProjectionMap(userProjectionMap);//其中userProjectionMap为上面建立好了的hashmap  
            break;  
        case INCOMING_USER_SIGNAL:  
            qb.setTables(UserTableMetaData.TABLE_NAME);//设置表的名称  
            qb.setProjectionMap(userProjectionMap);//其中userProjectionMap为上面建立好了的hashmap  
            //uri.getPathSegments()得到Path部分,即把uri的协议+authory部分去掉,把剩下的部分分段获取,这里取第  
            //一部分  
            qb.appendWhere(UserTableMetaData._ID + "=" +uri.getPathSegments().get(1));//设置where条件  
            break;  
        }  
        //排序  
        String orderBy;  
        if(TextUtils.isEmpty(sortOrder)){  
            orderBy = UserTableMetaData.DEFAULT_SORT_ORDER;//传入的排序参数为空的时候采用默认的排序  
        }  
        else{  
            orderBy = sortOrder;//不为空时用指定的排序方法进行排序  
        }  
        SQLiteDatabase db = dh.getWritableDatabase();  
        //采用传入的参数进行查询  
        Cursor c = qb.query(db, projection, selection, selectionArgs, null, null, sortOrder);  
        //发出通知  
        c.setNotificationUri(getContext().getContentResolver(), uri);  
        return c;  
    }  
  
} 



相关文章推荐

Android中5大数据存储(四)---ContentProvider

在Android中,每一个应用程序的数据都是采取私有的形式进行操作,不管这些数据是用文件还是数据库保存,都不能被外部应用程序所访问。但是咋很多情况下,用户需要可以在不同的应用程序之间进行交换的数据,所...

传智播客—Android(四)数据存储之四ContentProvider

 一、ContentProvider简介       当应用继承ContentProvider类,并重写该类用于提供数据和存储数据的方法,就可以向其他应用共享其数据。虽然使用其他方法也可以对外共享数据...

android 数据存储和访问方式四:ContentProvider(内容提供者、数据共享)详解

一、使用ContentProvider 当应用继承ContentProvider类并重写该类用于提供数据和存储数据的方法时,就可以向其他应用共享其数据。前面我们学习过文件的操作模式,通过指定文件的操...

Android 数据存储详解(SharedPreferences, 文件, Sqlite, ContentProvider)

文章大部分内容来自 < < Android开发全程实录 > >, 希望大家能看看原书 SharedPreferences sharepreferences是Android中最轻量级的数据存储. 原...

Android数据存储方式之:ContentProvider

ContentProvider是Android的四大组件之一,可见其重要性。我们使用到ContentProvider时,也要同Activity等其它组件一样,在AndroidManifest.xml中...
  • true100
  • true100
  • 2015年03月28日 11:09
  • 588

【Android数据存储】ContentProvider详细介绍(附实例源码)

1.ContentProvider是什么?     ContentProvider——内容提供者。它是一个类,这个类主要是对Android系统中进行共享的数据进行包装,并提供了一组统一的访问...

Android数据存储方式:SharePreference、SQLite、ContentProvider有什么不同?

在Android中一共提供了4种数据存储方式,由于Android中数据基本是私有的,如果需要在其他应用程序中使用这些数据,就要使用Android提供的ContentProviders。 Androi...

android中数据存储的contentprovider的使用方法

元数据接口 package com.example.contentproviderprojecrt; import android.net.Uri; import android.provider.B...

Android-数据存储(Content Provider ,调用系统 联系人 ContentProvider实现查询和增加联系人)

1.回顾    上篇学习了 安卓的 文件存储 ,包括  存储在 sd卡上; 2.重点    (1)了解 四大组件之一 Content Provider    (2)实现 查询通信录中 ...

android数据存储与访问之使用ContentProvider

ContentProvider简介及其好处 简介: ContentProvider 在android中的作用是对外共享数据,也就是说你可以通过ContentProvider把应用中的数...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:Android数据存储(四)---ContentProvider
举报原因:
原因补充:

(最多只允许输入30个字)