android 学习笔记 创建自己的内容提供器

如果想要实现跨程序共享数据的功能，官方推荐的方式就是使用内容提供器，可以通过新建一个类去继承ContentProvider的方式来创建一个自己的内容提供器。 

ContentProvider类中有六个抽象方法，我们在使用子类继承它的时候，需要将这六个方法全部重写。新建MyProvider继承自ContentProvider，

代码如下所示：

public class MyProvider extends ContentProvider { 

        @Override 

        public boolean onCreate() { 
            return false; 

        } 

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

        } 

        @Override 
        public Uri insert(Uri uri, ContentValues values) { 

            return null; 
        } 

        @Override 

        public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) { 

            return 0; 
        } 

        @Override 

        public int delete(Uri uri, String selection, String[] selectionArgs) { 
            return 0; 

        } 
         @Override 
        public String getType(Uri uri) { 
                  return null; 
        } 

   } 

 1. onCreate() 
         初始化内容提供器的时候调用。通常会在这里完成对数据库的创建和升级等操作，返回true表示内容提供器初始化成功，返回false则表示失败。注意，只有当存在 
 ContentResolver尝试访问我们程序中的数据时，内容提供器才会被初始化。 
 2. query() 
         从内容提供器中查询数据。使用uri参数来确定查询哪张表，projection参数用于确 定查询哪些列，selection和selectionArgs参数用于约束查询哪些行，sortOrder参数用于 
  对结果进行排序，查询的结果存放在Cursor对象中返回。 
 3. insert() 
         向内容提供器中添加一条数据。使用uri参数来确定要添加到的表，待添加的数据保存在values参数中。添加完成后，返回一个用于表示这条新记录的URI。 
 4. update() 
         更新内容提供器中已有的数据。使用uri参数来确定更新哪一张表中的数据，新数据保存在values参数中，selection和selectionArgs参数用于约束更新哪些行，受影响的 
   行数将作为返回值返回。 
 5. delete() 
         从内容提供器中删除数据。使用uri参数来确定删除哪一张表中的数据，selection 和selectionArgs参数用于约束删除哪些行，被删除的行数将作为返回值返回。 
 6. getType() 
         根据传入的内容URI来返回相应的MIME类型。可以看到，几乎每一个方法都会带 Uri这个参数，这个参数也正是调用ContentResolver的增删改查方法时传递过来的。而现在，我们需要对传入的Uri参数进行解析，从中分析出调用方期望访问的表和数据。 

  内容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对象所对应的自定义代码，利用这个代码，我们就可以判断出调用方期望访问的是哪张表中的数据了。修改MyProvider中的代码，如下所示： 

 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); 
        }       
       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; 

       } 
       …… 

    } 
       …… 
   } 

 可以看到，MyProvider 中新增了四个整型常量，其中TABLE1_DIR表示访问table1表 中的所有数据，TABLE1_ITEM表示访问table1表中的单条数据，TABLE2_DIR表示访问 
 able2表中的所有数据，TABLE2_ITEM表示访问table2表中的单条数据。接着在静态代码块里我们创建了UriMatcher 的实例，并调用addURI()方法，将期望匹配的内容URI格式传递进去，注意这里传入的路径参数是可以使用通配符的。然后当query()方法被调用的时候，就会通过UriMatcher 的match()方法对传入的Uri对象进行匹配，如果发现UriMatcher 中某个内容URI格式成功匹配了该Uri对象，则会返回相应的自定义代码，然后我们就可以判断出调用方期望访问的到底是什么数据了。上述代码只是以query()方法为例做了个示范，其实insert()、update()、delete()这几个方法的实现也是差不多的，它们都会携带Uri这个参数，然后同样利用UriMatcher 的match() 方法判断出调用方期望访问的是哪张表，再对该表中的数据进行相应的操作就可以了。除此之外，还有一个方法你会比较陌生，即getType()方法。它是所有的内容提供器都必须提供的一个方法，用于获取Uri对象所对应的MIME类型。一个内容URI所对应的MIME 字符串主要由三部分组分，Android对这三个部分做了如下格式规定。 

    1. 必须以vnd开头。 
    2. 如果内容URI 以路径结尾，则后接android.cursor.dir/，如果内容URI 以id结尾， 
        则后接android.cursor.item/。 
    3. 最后接上vnd.<authority>.<path>。 
            所以，对于content://com.example.app.provider/table1这个内容URI，它所对应的MIME 类型就可以写成： 
         vnd.android.cursor.dir/vnd.com.example.app.provider.table1 
      对于content://com.example.app.provider/table1/1这个内容URI，它所对应的MIME类型就可以写成： 
             vnd.android.cursor.item/vnd. com.example.app.provider.table1 

    现在我们可以继续完善MyProvider中的内容了，这次来实现getType()方法中的逻辑，代码如下所示： 

    public class MyProvider extends ContentProvider { 

        …… 
        @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; 

        } 
    }