1.ContentProvider简单介绍
在Android中有些数据(如通讯录、音频、视频文件等)是要供非常多应用程序使用的。为了更好地对外提供数据。Android系统给我们提供了Content Provider使用。通过它能够訪问上面所说的数据,比如非常多音乐播放器中的扫描功能事实上就用到了Content Provider功能(当然。也有的播放器是自己去实现更底层的功能)。这种优点是统一管理。比方添加了某个音频文件,底层就会将这种变化通知Content Provider,从而当应用程序訪问时就能够获得当前最新的数据。
当然,Android也同意我们定义自己的Content Provider。仅仅要继承它的基类,而且实现以下的方法就可以。
public boolean onCreate() 在创建ContentProvider时调用
public Cursor query(Uri, String[], String, String[], String):用于查询指定Uri的ContentProvider。返回一个Cursor
public Uri insert(Uri, ContentValues):依据指定的Uri加入数据到ContentProvider中
public int update(Uri, ContentValues, String, String[]):用于更新指定Uri的ContentProvider中的数据
public int delete(Uri, String, String[]):依据Uri删除指定的数据
public String getType(Uri):用于返回指定的Uri中的数据的MIME类型
*假设操作的数据属于集合类型。那么MIME类型字符串应该以vnd.android.cursor.dir/开头。
比如:要得到全部p1记录的Uri为content://contacts/p1,那么返回的MIME类型字符串为"vnd.android.cursor.dir/p1"。
*假设要操作的数据属于非集合类型数据。那么MIME类型字符串应该以vnd.android.cursor.item/开头。
比如:要得到id为100的student记录的Uri为content://contacts/student/100。那么返回的MIME类型字符串应为"vnd.android.cursor.item/student"。
2.Uri简单介绍
一个标准的Uri为content://authority/path可分为下面三部分:
(1)content://:这个部分是ContentProvider规定的,就像http://代表Http这个协议一样。使用ContentProvider的协议是content://
(2)authorities:它在所在的Android系统必须是唯一的,由于系统就是通过它来决定操作或訪问哪个ContentProvider的。这与互联网上的网址必须唯一是一样的道理。
(3)path:资源路径。
显然,从上面的分析能够看出ContentProvider尽管也可实现跨进程通信。可是它适用的场景主要是与数据库相关。有时也可能是文本文件或XML等存储方式。
3.ContentResolver
假设仅仅是定义一个ContentProvider的话,没有不论什么意义,由于ContentProvider仅仅是内容提供者,它要被别的应用(进程)读取才有价值。
与实现ContentProvder的方法相相应,使用ContentResolver相关的方法例如以下所看到的:
getContentResolver():Context类提供的,用于获取ContentResolver对象;
insert(Uri uri,ContentValues values):向Uri相应的ContentProvider中插入values相应的数据;
update(Uri uri,ContentValues values,String where,String[]selectionArgs):更新Uri相应的ContentProvider中where处的数据。当中selectionArgs是筛选參数。
query(Uri uri,String[]projection,String selection,String[]selectionArgs,String sortOrder):查询Uri相应的ContentProvider中where处的数据,当中selectionArgs是筛选參数,sortOrder是排序方式。
delete(Uri uri,String where,String[]selectionArgs):删除Uri相应的ContentProvider中where处的数据。当中selectionArgs是筛选參数。
4.UriMatcher
为了确定一个ContentProvider实际能处理的Uri。以及确定每一个方法中Uri參数所操作的数据,Android系统提供了UriMatcher工具类。它主要有例如以下两个方法:
(1)void addURI(String authority,String path,String code):该方法用于向UriMatcher对象注冊Uri。
当中authority和path组合成一个Uri,而code则代表该Uri相应的标识码;
(2)int match(Uri uri):依据前面注冊的Uri来推断指定Uri相应的标识码。
假设找不到匹配的标识码。该方法将会返回-1。
以下通过两个实例来解说ContentProvider的使用方法,第一个实例是自定义了一个ContentProvider而且在还有一个应用中读取它;第二个实例是读取当前手机中的联系人。
首先是第一个样例,项目结构例如以下图所看到的:
以下是各个类的代码。首先是常量的定义:
package com.android.student.utils; import android.net.Uri; /** * 这里定义了与ContentProvider相关的字符串以及Student相应的数据表中的字段 * @author Bettar * */ public class StudentWords { //注意Manifest文件里的authorities属性要跟这里保持一致。 public static final String AUTHORITY="com.android.student.provider"; public static final Uri STUDENT_WITH_ID_URI=Uri.parse("content://"+AUTHORITY+"/student"); public static final Uri STUDENT_URI=Uri.parse("content://"+AUTHORITY+"/student"); public static final String TABLE_NAME="student"; public static final String ID="id"; public static final String NAME="name"; public static final String SCORE="score"; public static final String ADDR="address"; }然后是数据库帮助类:
import com.android.student.utils.StudentWords; import android.content.Context; import android.database.sqlite.SQLiteDatabase; import android.database.sqlite.SQLiteOpenHelper; import android.widget.Toast; public class StudentDbHelper extends SQLiteOpenHelper{ private Context context; public StudentDbHelper(Context context,String name,int version) { super(context,name,null,version); this.context=context; } @Override public void onCreate(SQLiteDatabase db) { String createSQL="create table "+StudentWords.TABLE_NAME+"("+StudentWords.ID +" integer primary key autoincrement," +StudentWords.NAME+" varchar," +StudentWords.SCORE+" integer," +StudentWords.ADDR+" varchar)"; db.execSQL(createSQL); } @Override public void onUpgrade(SQLiteDatabase db,int oldVersion,int newVersion) { //升级版本号时,可能要运行表结构的改动之类,此处临时不考虑升级问题。因而仅仅是用Toast提示 Toast.makeText(context, "newVersion:"+newVersion+" will replace oldVersion:"+oldVersion, Toast.LENGTH_LONG).show(); } }最后是ContentProvider类的定义:
package com.android.student.provider; import com.android.student.database.StudentDbHelper; 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.provider.UserDictionary.Words; import com.android.student.utils.StudentWords; public class StudentProvider extends ContentProvider{ private static final String TAG="StudentProvider"; private static UriMatcher matcher=new UriMatcher(UriMatcher.NO_MATCH); private static final int STUDENT_WITH_ID=1; private static final int STUDENT=2; private StudentDbHelper dbHelper; static { matcher.addURI(StudentWords.AUTHORITY,"student/#",STUDENT_WITH_ID); //matcher.addURI(StudentWords.AUTHORITY, "student", SINGLE_STUDENT); //注意当中的#为通配符 matcher.addURI(StudentWords.AUTHORITY, "student", STUDENT); } @Override public boolean onCreate() { dbHelper=new StudentDbHelper(this.getContext(),"student.db3",1); return true; } @Override public String getType(Uri uri) { switch(matcher.match(uri)) { case STUDENT_WITH_ID: return "vnd.android.cursor.item/com.android.student"; case STUDENT: return "vnd.android.cursor.dir/com.android.student"; default: throw new IllegalArgumentException("Unknown Uri:"+uri); } } /** * 由单一的selection这一个筛选条件组合成包括id的复杂筛选条件 * @param uri * @param selection * @return */ private String getComplexSelection(Uri uri,String selection) { long id=ContentUris.parseId(uri); String complexSelection=StudentWords.ID+"="+id; if(selection!=null&&!"".equals(selection)) { complexSelection+=" and "+selection; } return complexSelection; } @Override public int delete(Uri uri,String selection,String[]selectionArgs) { SQLiteDatabase db=dbHelper.getReadableDatabase(); int num=0; switch(matcher.match(uri)) { case STUDENT_WITH_ID: String complexSelection=getComplexSelection(uri,selection); num=db.delete(StudentWords.TABLE_NAME, complexSelection, selectionArgs); break; case STUDENT: num=db.delete(StudentWords.TABLE_NAME,selection,selectionArgs); break; default: throw new IllegalArgumentException("Unknown Uri:"+uri); } //通知数据已经改变 getContext().getContentResolver().notifyChange(uri, null); return num; } @Override public Uri insert(Uri uri, ContentValues values) { SQLiteDatabase db=dbHelper.getReadableDatabase(); switch(matcher.match(uri)) { case STUDENT_WITH_ID: case STUDENT: long rowId=db.insert(StudentWords.TABLE_NAME, StudentWords.ID,values); if(rowId>0) { Uri studentUri=ContentUris.withAppendedId(uri, rowId); //假设设置了观察者的话,要通知全部观察者 getContext().getContentResolver().notifyChange(studentUri, null); return studentUri; } break; default: throw new IllegalArgumentException("Unknow Uri:"+uri); } return null; } /** * 注意当中的projection事实上是columns,即列名数组 */ @Override public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) { SQLiteDatabase db=dbHelper.getReadableDatabase(); switch(matcher.match(uri)) { //这事实上是包括id信息的情况 case STUDENT_WITH_ID: String complexSelection=getComplexSelection(uri,selection); return db.query(StudentWords.TABLE_NAME,projection,complexSelection,selectionArgs,null,null,sortOrder); //这是不带数字的情况,可是也未必就是好多个,一个也能够。 case STUDENT: return db.query(StudentWords.TABLE_NAME ,projection,selection,selectionArgs,null,null,sortOrder); default: throw new IllegalArgumentException("Unknow Uri"+uri); } } @Override public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) { SQLiteDatabase db=dbHelper.getWritableDatabase(); int num=0; switch(matcher.match(uri)) { case STUDENT_WITH_ID: String complexSelection=getComplexSelection(uri,selection); num=db.update(StudentWords.TABLE_NAME, values, complexSelection, selectionArgs); break; case STUDENT: num=db.update(StudentWords.TABLE_NAME, values, selection,selectionArgs); break; default: throw new IllegalArgumentException("Unknow Uri:"+uri); } getContext().getContentResolver().notifyChange(uri,null); return num; } }当然,要记得在Manifest文件里增加ContentProvider的声明:
<provider android:name="com.android.student.provider.StudentProvider" android:authorities="com.android.student.provider" android:exported="true"/>以下是对ContentResolver的样例,首先项目中的文件结构例如以下:
然后是layout文件 :
<ScrollView xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="fill_parent" android:layout_height="wrap_content" > <LinearLayout xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" android:paddingBottom="@dimen/activity_vertical_margin" android:paddingLeft="@dimen/activity_horizontal_margin" android:paddingRight="@dimen/activity_horizontal_margin" android:paddingTop="@dimen/activity_vertical_margin" android:orientation="vertical" tools:context=".MainActivity" > <TextView android:id="@+id/tv" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="下面为输入參数:" /> <EditText android:id="@+id/nameET" android:layout_width="fill_parent" android:layout_height="wrap_content" android:hint="Name" /> <EditText android:id="@+id/scoreET" android:layout_width="fill_parent" android:layout_height="wrap_content" android:hint="Score" /> <EditText android:id="@+id/addrET" android:layout_width="fill_parent" android:layout_height="wrap_content" android:hint="Address" /> <Button android:id="@+id/insertButton" android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="Insert" /> <TextView android:id="@+id/searchTv" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="下面为查询參数:" /> <EditText android:id="@+id/inputNameET" android:layout_width="fill_parent" android:layout_height="wrap_content" android:hint="Input name" /> <Button android:id="@+id/searchButton" android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="Search" /> <TextView android:id="@+id/searchResultTv" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="下面为Update參数" /> <EditText android:id="@+id/inputIdET" android:layout_width="fill_parent" android:layout_height="wrap_content" android:hint="Input id" /> <Button android:id="@+id/updateButton" android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="Update" /> <TextView android:id="@+id/searchResultTv" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="下面为删除參数" /> <EditText android:id="@+id/inputIdForDeleteET" android:layout_width="fill_parent" android:layout_height="wrap_content" android:hint="Input id" /> <Button android:id="@+id/deleteButton" android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="Delete" /> </LinearLayout> </ScrollView>项目中也有StudentWords这个类,由于与上面的StudentWords全然同样,故此处不再列出,MainActivity的代码例如以下:
package com.android.student.studentcontentresolver; import java.util.ArrayList; import java.util.List; import java.util.Map; import com.android.student.utils.StudentWords; import android.net.Uri; import android.os.Bundle; import android.app.Activity; import android.content.ContentResolver; import android.content.ContentUris; import android.content.ContentValues; import android.database.Cursor; import android.view.Menu; import android.widget.Button; import android.widget.EditText; import android.widget.Toast; import android.view.View; public class MainActivity extends Activity implements View.OnClickListener{ ContentResolver contentResolver; private EditText nameET,scoreET,addressET; private Button insertButton; private EditText inputNameET; private Button searchButton; private EditText inputIdForUpdateET,inputIdForDeleteET; private Button updateButton,deleteButton; private void initView() { nameET=(EditText)findViewById(R.id.nameET); scoreET=(EditText)findViewById(R.id.scoreET); addressET=(EditText)findViewById(R.id.addrET); insertButton=(Button)findViewById(R.id.insertButton); inputNameET=(EditText)findViewById(R.id.inputNameET); searchButton=(Button)findViewById(R.id.searchButton); inputIdForUpdateET=(EditText)findViewById(R.id.inputIdET); inputIdForDeleteET=(EditText)findViewById(R.id.inputIdForDeleteET); updateButton=(Button)findViewById(R.id.updateButton); deleteButton=(Button)findViewById(R.id.deleteButton); insertButton.setOnClickListener(this); searchButton.setOnClickListener(this); updateButton.setOnClickListener(this); deleteButton.setOnClickListener(this); } @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); contentResolver=getContentResolver(); initView(); } @Override public void onClick(View view) { switch(view.getId()) { case R.id.insertButton: insert(); break; case R.id.searchButton: query(); break; case R.id.updateButton: update(); break; case R.id.deleteButton: delete(); break; default: break; } } private void insert() { String name=nameET.getText().toString(); String score=scoreET.getText().toString(); String addr=addressET.getText().toString(); ContentValues values=new ContentValues(); values.put(StudentWords.NAME, name); values.put(StudentWords.SCORE, new Integer(score)); values.put(StudentWords.ADDR, addr); //contentResolver.insert(StudentWords.SINGLE_STUDENT_URI, values); //一个是多个的特例,所以此处用MANY_STUDENTS_URI就可以。 contentResolver.insert(StudentWords.STUDENT_URI, values); Toast.makeText(getBaseContext(), "加入学生信息成功", Toast.LENGTH_SHORT).show(); } private void query() { String name=inputNameET.getText().toString(); //Cursor cursor=contentResolver.query(uri, projection, selection, selectionArgs, sortOrder) Cursor cursor=contentResolver.query(StudentWords.STUDENT_URI, null, "name like ?执行结果例如以下:or address like ?", new String[]{"%"+name+"%","%"+name+"%"}, null); Toast.makeText(getBaseContext(), getResult(cursor), Toast.LENGTH_LONG).show(); } private void update() { //Uri updateUri=StudentWords.SINGLE_STUDENT_URI //更新id值为id的记录 Integer id=new Integer(inputIdForUpdateET.getText().toString()); Uri updateUri=ContentUris.withAppendedId(StudentWords.STUDENT_WITH_ID_URI,id); ContentValues values=new ContentValues(); values.put(StudentWords.NAME,"VictorWang"); contentResolver.update(updateUri, values, null, null); } private void delete() { //删除id值为id的记录 Integer id=new Integer(inputIdForDeleteET.getText().toString()); Uri deleteUri=ContentUris.withAppendedId(StudentWords.STUDENT_WITH_ID_URI, id); contentResolver.delete(deleteUri, null, null); } private List<String>convertCursor2List(Cursor cursor) { List<String>result=new ArrayList<String>(); while(cursor.moveToNext()) { result.add(cursor.getString(1)+" "); result.add(cursor.getString(2)+" "); result.add(cursor.getString(3)+" "); } return result; } private String getResult(Cursor cursor) { StringBuilder sb=new StringBuilder(); while(cursor.moveToNext()) { sb.append(cursor.getString(1)+" "); sb.append(cursor.getString(2)+" "); sb.append(cursor.getString(3)+"\n"); } return sb.toString(); } @Override public boolean onCreateOptionsMenu(Menu menu) { // Inflate the menu; this adds items to the action bar if it is present. getMenuInflater().inflate(R.menu.main, menu); return true; } }
今天先写到这里,联系人和ContentObserver的样例后面再加入。
本文转自mfrbuaa博客园博客,原文链接http://www.cnblogs.com/mfrbuaa/p/5120123.html,如需转载请自行联系原作者