android-ContentProvider<七>

1.ContentProvider

   Content Provider 作为Android应用程序四大组件之一，为存储和查询数据提供统一的接口，实现程序间

   数据的共享。Android系统内一些常见的数据如音乐、视频、图像等都内置了一系列的Content Provider。 

   应用程序间共享数据有两种方式：

1.  是创建子类继承于Content Provider，重写该类用于数据存储和查询的方法。(注意：这通常是为某类，设计它的CP)
2.  是直接使用已经存在的Content Provider，如联系人等。

   存储数据的方式：

   在Content Provider中数据的是以表的形式存储，在数据表中每一行为一条记录，每一列为类型和数据。

   每一条记录都包括一个唯一的名叫_ID的数值字段，这个字段唯一标识一条数据记录。

  

  在创建表的时候用 INTEGER PRIMARY KEY AUTOINCREMENT来标识此字段。

  意思是：这是主键，类型为int ,数值从1开始递增。下面就是将UserTableMetaData._ID这列设成这样

  例如：db.execSQL("create table " + USERS_TABLE_NAME+ "("+UserTableMetaData._ID
    + " INTEGER PRIMARY KEY AUTOINCREMENT,"+.UserTableMetaData.USER_NAME+" varchar(20));")

  参考博客：http://blog.csdn.net/liuhe688/article/details/7050868

  注意：

 

2.ContentProvider类的设计模式

   成员变量(字段)：

    private static final UriMatcher matcher;  
    private DBHelper helper;  
    private SQLiteDatabase db;  
      
    private static final String AUTHORITY = "com.scott.provider.PersonProvider";  
    private static final int PERSON_ALL = 0;  
    private static final int PERSON_ONE = 1;  
      
    public static final String CONTENT_TYPE = "vnd.android.cursor.dir/vnd.scott.person";  
    public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/vnd.scott.person";  
      
    //数据改变后立即重新查询  
    private static final Uri NOTIFY_URI = Uri.parse("content://" + AUTHORITY + "/persons");  
      
    static {  
        matcher = new UriMatcher(UriMatcher.NO_MATCH);  
          
        matcher.addURI(AUTHORITY, "persons", PERSON_ALL);   //匹配记录集合  
        matcher.addURI(AUTHORITY, "persons/#", PERSON_ONE); //匹配单条记录  
    } 

   成员方法(增删改查)：

@Override  
    public boolean onCreate() {  
        helper = new DBHelper(getContext());  
        return true;  
    }  
  
    @Override  
    public String getType(Uri uri) {  
        int match = matcher.match(uri);  
        switch (match) {  
        case PERSON_ALL:  
            return CONTENT_TYPE;  
        case PERSON_ONE:  
            return CONTENT_ITEM_TYPE;  
        default:  
            throw new IllegalArgumentException("Unknown URI: " + uri);  
        }  
    }  
      
    @Override  
    public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {  
        db = helper.getReadableDatabase();  
        int match = matcher.match(uri);  
        switch (match) {  
        case PERSON_ALL:  
            //doesn't need any code in my provider.  
            break;  
        case PERSON_ONE:  
            long _id = ContentUris.parseId(uri);  
            selection = "_id = ?";  
            selectionArgs = new String[]{String.valueOf(_id)};  
            break;  
        default:  
            throw new IllegalArgumentException("Unknown URI: " + uri);  
        }  
        return db.query("person", projection, selection, selectionArgs, null, null, sortOrder);  
    }  
  
    @Override  
    public Uri insert(Uri uri, ContentValues values) {  
        int match = matcher.match(uri);  
        if (match != PERSON_ALL) {  
            throw new IllegalArgumentException("Wrong URI: " + uri);  
        }  
        db = helper.getWritableDatabase();  
        if (values == null) {  
            values = new ContentValues();  
            values.put("name", "no name");  
            values.put("age", "1");  
            values.put("info", "no info.");  
        }  
        long rowId = db.insert("person", null, values);  
        if (rowId > 0) {  
            notifyDataChanged();  
            return ContentUris.withAppendedId(uri, rowId);  
        }  
        return null;  
    }  
  
    @Override  
    public int delete(Uri uri, String selection, String[] selectionArgs) {  
        db = helper.getWritableDatabase();  
        int match = matcher.match(uri);  
        switch (match) {  
        case PERSON_ALL:  
            //doesn't need any code in my provider.  
            break;  
        case PERSON_ONE:  
            long _id = ContentUris.parseId(uri);  
            selection = "_id = ?";  
            selectionArgs = new String[]{String.valueOf(_id)};  
        }  
        int count = db.delete("person", selection, selectionArgs);  
        if (count > 0) {  
            notifyDataChanged();  
        }  
        return count;  
    }  
  
    @Override  
    public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {  
        db = helper.getWritableDatabase();  
        int match = matcher.match(uri);  
        switch (match) {  
        case PERSON_ALL:  
            //doesn't need any code in my provider.  
            break;  
        case PERSON_ONE:  
            long _id = ContentUris.parseId(uri);  
            selection = "_id = ?";  
            selectionArgs = new String[]{String.valueOf(_id)};  
            break;  
        default:  
            throw new IllegalArgumentException("Unknown URI: " + uri);  
        }  
        int count = db.update("person", values, selection, selectionArgs);  
        if (count > 0) {  
            notifyDataChanged();  
        }  
        return count;  
    }  
  
    //通知指定URI数据已改变  
    private void notifyDataChanged() {  
        getContext().getContentResolver().notifyChange(NOTIFY_URI, null);         
    }  
}  

3.Uri类

   用来指向操作的数据，一般为contentprovider的类下的表名(在数据库中已创建的某张表)

    （构造）方法： public static Uri parse (String uriString)

String AUTHORIY = "mars.cp.FirstContentProvider";
Uri.parse("content://" + AUTHORIY + "/users");

4.UriMatcher类

   它是用来匹配Uri的，因为Uri有可能是指向整张表(..../users,users为一张表明),

   也有可能指向表中的某个记录(如：.../users/10,users表中的id为10的记录)。

   注意：下面里的“#”为通配符，用来通配各种uri里指向的某条记录(../users/1,.../user/5,等等)，起到了代表所有指向记录类型的uri.

public static final UriMatcher uriMatcher;
uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
        uriMatcher.addURI(FirstProviderMetaData.AUTHORIY, "/users",
                INCOMING_USER_COLLECTION);
        uriMatcher.addURI(FirstProviderMetaData.AUTHORIY, "/users/#",
                INCOMING_USER_SINGLE);

5.ContentUris类

   通常使用它的withAppendedId方法，为指向整张表的Uri尾部添加指向id值。

String AUTHORIY = "mars.cp.FirstContentProvider";
Uri CONTENT_URI = Uri.parse("content://" + AUTHORIY + "/users");
Uri insertedUserUri = ContentUris.withAppendedId(CONTENT_URI, 10);
//这里的insertedUserUri就成为了一个指向某张表下id=10的记录。