Android学习-8（内容提供者Content Provider(二)）

学习基于《第一行代码》第七章（郭霖）

四、创建自己的内容提供器

新建一个MyProvider继承自ContentProvider，并实现他的6个抽象方法：

public class MyProvider extends ContentProvider {
    //初始化内容提供器的时候调用。通常会在这里完成对数据库的创建和升级等操作，返回true表示内容提供器初始化成功，返回false则表示失败。//注意，只有当存在ContentResolver尝试访问我们程序中的数据时，内容提供器才会被初始化。
        @Override
        public boolean onCreate() {
            return false;
        }

//从内容提供器中查询数据。使用uri参数来确定查询哪张表，projection参数用于确定查询哪些列，
//selection和selectionArgs参数用于约束查询哪些行，sortOrder参数用于对结果进行排序，查询的结果存放在Cursor对象中返回。
    @Override
    public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {
        return null;
    }

//向内容提供器中添加一条数据。使用uri参数来确定要添加到的表，待添加的数据保存在values参数中。
//添加完成后，返回一个用于表示这条新记录的URI。
    @Override
    public Uri insert(Uri uri, ContentValues values) {
        return null;
    }

//更新内容提供器中已有的数据。使用uri参数来确定更新哪一张表中的数据，新数据保存在values参数中，
// selection和selectionArgs参数用于约束更新哪些行，受影响的行数将作为返回值返回。
    @Override
    public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
        return 0;
    }

//从内容提供器中删除数据。使用uri参数来确定删除哪一张表中的数据，selection和selectionArgs参数用于约束删除哪些行，
//被删除的行数将作为返回值返回。
    @Override
    public int delete(Uri uri, String selection, String[] selectionArgs) {
        return 0;
    }

//根据传入的内容URI来返回相应的MIME类型。
    @Override
    public String getType(Uri uri) {
        return null;
    }
}

回顾一下，一个标准的内容URI写法是这样的：
content://com.example.app.provider/table1
这就表示调用方期望访问的是com.example.app这个应用的table1表中的数据。除此之外，我们还可以在这个内容URI的后面加上一个id，如下所示：
content://com.example.app.provider/table1/1
这就表示调用方期望访问的是com.example.app这个应用的table1表中id为1的数据。
内容URI的格式主要就只有以上两种，以路径结尾就表示期望访问该表中所有的数据，以id结尾就表示期望访问该表中拥有相应id的数据。我们可以使用通配符的方式来分别匹配这两种格式的内容URI，规则如下。
1.：表示匹配任意长度的任意字符
2.#：表示匹配任意长度的数字
所以，一个能够匹配任意表的内容URI格式就可以写成：
content://com.example.app.provider/
而一个能够匹配table1表中任意一行数据的内容URI格式就可以写成：
content://com.example.app.provider/table1/#

接着，我们再借助UriMatcher这个类就可以轻松地实现匹配内容URI的功能。UriMatcher中提供了一个addURI()方法，这个方法接收三个参数，可以分别把权限、路径和一个自定义代码传进去。这样，当调用UriMatcher的match()方法时，就可以将一个Uri对象传入，返回值是某个能够匹配这个Uri对象所对应的自定义代码，利用这个代码，我们就可以判断出调用方期望访问的是哪张表中的数据了。
还有一个方法你会比较陌生，即getType()方法。它是所有的内容提供器都必须提供的一个方法，用于获取Uri对象所对应的MIME类型。
一个内容URI所对应的MIME字符串主要由三部分组分，Android对这三个部分做了如下格式规定。
1.必须以vnd开头。
2.如果内容URI以路径结尾，则后接android.cursor.dir/，如果内容URI以id结尾，则后接android.cursor.item/。
3.最后接上vnd…。
例子：

public class MyProvider extends ContentProvider {

    public static final int TABLE1_DIR = 0;

    public static final int TABLE1_ITEM = 1;

    public static final int TABLE2_DIR = 2;

    public static final int TABLE2_ITEM = 3;

    private static UriMatcher uriMatcher;

    static {
        uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
          uriMatcher.addURI("com.example.app .provider", "table1", TABLE1_DIR);
          uriMatcher.addURI("com.example.app .provider ", "table1/#", TABLE1_ITEM);
          uriMatcher.addURI("com.example.app .provider ", "table2", TABLE2_ITEM);
          uriMatcher.addURI("com.example.app .provider ", "table2/#", TABLE2_ITEM);
    }
    ……
    @Override
    public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {
        switch (uriMatcher.match(uri)) {
        case TABLE1_DIR:
            // 查询table1表中的所有数据
            break;
        case TABLE1_ITEM:
            // 查询table1表中的单条数据
            break;
        case TABLE2_DIR:
            // 查询table2表中的所有数据
            break;
        case TABLE2_ITEM:
            // 查询table2表中的单条数据
            break;
        default:
            break;
        }
       }

@Override
    public String getType(Uri uri) {
        switch (uriMatcher.match(uri)) {
        case TABLE1_DIR:
            return "vnd.android.cursor.dir/vnd.com.example.app.provider. table1";
        case TABLE1_ITEM:
            return "vnd.android.cursor.item/vnd.com.example.app.provider. table1";
        case TABLE2_DIR:
            return "vnd.android.cursor.dir/vnd.com.example.app.provider. table2";
        case TABLE2_ITEM:
            return "vnd.android.cursor.item/vnd.com.example.app.provider. table2";
        default:
            break;
        }
        return null;
    }
    ……
}