Android入门进阶教程(20)-ContentProvider 数据共享

1、使用ContentProvider 共享数据： 
ContentProvider 类主要方法的作用如下： 

* public boolean onCreate(); -该方法在ContentProvider 创建后就会被调用，Android开机后，ContentProvider 
在其它应用第一次访问时才会被创建； 

* public Uri insert(Uri uri,ContentValues values); 
-该方法用于外部应用往ContentProvider添加数据； 
* public int delete(Uri uri ,String selection,String[] selectionArgs); 
-该方法用于外部应用从ContentProvider删除数据； 
* public int update(Uri uri ,ContentValues values ,String selection,String[] selectionArgs); 
-该方法用于外部应用更新ContenProvider数据； 
* public Cursor query(Uri uri,String[] projection,String selection,String[] selectionArgs,String sortOrder); 
-该方法用于外部应用从ContentProvider获取数据； 
* public String getType(Uri uri); 
-该方法用于返回当前Url 所代表数据的MIME类型， 

1.2 public String getType(Uri uri);该方法的使用介绍： 
该方法用于返回当前Url所代表数据的MIME类型。如果操作的数据属于集合类型，那么MIME类型字符串 
应该以vnd.android.cursor.dir/开头； 
例如：要得到所有person记录的 Uri为content://cn.itcast.provider.personprovider/person,那 
么返回的MIME类型字符串应该为：vnd.android.cursor.dir/person。 
如果要操作的数据属于非集合类型数据，那么MIME类型字符串应该以vnd.android.cursor.item/开头； 
例如：得到id为10的person的记录，Uri为：content://cn.itcast.provider.personprovider/person/10, 
那么返回的MIME类型字符串应该为：vnd.android.cursor.item/person; 



2、使用ContentResolver操作ContentProvider中的数据： 
* 工具类：ContentResolver 
当外部的应用需要对ContentProvider中的数据进行添加、删除、修改和查询的操作时，可以使用ContentResolver类 
来完成，要获取ContentResolver对象，可以使用Activity提供的getContentResolver()方法；ContentResolver提 
供了与ContentProvider类相同签名的四个方法： 
* public Uri insert(Uri uri,ContentValues values);
-往ContentProvider中添加数据； 
* public int delete(Uri uri,String selection ,String[] selectionArgs);
-从ContentProvider中删除数据； 
* public int update(Uri uri,ContentValues values,String selection,String[] selectionArgs); 
-更行ContentProvider中的数据； 
* public Cursor query(Uri uri,String[] projectionm,String selection ,String[] selectionArgs,String sortOrder); 
-该方法用于从Content中获取数据； 

【注：以上所有方法的第一个参数Uri，代表要操作的ContentProvider和对其中的什么数据进行操作；】 
例如：Uri.parse("content://cn.itcast.providers.personprovider/person/10"); 
表示：对主机名为：cn.itcast.providers.personprovider的ContentProvider进行操作，操作数据表person中id为 
10的记录； 

案例：模拟通讯录的操作：添加数据，删除，修改，查看； 
使用小贴士： 

首先：加入读写联系人信息的权限： 
<uses-permission android:name="android.permission.READ_CONTACTS"/> 
    <uses-permission android:name="android.permission.WRITE_CONTACTS"/> 
    
    需要使用到的Uri： 
    content://com.android.contacts/contacts 操作的数据是联系人的Uri; 
    content://com.android.contacts/data/phone 联系人电话Uri; 
    content://com.android.contacts/data/emails 联系人Email Uri; 
    
    注：表中不同的MIME，对应的Uri是不同的，如需获取对应类型的信息，那么Uri必须相对应； 
    
    具体实现代码： 

 package com.svse.contentprovider;

 import android.net.Uri;
 import android.os.Bundle;
 import android.provider.ContactsContract;
 import android.provider.ContactsContract.CommonDataKinds.Email;
 import android.provider.ContactsContract.CommonDataKinds.Phone;
 import android.provider.ContactsContract.CommonDataKinds.StructuredName;
 import android.provider.ContactsContract.Data;
 import android.provider.ContactsContract.RawContacts;
 import android.app.Activity;
 import android.content.ContentResolver;
 import android.content.ContentUris;
 import android.content.ContentValues;
 import android.content.UriMatcher;
 import android.database.Cursor;
 import android.view.Menu;
 import android.view.View;
 import android.view.View.OnClickListener;
 import android.widget.Button;
 import android.widget.Toast;

 public class MainActivity extends Activity {

     private Button insert ,delete,update,read;
     protected void init(){
         insert = (Button) findViewById(R.id.insertContact);
         delete = (Button) findViewById(R.id.deleteContacts);
         update = (Button) findViewById(R.id.updateContacts);
         read = (Button) findViewById(R.id.readContact);
     }
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.main);
         /* 初始化组件对象 */
         init();

         /* 为read设置按钮点击事件监听器 */
         read.setOnClickListener(new OnClickListener() {

             public void onClick(View v) {
                 readContacts();
             }
         });

         insert.setOnClickListener(new OnClickListener() {

             @Override
             public void onClick(View v) {
                 // TODO Auto-generated method stub
                 insertContacts();
             }
         });

         delete.setOnClickListener(new OnClickListener() {

             @Override
             public void onClick(View v) {
                 // TODO Auto-generated method stub
                 deleteContacts();
             }
         });

         update.setOnClickListener(new OnClickListener() {

             @Override
             public void onClick(View v) {
                 // TODO Auto-generated method stub
                 //updateContacts();
             }
         });
     }

     /* 读取联系人信息 */
     public void readContacts(){
         /* 获取ContentResolver对象，使用getContentResolver()方法 */
         ContentResolver cr = this.getContentResolver();

         /**************************************联系人信息**********************************************/
         /* 执行查询操作，使用query();方法 */
         /* 参数说明：
          * @ uri : 操作ContentProvider的Uri；
          * @ projection :查询的列；
          * @ selecion   :查询条件；
          * @ selectionArgs  :条件对应参数；
          * @ sortOrder      :排序方式；
          */
         /* 获取联系人信息: Uri:ContactsContract.Contacts.CONTENT_URI*/
         Cursor cursor = cr.query(ContactsContract.Contacts.CONTENT_URI, null, null, null, null);

         /* 操作游标，获取数据 */
         for(cursor.moveToFirst();!cursor.isAfterLast();cursor.moveToNext()){

             /* 保存当前联系人的所有信息 */
             StringBuffer sb = new StringBuffer();

             /* 获取联系人ID */
             String contactID = cursor.getString(cursor.getColumnIndex(ContactsContract.Contacts._ID));
             sb.append("ID:"+contactID+"\n");
             /* 获取联系人姓名 */
             String name = cursor.getString(cursor.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME));
             sb.append("姓名："+name+"\n");
             /**********************************************************************************************/
             /* 通讯录 表 的特点：保存数据是按行保存，即：每个数据信息占一行，每行中该种属性能有多个值：
              * 例如 : 一个人的电话号码能有多个；即：一个contactID下有多个phone; */
             /**********************************************************************************************/

             /****************************获取电话号码*********************************************/
             //ContactsContract.CommonDataKinds.Phone.CONTENT_URI    获取Phone对应MIME类型的Uri;
             //ContactsContract.CommonDataKinds.Phone.CONTACT_ID     获取表中的联系人ID;
             Cursor phone = cr.query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI, null, ContactsContract.CommonDataKinds.Phone.CONTACT_ID+"=?", new String[]{contactID}, null);
             while(phone.moveToNext()){
                 String phoneNumber = phone.getString(phone.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
                 sb.append("phone:"+phoneNumber+"\n");
                 //Toast.makeText(MainActivity.this, "_ID="+contactID+" name="+name+" phone:"+phoneNumber, 1000).show();
             }
             /* 游标使用后要关闭 */
             phone.close();
             /**********************************************************************************************/

             /************************************获取Email*************************************************/
             Cursor email = cr.query(ContactsContract.CommonDataKinds.Email.CONTENT_URI, null, ContactsContract.CommonDataKinds.Email.CONTACT_ID+"=?", new String[]{contactID},null);
             while(email.moveToNext()){
                 String emailAddress = email.getString(email.getColumnIndex(ContactsContract.CommonDataKinds.Email.DATA));
                 sb.append("emailAddress:"+emailAddress+"\n");
                 //Toast.makeText(MainActivity.this, "_ID="+contactID+" name="+name+" Email:"+emailAddress, 1000).show();
             }
             email.close();
             /**********************************************************************************************/


             Toast.makeText(MainActivity.this, sb.toString(), 1000).show();
         }
         cursor.close();


     }

     /* 添加联系人 */
     public void insertContacts(){

         /*************************************方式一*******************************************************/
         /* 首先：需要向RawContacts.CONTENT_URI 执行一个空值的插入，目的是获取系统返回的rawConatactId ,
          * 这是后面插入data表的依据，只有执行空值的插入，才能使插入的联系人在通讯录里可见*/
         ContentValues values = new ContentValues();

         /* 向 RawContacts.CONTENT_URI执行一个空值的插入，返回rawContactId */
         Uri rawContactUri = this.getContentResolver().insert(RawContacts.CONTENT_URI, values);

         /* 从Uri路径中获取  ID 的部分 */
         long rawContactId = ContentUris.parseId(rawContactUri);
         values.clear();

         /* data表中的数据结构特点：每个数据信息以行进行保存，所以每次添加一行数据 */

         /* 向data表中插入姓名 */
         values.put(Data.RAW_CONTACT_ID, rawContactId);  //ID
         values.put(Data.MIMETYPE, StructuredName.CONTENT_ITEM_TYPE);    //内容的类型
         values.put(StructuredName.GIVEN_NAME, "张三峰");
         this.getContentResolver().insert(android.provider.ContactsContract.Data.CONTENT_URI, values);
         values.clear();

         /* 向data表中插入移动电话 */
         values.put(Data.RAW_CONTACT_ID, rawContactId);
         values.put(Data.MIMETYPE, Phone.CONTENT_ITEM_TYPE);
         values.put(Phone.NUMBER, "15337178625");
         values.put(Phone.TYPE, Phone.TYPE_MOBILE);  //电话的类型：工作电话  移动电话 家庭电话
         this.getContentResolver().insert(android.provider.ContactsContract.Data.CONTENT_URI, values);
         values.clear();

         /* 向data表中插入工作电话 */
         values.put(Data.RAW_CONTACT_ID, rawContactId);
         values.put(Data.MIMETYPE, Phone.CONTENT_ITEM_TYPE);
         values.put(Phone.NUMBER, "02787878989");
         values.put(Phone.TYPE, Phone.TYPE_WORK);    //电话的类型：工作电话  移动电话 家庭电话
         this.getContentResolver().insert(android.provider.ContactsContract.Data.CONTENT_URI, values);
         values.clear();

         /* 向data表中添加Email */
         values.put(Data.RAW_CONTACT_ID, rawContactId);
         values.put(Data.MIMETYPE, Email.CONTENT_ITEM_TYPE);
         values.put(Email.DATA, "[email protected]");
         values.put(Email.TYPE, Email.TYPE_WORK);    //电话的类型：工作电话  移动电话 家庭电话
         this.getContentResolver().insert(android.provider.ContactsContract.Data.CONTENT_URI, values);
         values.clear();
         Toast.makeText(MainActivity.this, "数据添加成功！", 1000).show();
         /********************************************************************************************************/

         /*********************************方式二：批量添加，处于同一个事务**************************************/
     }

     /* 删除 */
     public void deleteContacts(){
         /* 首先获取CotentResolver对象，用于操作ContentProvider */
         ContentResolver cr = this.getContentResolver();

         /* 思路：删除一个联系人的所有，则根据RAW_CONTACT_ID进行删除 */
         cr.delete(RawContacts.CONTENT_URI, RawContacts.CONTACT_ID+"=?", new String[]{"1"});
         Toast.makeText(MainActivity.this, "数据删除成功", 1000).show();
     }
 //
 //  /* 修改 */
 //  public void updateContacts(){
 //      ContentResolver cr = this.getContentResolver();
 //
 //      /* 获取ID，需要修改的联系人ID，然后确定修改信息 */
 //      ContentValues values = new ContentValues();
 //      values.put(Data.MIMETYPE, StructuredName.CONTENT_ITEM_TYPE);//值的类型
 //      values.put(StructuredName.GIVEN_NAME, "张无忌");
 //      cr.update(ContactsContract.Contacts.CONTENT_URI, values, ContactsContract.Data.DISPLAY_NAME+"=?", new String[]{"张三峰"});
 //      Toast.makeText(MainActivity.this, "修改成功", 1000).show();
 //      readContacts();
 //  }
 //


     /*  UriMathcer 类的用法  */
     public void uriMatcher(){
         /* 常量UriMatche.NO_MATCH 标示部匹配任何路径的返回码 */
         UriMatcher sMatcher = new UriMatcher(UriMatcher.NO_MATCH);

         /* 如果match()方法匹配content://cn.itcast.provider.personprovider/person 路径，
          * 返回匹配码为 1
          */
         /* 添加需要匹配的URL ，如果匹配就会返回匹配码  */
         sMatcher.addURI("cn.itcast.provider.personprovider", "person", 1);

         /* # 为通配符 *//* match():方法匹配：content://cn.itcast.provider.personprovider/person/230
          * 路径， 返回匹配码2
          *  */
         sMatcher.addURI("cn.itcast.provider.personprovider", "person/#", 2);

         /* 按上述添加的规则进行匹配，不同的路径匹配返回不同的匹配码 */
         int code = sMatcher.match(Uri.parse("content://cn.itcast.provider.personprovider/person/10"));

         /**********************************************************************/
         //ContentUris 的介绍
         /* 将字符串转换成Uri */
         Uri uri = Uri.parse("content://cn.itcast.provider.personprovider/person");

         /* 为路径添加ID部分 */
         Uri resultUri = ContentUris.withAppendedId(uri, 10);

     }

 }