记录：AndroidContentProvider的使用

摘要：contentprivoder好像自己没有遇到过，不过通常使用 联系人，日历等等之类系统自身提供的。简略的摘抄一下网上各位的资料以作为自己记录。对 其中 getType(Uri uri)方法还是不知道具体使用方法，暂且留在这里。等后面看能不能搜集到具体使用

概述

??ContentProvider的主要用途我认为是对一些数据进行管理，而对于数据的实现也有非常多。因此，实际的应用中要自行取舍。在每一个应用中数据库都允许创建它的应用自己来读写，那其它应用要访问这个数据库就需要使用 ContentProvider对数据共享。 ??在学习使用ContentProvider的时候，里面面涉及了SQLite、Uri等等系列的操作等等，前面通过摘抄了一下记录：Android SQLite的使用 和 记录：URI、URL和Uri 的使用。还有很零碎的点边在这里记录一下。 ??UriMatcher ??UriMatcher是一个工具类，主要是用于 ContentProvider中匹配 URI。实际上相当于一棵树，实例化的UriMatcher对象，相对于树的根节点。 ??使用方法如下： ??首先第一步，初始化：

//UriMatcher.NO_MATCH，是一个常量，如果不匹配就返回 -1
UriMatcher sURIMatcher = new UriMatcher(UriMatcher.NO_MATCH);

??第二步注册需要的Uri

 /**
*authority：就是 contentprivoder 的authority参数，这参数必须与 androidmanifest.xml中对应privoder的authorities值一样
*path：就是完整uri中，authority后的一长串
*code：对应码
 */
 //addURI 添加一个 uri，如果这个 uri匹配成功则返回匹配吗，不匹配则返回 -1
 public void addURI(String authority, String path, int code)

??第三部，与已经注册的Uri进行匹配

//从以创建的uri树中去匹配传进来的uri，如果匹配成功，则返回匹配码，否则-1
public int match(Uri uri)

??ContentUris ??ContentUris是一个工具类，主要是用来处理“Content”约束的 Uri 对象。 ??contentUris对象的语法格式是：“content://authority/path/id“ ??常用方法介绍：

 public static long parseId(Uri contentUri) 

??这个方法是将 uri 的id解析出来，此方法返回的是一个 long型的 id。

public static Uri withAppendedId(Uri contentUri, long id) 

??在指定的 uri后面添加一条 id 为指定的记录 ??一个摘抄的demo

    private static final  String AUTHORITY  = "com.smaple.hu";
    private static final int PEOPLE = 1;
    private static final int PEOPLE_ID = 2;
    private static final UriMatcher sURIMatcher = new UriMatcher(UriMatcher.NO_MATCH);
    static {
        sURIMatcher.addURI(AUTHORITY,"people",PEOPLE);
        //这里的#代表匹配任意数字，另外还可以用*来匹配任意文本  
        sURIMatcher.addURI(AUTHORITY,"people/#",PEOPLE_ID);
    }

    private void testUriMatcher() {
        Uri uriExact = Uri.parse("content://"+AUTHORITY+"/people");
        Log.i("info","uriExact: = "+uriExact) ;
        Log.i("info","match excat = "+getType(uriExact));

        Uri uriNumber = Uri.parse("content://"+AUTHORITY+"/people"+"/2");
        Log.i("info","uriNumber: = "+uriNumber) ;
        Log.i("info","match number = "+getType(uriNumber));


        //拼接Uri
        Uri newUri = ContentUris.withAppendedId(uriExact,15);
        Log.i("info","newUri: = "+newUri) ;
        //获取 ID
        long id = ContentUris.parseId(newUri) ;
        Log.i("info","ID = "+id);


        Log.i("info","getPathSegments = "+newUri.getPathSegments());
    }
    private String getType(Uri uri){
        int match = sURIMatcher.match(uri);
        switch (match){
            case  PEOPLE:

                return "vnd.android.cursor.dir/person";
            case  PEOPLE_ID:

                return "vnd.android.cursor.item/person";
            default:

                return null;
        }
    }

??打印出来的 log信息为：

 I/info: uriExact: = content://com.smaple.hu/people
 I/info: match excat = vnd.android.cursor.dir/person
 I/info: uriNumber: = content://com.smaple.hu/people/2
 I/info: match number = vnd.android.cursor.item/person
 I/info: newUri: = content://com.smaple.hu/people/15
 I/info: ID = 15
 I/info: getPathSegments = [people, 15]

??在UriMatcher的 math( )方法中有一个 uri.getPathSegments( )，大致的意思就是按“/”进行切分。和下面的参考资料有所差异 ??想要实现自己的 contentprovider，需要继承 “android.content.ContentProvider“ 抽象类，在继承之后必须覆写以下几个方法。

• oncreate( )： 构造方法，运行在 UI线程中，因此不能做一些耗时操作，一般用作属性初始化（比如数据库初始化）
• getType(Uri uri)：返回 uri对应的资源 MIME类型
• insert()：插入一条数据，返回插入数据的资源定位符
• delete()：使用给定的条件删除数据库信息，返回收受影响的记录数
• update()：使用给定的条件更新数据库信息，返回受影响的记录数
• query()：使用条件查询，最基本的也是最常用的方法，其实返回一个数据库游标

??毕竟是四组件，要求在 Androidmanifest.xml中进行注册声明

        <provider
            android:authorities="com.hu.smaple.provider"
            android:name=".hu.provider.TestProvider"
            android:exported="true"
            />

??这里有两个地方需要注意：

1. authorities：的值为 provider 对外暴露的 Uri地址，其必须保证全系统唯一性。即无论你的应用内部还是 android系统中都不能出现两个 authorities 值相同的 privoder声明
2. name：的属性则是真正 privoder类的位置。(恩，自己看着戳它)

contentprivoder的使用示例

??可以看见contentprivoder的基本操作方法都需要传入一个 Uri才能够使用。通过下面的摘抄的 demo，阅读起来可以更好的理解具体使用方法步骤： ??首先创建一个数据库，(为了方便把 记录：Android SQLite的使用 里面的直接copy使用。在这里还遇到了一个问题，初始的时候，两个不同的 activity去分别创建一张在 test.db下的表。这样会只有一个能够正常使用，后面修改成不通的数据库，两者才可以同时使用。由于是小白，希望知道的朋友些能帮忙一下，是因为一个SQLiteOpenHelper创建 数据库之后，同一应用中再次创建相同名称数据库的时候，不是在其后面追加表。而是，抛出异常)

public class TestSQLite extends SQLiteOpenHelper {

    private static final String DB_NAME = "provider.db";
    private static final int DB_VERSION = 1;
    private final String TABLE_NAME= "providertable";
    private final String COL_ID = "_id";
    private final String COL_NAME = "name" ;
    private final String COL_AGE = "age" ;
    private final String COL_INFO = "info" ;


    public TestSQLite(Context context) {
        super(context, DB_NAME, null, DB_VERSION);
    }

    @Override
    public void onCreate(SQLiteDatabase db) {


        String sql = "create table if not exists ["+TABLE_NAME+"] "+"("+COL_ID+" integer primary key autoincrement, "
                +COL_NAME+" varchar, "
                +COL_AGE+" integer, "
                +COL_INFO+" text)" ;

        Log.i("info","create table = "+sql) ;
        db.execSQL(sql);
    }

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        db.execSQL("ALTER TABLE person ADD COLUMN other STRING");
    }
}

??第二步，利用 contentPrivoder提供数据库的操作接口

public class TestProvider extends ContentProvider {
    private static final UriMatcher sUriMatcher ;
    private static final int MATCHER_TABLE = 1;
    private static final String AUTHORITY = "com.hu.smaple.provider" ;
    private static final String  TABLE_NAME = "providertable" ;
    private static final  Uri  CONTENT_URI_PROVIDERTABLE = Uri.parse("content://"+AUTHORITY+"/"+TABLE_NAME);
    private TestSQLite testSQLite ;
    private static final String CONTENT_PROVIDER_TABLE = "com.hu.smaple.provider.type" ;


    static {
        sUriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
        sUriMatcher.addURI(AUTHORITY,TABLE_NAME,MATCHER_TABLE);
    }

    @Override
    public boolean onCreate() {

        testSQLite = new TestSQLite(getContext());
        return false;
    }

    @Nullable
    @Override
    public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {

        Log.i("info","query uri = "+uri);

        SQLiteQueryBuilder queryBuilder = new SQLiteQueryBuilder();
        switch (sUriMatcher.match(uri)){
            case MATCHER_TABLE:
                //设置查询的表
                queryBuilder.setTables(TABLE_NAME);
                break;
            default:
                throw  new IllegalArgumentException("Unknow URI: " +uri);

        }

        SQLiteDatabase db = testSQLite.getWritableDatabase();
        Cursor c = queryBuilder.query(db,projection,selection,selectionArgs,null,null,sortOrder);

        return c;
    }

    @Nullable
    @Override
    public String getType(Uri uri) {
        Log.i("info","getType uri = "+uri);

        return null;
    }

    @Nullable
    @Override
    public Uri insert(Uri uri, ContentValues values) {
        Log.i("info","insert uri = "+uri);

        String tableName = null ;

        switch (sUriMatcher.match(uri)){
            case MATCHER_TABLE:tableName = TABLE_NAME ;
                break;
            default:
                throw  new IllegalArgumentException("Unknown URI: "+uri);
        }

        SQLiteDatabase db = testSQLite.getWritableDatabase();
        long rowId = db.insert(tableName,null,values);
        Uri result = ContentUris.withAppendedId(uri,rowId);
        notifyChange(result);

        return result;
    }

    @Override
    public int delete(Uri uri, String selection, String[] selectionArgs) {
        Log.i("info","delete uri = "+uri);

        String tableName = null ;;
        switch (sUriMatcher.match(uri)){
            case MATCHER_TABLE:
                tableName = TABLE_NAME ;
                break;
            default:
                throw new IllegalArgumentException("Unknown URI " + uri);
        }
        SQLiteDatabase db = testSQLite.getWritableDatabase() ;
        int count = db.delete(tableName,selection,selectionArgs);
        // 更新数据时，通知其他ContentObserver
        if(count > 0){
            notifyChange(uri);
        }
        return count;
    }

    @Override
    public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
        Log.i("info","update uri = "+uri);

        String tableName = null;

        switch (sUriMatcher.match(uri)){
            case MATCHER_TABLE:
              tableName = TABLE_NAME ;
                break;
            default:
                throw new IllegalArgumentException("Unknown URI " + uri);
        }

        SQLiteDatabase db = testSQLite.getWritableDatabase();
        int count = db.update(tableName,values,selection,selectionArgs);
        if(count > 0 ){
            notifyChange(uri);
        }
        return count;
    }


    private void notifyChange(Uri uri){
        Context context = getContext() ;
        if(context == null) return;
        ContentResolver resolver = context.getContentResolver();
        if(resolver == null) return;
        resolver.notifyChange(uri,null);
    }
}

??注意：在其中 通过 UriMatcher、ContentUris进行对 Uri的匹配和在返回时进行对Uri拼装。 ??第三步，在其它 app中通过context.getContentResolver( )使用这个共享的数据

public class MainActivity extends AppCompatActivity {

    private ListView listView ;

    private static final String AUTHORITY = "com.hu.smaple.provider" ;
    private static final String TABLENAME = "providertable";
    private static final Uri CONTENT_URI_TABLE = Uri.parse(
            "content://"+AUTHORITY+"/"+TABLENAME
    );


    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        listView = (ListView) findViewById(R.id.listView);
    }

    public void add(View view){
        ArrayList<Person> persons = new ArrayList<Person>();

        Person person = new Person("Ella"+System.currentTimeMillis(), 22, "lively girl insert other app");
        ContentValues cv = new ContentValues();
        cv.put("name",person.name);
        cv.put("age",person.age);
        cv.put("info",person.info);

        Uri uri = this.getContentResolver().insert(CONTENT_URI_TABLE,cv);

        Log.i("info ", "insert  uri =" + uri);
    }

    public void update(View view){
        Person person = new Person() ;
        person.name = "Jane";
        person.age = 30 ;
        person.info  = "updata form other app";

        ContentValues cv  =new ContentValues() ;
        cv.put("name",person.name);
        cv.put("age",person.age);
        cv.put("info",person.info);

        int count  = this.getContentResolver().update(CONTENT_URI_TABLE,cv,"name = ?",new String[]{"Jane"});
        Log.i("info ", "update count=" + count);


    }

    public void delete(View view) {

        int count = this.getContentResolver().delete(CONTENT_URI_TABLE,"name = ?",new String[]{"Jane"});
        Log.i("info ", "delete count=" + count);
    }

    public void query(View view){
        List<Person> persons = new ArrayList<>();

      Cursor c =   getContentResolver().query(CONTENT_URI_TABLE,null,null,null,null);
        if(c.getCount() > 0 && null != c){

            while(c.moveToNext()){
                Person person = new Person() ;
                person._id = c.getInt(c.getColumnIndex("_id"));
                person.name = c.getString(c.getColumnIndex("name"));
                person.age = c.getInt(c.getColumnIndex("age"));
                person.info = c.getString(c.getColumnIndex("info"));

                persons.add(person);
            }
        }

        ArrayList<Map<String,String>> list =
                new ArrayList<>() ;

        for (Person person : persons) {
            HashMap<String,String> map = new HashMap<>() ;
            map.put("name",person.name);
            map.put("info", person.age + " years old, " + person.info);

            list.add(map);
        }

        SimpleAdapter adapter = new SimpleAdapter(this, list, android.R.layout.simple_list_item_2,
                new String[]{"name", "info"}, new int[]{android.R.id.text1, android.R.id.text2});
        listView.setAdapter(adapter);
    }

}

??我在 contentprivoder的提供共享数据的界面也添加了一个 添加和查询的按钮，便于查看是否真的共享了。添加的数据为

        Person person1 = new Person("Ella", 22, "lively girl");
        Person person2 = new Person("Jenny", 22, "beautiful girl");
        Person person3 = new Person("Jessica", 23, "sexy girl");
        Person person4 = new Person("Kelly", 23, "hot baby");
        Person person5 = new Person("Jane", 25, "a pretty woman");

??可以看出在初始的时候，两个程序中都没有数据，在添加数据后，两个都有对应的数据显示。相关的 insert(),delete(),update()方法只有，两者app都会在查询的时候变化。

contentprivoder的权限

??在Androidmanifest.xml中 provider标签有三个额外的参数 permission、readPermissin、writePermiss。 ??对于privoder标签的几个重要参数注意一下：

• exported：用于指示该服务是否呢过被其它程序应用组件调用或跟它交互；取值为(true | fasle)。如果设置为 true，则能够被调用或交互；设置为发false时，只有同一个应用程序的组件或者带有相同用户的 ID的应用程序才能启动或绑定服务。
• readPermission：使用ContentProvider的查询功能所必须得权限，即使用 query( )函数的权限
• writePermission：使用contentprivoder的修改功能所必须得权限，即使用使用 insert( )、update( )、delete( )函数的权限
• permission：客服端读、写 contentprivoder中的数据所必须得权限名称。本属性为一次性设置读和写权限提供了快捷途径。
  不过，readPermission和writePremission属性优先于本设置。 如果同时设置了readPermission属性，则其将控制对 Content Provider 的读取。 如果设置了writePermission属性，则其也将控制对 Content Provider 数据的修改。也就是说如果只设置permission权限，那么拥有这个权限的应用就可以实现对这里的ContentProvider进行读写。
  如果同时设置了permission和readPermission那么具有readPermission权限的应用才可以读，拥有permission权限的才能写！也就是说只拥有permission权限是不能读的，因为readPermission的优先级要高于permission。
  如果同时设置了readPermission、writePermission、permission那么permission就无效了。

??以 writePermission作为是示例

        <provider
            android:authorities="com.hu.smaple.provider"
            android:name=".hu.provider.TestProvider"
            android:exported="true"
            android:writePermission="com.hu.smaple.privoder.write"
            />

??这里我在 privoder标签中添加了一个 writePermission的权限。当然，仅仅在这里添加了是没有任何作用的。因为系统的任何权限都是要通过申请的，没有申请过的一串String代表的字符串系统根本无法识别，也就是说谁进来都会被当在外面！！！所以，要在 application标签的同级目录，写上申请 permission的代码

    <permission android:name="com.hu.smaple.privoder.write"
        android:label="privoder permissin"
       android:protectionLevel="normal"
        />

    <application
        ...

??这样，我们的 permission才会在 系统同中注册，在其它的 app使用<uses-permission>直接申请就好。

权限对应的几个属性 链接： 声明、使用与自定义权限

属性	含义	是否必须
name	自定义的权限名称，通常需要遵循 Android权限定义命名方案：*.permission.*	是
protectionLevel	定义与权限相关的“风险级别”。必须是以下值之一，在确定是否授予权限时，系统可能采取不同的操作 normal 表示权限是低风险的，不会对系统、用户或其他应用程序造成危害 dangerous 表示权限是高风险的，系统将可能要求用户输入相关信息，才会授予此权限 signature 表示只有当应用程序所用数字签名与声明引权限的应用程序所用数字签名相同时，才能将权限授给它 signatureOrSystem 表示将权限授给具有相同数字签名的应用程序或android 包类。这一保护级别适和于非常特殊的情况，比如多个供应商需要通过系统映像共享功能时	是
permissionGroup	可以将权限放在一个组中，但对于自定期义权限，应该避免设置此属性。如果确实希望设置此属性，可能使用以下属性代替：android.permisson-group.SYSTEM_TOOLS	否
label	可使用它对权限进行简短描述	否
description	使用它提供对权限用途和所保护对象的更有用的描述	否
icon	权限可以与资源目录以外的图标相关联 ( 比如@drawable/myicon)	否

??我们在上面进行了 writePermission权限的规定和申请。在其它 app进行 写入或修改的时候。就需要申请此权限。举个反面教程，以下是没有申请时：

??进行一写入操作就错误，log出的错误为：

java.lang.SecurityException: Permission Denial: writing com.hu.smaple.hu.provider.TestProvider uri content://com.hu.smaple.provider/providertable from pid=10690, uid=10102 requires com.hu.smaple.write, or grantUriPermission()

??当我们Androidmanifest.xml中像申请系统权限一样的方式把 writepermission权限申请一下，就又能愉快的玩耍了

<uses-permission android:name="com.hu.smaple.privoder.write"/>

??对于数据变化时候监听，打印log测试后我在一个app里面使用注册 ContentObserver 实现类后，只用在自身 app，数据变化的时候，才会调用 onChange( )方法。

??在使用ContentProvider时由于我们无法得知数据的实际来源和数据操作的复杂度，如可能是读磁盘甚至是读网络，亦或有比较耗时的计算，所以我们无法保障数据返回的时间。因此就有必要使用异步查询来将耗时操作切换至后台线程，并在执行完成后切回到UI线程。对于直接使用Thread/Runnable - Handler这种情况实际上考虑的事情非常多，最关键的是写出来不优雅，用起来难受。我们可以使用Loader/LoaderManager和AsyncQuery

参考链接

---

• Android Content Provider
• Android应用程序组件Content Provider简要介绍和学习计划 (备注：这是多篇文章)
• Android contacts 联系人 通讯录 源码 完全解析
• ContentProvider从入门到精通
• ContentProvider数据库共享之——读写权限与数据监听
• Content Provider的权限
• Android 监听ContentProvider中数据的变化
• ContentUris详解及使用案例
• 【Android】Uri、UriMatcher、ContentUris详解
• http://bbs.csdn.net/topics/391902152(备注:我打印出来不是，api 24)