ContentProvider的使用

这方面的资料应该网上已经很多了,我在这里只是做简单的总结就行了。

如题:ContentProvider是android的内容提供器,可以为应用程序提供各种的数据,例如数据表,txt文件,xml文件等等。应用程序可以利用SQLLiteDataBase这个类来操作数据表中的内容。

下面就简单的介绍下ContentProvider的具体使用。

ContentProvider使用可以分为两种情况:1.使用android系统提供的数据内容。2.使用android系统以外的应用程序提供的数据内容。

下面就分别介绍下这两种情况的使用过程。

1.使用android系统提供的数据内容

 这里对android系统提供的通讯录进行操作

 首先通过ContentResolver这个类来获得数据表的访问模型

 

ContentResolver resolver = getContentResolver();


有了这个类,再知道通讯录的uri,还有操作的参数就可以对通讯录操作了。

 

需要修改的内容(也就是sql中需要修改的部分)

 

ContentValues values = new ContentValues();

现在往通讯录中添加一条数据

 

首先需要获得一个通讯录的数据表中的id,之后为这个id添加相应的数据

 

// 向RawContacts.CONTENT_URI执行一个空值插入,

				// 目的是获取系统返回的rawContactId

				Uri uri = resolver.insert(RawContacts.CONTENT_URI, values);

 

// 获得新增空值的id

				long id = ContentUris.parseId(uri);


向新增的id中添加联系人

 

 

values.put(Data.RAW_CONTACT_ID, id);

				// 设置内容类性

				values.put(Data.MIMETYPE, StructuredName.CONTENT_ITEM_TYPE);

				// 设置联系人的名字

				values.put(StructuredName.GIVEN_NAME, name.getText().toString());

				// 向联系人URI添加联系人名字

				resolver.insert(

						ContactsContract.Data.CONTENT_URI,

						values);

这样的话联系人的姓名就被添加到通讯录中了,如果还要添加电话号码,email等内容的话。同理如下处理:

 

 

values.clear();

				values.put(Data.RAW_CONTACT_ID, id);

				values.put(Data.MIMETYPE, Phone.CONTENT_ITEM_TYPE);

				// 添加电话号码

				values.put(Phone.NUMBER, phone.getText().toString());

				values.put(Phone.TYPE, Phone.TYPE_MOBILE);

				resolver.insert(

						android.provider.ContactsContract.Data.CONTENT_URI,

						values);

				values.clear();

				// 添加email

				values.put(Data.RAW_CONTACT_ID, id);

				values.put(Data.MIMETYPE, Email.CONTENT_ITEM_TYPE);

				values.put(Email.DATA, email.getText().toString());

				values.put(Email.TYPE,Email.TYPE_WORK );

				resolver.insert(

						android.provider.ContactsContract.Data.CONTENT_URI,

						values);

别忘记添加对通讯录的权限

 <uses-permission android:name="android.permission.READ_CONTACTS"/>

    <uses-permission android:name="android.permission.WRITE_CONTACTS"/>


这样第一种情况就算完成了。注意添加不同的信息的时候ContentValues的put的内容的不同。

 


第二种情况,应用程序1访问应用程序2的数据内容,那么首先要将程序2的数据内容构造成一个ContentProvider,供程序1使用。

那么这里依旧将程序2中数据表的内容共享出来。


第一步:为程序2建造一个数据库,紧接生成数据表

 

public class MyDatabaseHelper extends SQLiteOpenHelper {



	/**   

	 * 创建数据表

	 */

	final String CREATE_TABLE_SQL = "create table dict(_id integer primary key autoincrement , word , detail)";



	/**

	 * @param context 上下午对象

	 * @param name 数据库名称

	 * @param version 版本号

	 */

	public MyDatabaseHelper(Context context, String name, int version) {

		super(context, name, null, version);

	}



	@Override

	public void onCreate(SQLiteDatabase db) {

		// 第一次使用数据库时自动建表

		db.execSQL(CREATE_TABLE_SQL);

	}



	/* (non-Javadoc)更新数据库   

	 * @see android.database.sqlite.SQLiteOpenHelper#onUpgrade(android.database.sqlite.SQLiteDatabase, int, int)   

	 */

	@Override

	public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {

		System.out.println("--------onUpdate Called--------" + oldVersion

				+ "--->" + newVersion);

	}

}

这样实例化

MyDatabaseHelper dbHelper = new MyDatabaseHelper(this, "myDict.db3", 1);

就可以建立一个数据库并生成一个数据表

 

因为MyDatabaseHelper继承了SQLiteOpenHelper,所有就可以使用dbHelper来操作数据库和数据表了

新增一条记录word,detail是传入表中两个字段的内容

 

dbHelper.execSQL("insert into dict values(null , ? , ?)", new String[] {

				word, detail });


这样的话就将数据库和表创建成功

 

下一步将表的内容构建成ContentProvider,供其他的程序使用

 

/**

 * 

 */

package org.crazyit.content;



import android.content.ContentProvider;

import android.content.ContentUris;

import android.content.ContentValues;

import android.content.UriMatcher;

import android.database.Cursor;

import android.database.sqlite.SQLiteDatabase;

import android.net.Uri;



/**

 * Description:将新建的数据库共享(注意必须要继承ContentProvider,需要在配置文件增加provider节点)

 * <br/>网站: <a href="http://www.crazyit.org">疯狂Java联盟</a> 

 * <br/>Copyright (C), 2001-2012, Yeeku.H.Lee

 * <br/>This program is protected by copyright laws.

 * <br/>Program Name:

 * <br/>Date:

 * @author  Yeeku.H.Lee [email protected]

 * @version  1.0

 */

public class DictProvider extends ContentProvider {

	/**   

	 * 未匹配

	 */

	private static UriMatcher matcher = new UriMatcher(UriMatcher.NO_MATCH);

	private static final int WORDS = 1;

	private static final int WORD = 2;

	private MyDatabaseHelper dbOpenHelper;

	static {

		// 为UriMatcher注册两个Uri(用于查询的时候作为条件)

		matcher.addURI(Words.AUTHORITY, "words", WORDS);

		matcher.addURI(Words.AUTHORITY, "word/#", WORD);

	}



	// 第一次调用该DictProvider时,系统先创建DictProvider对象,并回调该方法

	@Override

	public boolean onCreate() {

		dbOpenHelper = new MyDatabaseHelper(this.getContext(), "myDict.db3", 1);

		return true;

	}



	// 插入数据方法

	@Override

	public Uri insert(Uri uri, ContentValues values) {

		// 获得数据库实例

		SQLiteDatabase db = dbOpenHelper.getReadableDatabase();

		// 插入数据,返回行ID

		long rowId = db.insert("dict", Words.Word._ID, values);

		// 如果插入成功返回uri

		if (rowId > 0) {

			// 在已有的 Uri的后面追加ID数据

			Uri wordUri = ContentUris.withAppendedId(uri, rowId);

			// 通知数据已经改变(这句话很重要,体现了实时的更新)

			getContext().getContentResolver().notifyChange(wordUri, null);

			return wordUri;

		}

		return null;

	}



	// 删除数据的方法

	@Override

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

		SQLiteDatabase db = dbOpenHelper.getReadableDatabase();

		// 记录所删除的记录数

		int num = 0;

		// 对于uri进行匹配。

		switch (matcher.match(uri)) {

		case WORDS:

			num = db.delete("dict", selection, selectionArgs);

			break;

		case WORD:

			// 解析出所需要删除的记录ID

			long id = ContentUris.parseId(uri);

			String where = Words.Word._ID + "=" + id;

			// 如果原来的where子句存在,拼接where子句

			if (selection != null && !selection.equals("")) {

				where = where + " and " + selection;

			}

			num = db.delete("dict", where, selectionArgs);

			break;

		default:

			throw new IllegalArgumentException("未知Uri:" + uri);

		}

		// 通知数据已经改变

		getContext().getContentResolver().notifyChange(uri, null);

		return num;

	}



	// 修改数据的方法

	@Override

	public int update(Uri uri, ContentValues values, String selection,

			String[] selectionArgs) {

		SQLiteDatabase db = dbOpenHelper.getWritableDatabase();

		// 记录所修改的记录数

		int num = 0;

		switch (matcher.match(uri)) {

		case WORDS:

			num = db.update("dict", values, selection, selectionArgs);

			break;

		case WORD:

			// 解析出想修改的记录ID

			long id = ContentUris.parseId(uri);

			String where = Words.Word._ID + "=" + id;

			// 如果原来的where子句存在,拼接where子句

			if (selection != null && !selection.equals("")) {

				where = where + " and " + selection;

			}

			num = db.update("dict", values, where, selectionArgs);

			break;

		default:

			throw new IllegalArgumentException("未知Uri:" + uri);

		}

		// 通知数据已经改变

		getContext().getContentResolver().notifyChange(uri, null);

		return num;

	}



	// 查询数据的方法

	@Override

	public Cursor query(Uri uri, String[] projection, String selection,

			String[] selectionArgs, String sortOrder) {

		SQLiteDatabase db = dbOpenHelper.getReadableDatabase();

		// 这里主要是判断查询条件

		switch (matcher.match(uri)) {

		case WORDS:

			// 执行查询

			return db.query("dict", projection, selection, selectionArgs, null,

					null, sortOrder);

		case WORD:

			// 解析出想查询的记录ID

			long id = ContentUris.parseId(uri);

			String where = Words.Word._ID + "=" + id;

			// 如果原来的where子句存在,拼接where子句

			if (selection != null && !"".equals(selection)) {

				where = where + " and " + selection;

			}

			return db.query("dict", projection, where, selectionArgs, null,

					null, sortOrder);

		default:

			throw new IllegalArgumentException("未知Uri:" + uri);

		}

	}



	// 返回指定uri参数对应的数据的MIME类型

	@Override

	public String getType(Uri uri) {

		switch (matcher.match(uri)) {

		// 如果操作的数据是多项记录

		case WORDS:

			return "vnd.android.cursor.dir/org.crazyit.dict";

			// 如果操作的数据是单项记录

		case WORD:

			return "vnd.android.cursor.item/org.crazyit.dict";

		default:

			throw new IllegalArgumentException("未知Uri:" + uri);

		}

	}

}


上面的类用到了一些静态的变量

 

 

public final class Words

{

	// 定义该ContentProvider的Authority

	public static final String AUTHORITY 

		= "org.crazyit.providers.dictprovider";

	//定义一个静态内部类

	public static final class Word implements BaseColumns

	{

		// 定义Content所允许操作的3个数据列

		public final static String _ID = "_id";

		public final static String WORD = "word";

		public final static String DETAIL = "detail";

		// 定义该Content提供服务的两个Uri

		public final static Uri DICT_CONTENT_URI = 

			Uri.parse("content://" +  AUTHORITY + "/words");

		public final static Uri WORD_CONTENT_URI = 

			Uri.parse("content://" +  AUTHORITY + "/word");		

	}

}


最后需要在清单文件中声明这个ContentProvider

 

 

<!-- 注册一个ContentProvider -->

		<provider android:name=".DictProvider" 

			android:authorities="org.crazyit.providers.dictprovider"/>


这样程序2就已经将数据表的内容提供了出来,我们在程序1只需要在按照第一种情况对数据表进行操作即可。

 

在程序1中如下操作

 

// 获取系统的ContentResolver对象

		contentResolver = getContentResolver();


新增一条数据(Words类和程序2中的是同样的)

 

 

//插入生词记录

				ContentValues values = new ContentValues();

				values.put(Words.Word.WORD , word);

				values.put(Words.Word.DETAIL , detail);

				contentResolver.insert(Words.Word.DICT_CONTENT_URI , values);


增删改查只要按照上面的操作举一反三即可。(注意的是数据表的uri的构建)

 


好了大体就是这个样子了,如果还有疑问,请看传播智客的视频,绝大部分都参考其内容。

测试的过程中,如果程序2没有启动,那么程序1是没有办法去操作程序2提供的数据表内容的。









 

你可能感兴趣的:(ContentProvider)