安卓用QuickContactBadge和AsyncQueryHandler实现联系人列表的完美实现

AsyncQueryHandler:异步的查询操作帮助类，其实它同样可以处理增删改

１。AsyncQueryHandler的作用

查询其API便可知，它担供：

startInsert，startDelete，startUpdate，startQuery

这四个操作，并提供相对应的onXXXComplete方法，以供操作完数据库后进行其它的操作，这四个onXXXComplete方法都是空实现，以便我们只需要去实现我们关注的操作。

２。为什么要使用AsyncQueryHandler

当然你也可以使用ContentProvider去操作数据库。这在数据量很小的时候是没有问题的，但是如果数据量大了，可能导致ＵＩ线程发生ANR事件。当然你也可以写个Handler去做这些操作，只是你每次使用ContentProvider时都要再写个Handler，必然降低了效率。

因此API提供了一个操作数据库的通用方法。

３。如何使用AsyncQueryHandler

你只需要继承AsyncQueryHandler类，并提供onXXXComplete方法的实现（可以实现任何一个或多个，当然你也可以一个也不实现，如果你不关注操作数据库的結果），在你的实现中做一些对数据库操作完成的处理。

使用时直接调用startXXX方法即可。传入的通用参数如下：

int token,一个令牌，需要跟onXXXComplete方法传入的一致。（当然你也可以不一致，同样在数据库的操作结束后会调用对应的onXXXComplete方法 ）

Object cookie,你想传给onXXXComplete方法使用的一个对象。(没有的话传递null即可。基本发现这个变量没太大作用)

Uri uri,操作数据的URi

４。AsyncQueryHandler还为我们做了什么

AsyncQueryHandler中使用了一个WeakReference<ContentResolver>对象，即 ContentResolver的弱引用　　作用：当contentProvied发生变化时候同步更新仍可以通过使用 AsyncQueryHandler类来达到这一要求(暂时还没理解这个作用)

同时，在它执行操作数据库时，吃掉了所有的异常。见如下代码。

三、SparseArray的使用

SparseArray是 Android框架独有的类，在标准的JDK中不存在这个类。SparseArray实现了Cloneable接口，还可以调用clo

ne方法，它要比 HashMap 节省内存，某些情况下比HashMap性能更好，按照官方问答的解释，主要是因为SparseArray不需要

对key和value进行auto- boxing（将原始类型封装为对象类型，比如把int类型封装成Integer类型），结构比HashMap简单

（SparseArray内部主要使用 两个一维数组来保存数据，一个用来存key，一个用来存value）不需要额外的额外的数据结构（

主要是针对HashMap中的HashMapEntry 而言的）。

SparseArrays map integers to Objects.  Unlike a normal array of Objects,

* there can be gaps in the indices.  It is intended to be more memory efficient

* than using a HashMap to map Integers to Objects, both because it avoids object for each mapping.

* auto-boxing keys and its data structure doesn't rely on an extra entry

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
        android:id="@+id/contact_list_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"

        android:background="#E1E6F6" >
<ListView
android:id="@+id/contact_list"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:cacheColorHint="#7690A5"
        android:divider="#7690A5"
        android:fadingEdge="none"
        android:scrollbars="none"
        android:scrollingCache="false"
        android:visibility="visible" />
<com.zy.quilkycontact.AlphabeticBarandroid:id="@+id/fast_scroller"
        android:layout_width="22dp"
        android:layout_height="match_parent"
        android:layout_alignParentRight="true"
        android:layout_gravity="top|right|center"
        android:layout_marginTop="0dip"
        android:background="@null"
        android:scaleType="centerInside"
        android:src="@drawable/dic_background" >
</com.zy.quilkycontact.AlphabeticBar>
<TextView
android:id="@+id/fast_position"
        android:layout_width="70dip"
        android:layout_height="70dip"
        android:layout_centerInParent="true"
        android:layout_gravity="center_horizontal|top"
        android:layout_margin="34dip"
        android:background="@drawable/flag"
        android:gravity="center"
        android:padding="2dip"
        android:textColor="#404040"
        android:textSize="48dip"
        android:visibility="invisible" />
</RelativeLayout>

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content" >
<!-- 首字母 -->
<TextView
android:id="@+id/alpha"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:background="#7690A5"
        android:paddingLeft="10dip"
        android:textColor="#FFFFFF"
        android:visibility="gone" />
<!-- 联系人信息 -->
<QuickContactBadge
android:id="@+id/contact"
        android:layout_width="75dip"
        android:layout_height="75dip"
        android:layout_alignParentLeft="true"
        android:layout_below="@+id/alpha"
        android:layout_marginBottom="3dip"
        android:layout_marginTop="3dip"
        android:src="@drawable/login_icon_member"
        style="?android:attr/quickContactBadgeStyleWindowSmall"  />
<TextView
android:id="@+id/name"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerVertical="true"
        android:layout_toRightOf="@+id/contact"
        android:singleLine="true"
        android:layout_marginLeft="50dp"
        android:textAppearance="?android:textAppearanceLarge"
        android:textColor="#FFFFFF" />
<TextView
android:id="@+id/number"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_alignParentBottom="true"
        android:layout_toRightOf="@+id/contact"
        android:singleLine="true"
        android:layout_marginLeft="50dp"
        android:textAppearance="?android:textAppearanceSmall"
        android:textColor="#FFFFFF" />
</RelativeLayout>

package com.zy.quilkycontact;
public class Contact {private int contactId; //id
    private String desplayName;//姓名
    private String phoneNum; // 电话号码
    private String sortKey; // 排序用的
    private Long photoId; // 图片id
    private String lookUpKey;
    private int selected = 0;
    private String formattedNumber;
    private String pinyin; // 姓名拼音
    private String email;
    public int getContactId() {return contactId;
    }public void setContactId(int contactId) {this.contactId = contactId;
    }public String getDesplayName() {return desplayName;
    }public void setDesplayName(String desplayName) {this.desplayName = desplayName;
    }public String getPhoneNum() {return phoneNum;
    }public void setPhoneNum(String phoneNum) {this.phoneNum = phoneNum;
    }public String getSortKey() {return sortKey;
    }public void setSortKey(String sortKey) {this.sortKey = sortKey;
    }public Long getPhotoId() {return photoId;
    }public void setPhotoId(Long photoId) {this.photoId = photoId;
    }public String getLookUpKey() {return lookUpKey;
    }public void setLookUpKey(String lookUpKey) {this.lookUpKey = lookUpKey;
    }public int getSelected() {return selected;
    }public void setSelected(int selected) {this.selected = selected;
    }public String getFormattedNumber() {return formattedNumber;
    }public void setFormattedNumber(String formattedNumber) {this.formattedNumber = formattedNumber;
    }public String getPinyin() {return pinyin;
    }public void setPinyin(String pinyin) {this.pinyin = pinyin;
    }public String getEmail() {return email;
    }public void setEmail(String email) {this.email = email;
    }

package com.zy.quilkycontact;
        import java.util.HashMap;
        import java.util.Map;
        import android.annotation.SuppressLint;
        import android.app.Activity;
        import android.content.AsyncQueryHandler;
        import android.content.ContentResolver;
        import android.database.Cursor;
        import android.net.Uri;
        import android.os.Bundle;
        import android.provider.ContactsContract;
        import android.util.SparseArray;
        import android.view.View;
        import android.view.Window;
        import android.widget.ListView;


/**
 * 联系人列表
 *
 *
 */
public class MainActivity extends Activity {private ContactListAdapter adapter;
    private ListView contactListView;
    private SparseArray<Contact> list;
    private AsyncQueryHandler asyncQueryHandler; // 异步查询数据库类对象
    private AlphabeticBar alphabeticBar; // 快速索引条
    private Map<Integer, Contact> contactIdMap = null;
    @Override
    protected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);
        requestWindowFeature(Window.FEATURE_NO_TITLE);
        setContentView(R.layout.activity_main);
        contactListView = (ListView) findViewById(R.id.contact_list);
        alphabeticBar = (AlphabeticBar) findViewById(R.id.fast_scroller);
// 实例化
        asyncQueryHandler = new MyAsyncQueryHandler(getContentResolver());
        initDatas();


    }/**
     * 初始化数据库查询参数
     */
    private void initDatas() {Uri uri = ContactsContract.CommonDataKinds.Phone.CONTENT_URI; // 联系人Uri；
// 查询的字段
        String[] projection = { ContactsContract.CommonDataKinds.Phone._ID,
                ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME,
                ContactsContract.CommonDataKinds.Phone.DATA1, "sort_key",
                ContactsContract.CommonDataKinds.Phone.CONTACT_ID,
                ContactsContract.CommonDataKinds.Phone.PHOTO_ID,
                ContactsContract.CommonDataKinds.Phone.LOOKUP_KEY };
// 按照sort_key升序查詢
        asyncQueryHandler.startQuery(0, null, uri, projection, null, null,
                "sort_key COLLATE LOCALIZED asc");


    }/**
     * 使用异步方式对DB数据库进行基本的增，删，改，查
     * */
    private class MyAsyncQueryHandler extends AsyncQueryHandler {public MyAsyncQueryHandler(ContentResolver cr) {super(cr);
        }@SuppressLint("UseSparseArrays")protected void onQueryComplete(int token, Object cookie, Cursor cursor) {if (cursor != null && cursor.getCount() > 0) {contactIdMap = new HashMap<Integer, Contact>();
                list = new SparseArray<Contact>();
                cursor.moveToFirst(); // 游标移动到第一项
                for (int i = 0; i < cursor.getCount(); i++) {cursor.moveToPosition(i);
                    String name = cursor.getString(1);
                    String number = cursor.getString(2);
                    String sortKey = cursor.getString(3);//首字母
                    int contactId = cursor.getInt(4);
                    Long photoId = cursor.getLong(5);
                    String lookUpKey = cursor.getString(6);
                    String email = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Email.DATA));
                    if (contactIdMap.containsKey(contactId)) {
// 无操作
                    } else {
// 创建联系人对象
                        Contact contact = new Contact();
                        contact.setDesplayName(name);
                        contact.setPhoneNum(number);
                        contact.setSortKey(sortKey);
                        contact.setPhotoId(photoId);
                        contact.setLookUpKey(lookUpKey);
                        contact.setEmail(email);
                        list.put(i, contact);
                        contactIdMap.put(contactId, contact);
                    }}if (list.size() > 0) {setAdapter(list);
                }}super.onQueryComplete(token, cookie, cursor);
        }}private void setAdapter(SparseArray<Contact> list) {adapter = new ContactListAdapter(this, list, alphabeticBar);
        contactListView.setAdapter(adapter);
        alphabeticBar.init(MainActivity.this);
        alphabeticBar.setListView(contactListView);
        alphabeticBar.setHight(alphabeticBar.getHeight());
        alphabeticBar.setVisibility(View.VISIBLE);
    }
}