ContentProvider

本文详细介绍了ContentProvider和Uri在Android中的使用方法,包括如何通过Uri操作ContentProvider提供的数据,以及UriMatcher、ContentUris和ContentResolver的使用场景。重点阐述了Uri在数据访问方式上的统一性优势,通过解析Uri获取数据并进行增删改查操作的具体步骤。

一、ContentProvider简介
    当应用继承ContentProvider类,并重写该类用于提供数据和存储数据的方法,就可以向其他应用共享其数据。虽然使用其他方法也可以对外共享数据,但数据访问方式会因数据存储的方式而不同,如:采用文件方式对外共享数据,需要进行文件操作读写数据;采用sharedpreferences共享数据,需要使用sharedpreferencesAPI读写数据。而使用ContentProvider共享数据的好处是统一了数据访问方式。
二、Uri类简介
    Uri代表了要操作的数据,Uri主要包含了两部分信息:1.需要操作的ContentProvider ,2.对ContentProvider中的什么数据进行操作,一个Uri由以下几部分组成:
    1.scheme:ContentProvider(内容提供者)的scheme已经由Android所规定为:content://。
    2.主机名(或Authority):用于唯一标识这个ContentProvider,外部调用者可以根据这个标识来找到它。
    3.路径(path):可以用来表示我们要操作的数据,路径的构建应根据业务而定,如下:
      •要操作contact表中id为10的记录,可以构建这样的路径:/contact/10
      •要操作contact表中id为10的记录的name字段, contact/10/name
      •要操作contact表中的所有记录,可以构建这样的路径:/contact
要操作的数据不一定来自数据库,也可以是文件等他存储方式,如下:
要操作xml文件中contact节点下的name节点,可以构建这样的路径:/contact/name
如果要把一个字符串转换成Uri,可以使用Uri类中的parse()方法,如下:
Uri uri = Uri.parse("content://com.changcheng.provider.contactprovider/contact")
三、UriMatcher、ContentUrist和ContentResolver简介
    因为Uri代表了要操作的数据,所以我们很经常需要解析Uri,并从Uri中获取数据。Android系统提供了两个用于操作Uri的工具类,分别为UriMatcher 和ContentUris 。掌握它们的使用,会便于我们的开发工作。
    UriMatcher:用于匹配Uri,它的用法如下:
    1.首先把你需要匹配Uri路径全部给注册上,如下:
    //常量UriMatcher.NO_MATCH表示不匹配任何路径的返回码(-1)。
    UriMatcher  uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
    //如果match()方法匹配content://com.changcheng.sqlite.provider.contactprovider/contact路径,返回匹配码为1
    uriMatcher.addURI(“com.changcheng.sqlite.provider.contactprovider”, “contact”, 1);//添加需要匹配uri,如果匹配就会返回匹配码
    //如果match()方法匹配   content://com.changcheng.sqlite.provider.contactprovider/contact/230路径,返回匹配码为2
    uriMatcher.addURI(“com.changcheng.sqlite.provider.contactprovider”, “contact/#”, 2);//#号为通配符
    2.注册完需要匹配的Uri后,就可以使用uriMatcher.match(uri)方法对输入的Uri进行匹配,如果匹配就返回匹配码,匹配码是调用addURI()方法传入的第三个参数,假设匹配content://com.changcheng.sqlite.provider.contactprovider/contact路径,返回的匹配码为1。
    ContentUris:用于获取Uri路径后面的ID部分,它有两个比较实用的方法:
    •withAppendedId(uri, id)用于为路径加上ID部分
    •parseId(uri)方法用于从路径中获取ID部分
    ContentResolver:当外部应用需要对ContentProvider中的数据进行添加、删除、修改和查询操作时,可以使用ContentResolver 类来完成,要获取ContentResolver 对象,可以使用Activity提供的getContentResolver()方法。 ContentResolver使用insert、delete、update、query方法,来操作数据。

 

什么是ContentUris?

ContentUris是content URI的一个辅助类。它有两个方法很有用,具体如下所示。

public static Uri withAppendedId(Uri contentUri, long id),这个方法负责把id和contentUri连接成一个新的Uri。比如在我们这个例子当中是这么使用 的:ContentUris.withAppendedId (Diary. DiaryColumns.CONTENT_URI, rowId)。如果rowId为100的话,那么现在的这个Uri的内容就是:
content://com.ex09_2_contentprovider.diarycontentprovider/diaries/100。

public static long parseId(Uri contentUri),这个方法负责把content URI 后边的id解析出来,比如现在这个content URI 是content://com.ex09_2_contentprovider.diarycontentprovider/diaries/100,那 么这个函数的返回值就是100。

 1. NotePad.java

public class NotePad { 
	public static final String AUTHORITY = "com.xh.google.provider.NotePad";
	
	public static final class Notes implements BaseColumns{ 
		//CONTENT_URI指到表
		public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/notes");
		
		public static final String CONTENT_TYPE = "vnd.android.cursor.dir/vnd.google.note";
		public static final String CONTENT_ITME_TYPE = "vnd.android.cursor.item/vnd.google.note";
		public static final String DEFAULT_SORT_ORDER = "modified DESC";
		
		public static final String TITLE = "title";
		public static final String NOTE = "note"; 
		public static final String CREATEDDATE = "created";
		public static final String MODIFIEDDATE = "modified"; 
	}
}

2. NotePadProvider.java

public class NotePadProvider extends ContentProvider{
	private SQLiteDatabase db; 
	private static final String DATABASE_NAME = "note_pad.db";   //数据库名字
	private static final int DATABASE_VERSION = 2;
	
	private static final String NOTES_TABLE_NAME = "notes";   //表的名字
	
	//创建表的SQL语句
	private static final String CREATE_TABLE="CREATE TABLE " 
			+ NOTES_TABLE_NAME 
			+ "(" + Notes._ID 
			+ "INTEGER PRIMARY KEY,"
			+ Notes.TITLE 
			+ " TEXT," 
			+ Notes.NOTE
			+ " TEXT," 
			+ Notes.CREATEDDATE 
			+ " INTEGER,"
			+ Notes.MODIFIEDDATE 
			+ " INTEGER" + "); "
			;
	
	private static final UriMatcher sUriMatcher; 
	private static final int NOTES = 1; 
	private static final int NOTE_ID = 2; 
	
	private static HashMap<String, String> sNotesProjectionMap;
	
	static{ 
		sUriMatcher = new UriMatcher(UriMatcher.NO_MATCH); 
		sUriMatcher.addURI(NotePad.AUTHORITY, "notes", NOTES); 
		sUriMatcher.addURI(NotePad.AUTHORITY, "notes/#", NOTE_ID); 
		
		sNotesProjectionMap = new HashMap<String, String>();
		sNotesProjectionMap.put(Notes._ID, Notes._ID);
		sNotesProjectionMap.put(Notes.TITLE, Notes.TITLE); 
		sNotesProjectionMap.put(Notes.NOTE, Notes.NOTE); 
		sNotesProjectionMap.put(Notes.CREATEDDATE, Notes.CREATEDDATE); 
		sNotesProjectionMap.put(Notes.MODIFIEDDATE, Notes.MODIFIEDDATE); 
	}
	
	private DatabaseHelper mOpenHelper; 
	
	private static class DatabaseHelper extends SQLiteOpenHelper{ 
		DatabaseHelper(Context context){
			super(context, DATABASE_NAME, null, DATABASE_VERSION); 
		}

		@Override
		public void onCreate(SQLiteDatabase arg0) {
			// TODO Auto-generated method stub
			//创建数据库表
			arg0.execSQL(CREATE_TABLE);
		}

		@Override
		public void onUpgrade(SQLiteDatabase arg0, int arg1, int arg2) {
			// TODO Auto-generated method stub
			arg0.execSQL("DROP TABLE IF EXISTS notes"); 
			onCreate(arg0);
		}
	}
	
	@Override
	//创建数据库表,并获取数据库句柄
	public boolean onCreate() {
		// TODO Auto-generated method stub
		mOpenHelper = new DatabaseHelper(getContext()); 
		db = mOpenHelper.getWritableDatabase();
		return true;
	}	
	
	@Override
	//向数据库表插入一条记录
	public Uri insert(Uri uri, ContentValues initialValues) {
		// TODO Auto-generated method stub
		if (sUriMatcher.match(uri) != NOTES) { 
			throw new IllegalArgumentException("Unknown URI " + uri); 
		}
		
		ContentValues values; 
		if (initialValues != null) { 
			values = new ContentValues(initialValues); 
		}else { 
			values = new ContentValues(); 
		}
		
		Long now = Long.valueOf(java.lang.System.currentTimeMillis()); 
		if (values.containsKey(NotePad.Notes.CREATEDDATE) == false) { 
			values.put(NotePad.Notes.CREATEDDATE, now);
		}
		if (values.containsKey(NotePad.Notes.MODIFIEDDATE) == false) { 
			values.put(NotePad.Notes.MODIFIEDDATE, now); 
		}
		
		if (values.containsKey(NotePad.Notes.TITLE) == false) { 
			Resources r = Resources.getSystem();
			values.put(NotePad.Notes.TITLE, r.getString(android.R.string.unknownName)); 
		}
		
		if (values.containsKey(NotePad.Notes.NOTE) == false) { 
			values.put(NotePad.Notes.NOTE, ""); 
		}
		
		long rowId = db.insert(NOTES_TABLE_NAME, Notes.NOTE, values); 
		if (rowId > 0) { 
			//负责把/rowId追加到CONTENT_URI的后面,连接成一个新的uri
			Uri noteUri = ContentUris.withAppendedId(NotePad.Notes.CONTENT_URI, rowId);
			getContext().getContentResolver().notifyChange(noteUri, null);
			return noteUri; 
		}
		throw new SQLException("Failed to insert row into" + uri); 
	}	

	@Override
	public int delete(Uri uri, String selection, String[] selectionArgs) {
		// TODO Auto-generated method stub
		int count; 
		switch (sUriMatcher.match(uri)) {
		case NOTES:
			count = db.delete(NOTES_TABLE_NAME, selection, selectionArgs); 
			break;
			
		case NOTE_ID: {
			String noteId = uri.getPathSegments().get(1);  
			count = db.delete(NOTES_TABLE_NAME, Notes._ID + "=" + noteId + (!TextUtils.isEmpty(selection) ? " AND (" + selection + ')' : ""), selectionArgs);
			break;
		}
		
		default: 
			throw new IllegalArgumentException("Unnown URI" + uri); 
		}
		getContext().getContentResolver().notifyChange(uri, null);  
		return count;
	}

	@Override
	public String getType(Uri arg0) {
		// TODO Auto-generated method stub
		return null;
	}

	@Override
	//selection是条件语句
	public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs,
			String sortOrder) {
		// TODO Auto-generated method stub
		/*Cursor cursor; 
		switch(sUriMatcher.match(uri)) {
		case NOTES:
			cursor= db.query(NOTES_TABLE_NAME, projection, selection, selectionArgs, null, null, sortOrder);
			break;
		case NOTE_ID:
			long id=ContentUris.parseId(uri);
			String myselection="_id="+id; 
			if(selection!=null){
				myselection +=selection;
			}
			cursor =db.query(NOTES_TABLE_NAME, projection, myselection, selectionArgs, null, null, sortOrder);
			break;
		default:  
			throw new IllegalArgumentException("Unknown URI " + uri); 
		}
		return cursor;*/
		
		SQLiteQueryBuilder qb = new SQLiteQueryBuilder();  
		switch (sUriMatcher.match(uri)) {
		case NOTES:
			qb.setTables(NOTES_TABLE_NAME);  
			qb.setProjectionMap(sNotesProjectionMap); 
			break; 
		case NOTE_ID: 
			qb.setTables(NOTES_TABLE_NAME); 
			qb.setProjectionMap(sNotesProjectionMap);  
			qb.appendWhere(Notes._ID + "=" + uri.getPathSegments().get(1)); 
			break; 
		default:  
			throw new IllegalArgumentException("Unknown URI " + uri); 
		}
		
		String orderBy;
		if (TextUtils.isEmpty(sortOrder)) {
			orderBy = NotePad.Notes.DEFAULT_SORT_ORDER;
		}else{
			orderBy = sortOrder; 
		}
		Cursor c = qb.query(db, projection, selection, selectionArgs, null, null, orderBy);
		c.setNotificationUri(getContext().getContentResolver(), uri); 
		return c;
	}

	@Override
	public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
		// TODO Auto-generated method stub
		int count; 
		switch (sUriMatcher.match(uri)) { 
		case NOTES:
			count = db.update(NOTES_TABLE_NAME, values, selection, selectionArgs); 
			break;
		case NOTE_ID: 
			String noteId = uri.getPathSegments().get(1); 
			count = db.update(NOTES_TABLE_NAME, values, Notes._ID + "=" + noteId + (!TextUtils.isEmpty(selection) ? " AND (" + selection + ')' : ""), selectionArgs);
			break; 
		default: 
			throw new IllegalArgumentException("Unknow URI " + uri);  
		}
		return count;
	}
}

3. MainActivity.java

public class MainActivity extends Activity {
	private TextView mView;

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);
		
		mView=(TextView)this.findViewById(R.id.textView1);
		
		//向数据库表插入一条记录
		//NotePad.Notes.CONTENT_URI指到的是一个数据库表
		ContentValues values = new ContentValues(); 
		values.put(NotePad.Notes.TITLE, "title1"); 
		values.put(NotePad.Notes.NOTE, "NOTENOTE1");  
		getContentResolver().insert(NotePad.Notes.CONTENT_URI, values);
		
		values.clear(); 
		values.put(NotePad.Notes.TITLE, "title2"); 
		values.put(NotePad.Notes.NOTE, "NOTENOTE2");  
		getContentResolver().insert(NotePad.Notes.CONTENT_URI, values); 
		
		displayNote(); 
	}
	
	private void displayNote(){
		/*
		Context ctx = MainActivity.this;
		ContentResolver resolver = ctx.getContentResolver();
		Cursor c = resolver.query(NotePad.Notes.CONTENT_URI, null, null, null, null);
		c.moveToFirst();
		for(int i=0; i<c.getCount(); i++){
			//NotePad.Notes.TITLE是一个数据库表的字段名,index是该字段的索引
			int index = c.getColumnIndexOrThrow(NotePad.Notes.TITLE);
			String src = c.getString(index);
			c.moveToNext();
			mView.setText("NOTE:"+src);
		}*/
		
		String columns[] = new String[] { 
				NotePad.Notes.TITLE,
				NotePad.Notes.NOTE,
				NotePad.Notes.CREATEDDATE,
				NotePad.Notes.MODIFIEDDATE
				}; 
		Uri myUri = NotePad.Notes.CONTENT_URI; 
		Cursor cur = managedQuery(myUri, columns, null, null, null); 
		if (cur.moveToFirst()) { 
			String note = null; 
			String titile = null; 
			do { 
				note = cur.getString(cur.getColumnIndex(NotePad.Notes.NOTE)); 
				titile = cur.getString(cur.getColumnIndex(NotePad.Notes.TITLE));
				/*Toast toast = Toast.makeText(this, "TITILE:"+id + "\t" + "NOTE:" + titile, Toast.LENGTH_LONG);
				toast.setGravity(Gravity.TOP|Gravity.CENTER, 0, 40);
				toast.show();*/
				mView.setText("TITILE:"+titile + "\n" + "NOTE:" + note);
			}while (cur.moveToNext()); 
		}

	}
}


 

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值