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

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

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

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

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

一、使用 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

ri 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 {
  @Override
  public boolean canHandleRequest(Request data) {
    return URL_SCHEMA_CONTACT_PHOTO.equals(data.uri.getScheme());
  }

  /**
   * 将联系人头像的缩略图数据作为输入流返回。
   */
  @Override
  public Result load(Request request, int networkPolicy) throws IOException {
    Uri uri = request.uri;
    // 从联系人 URL 中解析出联系人名字
    String contactName = uri.getAuthority();
    // 根据名字获取联系人的 Contact ID
    long contactId = getContactId(mContext, contactName);
    if (contactId <= 0)="" {="" return="" null;="" }="" 根据联系人的="" contact="" 获取联系人头像的缩略图数据="" byte[]="" photodata="loadPhotoData(mContext," contactid);="" if="" (photodata="=" null)="" inputstream="" photoinputstream="new" bytearrayinputstream(photodata);="" new="" result(photoinputstream,="" picasso.loadedfrom.disk);="" **="" *="" 根据名字获取联系人的="" id。="" @param="" displayname="" 联系人的名字="" @return="" 联系人的="" public="" static="" long="" getcontactid(context="" context,="" string="" displayname)="" contactid="0;" contentresolver="" uri="" string[]="" projection="new" string[]{contactscontract.commondatakinds.structuredname.contact_id};="" selection="ContactsContract.Data.MIMETYPE" +="" "="?" and="" contactscontract.commondatakinds.structuredname.display_name="" selectionarguments="{" contactscontract.commondatakinds.structuredname.content_item_type,="" displayname};="" cursor="" projection,="" selection,="" selectionarguments,="" null);="" (cursor="" !="null)" try="" (cursor.movetofirst())="" finally="" cursor.close();="" contactid;="" 获取联系人头像的缩略图数据。="" 联系人头像的缩略图数据="" loadphotodata(context="" contactid)="" contacturi="ContentUris.withAppendedId(ContactsContract.Contacts.CONTENT_URI," photouri="Uri.withAppendedPath(contactUri," contactscontract.contacts.photo.content_directory);="" string[]{contactscontract.contacts.photo.photo},="" null,="" photodata;="" }<="" code="">

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 未知的情况下，优选第二种方案，这样可以让联系人的头像加载像其他网络图片的加载一样简便。