Android进阶之读取手机联系人显示listview并点击拨号（CursorAdapter）

一、CursorAdapter介绍

1、继承于BaseAdapter是个虚类,它为cursor和ListView提供了连接的桥梁。

如：public abstract class CursorAdapter extends BaseAdapter

2、注意cursor的必须要有个命名为”_id”的列。比如Contacts._ID就为”_id”

3、必须实现以下函数：

①newView(Context context, Cursor cursor, ViewGroup parent)

newView：并不是每次都被调用的，它只在实例化的时候调用,数据增加的时候也会调用,但是在重绘(比如修改条目里的TextView的内容)的时候不会被调用

②bindView(View view, Context context, Cursor cursor)

bindView：从代码中可以看出在绘制Item之前一定会调用bindView方法它在重绘的时候也同样被调用

4、更新ListView方法：adapter.changeCursor(cursor)，它的功能类似于adapter.notifyDataSetChanged()方法

二、读取通讯录详解

1、权限

<!-- 读取联系人权限 -->
<uses-permission android:name="android.permission.READ_CONTACTS"></uses-permission>
<!-- 拨打电话权限 -->
<uses-permission android:name="android.permission.CALL_PHONE"></uses-permission>

2、获取Cursor方法

Cursor phoneCursor = resolver.query(Phone.CONTENT_URI,
PHONES_PROJECTION, null, null, null);

3、为什么不使用Adapter继承于BaseAdapter？

因为Object对象不能转型为Cursor， 所以使用的Adapter继承于CursorAdapter,才能转型为CursorWrapper。

/**
* 点击监听实现
*
* 实现：获得选中项的电话号码并拨号
*/
private class onItemClickListener implements OnItemClickListener {

@Override
public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
//从指针的封装类中获得选中项的电话号码并拨号
//返回值是Object类需要向下转型成CursorWrapper类型
CursorWrapper wrapper = (CursorWrapper) lvContact.getItemAtPosition(position - 1);

//返回从0开始的索引，如果列名不存在将返回-1
int columnIndex = wrapper.getColumnIndex(Phone.NUMBER);

if (!wrapper.isNull(columnIndex)) {
String number = wrapper.getString(columnIndex);
// 判断电话号码的有效性
if (PhoneNumberUtils.isGlobalPhoneNumber(number)) {
Intent intent = new Intent(Intent.ACTION_DIAL, Uri.parse("tel://" + number));
startActivity(intent);
}
}
}
}

三、例子代码

1、AndroidManifest.xml

<!-- 读取联系人权限 -->
<uses-permission android:name="android.permission.READ_CONTACTS" />
<!-- 拨打电话权限 -->
<uses-permission android:name="android.permission.CALL_PHONE" />

2、item_contact.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="horizontal" >

<LinearLayout
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:layout_marginLeft="8dp"
android:orientation="horizontal" >

<ImageView
android:id="@+id/iv_head"
android:layout_width="45dp"
android:layout_height="45dp"
android:src="@mipmap/ic_launcher" />

<LinearLayout
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:gravity="center_vertical"
android:layout_marginLeft="8dp"
android:orientation="horizontal" >

<LinearLayout
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:orientation="vertical" >

<TextView
android:id="@+id/name"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:textSize="16sp"
android:text="TextView" />

<TextView
android:id="@+id/number"
android:textSize="12sp"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="TextView" />
</LinearLayout>
</LinearLayout>
</LinearLayout>

</LinearLayout>

3、activity_contact.xml

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity">

<ListView
android:id="@+id/lv_contact"
android:layout_width="fill_parent"
android:layout_height="fill_parent">

</ListView>
</RelativeLayout>

4、ContactAdapter.java

package com.guan.contentproviderwork.contact;

import android.content.ContentUris;
import android.content.Context;
import android.database.Cursor;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.net.Uri;
import android.provider.ContactsContract;
import android.support.v4.widget.CursorAdapter;
import android.text.TextUtils;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.BaseAdapter;
import android.widget.ImageView;
import android.widget.TextView;

import com.guan.contentproviderwork.R;

import java.io.InputStream;
import java.util.ArrayList;

import butterknife.Bind;
import butterknife.ButterKnife;

/**
* 定义适配器
* CursorAdapter为cursor和ListView提供了连接的桥梁
*
* @author Guan
* @file com.guan.contentproviderwork
* @date 2015/9/8
* @Version 1.0
*/
public class ContactAdapter extends CursorAdapter {

private Context mContext;

/**
* 联系人显示名称
*/
private static final int PHONES_DISPLAY_NAME_INDEX = 1;

/**
* 电话号码
**/
private static final int PHONES_NUMBER_INDEX = 2;

/**
* 头像ID
*/
private static final int PHONES_PHOTO_ID_INDEX = 3;

/**
* 联系人的ID
*/
private static final int PHONES_CONTACT_ID_INDEX = 4;

public ContactAdapter(Context context, Cursor cursor) {
super(context,cursor);
this.mContext = context;
}

@Override
public int getCount() {

if (mDataValid && mCursor != null) {
return mCursor.getCount();
} else {
return 0;
}
}

@Override
public Object getItem(int position) {

if (mDataValid && mCursor != null) {
mCursor.moveToPosition(position);
return mCursor;
} else {
return null;
}
}

@Override
public long getItemId(int position) {

if (mDataValid && mCursor != null) {
if ( mCursor.moveToPosition(position)) {
return mCursor.getLong( mRowIDColumn);
} else {
return 0;
}
} else {
return 0;
}
}

@Override
public View getView(int position, View convertView, ViewGroup parent) {

View view;
if (convertView == null) {
view = newView(mContext, mCursor, parent);
} else {
view = convertView;
}
bindView(view, mContext, mCursor);
return view;
}

@Override
public View newView(Context context, Cursor cursor, ViewGroup parent) {

ViewHolder viewholder = null;
View view = LayoutInflater.from(mContext).inflate(
R.layout.item_contact, null);
viewholder = new ViewHolder(view);
view.setTag(viewholder);
return view;
}

@Override
public void bindView(View view, Context context, Cursor cursor) {

/**
* 获取当前position
* final int position=cursor.getPosition();
*/

ViewHolder viewholder = (ViewHolder) view.getTag();

/**
* 得到联系人名称
*/
viewholder.name.setText(cursor.getString(PHONES_DISPLAY_NAME_INDEX) + "");

/**
* 得到手机号码
*/
viewholder.number.setText(cursor.getString(PHONES_NUMBER_INDEX) + "");

/**
* 得到联系人头像
*/
// 得到联系人ID
Long contactid = cursor
.getLong(PHONES_CONTACT_ID_INDEX);
// 得到联系人头像ID
Long photoid = cursor.getLong(PHONES_PHOTO_ID_INDEX);
// 得到联系人头像Bitamp
Bitmap contactPhoto = null;
// photoid 大于0 表示联系人有头像 如果没有给此人设置头像则给他一个默认的
if (photoid > 0) {
Uri uri = ContentUris.withAppendedId(
ContactsContract.Contacts.CONTENT_URI,
contactid);
InputStream input = ContactsContract.Contacts
.openContactPhotoInputStream(mContext.getContentResolver(), uri);
contactPhoto = BitmapFactory.decodeStream(input);
} else {
contactPhoto = BitmapFactory.decodeResource(
mContext.getResources(), R.mipmap.ic_launcher);
}

viewholder.ivHead.setImageBitmap(contactPhoto);
}

/**
* ViewHolder
*/
static class ViewHolder {
@Bind(R.id.iv_head)
ImageView ivHead;
@Bind(R.id.name)
TextView name;
@Bind(R.id.number)
TextView number;

ViewHolder(View view) {
ButterKnife.bind(this, view);
}
}
}

5、ContactActivity.java

package com.guan.contentproviderwork.contact;

import android.app.Activity;
import android.content.ContentResolver;
import android.content.Intent;
import android.database.Cursor;
import android.database.CursorWrapper;
import android.net.Uri;
import android.os.Bundle;
import android.provider.ContactsContract.CommonDataKinds.Phone;
import android.telephony.PhoneNumberUtils;
import android.view.View;
import android.widget.AdapterView;
import android.widget.AdapterView.OnItemClickListener;
import android.widget.ListView;

import com.guan.contentproviderwork.R;

import butterknife.Bind;
import butterknife.ButterKnife;

public class ContactActivity extends Activity {

@Bind(R.id.lv_contact)
ListView lvContact;

/**
* 联系人组
*/
private static String[] PHONES_PROJECTION;

/**
* 联系人adapter
*/
private ContactAdapter mContactAdapter;

/**
* Curosr
*/
private Cursor mPhoneCursor;

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_contact);
ButterKnife.bind(this);

// 初始化变量
initValiable();
// 获取联系人Cursor
getCursor();
// 初始化listview
bindData();
// 初始化监听
initListener();
}

/**
* 初始化变量
*/
private void initValiable() {
PHONES_PROJECTION = new String[]{
"_id", Phone.DISPLAY_NAME, Phone.NUMBER, Phone.PHOTO_ID, Phone.CONTACT_ID};
}

/**
* 获取所有联系人Cursor
*/
private Cursor getCursor() {
ContentResolver resolver = getContentResolver();
mPhoneCursor = resolver.query(Phone.CONTENT_URI,
PHONES_PROJECTION, null, null, null);
return mPhoneCursor;
}

/**
* 绑定数据
*/
private void bindData() {
mContactAdapter = new ContactAdapter(ContactActivity.this, mPhoneCursor);
lvContact.setAdapter(mContactAdapter);
}

/**
* 初始化监听
*/
private void initListener() {
lvContact.setOnItemClickListener(new onItemClickListener());
}

/**
* 点击监听实现
* <p/>
*
* 实现：获得选中项的电话号码并拨号
*
* 注意：不能使用仅是继承于BaseAdapter，因为Object对象不能转型为Cursor。
* 所以：使用的Adapter是继承于CursorAdapter,才能转型为CursorWrapper。
*/
private class onItemClickListener implements OnItemClickListener {

@Override
public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
//从指针的封装类中获得选中项的电话号码并拨号
//返回值是Object类需要向下转型成CursorWrapper类型
CursorWrapper wrapper = (CursorWrapper) lvContact.getItemAtPosition(position - 1);

//返回从0开始的索引，如果列名不存在将返回-1
int columnIndex = wrapper.getColumnIndex(Phone.NUMBER);

if (!wrapper.isNull(columnIndex)) {
String number = wrapper.getString(columnIndex);
// 判断电话号码的有效性
if (PhoneNumberUtils.isGlobalPhoneNumber(number)) {
Intent intent = new Intent(Intent.ACTION_DIAL, Uri.parse("tel://" + number));
startActivity(intent);
}
}
}
}

@Override
protected void onDestroy() {
super.onDestroy();
mPhoneCursor.close();
}

/**
//     * 获取所有联系人
//     */
//    private void getPhoneContacts() {
//
//        ContentResolver resolver = getContentResolver();
//        try {
//            // 获取手机联系人
//            mPhoneCursor = resolver.query(Phone.CONTENT_URI,
//                    PHONES_PROJECTION, null, null, null);
//            if (mPhoneCursor != null) {
//
//                while (mPhoneCursor.moveToNext()) {
//
//                    // 得到手机号码
//                    String phoneNumber = mPhoneCursor
//                            .getString(PHONES_NUMBER_INDEX);
//                    // 当手机号码为空的或者为空字段 跳过当前循环
//                    if (TextUtils.isEmpty(phoneNumber))
//                        continue;
//
//                    // 得到联系人名称
//                    String contactName = mPhoneCursor
//                            .getString(PHONES_DISPLAY_NAME_INDEX);
//
//                    // 得到联系人ID
//                    Long contactid = mPhoneCursor
//                            .getLong(PHONES_CONTACT_ID_INDEX);
//
//                    // 得到联系人头像ID
//                    Long photoid = mPhoneCursor.getLong(PHONES_PHOTO_ID_INDEX);
//
//                    // 得到联系人头像Bitamp
//                    Bitmap contactPhoto = null;
//
//                    // photoid 大于0 表示联系人有头像 如果没有给此人设置头像则给他一个默认的
//                    if (photoid > 0) {
//                        Uri uri = ContentUris.withAppendedId(
//                                ContactsContract.Contacts.CONTENT_URI,
//                                contactid);
//                        InputStream input = ContactsContract.Contacts
//                                .openContactPhotoInputStream(resolver, uri);
//                        contactPhoto = BitmapFactory.decodeStream(input);
//                    } else {
//                        contactPhoto = BitmapFactory.decodeResource(
//                                getResources(), R.mipmap.ic_launcher);
//                    }
//                    ContactEntity mContact = new ContactEntity(contactName,
//                            phoneNumber, contactPhoto);
//                    mContacts.add(mContact);
//                }
////                mPhoneCursor.close();
//            }
//        } catch (Exception e) {
//            e.printStackTrace();
//        }
//    }

}

四、效果图



五、推荐链接

Android中CursorAdapter的使用详解

android 读取手机通讯录并显示listview

Android之CursorAdapter用法

Android中读取短信信息

Android SMS 短信读取