今天学习了ContentProvider,知道只要应用继承ContentProvider类,并重写该类用于提供数据和存储数据的方法,就可以向其他应用共享其数据。虽然使用其他方法也可以对外共享数据,但数据访问方式会因数据存储的方式而不同,如:采用文件方式对外共享数据,需要进行文件操作读写数据;采用sharedpreferences共享数据,需要使用sharedpreferences API读写数据。而使用ContentProvider共享数据的好处是统一了数据访问方式。
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")
因为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方法,来操作数据。
上面就是打打基础,稍稍解释一下ContentProvider中用到的很重要的元素——URI和一些相应的操作。不多说了哈,下面是一个测试工程,其中的注释对大家的理解应该也会小有帮助的^_^
首先是Manifest文件,一定要记得在里面注册Provider哈~
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.test.mycontentprovider"
android:versionCode="1"
android:versionName="1.0" >
<uses-sdk android:minSdkVersion="8" />
<application
android:icon="@drawable/ic_launcher"
android:label="@string/app_name" >
<activity
android:label="@string/app_name"
android:name=".ContentProviderTestActivity" >
<intent-filter >
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<provider android:name="MyFirstProvider" android:authorities="com.cp.test" />
</application>
</manifest>
再来就是数据定义的类啦~
package com.test.mycontentprovider;
import android.net.Uri;
public class DataDefine {
public static final String DB_NAME = "DB_Name";
public static final String TABLE_NAME = "Tab_Name";
public static final int VERSION = 1;
public static String ID = "id";
public static final String USERNAME = "username";
public static final String SEX = "sex";
public static final String AUTOHORITY = "com.cp.test";
public static final int ITEM = 1;
public static final int ITEM_ID = 2;
public static final String CONTENT_TYPE = "vnd.android.cursor.dir/vnd.ruixin.login";
//访问整个数据
public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/vnd.ruixin.login";
//访问集合中的某一条数据
public static final Uri CONTENT_URI = Uri.parse("content://" + AUTOHORITY + "/Tab_Name");
}
然后,是一个继承自SQLiteOpenHelper的类,一些简单的数据库的操作~
package com.test.mycontentprovider;
import android.content.ContentValues;
import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteOpenHelper;
import android.util.Log;
public class DBlite extends SQLiteOpenHelper {
public DBlite(Context context) {
super(context, DataDefine.DB_NAME, null, DataDefine.VERSION);
// TODO Auto-generated constructor stub
}
@Override
public void onCreate(SQLiteDatabase db) {
// TODO Auto-generated method stub
db.execSQL("create table " + DataDefine.TABLE_NAME + "("
+ DataDefine.ID
+ " integer primary key autoincrement not null,"
+ DataDefine.USERNAME + " text not null," + DataDefine.SEX
+ " text not null);");
}
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
// TODO Auto-generated method stub
}
public void add(String username, String sex) {
SQLiteDatabase db = getWritableDatabase();
ContentValues values = new ContentValues();
values.put(DataDefine.USERNAME, username);
values.put(DataDefine.SEX, sex);
db.insert(DataDefine.TABLE_NAME, "", values);
Log.i("TAG","add");
}
}
再下面就是我们的主角了哈~
package com.test.mycontentprovider;
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;
import android.text.TextUtils;
import android.util.Log;
/* 注意:这个类的类名一定要跟Manifest中注册的provider的name一致,不然系统会出现以下运行时错误
* java.lang.RuntimeException: Unable to get provider com.test.mycontentprovider.MyProvider: java.lang.ClassNotFoundException: com.test.mycontentprovider.MyProvider in loader dalvik.system.PathClassLoader[/data/app/com.test.mycontentprovider-2.apk]
*/
public class MyFirstProvider extends ContentProvider {
DBlite dBlite;
SQLiteDatabase db;
private static final UriMatcher sMatcher;
static {
sMatcher = new UriMatcher(UriMatcher.NO_MATCH);
sMatcher.addURI(DataDefine.AUTOHORITY, DataDefine.TABLE_NAME,
DataDefine.ITEM);
sMatcher.addURI(DataDefine.AUTOHORITY, DataDefine.TABLE_NAME + "/#",
DataDefine.ITEM_ID);
/*
* 创建匹配码表,以后使用Match.match(uri)方法时,其中的uri与addURI方法add进去的
* uri匹配,则返回addURI方法中对应uri后的那个数值码
*/
}
@Override
public int delete(Uri uri, String selection, String[] selectionArgs) {
// TODO Auto-generated method stub
db = dBlite.getWritableDatabase();
int count = 0;
switch (sMatcher.match(uri)) {
case DataDefine.ITEM:
count = db.delete(DataDefine.TABLE_NAME, selection, selectionArgs);
break;
case DataDefine.ITEM_ID:
String id = uri.getPathSegments().get(1);
count = db.delete(DataDefine.ID, DataDefine.ID
+ "="
+ id
+ (!TextUtils.isEmpty(DataDefine.ID = "?") ? "AND("
+ selection + ')' : ""), selectionArgs);
break;
default:
throw new IllegalArgumentException("Unknown URI" + uri);
}
getContext().getContentResolver().notifyChange(uri, null);
Log.i("TAG", "Delete...");
return count;
}
@Override
public String getType(Uri uri) {
// TODO Auto-generated method stub
switch (sMatcher.match(uri)) {
case DataDefine.ITEM:
Log.i("TAG", "getType");
return DataDefine.CONTENT_TYPE; // 这个是系统定义好了的TYPE——
case DataDefine.ITEM_ID:
Log.i("TAG", "getType");
return DataDefine.CONTENT_ITEM_TYPE;
default:
throw new IllegalArgumentException("Unknown URI" + uri);
}
}
@Override
public Uri insert(Uri uri, ContentValues values) {
// TODO Auto-generated method stub
db = dBlite.getWritableDatabase();
long rowId;
if (sMatcher.match(uri) != DataDefine.ITEM) {
throw new IllegalArgumentException("Unknown URI" + uri);
}
rowId = db.insert(DataDefine.TABLE_NAME, DataDefine.ID, values);
// 哲理insert的返回值是插入到表中所分配的ID值
if (rowId > 0) {
Uri noteUri = ContentUris.withAppendedId(DataDefine.CONTENT_URI,
rowId);
/*
* 以上这一方法是将刚刚返回的ID值连接到原来的URI后生成新的代表这个刚刚插入数据的URI
* 其实这边也可以用字符串的连接,将CINTENT_URI与rowId连接起来,再使用uri.Parse方法将其转换为URI类型
*/
getContext().getContentResolver().notifyChange(noteUri, null);
Log.i("TAG", "Insert......");
return noteUri;
}
throw new IllegalArgumentException("Unknown URI" + uri);
}
@Override
public boolean onCreate() {
// TODO Auto-generated method stub
this.dBlite = new DBlite(this.getContext());
// db = dBlite.getWritableDatabase();
// return (db == null)?false:true;
Log.i("TAG", "onCreate");
return true;
}
@Override
public Cursor query(Uri uri, String[] projection, String selection,
String[] selectionArgs, String sortOrder) {
// TODO Auto-generated method stub
db = dBlite.getWritableDatabase();
Cursor c;
Log.i("TAG",
"The match code --->" + String.valueOf(sMatcher.match(uri)));
switch (sMatcher.match(uri)) {
case DataDefine.ITEM:
c = db.query(DataDefine.TABLE_NAME, projection, selection,
selectionArgs, null, null, null);
break;
case DataDefine.ITEM_ID:
String id = uri.getPathSegments().get(1);
/*
* getPathSegments()方法能获得uri中的AUTOHORITY之后的路径,并且将路径拆分存储与一个数组中
* 如:content://com.cp.test/Tab_Name/3
* 经过上述方法后就将Tab_Name存放于数组中的第0个位置,ID值3存放于第1个位置
* 这边get(1)就是获得那个ID值,也就是3。 那下面的查询也就是查询ID=3的那一条记录了
*/
c = db.query(DataDefine.TABLE_NAME, projection, DataDefine.ID
+ "="
+ id
+ (!TextUtils.isEmpty(selection) ? "AND(" + selection + ')'
: ""), selectionArgs, null, null, sortOrder);
break;
default:
Log.i("TAG", "Unknown URI" + uri);
throw new IllegalArgumentException("Unknown URI" + uri);
}
c.setNotificationUri(getContext().getContentResolver(), uri);
Log.i("TAG", "Query");
return c;
}
@Override
public int update(Uri uri, ContentValues values, String selection,
String[] selectionArgs) {
// TODO Auto-generated method stub
Log.i("TAG", "Update");
return 0;
}
}
当然,如果仅仅只是在本应用工程中对该数据库进行所谓的增、删、改、查等等的操作,其实完全可以不用我们定义的ContentProvider的哈,就只在继承自
SQLiteOpenHelper的类中进行操作完全OK,但是我们定义ContentProvider干嘛的?不就是为了多个应用之间都能访问这些共享的数据么是吧~
继续继续哈,下面就是我们的测试程序,界面大家不要太介意啦,啥都木有>_<就以Toast的方式显示了一下数据库中的内容……
当然,因为是在同一个工程中,所以我把两种对数据库的访问方法都测了,大家有兴趣的话可以在新起一个工程,然后对这个数据库进行访问哈,那样直接操作肯定是不行的了,这个时候就是ContentProvider大显身手的时候了哟~
package com.test.mycontentprovider;
import android.app.Activity;
import android.content.ContentResolver;
import android.content.ContentValues;
import android.database.Cursor;
import android.os.Bundle;
import android.util.Log;
import android.widget.Toast;
public class ContentProviderTestActivity extends Activity {
/** Called when the activity is first created. */
private DBlite dBlite1 = new DBlite(this);;
private ContentResolver contentResolver;
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
/* 先对数据库进行添加数据——注意这边添加数据是用的DBlite中的add方法,
* 在该方法中封装了SQLiteOpenHelper中的insert系统方法,
* 而不是调用的ContentProvider中的insert方法,其实两个是一样的原理,只是使用方法不一样*/
dBlite1.add("zhangsan", "female");
dBlite1.add("lisi", "male");
dBlite1.add("wangwu", "female");
// 通过contentResolver进行查找
contentResolver = ContentProviderTestActivity.this.getContentResolver();
ContentValues values = new ContentValues();
values.put(DataDefine.USERNAME, "zhaoliu");
values.put(DataDefine.SEX, "male");
contentResolver.insert(DataDefine.CONTENT_URI, values);
//以上是通过ContentProvider的方法对共享的数据进行修改
Cursor cursor = contentResolver.query(DataDefine.CONTENT_URI,
new String[] { DataDefine.USERNAME, DataDefine.SEX }, null,
null, null);
while (cursor.moveToNext()) {
Toast.makeText(
ContentProviderTestActivity.this,
cursor.getString(cursor.getColumnIndex(DataDefine.USERNAME))
+ " "
+ cursor.getString(cursor.getColumnIndex(DataDefine.SEX)),
500).show();
Log.i("TAG",cursor.getString(cursor.getColumnIndex(DataDefine.USERNAME))
+ " "
+ cursor.getString(cursor.getColumnIndex(DataDefine.SEX)));
}
int cursor1 = contentResolver.delete(DataDefine.CONTENT_URI, DataDefine.USERNAME + "=?", new String[]{"deo"});
cursor = contentResolver.query(DataDefine.CONTENT_URI,
new String[] { DataDefine.USERNAME, DataDefine.SEX }, null,
null, null);
Log.i("TAG","Query again~~~~~~~");
while (cursor.moveToNext()) {
Toast.makeText(
ContentProviderTestActivity.this,
cursor.getString(cursor.getColumnIndex(DataDefine.USERNAME))
+ " "
+ cursor.getString(cursor.getColumnIndex(DataDefine.SEX)),
500).show();
Log.i("TAG",cursor.getString(cursor.getColumnIndex(DataDefine.USERNAME))
+ " "
+ cursor.getString(cursor.getColumnIndex(DataDefine.SEX)));
}
startManagingCursor(cursor); // 查找后关闭游标
}
}
好啦,就这样吧,希望大家看了有所帮助哈~~~
刚刚想了想,还是把在另一个工程中访问这个工程中的数据再传一下,因为还是有不少要注意的地方的~
先上代码哈~这个是在新起的一个工程中的哟~
package com.test;
import com.test.mycontentprovider.DataDefine;
import android.app.Activity;
import android.content.ContentResolver;
import android.database.Cursor;
import android.os.Bundle;
import android.util.Log;
import android.widget.Toast;
public class TestActivity extends Activity {
/** Called when the activity is first created. */
private ContentResolver contentResolver;
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
// 通过contentResolver进行查找
contentResolver = getContentResolver();
Cursor cursor = contentResolver.query(DataDefine.CONTENT_URI,
new String[] { DataDefine.USERNAME, DataDefine.SEX }, null,
null, null);
while (cursor.moveToNext()) {
Toast.makeText(
TestActivity.this,
cursor.getString(cursor.getColumnIndex(DataDefine.USERNAME))
+ " "
+ cursor.getString(cursor
.getColumnIndex(DataDefine.SEX)),
Toast.LENGTH_SHORT).show();
Log.i("TAG",cursor.getString(cursor.getColumnIndex(DataDefine.USERNAME))
+ " "
+ cursor.getString(cursor.getColumnIndex(DataDefine.SEX)));
}
startManagingCursor(cursor); // 查找后关闭游标
}
}
注意注意哈!如果啥都不做,就贴这个代码,肯定会出错的!那要做些啥呢?
首先,要把之前创建数据库的那个工程导出jar文件,这里一定要当心,导出jar文件的时候不能把整个工程导出为jar文件的,不然把这样的jar文件导入的新起的工程中时,在新起的工程中编译虽然不会有什么错啦,但是运行的时候就会提示有多个Manifest文件的错误,所以在导jar文件的时候只要把src导成jar即可;
刚刚既然导出jar文件了,那肯定是要用的,不然导它干嘛是吧~这时候就在新起的工程中Add Library把我们刚刚导出的jar文件导入,具体步骤如下:
右键工程,
Build path,
java build path,选择libraries
在右边的按钮中点击“Add Library”
选择“User library”,点击“下一步”
点击“User librarys”按钮
在出现的界面中点击“New..”按钮
在弹出的界面中随便起一个名字,点击“确定”
点击“Add jars”按钮选择第三方jar包,点击“确定”完成操作。
需要添加这么一个操作。在 Library旁边有个Order and Export
要将你刚刚添加的lib置为top
这会儿就可以看到ContentProvider的强大喽~哈哈~~~~~