运维开发网

Android开发之ContentProvider的使用详解

运维开发网 https://www.qedev.com 2020-02-09 17:14 出处:网络 作者: 网络整理
本篇文章介绍了Android开发之ContentProvider的使用详解。需要的朋友参考下
前言        

  Content Provider为存储数据和获取数据提供了统一的接口,它可以完成在不同应用程序下的数据共享,而在上一篇文章Android开发之SQLite的使用方法讲到的SQLite只能在同一个程序中共享数据。另外android为一些常见的数据,比如说音频,视频,图片,通讯录等提供了Content Provider,这样我们就可以很方便的对这些类型的数据操作了。使用ContentProvider的好处是开发人员不需要考虑数据内部是怎么存储的,比如说如果我们想利用ContenProvider来存数据,只需告诉insert函数该ContentProvider的uri和想存入的数据(包括列名和数值),查询时也是一样,只需输入Uri和查询的表,列名和查询条件,至于ContentProvider里面是怎么进行这些操作的我们不需要知道。

  实验基础

  在了解本实验的内容,需要用到下面这几个跟ContentProvider有关的类。

  UriMatcher:

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

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

  ContentResolver :

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

  SQLiteQueryBuilder:

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

  实验过程

  本文通过一个实例来实现一个ContentProvider,其实一般情况下我们是不需要自己来实现的,而是使用andorid内置的ContentProvider,但是自己实现一个以后,对它的原理能更深刻的认识,以后使用内置的就得心应手了。这是mars老师的话,本人火候不够,暂时还没深刻的体会。Mars老师将实现ContentProvider的步骤总结为如下:

  

 

 

  程序中需要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标签外加入如下声明即可:

<provider android:name="com.example.cptest.FirstContentProvider" android:authorities="com.example.cptest.FirstContentProvider" />

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

MainActivity.java:

复制代码 代码如下:

package com.example.cptest;

//import com.example.cptest.FirstProviderMetaData;

import com.example.cptest.FirstProviderMetaData.UserTableMetaData;

import android.app.Activity;

import android.content.ContentValues;

import android.database.Cursor;

import android.net.Uri;

import android.os.Bundle;

import android.view.Menu;

import android.view.View;

import android.view.View.OnClickListener;

import android.widget.Button;

public class MainActivity extends Activity {

    private Button insert = null;

    private Button query = null;

    @Override

    public void onCreate(Bundle savedInstanceState) {

        super.onCreate(savedInstanceState);

        setContentView(R.layout.activity_main);

        insert = (Button)findViewById(R.id.insert);

        insert.setOnClickListener(new InsertOnClickListener());

        query = (Button)findViewById(R.id.query);

        query.setOnClickListener(new QueryOnClickListener());

        System.out.println(getContentResolver().getType(FirstProviderMetaData.UserTableMetaData.CONTENT_URI));

    }

    //往子表中插入一条记录

    public class InsertOnClickListener implements OnClickListener{

        public void onClick(View arg0) {

            // TODO Auto-generated method stub   

            ContentValues values = new ContentValues();

            values.put(FirstProviderMetaData.UserTableMetaData.USER_NAME, "tornadomeet");

            //实际上使用的是ContentResolver的insert方法

            //该insert中有2个参数,第一个为代表了ContentProvider的Uri,第二个参数为要插入的值。此处的insert函数

            //一执行,则自动调用ContentProvider的insert方法。

            Uri uri = getContentResolver().insert(FirstProviderMetaData.UserTableMetaData.CONTENT_URI,

                    values);

            System.out.println("uri--->" +uri.toString());

        }       

    }

   

    //查询也是采用的ContentResolver中的query方法。

    public class QueryOnClickListener implements OnClickListener{

        public void onClick(View v) {

            // TODO Auto-generated method stub       

            Cursor c = getContentResolver().query(FirstProviderMetaData.UserTableMetaData.CONTENT_URI,

                    null, null, null, null);

            while(c.moveToNext())

                System.out.println(c.getString(c.getColumnIndex(UserTableMetaData.USER_NAME)));

        }    

    }

    @Override

    public boolean onCreateOptionsMenu(Menu menu) {

        getMenuInflater().inflate(R.menu.activity_main, menu);

        return true;

    }

}

DatabaseHelper:

复制代码 代码如下:

package com.example.cptest;

import android.content.Context;

import android.database.sqlite.SQLiteDatabase;

import android.database.sqlite.SQLiteOpenHelper;

import android.database.sqlite.SQLiteDatabase.CursorFactory;

public class DatabaseHelper extends SQLiteOpenHelper {

    private static final int  VERSON = 1;//默认的数据库版本

    //继承SQLiteOpenHelper类的类必须有自己的构造函数

    //该构造函数4个参数,直接调用父类的构造函数。其中第一个参数为该类本身;第二个参数为数据库的名字;

    //第3个参数是用来设置游标对象的,这里一般设置为null;参数四是数据库的版本号。

    public DatabaseHelper(Context context, String name, CursorFactory factory, int verson){

        super(context, name, factory, verson);

    }

    //该构造函数有3个参数,因为它把上面函数的第3个参数固定为null了

    public DatabaseHelper(Context context, String name, int verson){

        this(context, name, null, verson);

    }

    //该构造函数只有2个参数,在上面函数 的基础山将版本号固定了

    public DatabaseHelper(Context context, String name){

        this(context, name, VERSON);

    }

    //该函数在数据库第一次被建立时调用

    @Override

    public void onCreate(SQLiteDatabase arg0) {

        // TODO Auto-generated method stub

        System.out.println("create a database");

        //execSQL()为执行参数里面的SQL语句,因此参数中的语句需要符合SQL语法,这里是创建一个表

        //arg0.execSQL("create table user1(id int, name varchar(20))");下面的语句格式是与该句类似

//        arg0.execSQL("create table" + FirstProviderMetaData.USERS_TABLE_NAME

//                + "(" + FirstProviderMetaData.UserTableMetaData._ID

//                + " INTEGER PRIMARY KEY AUTOINCREMENT," +   //ID类型为自增长的整型

//                FirstProviderMetaData.UserTableMetaData.USER_NAME + " varchar(20));"

//                );

    //    arg0.execSQL("create table user1(id int, name varchar(20))");

        arg0.execSQL("create table" + FirstProviderMetaData.USERS_TABLE_NAME + "("

                + FirstProviderMetaData.UserTableMetaData._ID + " INTEGER PRIMARY KEY AUTOINCREMENT, "

                +FirstProviderMetaData.UserTableMetaData.USER_NAME + " varchar(20))");

        System.out.println("create a database ok");

    }

    @Override

    public void onUpgrade(SQLiteDatabase arg0, int arg1, int arg2) {

        // TODO Auto-generated method stub

        System.out.println("update a database");

    }

}

FirstProviderMetaData.java:

复制代码 代码如下:

package com.example.cptest;

import android.net.Uri;

import android.provider.BaseColumns;

public class FirstProviderMetaData {

    //这里的AUTHORTY为包的全名+ContentProvider子类的全名

    public static final String AUTHORTY = "com.example.cptest.FirstContentProvider";

    //数据库的名称

    public static final String DATABASE_NAME = "FisrtProvider.db";

    //数据库的版本号

    public static final int DATABASE_VERSION = 1;

    //数据库中的表名

    public static final String USERS_TABLE_NAME = "users";

    //表中的字表

    public static final class UserTableMetaData implements BaseColumns{

        //子表名

        public static final String TABLE_NAME = "users";

        //CONTENT_URI为常量Uri; parse是将文本转换成Uri

        public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORTY + "/users");

        //返回ContentProvider中表的数据类型

        public static final String CONTENT_TYPE = "vnd.android.cursor.dir/vnd.firstprovider.user";

        //返回ContentProvider表中item的数据类型

        public static final String CONTENT_TYPE_ITEM = "vnd.android.cursor.item/vnd.firstprovider.user";

        //子表列名

        public static final String USER_NAME = "name";

        //表中记录的默认排序算法,这里是降序排列

        public static final String DEFAULT_SORT_ORDER = "_id desc";

       

    }

}

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;

    }

}

0

精彩评论

暂无评论...
验证码 换一张
取 消