Android联系人模块分析（三）

最新推荐文章于 2021-06-04 20:37:24 发布
最新推荐文章于 2021-06-04 20:37:24 发布
阅读量3k 收藏 4
点赞数
CC 4.0 BY-SA版权
分类专栏： 01.Android
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/jiang_lostcode/article/details/8090465
本文深入探讨了Android ContactsProvider的数据表结构，包括数据库定义、表结构、视图及触发器，解析了联系人数据的存储与查询机制。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >



       前两篇文章主要讲解了ContactsProvider的结构，这篇文章想详细分析一下ContactsProvider的底层数据表结构（Android4.1.1），和大家一起深入的理解其内部实现。

       ContactsProvider的代码路径位于packages/providers/ContactsProvider/src下，我们可以结合实际的场景来分析ContactsProvider的代码逻辑。

       首先从ContactsPovider的数据库开始分析，数据是ContactsProvider的基础。如前所述，ContactsDatabaseHelper类创建了联系人数据库，数据库中包括表、视图、触发器，并且为部分表项创建了索引。

  一、数据库的定义：

static final int DATABASE_VERSION = 704;
private static final String DATABASE_NAME = "contacts2.db";
private static final String DATABASE_PRESENCE = "presence_db";

         DATABASE_VERSION定义了该数据库的版本号，版本号可以用来判断该数据库是否需要升级，即是否执行onUpgrade方法。

         DATABASE_NAME定义了该数据库的名称，也是序列化到磁盘上的文件名称。

         DATABASE_PRESENCE是内存数据库的名称，在contacts db中，创建了一份内存数据库，用来存储联系人的实时状态信息，这部分数据需要快速、频繁的操作，且无需序列化，所以采用了内存数据库的方式，创建的代码如下：

db.execSQL("ATTACH DATABASE ':memory:' AS " + DATABASE_PRESENCE + ";");

         内存数据库的创建过程定义在onOpen方法中，由于目前没有涉及到StatusUpdates的内容，所以暂时不详细分析这部分内容，但是从这部分内容我们也可以看到，Google还是有想法要把通讯录做成社交化的通讯录，现在已经预留了这些和IM的接口。

 二、表结构的定义：

public interface Tables {
        public static final String CONTACTS = "contacts";
        public static final String RAW_CONTACTS = "raw_contacts";
        public static final String STREAM_ITEMS = "stream_items";
        public static final String STREAM_ITEM_PHOTOS = "stream_item_photos";
        public static final String PHOTO_FILES = "photo_files";
        public static final String PACKAGES = "packages";
        public static final String MIMETYPES = "mimetypes";
        public static final String PHONE_LOOKUP = "phone_lookup";
        public static final String NAME_LOOKUP = "name_lookup";
        public static final String AGGREGATION_EXCEPTIONS = "agg_exceptions";
        public static final String SETTINGS = "settings";
        public static final String DATA = "data";
         上述代码只是表名称定义的一部分，读者可以挑选几个自己感兴趣的数据表，分析一下其创建过程，比如raw contact表的创建代码如下： 

        // Raw_contacts table
        db.execSQL("CREATE TABLE " + Tables.RAW_CONTACTS + " (" +
                RawContacts._ID + " INTEGER PRIMARY KEY AUTOINCREMENT," +
                RawContactsColumns.ACCOUNT_ID + " INTEGER REFERENCES " +
                    Tables.ACCOUNTS + "(" + AccountsColumns._ID + ")," +
                RawContacts.SOURCE_ID + " TEXT," +
                RawContacts.RAW_CONTACT_IS_READ_ONLY + " INTEGER NOT NULL DEFAULT 0," +
                RawContacts.VERSION + " INTEGER NOT NULL DEFAULT 1," +
                RawContacts.DIRTY + " INTEGER NOT NULL DEFAULT 0," +
                RawContacts.DELETED + " INTEGER NOT NULL DEFAULT 0," +
                RawContacts.CONTACT_ID + " INTEGER REFERENCES contacts(_id)," +
                RawContacts.AGGREGATION_MODE + " INTEGER NOT NULL DEFAULT " +
                        RawContacts.AGGREGATION_MODE_DEFAULT + "," +
                RawContactsColumns.AGGREGATION_NEEDED + " INTEGER NOT NULL DEFAULT 1," +
                RawContacts.CUSTOM_RINGTONE + " TEXT," +
                RawContacts.SEND_TO_VOICEMAIL + " INTEGER NOT NULL DEFAULT 0," +
                RawContacts.TIMES_CONTACTED + " INTEGER NOT NULL DEFAULT 0," +
                RawContacts.LAST_TIME_CONTACTED + " INTEGER," +
                RawContacts.STARRED + " INTEGER NOT NULL DEFAULT 0," +
                RawContacts.DISPLAY_NAME_PRIMARY + " TEXT," +
                RawContacts.DISPLAY_NAME_ALTERNATIVE + " TEXT," +
                RawContacts.DISPLAY_NAME_SOURCE + " INTEGER NOT NULL DEFAULT " +
                        DisplayNameSources.UNDEFINED + "," +
                RawContacts.PHONETIC_NAME + " TEXT," +
                RawContacts.PHONETIC_NAME_STYLE + " TEXT," +
                RawContacts.SORT_KEY_PRIMARY + " TEXT COLLATE " +
                        ContactsProvider2.PHONEBOOK_COLLATOR_NAME + "," +
                RawContacts.SORT_KEY_ALTERNATIVE + " TEXT COLLATE " +
                        ContactsProvider2.PHONEBOOK_COLLATOR_NAME + "," +
                RawContacts.NAME_VERIFIED + " INTEGER NOT NULL DEFAULT 0," +
                RawContacts.SYNC1 + " TEXT, " +
                RawContacts.SYNC2 + " TEXT, " +
                RawContacts.SYNC3 + " TEXT, " +
                RawContacts.SYNC4 + " TEXT " +
        ");");

        db.execSQL("CREATE INDEX raw_contacts_contact_id_index ON " + Tables.RAW_CONTACTS + " (" +
                RawContacts.CONTACT_ID +
        ");");

        db.execSQL("CREATE INDEX raw_contacts_source_id_account_id_index ON " +
                Tables.RAW_CONTACTS + " (" +
                RawContacts.SOURCE_ID + ", " +
                RawContactsColumns.ACCOUNT_ID +
        ");");
             从上述代码中，可以发现在raw conacts表上还为字段CONTACT_ID和SOURCE_ID+ACCOUNT_ID创建了索引。

 三、 视图的定义；

       为了提高查询速度，ContactsProvider提供了部分视图，以下为视图名称定义的代码（位于ContactsDatabaseHelper.java文件中）

public interface Views {
        public static final String DATA = "view_data";
        public static final String RAW_CONTACTS = "view_raw_contacts";
        public static final String CONTACTS = "view_contacts";
        public static final String ENTITIES = "view_entities";
        public static final String RAW_ENTITIES = "view_raw_entities";
        public static final String GROUPS = "view_groups";
        public static final String DATA_USAGE_STAT = "view_data_usage_stat";
        public static final String STREAM_ITEMS = "view_stream_items";
    }
       下面以view_data视图为例，说明其创建过程，所有的视图创建都封装在成员方法createContactsView中，如下： 
    private void createContactsViews(SQLiteDatabase db) {
        db.execSQL("DROP VIEW IF EXISTS " + Views.CONTACTS + ";");
        db.execSQL("DROP VIEW IF EXISTS " + Views.DATA + ";");
        db.execSQL("DROP VIEW IF EXISTS " + Views.RAW_CONTACTS + ";");
        db.execSQL("DROP VIEW IF EXISTS " + Views.RAW_ENTITIES + ";");
        db.execSQL("DROP VIEW IF EXISTS " + Views.ENTITIES + ";");
        db.execSQL("DROP VIEW IF EXISTS " + Views.DATA_USAGE_STAT + ";");
        db.execSQL("DROP VIEW IF EXISTS " + Views.STREAM_ITEMS + ";");
        而view_data视图的创建代码为：

        String dataSelect = "SELECT "
                + DataColumns.CONCRETE_ID + " AS " + Data._ID + ","
                + Data.RAW_CONTACT_ID + ", "
                + RawContactsColumns.CONCRETE_CONTACT_ID + " AS " + RawContacts.CONTACT_ID + ", "
                + syncColumns + ", "
                + dataColumns + ", "
                + contactOptionColumns + ", "
                + contactNameColumns + ", "
                + baseContactColumns + ", "
                + buildDisplayPhotoUriAlias(RawContactsColumns.CONCRETE_CONTACT_ID,
                        Contacts.PHOTO_URI) + ", "
                + buildThumbnailPhotoUriAlias(RawContactsColumns.CONCRETE_CONTACT_ID,
                        Contacts.PHOTO_THUMBNAIL_URI) + ", "
                + dbForProfile() + " AS " + RawContacts.RAW_CONTACT_IS_USER_PROFILE + ", "
                + Tables.GROUPS + "." + Groups.SOURCE_ID + " AS " + GroupMembership.GROUP_SOURCE_ID
                + " FROM " + Tables.DATA
                + " JOIN " + Tables.MIMETYPES + " ON ("
                +   DataColumns.CONCRETE_MIMETYPE_ID + "=" + MimetypesColumns.CONCRETE_ID + ")"
                + " JOIN " + Tables.RAW_CONTACTS + " ON ("
                +   DataColumns.CONCRETE_RAW_CONTACT_ID + "=" + RawContactsColumns.CONCRETE_ID + ")"
                + " JOIN " + Tables.ACCOUNTS + " ON ("
                +   RawContactsColumns.CONCRETE_ACCOUNT_ID + "=" + AccountsColumns.CONCRETE_ID
                    + ")"
                + " JOIN " + Tables.CONTACTS + " ON ("
                +   RawContactsColumns.CONCRETE_CONTACT_ID + "=" + ContactsColumns.CONCRETE_ID + ")"
                + " JOIN " + Tables.RAW_CONTACTS + " AS name_raw_contact ON("
                +   Contacts.NAME_RAW_CONTACT_ID + "=name_raw_contact." + RawContacts._ID + ")"
                + " LEFT OUTER JOIN " + Tables.PACKAGES + " ON ("
                +   DataColumns.CONCRETE_PACKAGE_ID + "=" + PackagesColumns.CONCRETE_ID + ")"
                + " LEFT OUTER JOIN " + Tables.GROUPS + " ON ("
                +   MimetypesColumns.CONCRETE_MIMETYPE + "='" + GroupMembership.CONTENT_ITEM_TYPE
                +   "' AND " + GroupsColumns.CONCRETE_ID + "="
                        + Tables.DATA + "." + GroupMembership.GROUP_ROW_ID + ")";

        db.execSQL("CREATE VIEW " + Views.DATA + " AS " + dataSelect);
            读者可以仔细阅读一下创建该试图的SQL语句，这里就不详细分析这条SQL语句。基于这个视图我们就能提供快速查询功能，我们来看一下ContactsProvider提供了URI来查询该视图，在UriMatcher中，增加了通过email来查询的URI：

        matcher.addURI(ContactsContract.AUTHORITY, "data/emails/lookup", EMAILS_LOOKUP);
        matcher.addURI(ContactsContract.AUTHORITY, "data/emails/lookup/*", EMAILS_LOOKUP);
           咱们可以找到对EMAILS_LOOKUP进行查询处理的逻辑，如下：

            case EMAILS_LOOKUP: {
                setTablesAndProjectionMapForData(qb, uri, projection, false);
                qb.appendWhere(" AND " + DataColumns.MIMETYPE_ID + " = "
                        + mDbHelper.get().getMimeTypeIdForEmail());
                if (uri.getPathSegments().size() > 2) {
                    String email = uri.getLastPathSegment();
                    String address = mDbHelper.get().extractAddressFromEmailAddress(email);
                    selectionArgs = insertSelectionArg(selectionArgs, address);
                    qb.appendWhere(" AND UPPER(" + Email.DATA + ")=UPPER(?)");
                }
                // unless told otherwise, we'll return visible before invisible contacts
                if (sortOrder == null) {
                    sortOrder = "(" + RawContacts.CONTACT_ID + " IN " +
                            Tables.DEFAULT_DIRECTORY + ") DESC";
                }
                break;
            }
             setTablesAndProjectionMapForData主要做SQL语句的封装，下面if语句内的内容是用来准备查询条件，首先取出email字符串，然后利用email值来生成selection条件。代码本身并不复杂，有兴趣的读者可以仔细研读。既然ContactsProvider提供了这样的接口，即通过email获得contact id，那么怎么使用呢，下面给出查询示例：

             Uri uri = Uri.withAppendedPath(Email.CONTENT_LOOKUP_URI, Uri.encode(email));
             Cursor c = getContentResolver().query(uri,
             	new String[]{Email.CONTACT_ID, Email.DISPLAY_NAME, Email.DATA},
             	null, null, null);
            以上就是通过Email获得该联系人的信息的方法。
            读者可以自己完成，通过手机号码去的联系人信息的方法。

    四、触发器的定义

触发器的定义在函数createContactsTriggers中，以RAW_CONTACTS表中的触发器为例，看如下代码：

db.execSQL("DROP TRIGGER IF EXISTS " + Tables.RAW_CONTACTS + "_deleted;");
db.execSQL("CREATE TRIGGER " + Tables.RAW_CONTACTS + "_deleted "
                + "   BEFORE DELETE ON " + Tables.RAW_CONTACTS
                + " BEGIN "
                + "   DELETE FROM " + Tables.DATA
                + "     WHERE " + Data.RAW_CONTACT_ID
                                + "=OLD." + RawContacts._ID + ";"
                + "   DELETE FROM " + Tables.AGGREGATION_EXCEPTIONS
                + "     WHERE " + AggregationExceptions.RAW_CONTACT_ID1
                                + "=OLD." + RawContacts._ID
                + "        OR " + AggregationExceptions.RAW_CONTACT_ID2
                                + "=OLD." + RawContacts._ID + ";"
                + "   DELETE FROM " + Tables.VISIBLE_CONTACTS
                + "     WHERE " + Contacts._ID + "=OLD." + RawContacts.CONTACT_ID
                + "       AND (SELECT COUNT(*) FROM " + Tables.RAW_CONTACTS
                + "            WHERE " + RawContacts.CONTACT_ID + "=OLD." + RawContacts.CONTACT_ID
                + "           )=1;"
                + "   DELETE FROM " + Tables.DEFAULT_DIRECTORY
                + "     WHERE " + Contacts._ID + "=OLD." + RawContacts.CONTACT_ID
                + "       AND (SELECT COUNT(*) FROM " + Tables.RAW_CONTACTS
                + "            WHERE " + RawContacts.CONTACT_ID + "=OLD." + RawContacts.CONTACT_ID
                + "           )=1;"
                + "   DELETE FROM " + Tables.CONTACTS
                + "     WHERE " + Contacts._ID + "=OLD." + RawContacts.CONTACT_ID
                + "       AND (SELECT COUNT(*) FROM " + Tables.RAW_CONTACTS
                + "            WHERE " + RawContacts.CONTACT_ID + "=OLD." + RawContacts.CONTACT_ID
                + "           )=1;"
                + " END");
                上述代码，在RAW_CONTACTS表上创建了一个触发器，当从RAW_CONTACTS表里删除记录时，会通过触发器自动删除该RAW_CONTACT_ID对应的DATA表、CONTACTS表等其他表中的信息。再来看一个比较重要的触发器： 

db.execSQL("DROP TRIGGER IF EXISTS " + Tables.RAW_CONTACTS + "_marked_deleted;");
db.execSQL("CREATE TRIGGER " + Tables.RAW_CONTACTS + "_marked_deleted "
                + "   AFTER UPDATE ON " + Tables.RAW_CONTACTS
                + " BEGIN "
                + "   UPDATE " + Tables.RAW_CONTACTS
                + "     SET "
                +         RawContacts.VERSION + "=OLD." + RawContacts.VERSION + "+1 "
                + "     WHERE " + RawContacts._ID + "=OLD." + RawContacts._ID
                + "       AND NEW." + RawContacts.DELETED + "!= OLD." + RawContacts.DELETED + ";"
                + " END");
                上述的触发器，在RAW_CONTACTS表发生UPDATE时，会将其VERSION加1，其实出发VERSION加1的逻辑还有其他几个，读者可以自行分析，这里的VERSION字段可以用来做数据比较，还是非常有用的。

           

               数据库的基本操作暂时介绍到这，如果您想深入的理解Android联系人模块，这部分代码还是需要掌握的，掌握了基础设施，才有可能了解上层建筑。



Android contacts 联系人 通讯录 源码 完全解析
Kafka_88的专栏
02-15 1万+
Android contacts 联系人 通讯录 源码 完全解析Android contacts 联系人 通讯录 源码 完全解析 1简介 2软件架构 3各功能模块分析 1联系人数据的显示 1联系人列表显示 2联系人详细信息数据的显示 2联系人数据的编辑和存储 1编辑界面相关 2数据存储相关 3Sim联系人数据的整合 1Sim卡联系人数据的显示 2开机自动导入Sim卡联系人 3telephony中Ic
android 联系人模块
10-28
这是一个自己写的android联系人的app初学者可以学习
Android联系人模块分析（一）
jiang_lostcode的专栏
10-08 3320
联系人模块是Android系统中的一个重要的功能模块，目前Android市场上有大量的基于通讯录的应用，本人计划写出系列文章详细介绍联系人模块的结构和使用。作为开头，本篇文章将对ContactsProvider做个简要的介绍。      Android系统将联系人的信息存储在sqlite数据库中，并通过ContactsProvider提供查询、更新、删除等操作。所以如果需要掌握联系人相关信息的操
Android手机通讯录解析
07-11 399
相关图片上传麻烦，原文件到我的博客上传的文件里下载。 1、通讯录应用介绍 通讯录应用是Android自带的应用程序，我们看到此应用的时候，可能只认为这是一个应用，用数据库存储数据，但是实际上不是这样的。 通讯录是ContentProvider的应用，通讯录由两部分组成： (1)com.android.providers.contacts的ContentProvider：真正...
android获取联系人信息，插入联系人
无心细语
03-07 1074
Cursor cur = getContentResolver().query( ContactsContract.Contacts.CONTENT_URI, null, null, null, ContactsCont
Android 联系人开发- 保存联系人
dengmc的专栏
11-18 9891
 最近在开发android平台的联系人部分，有点总结和大家分享一下： 参数：String name,   联系人姓名String homePhone,  家庭电话String mobile,   手机String workphone,  公司电话String workfax,       公司传真String emailAddr,    邮件地址String
android联系人模块分析文档.doc.doc
07-05
【Android联系人模块分析】 1. **简介** Android联系人模块是操作系统核心组件之一，它负责管理和存储用户的联系人信息。本机联系人数据存储在手机内部的SQLite数据库中，由Content Provider（ContactsProvider）...
android联系人模块分析文档
02-24
android联系人模块分析文档
Android联系人模块源码分析与应用
标题“Android联系人源码”与描述“这是android联系人模块的源码 希望对大家的工作和学习有所帮助！”表明文档包含的是Android系统中联系人应用的源代码，这是一个对开发人员和学习者具有高度参考价值的资料。...
Android联系人管理模块Java源码分析与实践
资源摘要信息: "Android 联系人管理Java源码实例" 知识点一：Android 联系人管理机制 ...通过深入分析和学习这个实例，开发者能够加深对Android联系人API的了解，提高在Android平台上开发相关功能的能力。
Pro Android学习笔记（一六七）：联系人API（10）：在Personal Profile中添加raw contact
愷风（Wei）的专栏
06-16 3172
文章转载只能用于非商业性质，且不能带有虚拟货币、积分、注册等附加条件。转载须注明出处http://blog.youkuaiyun.com/flowingflying/以及作者@恺风Wei。 在Personal Profile中添加raw contact和普通的contact差不多，只是数据存放在profile.db中相应的表格中。小例子将在profile中添加一个raw contact。 相关的代码片
android Contacts 通讯录源码
07-24
android4.0 Contacts 通讯录源码
rawContact数据查询
Robin Hu的专栏
10-26 2367
对RawContacts主表可查询以下共18项数据： 变量名                                列名                                备注  _ID                                _id                                    这个就是raw_contact_id  CON
android contactsprovider 启动流程,Android开机启动流程初探
weixin_29195615的博客
06-04 538
lInit进程Android系统在启动时首先会启动Linux系统，引导加载Linux Kernel并启动init进程。Init进程是一个由内核启动的用户级进程，是Android系统的第一个进程。该进程的相关代码在platform\system\core\init\init.c。在main函数中，有如下代码：open_devnull_stdio();log_init();INFO("reading ...
Contacts Provider基础
知识共享，你我皆是知识的搬运工
01-12 3384
作为四大组件之一的ContentProvider工作中我们很少会用到自己自定义的ContentProvider,用到的最多的就是系统提供的。官方文档提供了两种系统ContentProvider,一种是CalendarProvider,一种是Contacts Provider。今天我们的主角就是Contact Provider。
数据库中删除SIM卡联系人
Jack的博客
01-04 2643
4,SIM卡联系人 Contacts2.db数据库中联系人其实包括2部分,手机上面的联系人以及SIM卡中的联系人。 当然, SIM卡中的联系人是保存在单独的数据库中,其对应的Provider为IccProvider,在packages\services\Telephony 路径下,也就是phone进程中。 AndroidManifest.xml对应的定义如下, <provider andr
汉字转拼音android实现（HanziToPinyin类）
qjbagu的专栏
11-19 1150
对Contacts了解就会知道（不了解可以了解下），每个联系人都有一个sort_key字段，如果查询中没有设置sortOrder，默认就会以 sort_key字段为排序依据。名字的检索其实也是根据sort_key来做的（比如拨号盘的模糊匹配：数字转成字母，再到拼音，最后得到汉字）。sort_key是根据名字生成的：如果联系人名字中包含字母，sort_key和name保持一致；如果名字是汉字，生成的
ContentProvider 源码分析---之三
Jack的博客
08-18 1209
3, ContentProvider实现 调用数据库的方法如下, ContentResolver resolver = getContentResolver(); Cursor phoneCursor = resolver.query(Phone.CONTENT_URI,••• 实际步骤如下, 1,调用getContentResolver方法获取ContextImpl的内部类Applic
contacts模块功能分析
lksodit_yiyi的专栏
08-20 9377
1.    简介 本文基于MTK6516代码进行分析联系人模块的功能及数据库操作的流程。 联系人是手机功能中不可缺少的模块，主要记录用户的联系人数据，方便用户快捷的操作和使用，主要包括本机联系人和Sim卡联系人。 本机联系人主要存储在手机内部存储空间，Android平台上是通过数据库（Provider）进行存储，并提供复杂的字段用于表示联系人数据，并提供用户快捷的操作，比如增加，删除，修改，
评论 3
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值