使用 Picasso 加载显示联系人头像

Picasso 自带了对加载显示联系人头像的支持，只要传入联系人头像的 URL，例如
"photo:content://com.android.contacts/contacts/1005/photo", 再调用 Picasso.load(Uri).into(ImageView)，即可完成对联系人头像的显示。

但这种用法有个局限：当我们并不知道某个联系人的头像 URL 时，首先得通过名字（或其他，如电话号码）获取到联系人头像的 URL，而这通常是耗时操作（查询数据库），需要异步进行；这样一来，先异步查询出头像 URL，再交给 Picasso 进行异步加载并显示，两级异步显得有点儿鸡肋。所以本文除了简单介绍

Picasso 自带对联系人头像的支持

外，还将介绍另一种用法，

使用自定义 RequestHandler

下面，我们以根据联系人名字获取联系人头像为例，来讲解这两种用法。

一、使用 Picasso 的内置支持来加载

Picasso（以 2.5.2 版本为例）总共支持 5 种联系人头像的 URL 格式

photo:content://com.android.contacts/contacts/lookup/*/#
photo:content://com.android.contacts/contacts/lookup/*
photo:content://com.android.contacts/contacts/#/photo
photo:content://com.android.contacts/contacts/#
photo:content://com.android.contacts/display_photo/#

加载过程分以下几步：

1. 根据名字获取联系人头像的 URL

Uri elvisUrl = getContactPhotoUrl("Elvis");/*** 根据名字获取联系人头像的 URL。* @param contactName 联系人的名字* @return 联系人头像的 URL*/
@Nullable
public static Uri getContactPhotoUrl(Context context, String contactName) {Uri phoneUri = null;Cursor cursor = context.getContentResolver().query(ContactsContract.Contacts.CONTENT_URI,new String[]{ContactsContract.Contacts.PHOTO_URI},ContactsContract.Contacts.DISPLAY_NAME_PRIMARY + " = ?",new String[]{contactName},null);if (cursor != null) {try {if (cursor.moveToFirst()) {String photoUrlString = cursor.getString(0);if (!TextUtils.isEmpty(photoUrlString)) {phoneUri = Uri.parse(photoUrlString);}}} finally {cursor.close();}}return phoneUri;
}

2. 使用 Picasso.load(Uri).into(ImageView) 进行显示

mPicasso.load(elvisUrl).into(imageView);

二、使用自定义 RequestHandler 加载

1. 自定义 RequestHandler

public static final String URL_SCHEMA_CONTACT_PHOTO = "contact.photo";private class CustomRequestHandler extends RequestHandler {@Overridepublic boolean canHandleRequest(Request data) {return URL_SCHEMA_CONTACT_PHOTO.equals(data.uri.getScheme());}/*** 将联系人头像的缩略图数据作为输入流返回。*/@Overridepublic Result load(Request request, int networkPolicy) throws IOException {Uri uri = request.uri;// 从联系人 URL 中解析出联系人名字String contactName = uri.getAuthority();// 根据名字获取联系人的 Contact IDlong contactId = getContactId(mContext, contactName);if (contactId <= 0) {return null;}// 根据联系人的 Contact ID 获取联系人头像的缩略图数据byte[] photoData = loadPhotoData(mContext, contactId);if (photoData == null) {return null;}InputStream photoInputStream = new ByteArrayInputStream(photoData);return new Result(photoInputStream, Picasso.LoadedFrom.DISK);}
}/*** 根据名字获取联系人的 Contact ID。** @param displayName 联系人的名字* @return 联系人的 Contact ID*/
public static long getContactId(Context context, String displayName) {long contactId = 0;ContentResolver contentResolver = context.getContentResolver();Uri uri = ContactsContract.Data.CONTENT_URI;String[] projection = new String[]{ContactsContract.CommonDataKinds.StructuredName.CONTACT_ID};String selection = ContactsContract.Data.MIMETYPE + " = ? AND "+ ContactsContract.CommonDataKinds.StructuredName.DISPLAY_NAME + " = ?";String[] selectionArguments = {ContactsContract.CommonDataKinds.StructuredName.CONTENT_ITEM_TYPE, displayName};Cursor cursor = contentResolver.query(uri, projection, selection, selectionArguments, null);if (cursor != null) {try {if (cursor.moveToFirst()) {contactId = cursor.getLong(0);}} finally {cursor.close();}}return contactId;
}/*** 根据联系人的 Contact ID 获取联系人头像的缩略图数据。** @param contactId 联系人的 Contact ID* @return 联系人头像的缩略图数据*/
public static byte[] loadPhotoData(Context context, long contactId) {byte[] photoData = null;Uri contactUri = ContentUris.withAppendedId(ContactsContract.Contacts.CONTENT_URI, contactId);Uri photoUri = Uri.withAppendedPath(contactUri,ContactsContract.Contacts.Photo.CONTENT_DIRECTORY);Cursor cursor = context.getContentResolver().query(photoUri,new String[]{ContactsContract.Contacts.Photo.PHOTO}, null, null, null);if (cursor != null) {try {if (cursor.moveToFirst()) {photoData = cursor.getBlob(0);}} finally {cursor.close();}}return photoData;
}

2. 在初始化 Picasso 时添加自定义的 RequestHandler

mPicasso = new Picasso.Builder(context).addRequestHandler(new CustomRequestHandler())... // 省略其他配置.build();

3. 组装联系人（"Elvis"）的头像 URL

/*** 获取代表特定联系人头像缩略图的 URL** @param contactName 特定联系人的显示名* @return 代表特定联系人头像缩略图的 URL*/
public static Uri getContactPhotoLoadableUrl(String contactName) {return new Uri.Builder().scheme(URL_SCHEMA_CONTACT_PHOTO).authority(contactName).build();
}Uri elvisUrl = getContactPhotoLoadableUrl("Elvis");

4. 使用 Picasso.load(Uri).into(ImageView) 进行显示

mPicasso.load(elvisUrl).into(imageView);

至此，使用 Picasso 加截显示联系人头像的两种方法已介绍完毕。大家可根据自己需求，择其一使用。在联系人头像 URL 未知的情况下，优选第二种方案，这样可以让联系人的头像加载像其他网络图片的加载一样简便。

关于作者
ElvisHew 的开源项目: XLog
ElvisHew 的 Github 主页: https://github.com/elvishew
ElvisHew 的新浪微博：http://weibo.com/elvishew

作者：ElvisHew
链接：https://www.jianshu.com/p/5488e3b7f3bc
来源：简书
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。