0119ContentProvider

0119ContentProvider 提供访问数据的一个统一的接口 在不同的应用程序之间共享数据

每一组数据都对应一个ContentProvider，有很多的ContentProvider 如何找到对应的ContentProvider？ URL，统一资源标识符。对每一个资源起一个单独的名字，每一个ContentProvider都有一个公共的URL

Android所提供的ContentProvider都存放在Android.provider包当中 得到URL的一个常量，比如CONTENT_URL,得到这个常量就可以得到代表这个ContentProvider的URL，得到这个URL就使用这个ContentProvider提供的方法

得到ContentProvider后，根据其所提供的函数，可以增删改查

query() 查询 insert() 插入 update() 更新 delete() 删除 getType() 得到数据类型 onCreate()  创建时的回调函数？？ 在创建ContentProvider时要做的一些事情

自己实现ContentProvider不多，但是如果不知道其工作原理，如何实现，用起来就会一头雾水

实现ContentProvider的过程

1，定义一个CONTENT_URI常量

2，定义一个类，继承ContentProvider

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

4，在AndroidManifest.xml当中进行声明

FirstContentProvider.java FirstContentProvider继承了ContentProvider这个类

FirstProviderMetaData.java定义了ContentProvider所需要使用的常量

首先定义一个CONTENT_URI 实际上是一个字符串，然后转换为URI类型，这个字符串必须是唯一的 content://com.example.codelab.transportationsprovider  第一，content:// 第二，需要完整的类名

需要有_id作为唯一的标示符 如果用SQLite _id可以定义为INTERGER PRIMARY KEY AUTOINCREMENT 即整形数据 关键字 自增长

数据类型 访问整张表的数据 "vnd.android.cursor.dir/vnd.firstprovider.user"   dir是整张表格

如果要访问Provider里面其中一个数据的话 "vnd.android,cursor.item/vnd.firstprovider.user"  item是其中一条数据

URIMatcher 作用 检测  URI是否符合我们的标准 原理是将一个URL和一个数字相关联

定义一个规则 uriMatcher.addURI(authority,目录路径，与之对应整型变量的值)//此为定义的一个规则 public String getType(Uri uri)方法中 uriMatcher.match(uri)进行匹配

UriMatcher就是起了一个规则，给每一个Uri一个整型变量 如果规则中“与之对应整型变量的值”与 case 匹配，则返还相应的值

定义一个 HashMap public static HashMap<String,String> userProjectionMap;//声明一个 HashMap static {     userProjectionMap= new HashMap<String,String>();     userProjectionMap.put(UserTableMetaData._ID,UserTableMetaDate._ID);     userProjectionMap.put(UserTableMetaData.USER_NAME,UserTableMetaDate.USER_NAME); }//给ContentProvider这张表的列起一个别名

getContentResolve();获得ContentResolve() ,这个可以操作ContentProvider

public Uri insert(要向哪一个Uri插入即向哪一个ContentProvider，值) //该函数的返回值是一个Uri,这个Uri表示的是刚刚使用这个函数所插入的数据 //content://mars.cp.FirstContentProvider/users/1  这个以代表新插入的行号 db.insert();该函数的返回值是新插入行的行号

SQLiteQueryBuilder qb=new SQLiteQueryBuilder();创建查询的语句，相当于一个查询语句

qb.appendWhere();//添加where字句

CPActivity.java

package com.example.test_cp;

import com.example.test_cp.FirstProviderMetaData.UserProvidermetaData;

import android.net.Uri;
import android.os.Bundle;
import android.app.Activity;
import android.content.ContentValues;
import android.database.Cursor;
import android.view.Menu;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;

public class CPActivity extends Activity {

    private Button myButton;
    private Button myButton2;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_cp);
        myButton=(Button)findViewById(R.id.myButton);
        myButton2=(Button)findViewById(R.id.myButton2);
        myButton.setOnClickListener(new MyButtonClickListener());
        myButton2.setOnClickListener(new MyButton2ClickListener());
        
    }
    
    public class MyButtonClickListener implements OnClickListener{

        @Override
        public void onClick(View v) {
            // TODO Auto-generated method stub
            ContentValues values=new ContentValues();
            //将张三这个值放到values 里面    键值对
            values.put(FirstProviderMetaData.UserProvidermetaData.USER_NAME, "zhangsan");
            Uri uri=getContentResolver()
                    .insert(UserProvidermetaData.CONTENT_URI, values);
            //这样就可以得到一个ContentResolver对象，
            //可以操作ContentProvider,比如用ContentProvider里面的insert（）
            //把代表FirestContentProvider的uri传入，这样就可以调用FirstContentProvider的insert方法
            System.out.println("uri--->"+uri.toString());
        }
        
    }
    
    public class MyButton2ClickListener implements OnClickListener{

        @Override
        public void onClick(View v) {
            // TODO Auto-generated method stub
            Cursor c=getContentResolver().query(FirstProviderMetaData.UserProvidermetaData.CONTENT_URI, null, null, null, null);
            while(c.moveToNext()){
                System.out.println(c.getString(c.getColumnIndex(UserProvidermetaData.USER_NAME)));
            //getString里面是列的编号，列的编号要挺过getColumnIndex（）得到；
            }        
        }
        
    }



}

FirstContentProvider.java

package com.example.test_cp;
import java.util.HashMap;

import com.example.mars_sqlite.db.DatebaseHelper;//引入另一个包
import com.example.test_cp.FirstProviderMetaData.UserProvidermetaData;

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{
    DatebaseHelper dh=null;
    public static UriMatcher uriMatcher=null;
    public static final int INCOMING_USER_COLLECTION=1;
    public static final int INCOMING_USER_SINGLE=2;
    /**
     * URIMatcher 作用 检测  URI是否符合我们的标准
                             原理是将一个URL和一个数字相关联
     */
    // 定义一个规则
    static{
        uriMatcher=new UriMatcher(UriMatcher.NO_MATCH);
        uriMatcher.addURI(FirstProviderMetaData.AUTHORITY, "users", INCOMING_USER_COLLECTION);
        uriMatcher.addURI(FirstProviderMetaData.AUTHORITY, "users/#", INCOMING_USER_SINGLE);
    }
    
    public static HashMap<String,String>  userProjectionMap;
    static {
        userProjectionMap=new HashMap<String,String>();
        userProjectionMap.put(UserProvidermetaData._ID, UserProvidermetaData._ID);
        userProjectionMap.put(UserProvidermetaData.USER_NAME, UserProvidermetaData.USER_NAME);
        //第一个是键，第二个是值，可以参考0113，老师讲师起别名
    }
    
    
    /**
     * UriMatcher就是起了一个规则，给每一个Uri一个整型变量
     * 如果规则中“与之对应整型变量的值”与 case 匹配，则返还相应的值
     */
    //下面的代码这个实例没有用到没有
    @Override
    public String getType(Uri uri) {
        // TODO Auto-generated method stub
        
        switch(uriMatcher.match(uri)){
        case INCOMING_USER_COLLECTION:
            return FirstProviderMetaData.UserProvidermetaData.CONTENT_TYPE;
        case INCOMING_USER_SINGLE:
            return FirstProviderMetaData.UserProvidermetaData.CONTENT_TYPE_ITEM;
        default:
            throw new IllegalArgumentException("Unknow String" + uri);    
        }
        
        
    }
    
    
    
  
    
    @Override
    public Cursor query(Uri uri, String[] projection, String selection,
            String[] selectionArgs, String sortOrder) {
        //projection是列有哪些
        //selcetion是where字句的内容 selectionArgs 前面查询的占位符所对应的参数
        // TODO Auto-generated method stub
        SQLiteQueryBuilder qb=new SQLiteQueryBuilder();//创建查询的语句，相当于一个查询语句
        switch(uriMatcher.match(uri)){//要知道是查询的一系列的user对象还是单个的user对象
        case INCOMING_USER_COLLECTION:
            qb.setTables(UserProvidermetaData.TABLE_NAME);//设置要查询哪一张表格
            qb.setProjectionMap(userProjectionMap);
            //表格的每一列起一个别名projectionMap
            break;//忘记添加这个导致进入第二个，get(1)不存在，得不到发生错误
            //uri-->content://com.example.test_cp.FirstContentProvider/users所以进入第一个
        case INCOMING_USER_SINGLE://这个没有进入
            qb.setTables(UserProvidermetaData.TABLE_NAME);
            qb.setProjectionMap(userProjectionMap);
            //coneten://com.example.test_cp.FirstContentProvider/users/1
            //users/1就是path部分 users是第0个元素 get(1)就是得到users/#中的#
            qb.appendWhere(UserProvidermetaData._ID+"="+uri.getPathSegments().get(1));
            //相当于一个查询语句
        default:
            break;
            
        
        }
        
        String orderBy;
        if(TextUtils.isEmpty(sortOrder))//如果传入的sortOrder是空的话
        {
            orderBy=UserProvidermetaData.DEFUALT_SORT_ORDER;
            
        }else{orderBy=sortOrder;}
        SQLiteDatabase db=dh.getWritableDatabase();
        Cursor c=qb.query(db, projection, selection, selectionArgs, null, null, sortOrder);
        //0116 db要查询的数据库 projection 要查询的列 selection是where字句 selectionArgs是前面占位符对应的参数
        c.setNotificationUri(getContext().getContentResolver(), uri);//通知修改
        System.out.println("b");
        return c;
        
            
    }

    @Override
    public boolean onCreate() {
        // TODO Auto-generated method stub
        dh=new DatebaseHelper(getContext(),FirstProviderMetaData.DATABASE_NAME);
        //context 在你的环境中可以通过context得到运行环境的信息
        return true;
    }
    
    
    

    @Override
    public Uri insert(Uri uri, ContentValues values) {
        // TODO Auto-generated method stub
        SQLiteDatabase db=dh.getWritableDatabase();
        //向表中插入值
        int rowid=(int)db.insert(FirstProviderMetaData.USERS_TABLE_NAME,null,values);
        //该函数的返回值是新插入行的行号
        if(rowid>0)
        {
            Uri insertedUserUri=ContentUris.withAppendedId(UserProvidermetaData.CONTENT_URI, rowid);
            getContext().getContentResolver().notifyChange(uri,null );//通知数据的修改
            return insertedUserUri;//返回新插入数据的uri
        }
        throw new SQLException("ERR Uri" + uri);
    }

    @Override
    public int delete(Uri uri, String selection, String[] selectionArgs) {
        // TODO Auto-generated method stub
        return 0;
    }

    @Override
    public int update(Uri uri, ContentValues values, String selection,
            String[] selectionArgs) {
        // TODO Auto-generated method stub
        return 0;
    }
    
}

FirstProviderMetaData.java

package com.example.test_cp;

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

public class FirstProviderMetaData{
    //要写完整的类名
    public static final String AUTHORITY="com.example.test_cp.FirstContentProvider";
    //数据库名字，因为我们要用数据库来作为ContentProvider底层的存储方式
    public static final String DATABASE_NAME="FirstProvider.db";
    //数据库版本
    public static final int DATABASE_VERSION=1;
    //表名
    public static final String USERS_TABLE_NAME="users";
    //内部类，要实现的属性或者方法在接口中已经有，则可以定义一个内部类来实现此接口
    public static final class UserProvidermetaData implements BaseColumns {
        //BaseColumns定义了_ID  这个是The unique ID for a row
        public static final String TABLE_NAME="users";
        //访问该provider的Uri ， content+AUTHORTY+字表的名字
        //表示取得这样一个ContentProvider的uri对象
        public static final Uri CONTENT_URI=Uri.parse("content://"+AUTHORITY+"/users");
        //这个是定义访问整张表的数据类型，后面的名字可以随便起
        public static final String CONTENT_TYPE="vnd.android.cursor.dir/vnd.firstprovider.user";
        //定义访问provider里面的某一条数据的数据类型
        public static final String CONTENT_TYPE_ITEM="vnd.android.cursor.item/vnd.firstprovider.user";
        //列名，在users里面存放name这一列
        public static final String USER_NAME="name";
        //定义默认排序
        public static final String DEFUALT_SORT_ORDER="_id desc";
    }
    
}

DatabaseHelpr.java

//第一，getReadableDatabase(),getWritableDatabase()可以获得SQLiteDatabse对象，通过该对象可以对数据库进行操作
//即通过数据库助手类，可以通过他的两个函数得到可读或者可写的数据库对象
//第二，提供了onCreate()和onUpgrade()两个回调函数，允许我们在创建和升级数据库时，进行自己的操作
//自定义SQLiteOpenHelper，必需要实现onCreate(), onUpgrade()，可以选择实现onOpen。 
package com.example.mars_sqlite.db;

import com.example.test_cp.FirstProviderMetaData;
import com.example.test_cp.FirstProviderMetaData.UserProvidermetaData;

import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteDatabase.CursorFactory;
import android.database.sqlite.SQLiteOpenHelper;
//A helper class to manage database creation and version management.

public class DatebaseHelper extends SQLiteOpenHelper
{

    public DatebaseHelper(Context context, String name, CursorFactory factory,
            int version) {
        super(context, name, factory, version);
        // TODO Auto-generated constructor stub
    }
    
    public DatebaseHelper(Context context,String name,int version)
    
    {
        this(context ,name ,null, version);//调用上面四个参数的构造函数
    }
    public DatebaseHelper(Context context,String name )
    {
        this (context ,name ,1);//调用上面三个参数的构造函数
    }
    
    //下面函数要创建实际上是在第一次得到SQliteDatebase对象的时候才会调用这个方法，
    //意思就是仅仅生成DatebaseHelper（继承SQliteOpenHelper）的对象是无法执行这两个函数，
    //只有调用getReadableDatebase 和getWritableDatebase时候才会调用这些方法
    @Override
    public void onCreate(SQLiteDatabase db) {
        // TODO Auto-generated method stub
        System.out.println("create a datebase");
        //db.execSQL("create table user(id int,name verchar(20))");
        db.execSQL("create table"+" "+FirstProviderMetaData.USERS_TABLE_NAME+
                "("+UserProvidermetaData._ID+" "+"INTEGER PRIMARY KEY AUTOINCREMENT," +
                            UserProvidermetaData.USER_NAME+" "+"verchar(20));");//数据库db执行数据库语句
    }//这里创建表名为user
     //当更新这张表时候，要更改scheme version 即模式版本，不然无法更新
    //Called when the database needs to be upgraded.
    //The implementation should use this method to drop tables,
    //add tables, or do anything else it needs to upgrade to the new schema version
    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        // TODO Auto-generated method stub
        System.out.println("onUpgrade a datebase");
    }
    }

经过测试，以下语句必须添加在AndroidManifest.xml中

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