android怎样批量添加联系人

原创

mob64ca12d06991 2024-10-08 04:03:36 ©著作权

文章标签 批量添加 Data App 文章分类 Android 移动开发

©著作权归作者所有：来自51CTO博客作者mob64ca12d06991的原创作品，请联系作者获取转载授权，否则将追究法律责任

在Android中批量添加联系人

在Android开发中，批量添加联系人是一个常见的需求。对于刚入行的小白开发者来说，这个过程可能会有些复杂，本文将详细讲解整个流程，并提供完整的代码示例，帮助你快速上手。

流程概述

首先，我们来看看批量添加联系人的流程。下面是一个简洁的流程表：

步骤	描述
1. 权限申请	确保应用具有必要的权限。
2. 创建联系人	使用`ContentResolver`创建联系人的基本信息。
3. 批量插入	通过`ContentProvider`批量添加多个联系人。
4. 结果处理	处理添加联系人后的结果（成功或失败）。

1. 权限申请

在Android中，添加联系人需要相应的权限。我们需要在AndroidManifest.xml文件中添加以下权限：

<uses-permission android:name="android.permission.WRITE_CONTACTS"/>
<uses-permission android:name="android.permission.READ_CONTACTS"/>

2. 创建联系人

接下来，我们需要创建联系人。这通常涉及到创建一个自定义的联系人信息类。下面是一个基本的Contact类例子：

public class Contact {
    private String displayName;
    private String phoneNumber;

    // Constructor
    public Contact(String displayName, String phoneNumber) {
        this.displayName = displayName;
        this.phoneNumber = phoneNumber;
    }

    // Getters
    public String getDisplayName() {
        return displayName;
    }

    public String getPhoneNumber() {
        return phoneNumber;
    }
}

3. 批量插入联系人

现在我们来编写批量插入联系人的方法。我们将利用ContentResolver和ContentValues来插入联系人。

import android.content.ContentResolver;
import android.content.ContentValues;
import android.provider.ContactsContract;
import android.content.Context;

public void addContacts(Context context, List<Contact> contacts) {
    ContentResolver contentResolver = context.getContentResolver();

    for (Contact contact : contacts) {
        ContentValues values = new ContentValues();
        // 设置联系人名字
        values.put(ContactsContract.RawContacts.ACCOUNT_TYPE, null);
        values.put(ContactsContract.RawContacts.ACCOUNT_NAME, null);
        long rawContactId = contentResolver.insert(ContactsContract.RawContacts.CONTENT_URI, values).getLastPathSegment();

        // 插入姓名
        values.clear();
        values.put(ContactsContract.Data.RAW_CONTACT_ID, rawContactId);
        values.put(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.StructuredName.CONTENT_ITEM_TYPE);
        values.put(ContactsContract.CommonDataKinds.StructuredName.DISPLAY_NAME, contact.getDisplayName());
        contentResolver.insert(ContactsContract.Data.CONTENT_URI, values);

        // 插入电话号码
        values.clear();
        values.put(ContactsContract.Data.RAW_CONTACT_ID, rawContactId);
        values.put(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE);
        values.put(ContactsContract.CommonDataKinds.Phone.NUMBER, contact.getPhoneNumber());
        values.put(ContactsContract.CommonDataKinds.Phone.TYPE, ContactsContract.CommonDataKinds.Phone.TYPE_MOBILE);
        contentResolver.insert(ContactsContract.Data.CONTENT_URI, values);
    }
}

在上面的代码中，我们依次为每个联系人创建一个原始联系人条目（RawContact），然后插入联系人名字和电话号码。我们使用ContentResolver执行插入操作。

4. 结果处理

我们可以在调用addContacts方法的地方来处理添加联系人的结果，通常包括显示成功信息或错误信息。

try {
    addContacts(context, contactList);
    Toast.makeText(context, "成功添加联系人!", Toast.LENGTH_SHORT).show();
} catch (Exception e) {
    Toast.makeText(context, "添加联系人失败: " + e.getMessage(), Toast.LENGTH_LONG).show();
}

类图

以下是联系人的类图，展示了Contact类的基本结构。

classDiagram
    class Contact {
        - String displayName
        - String phoneNumber
        + Contact(String displayName, String phoneNumber)
        + getDisplayName(): String
        + getPhoneNumber(): String
    }

序列图

接下来是一个序列图，展示了调用addContacts方法的互动过程。

sequenceDiagram
    participant User
    participant App
    participant ContentResolver

    User->>App: 点击添加联系人
    App->>ContentResolver: addContacts(contactList)
    ContentResolver-->>App: 返回状态
    App->>User: 显示结果消息