联系人过滤索引的建立、修改是在新建、修改、删除或同步联系人的时候,触发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 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语句。