Android 学习 笔记_06. Content Provider初步

1、作用：

     （1、为存储和获取（访问）数据提供了统一的接口（它对数据的存储进行了一层封装，让我们无需关心数据存储的细节就可以直接使用。）

     （2、能够让我们的数据在不同的应用程序中共享（SQLite只能在同一个应用程序中共享数据）

     （3、Android为常见的一些数据提供了Content Provider（包括了音频、视频、图片、通讯录等）

2、ContentProvider使用表的形式来组织数据

    

3、统一资源标识符 URL（为资源起名字）

     （1、每个ContentProvider都有一个公共的URl，用于表示该ContentProvider提供的数据

     （2、Android的ContentProvider都存放于android.provider包当中

4、ContentProvider函数:对数据进行增删改查的操作

      （1、query();

      （2、insert();

      （3、update();

      （4、delete();

      （5、getType();

      （6、onCreate();

5、实现ContentProvider的过程

      （1、定义一个CONTENT_URL常量

      （2、定义一个类，继承ContentProvider

      （3、实现上述函数方法

      （4、在Manifest.xml中声明

             

 CPActivity.java

package zzl.contentprovider;

import zzl.contentprovider.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 CPActivity extends Activity {
    
    private Button insert=null;
    private Button query=null;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_cp);
        
        insert=(Button)findViewById(R.id.insert);
        query=(Button)findViewById(R.id.query);
        
        insert.setOnClickListener(new InsertOnClickListener());
        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的URL，第二个参数为要插入的值。此处的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) {
        // Inflate the menu; this adds items to the action bar if it is present.
        getMenuInflater().inflate(R.menu.activity_cp, menu);
        return true;
    }

}

FirstProviderMetaData.java

package zzl.contentprovider;

import android.net.Uri;
import android.provider.BaseColumns;

public class FirstProviderMetaData {

    //这里的AUTHORTY为包的全名+ContentProvider子类的全名
    public static final String AUTHORTY = "zzl.contentprovider.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";
        //访问ContentProvider的URL：CONTENT_URI为常量URL; parse是将文本转换成URL
        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";
        
        
    }
    
}

FirstProviderMetaData.java

package zzl.contentprovider;

import java.util.HashMap;

import zzl.contentprovider.FirstProviderMetaData.UserTableMetaData;
import zzl.sqlite3.db.DatabaseHelper;
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;

public class FirstContentProvider extends ContentProvider{
    
    //定义一个UriMatcher类对象，用来匹配URL:形成映射，规则是否合法
    public static final UriMatcher uriMatcher;
    //组时的ID
    public static final int INCOMING_USER_COLLECTION = 1;
    //单个时的ID
    public static final int INCOMING_USER_SIGNAL = 2;
    //定义一个DatabaseHelper对象
    private DatabaseHelper dh;
    
    static{
        //UriMatcher.NO_MATCH表示不匹配任何路径的返回码
        uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
        uriMatcher.addURI(FirstProviderMetaData.AUTHORTY, "users", INCOMING_USER_COLLECTION);
        //后面加了#表示为单个:users下面的某一个users
        uriMatcher.addURI(FirstProviderMetaData.AUTHORTY, "users/#", INCOMING_USER_SIGNAL);
   }
    //新建一个HashMap,后面执行插入操作时有用
    public static HashMap<String, String> userProjectionMap;
    static
    {
        userProjectionMap = new HashMap<String, String>();
        //给数据库表中的列取别名
        userProjectionMap.put(UserTableMetaData._ID, UserTableMetaData._ID);
        userProjectionMap.put(UserTableMetaData.USER_NAME, UserTableMetaData.USER_NAME);
    }
    
    //得到ContentProvider的数据类型，返回的参数URL所代表的数据类型
    @Override
    public String getType(Uri uri) {
        // TODO Auto-generated method stub
        System.out.println("getType");
        switch(uriMatcher.match(uri)){
        //matcher满足URL的前2项（即协议+路径）为第1种情况时，switch语句的值为URL的第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" + uri);
        }
    }
    //该函数的返回值是一个URL
    //这个URL表示的是刚刚使用这个函数的所插入的数据
    //content://zzl.FirstContentProvider/users/
    @Override
    public Uri insert(Uri uri, ContentValues values) {
        // TODO Auto-generated method stub
        System.out.println("insert");
        SQLiteDatabase db = dh.getWritableDatabase();
        long rowId = db.insert(UserTableMetaData.TABLE_NAME, null, values);
        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);
        return true;
    }
    @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 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部分，即把URL的协议+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;
    }
}

总结：

    （1、 要在Manifest中加入

      <provider
               android:name="zzl.contentprovider.FirstContentProvider"
              android:authorities="zzl.contentprovider.FirstContentProvider"
     />