android基础学习12——内容提供者ContentProvider的使用

内容提供者（ContentProvider）是Android系统四大组件之一，用于保存和检索数据，是Android系统中不同应用程序之间共享数据的接口。在Android系统中，应用程序之间是相互独立的，分别运行在自己的进程中，相互之间没有数据交换。若应用程序之间需要共享数据，就需要用到ContentProvider。ContentProvider是不同应用程序之间进行数据交换的标准API，它以Uri的形式对外提供数据，允许其他应用操作本应用数据。其他应用则使用ContentResolver，并根据ContentProvider提供的Uri操作指定数据。接下来通过一个案例“读取联系人信息”使用内容提供者暴露数据。该案例实现了查询自己暴露的数据，并将数据捆绑到ListView控件中的功能。

activity.xml

<?xml version="1.0" encoding="utf-8"?><LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"    xmlns:tools="http://schemas.android.com/tools"    android:id="@+id/ll_root"    android:layout_width="match_parent"    android:layout_height="match_parent"    tools:context="com.example.lenovo.contentprovider.MainActivity">    <ListView        android:id="@+id/lv"        android:layout_width="match_parent"        android:layout_height="match_parent">    </ListView></LinearLayout>

在layout文件夹下创建一个list_item.xml文件

<?xml version="1.0" encoding="utf-8"?><LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"    android:layout_width="match_parent"    android:layout_height="60dip"    android:gravity="center_vertical"    android:orientation="horizontal">    <ImageView        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:layout_marginLeft="5dip"        android:src="@drawable/default_avatar"/>    <LinearLayout        android:layout_width="fill_parent"        android:layout_height="60dip"        android:layout_marginLeft="20dip"        android:gravity="center_vertical"        android:orientation="vertical">        <TextView            android:id="@+id/tv_name"            android:layout_width="wrap_content"            android:layout_height="wrap_content"            android:layout_marginLeft="5dip"            android:text="姓名"            android:textColor="#000000"            android:textSize="18sp"/>        <TextView            android:id="@+id/tv_phone"            android:layout_width="wrap_content"            android:layout_height="wrap_content"            android:layout_marginLeft="5dip"            android:layout_marginTop="3dp"            android:text="电话"            android:textColor="#88000000"            android:textSize="16sp" />    </LinearLayout></LinearLayout>

在drawble文件夹下添加一张名为default_avater的图片作为联系人的图片

创建数据库

package com.example.lenovo.contentprovider;import android.content.Context;import android.database.sqlite.SQLiteDatabase;import android.database.sqlite.SQLiteOpenHelper;import android.util.Log;/** * Created by lenovo on 2017/6/8. */public class PersonSQLiteOpenHelper extends SQLiteOpenHelper {    private static final String TAG="PersonSQLiteOpenHelper";    //数据库的构造方法，用来定义数据库的名称、数据库查询的结果集、数据库的版本    public PersonSQLiteOpenHelper(Context context){    super(context,"person.db",null,3);    }    //数据库第一次被创建的时候调用的方法    public void onCreate(SQLiteDatabase db){        //初始化数据库的表结构        db.execSQL("create table person(id integer primary key autoincrement,name varchar(20),number varchar(20))");    }    //当数据库的版本号发生变化的时候（增加的时候）调用    public void onUpgrade(SQLiteDatabase db,int oldVersion,int newVersion){        Log.i(TAG,"数据库的版本变化了......");    }}

创建Person类，用于封装id、name和number属性

package com.example.lenovo.contentprovider;/** * Created by lenovo on 2017/6/8. */public class Person {    private int id;    private String name;    private String number;    public Person() {    }    public String toString() {        return "Person [id=" + id + ", name=" + name + ", number=" + number                + "]";    }    public Person(int id, String name, String number) {        this.id = id;        this.name = name;        this.number = number;    }    public int getId() {        return id;    }    public void setId(int id) {        this.id = id;    }    public String getName() {        return name;    }    public void setName(String name) {        this.name = name;    }    public String getNumber() {        return number;    }    public void setNumber(String number) {        this.number = number;    }}

创建内容提供者

创建PersonDBProvider类继承ContentProvider，用于实现暴露数据库程序的功能

package com.example.lenovo.contentprovider;import android.content.ContentProvider;import android.content.ContentUris;import android.content.ContentValues;import android.content.UriMatcher;import android.database.Cursor;import android.database.sqlite.SQLiteDatabase;import android.net.Uri;/** * Created by lenovo on 2017/6/8. */public class PersonDBProvider extends ContentProvider {    // 定义一个uri的匹配器 用于匹配uri 如果路径不满足条件 返回 -1    private static UriMatcher matcher = new UriMatcher(UriMatcher.NO_MATCH);    private static final int INSERT = 1;    //添加数据匹配Uri路径成功时返回码    private static final int DELETE = 2;    //删除数据匹配Uri路径成功时返回码    private static final int UPDATE = 3;    //更改数据匹配Uri路径成功时返回码    private static final int QUERY = 4;     //查询数据匹配Uri路径成功时返回码    private static final int QUERYONE = 5; //查询一条数据匹配Uri路径成功时返回码    //数据库操作类的对象    private PersonSQLiteOpenHelper helper;    static {        // 添加一组匹配规则.        matcher.addURI("com.example.lenovo.db.personprovider", "insert", INSERT);        matcher.addURI("com.example.lenovo.db.personprovider", "delete", DELETE);        matcher.addURI("com.example.lenovo.db.personprovider", "update", UPDATE);        matcher.addURI("com.example.lenovo.db.personprovider", "query", QUERY);        //这里的“#”号为通配符凡是符合”query/”皆返回QUERYONE的返回码        matcher.addURI("com.example.lenovo.contentprovider.personprovider", "query/#", QUERYONE);    }    //当内容提供者被创建的时候 调用 适合 数据的初始化    public boolean onCreate() {        helper = new PersonSQLiteOpenHelper(getContext());        return false;    }    //查询数据操作    public Cursor query(Uri uri, String[] projection, String selection,                        String[] selectionArgs, String sortOrder) {        if (matcher.match(uri) == QUERY) { //匹配查询的Uri路径            //匹配成功 ,返回查询的结果集            SQLiteDatabase db = helper.getReadableDatabase();            //调用数据库操作的查询数据的方法            Cursor cursor = db.query("person", projection, selection,                    selectionArgs, null, null, sortOrder);            return cursor;        } else if (matcher.match(uri) == QUERYONE) {            //匹配成功,根据id查询数据            long id = ContentUris.parseId(uri);            SQLiteDatabase db = helper.getReadableDatabase();            Cursor cursor = db.query("person", projection, "id=?",                    new String[]{id+""}, null, null, sortOrder);            return cursor;        } else {            throw new IllegalArgumentException("路径不匹配,不能执行查询操作");        }    }    //获取当前Uri的数据类型    public String getType(Uri uri) {        if (matcher.match(uri) == QUERY) {            // 返回查询的结果集            return "vnd.android.cursor.dir/person";        } else if (matcher.match(uri) == QUERYONE) {            return "vnd.android.cursor.item/person";        }        return null;    }    //添加数据    public Uri insert(Uri uri, ContentValues values) {        if (matcher.match(uri) == INSERT) {            //匹配成功 返回查询的结果集            SQLiteDatabase db = helper.getWritableDatabase();            db.insert("person", null, values);        } else {            throw new IllegalArgumentException("路径不匹配,不能执行插入操作");        }        return null;    }    //删除数据    public int delete(Uri uri, String selection, String[] selectionArgs) {        if (matcher.match(uri) == DELETE) {            //匹配成功 返回查询的结果集            SQLiteDatabase db = helper.getWritableDatabase();            db.delete("person", selection, selectionArgs);        } else {            throw new IllegalArgumentException("路径不匹配,不能执行删除操作");        }        return 0;    }    //更新数据    public int update(Uri uri, ContentValues values, String selection,                      String[] selectionArgs) {        if (matcher.match(uri) == UPDATE) {            //匹配成功 返回查询的结果集            SQLiteDatabase db = helper.getWritableDatabase();            db.update("person", values, selection, selectionArgs);        } else {            throw new IllegalArgumentException("路径不匹配,不能执行修改操作");        }        return 0;    }}

从上述代码中可以看出，在暴露数据的增、删、改、查方法之前，首先需要添加一组用于请求数据操作的Uri，然后在相应的增删改查方法中匹配Uri，匹配成功才能对数据进行操作。

创建数据库逻辑操作类

package com.example.lenovo.contentprovider;import android.content.ContentValues;import android.content.Context;import android.database.sqlite.SQLiteDatabase;/** * Created by lenovo on 2017/6/8. */public class PersonDao2 {    private PersonSQLiteOpenHelper helper;    //在构造方法里面完成helper的初始化    public PersonDao2(Context context){        helper=new PersonSQLiteOpenHelper(context);    }    //添加一条记录到数据库    public long add(String name,String number,int money){        SQLiteDatabase db=helper.getWritableDatabase();        ContentValues values=new ContentValues();        values.put("name",name);        values.put("number",number);        long id=db.insert("person",null,values);        db.close();        return id;    }}

MainActivity

package com.example.lenovo.contentprovider;import android.support.v7.app.AppCompatActivity;import android.os.Bundle;import java.util.ArrayList;import java.util.List;import java.util.Random;import android.content.ContentResolver;import android.database.Cursor;import android.net.Uri;import android.os.Handler;import android.view.View;import android.view.ViewGroup;import android.widget.BaseAdapter;import android.widget.ListView;import android.widget.TextView;public class MainActivity extends AppCompatActivity {    private ListView lv;    private List<Person>  persons ;    //创建一个Handler对象用于线程间通信    private Handler handler = new Handler(){        public void handleMessage(android.os.Message msg) {            switch (msg.what) {                case 100://接收到数据查询完毕的消息                    //UI线程适配ListView                    lv.setAdapter(new MyAdapter());                    break;            }        };    };    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.activity_main);        lv = (ListView) findViewById(R.id.lv);        //由于添加数据、查询数据是比较耗时的,因此需要在子线程中做这两个操作        new Thread(){            public void run() {                //添加数据                AddData();                //获取persons集合                getPersons();                //如果查询到数据 则向UI线程发送消息                if(persons.size() > 0){                    handler.sendEmptyMessage(100);                }            };        }.start();    }    //往person表中插入10条数据    public void AddData(){        PersonDao2 dao = new PersonDao2(this);        long number = 885900000l;        Random random = new Random();        for(int i=0;i<10;i++){            dao.add("wangwu"+i, Long.toString(number+i), random.nextInt(5000));        }    }    //利用ContentResolver对象查询本应用程序使用ContentProvider暴露的数据    private void getPersons() {        //首先要获取查询的uri        String url = "content://com.example.lenovo.db.personprovider/query";        Uri uri = Uri.parse(url);        //获取ContentResolver对象 这个对象的使用后面会详细讲解        ContentResolver contentResolver = getContentResolver();        //利用ContentResolver对象查询数据得到一个Cursor对象        Cursor cursor = contentResolver.query(uri, null, null, null, null);        persons = new ArrayList<Person>();        //如果cursor为空立即结束该方法        if(cursor == null){            return;        }        while(cursor.moveToNext()){            int id = cursor.getInt(cursor.getColumnIndex("id"));            String name = cursor.getString(cursor.getColumnIndex("name"));            String number = cursor.getString(cursor.getColumnIndex("number"));            Person p = new Person(id, name, number);            persons.add(p);        }        cursor.close();    }    //适配器    private class MyAdapter extends BaseAdapter{        private static final String TAG = "MyAdapter";        // 控制listview里面总共有多个条目        public int getCount() {            return persons.size(); //条目个数 == 集合的size        }        public Object getItem(int position) {            return persons.get(position);        }        public long getItemId(int position) {            return 0;        }        public View getView(int position, View convertView, ViewGroup parent) {            //得到某个位置对应的person对象            Person person = persons.get(position);            View view = View.inflate(MainActivity.this, R.layout.list_item, null);            //一定要在view对象里面寻找孩子的id            //姓名            TextView tv_name = (TextView) view.findViewById(R.id.tv_name);            tv_name.setText("姓名:"+person.getName());            //电话            TextView tv_phone = (TextView) view.findViewById(R.id.tv_phone);            tv_phone.setText("电话:"+person.getNumber());            return view;        }    }}

上述代码使用ContentResolver查询本程序使用ContentProvider暴露的数据。

需要注意的是，当执行耗时操作时，应创建一个子线程将耗时操作放在子线程中，然后使用handler实现子线程与UI线程的通信。
在清单文件中注册PersonDBProvider

        <provider            android:authorities="com.example.lenovo.db.personprovider"            android:name="com.example.lenovo.contentprovider.PersonDBProvider">        </provider>

运行程序能看到如图所示