android 4.0联系人分析—查找匹配

一、android 4.0 联系人过滤索引建立分析

联系人过滤索引的建立、修改是在新建、修改、删除或同步联系人的时候，触发ContactsProvider2更新联系人数据库中的search_index表的。

search_index表结构

字段	版本	数据类型	外键	非空 (默认值)	说明
contact_id		INTEGER	Y		跟contact表的ID关联
content		TEXT			联系人内容查找索引,包含单位、职位、邮件地址等，以空格分隔各个content
name		TEXT			联系人姓名索引字段，包含多个索引，以空格分隔。 注：这将是我们查找内容的主要字段
tokens		TEXT			电话号码查找索引，多个电话间以空格分隔

建立索引的步骤：

1. ContactsProvider2的applyBatch把从界面传过来的事务提交到ContactsProvider2.onCommit处理

2. onCommit调用ContactsProvider2.updateSearchIndexInTransaction

3. updateSearchIndexInTransaction调用SearchIndexManager.updateIndexForRawContacts

4. updateIndexForRawContacts调用SearchIndexManager的内部方法buildIndex

5. 在buildIndex中会针对每个字段调用相应DataRowHandlerForXXX.appendSearchableData方法
我们需要关注的DataRowHandlerForStructuredName类的appendSearchableData

6. 最终会调用NameLookupBuilder的appendToSearchIndex建立多个索引

二、android 4.0 联系人查找匹配

android 4.0 contact filt sequence

1. 点击联系人查找界面，输入拼音首字母，会触发PeopleActivity的onAction方法

2. 在onAction中调用ContactBrowseListFragment的setQueryString方法

3. setQueryString调用restartLoader来启动Loader异步更新数据

4. 在Loader的回调接口onCreateLoader配置Loader的参数，包括查询的Uri等。

5. Loader启动后会触发ContactProvider2的query,其处理所有的联系人信息查询.
   我们要关注的是queryLocal中的CONTACTS_FILTER分支。

6. 在ContactProvider2的appendSearchIndexJoin(StringBuilder, String…)方法中会建立查询SQLite数据库的SQL语句。