实例通讯录管理Contacts20 条种子数据覆盖 6 个字母分组索引条和统计条都有内容一、种子数据设计思路覆盖 6 个首字母组A×5、B×2、C×3、L×4、W×3、Z×3姓名含常见姓氏张/李/王/赵/周/刘/陈/杨/黄/林/孙/吴/徐/马/朱/胡/郭/何/高/罗电话 11 位真实格式、公司职位多样化、头像颜色 8 色循环二、种子数据表20 条idnamephonepinyincompanypositionavatarColor1张伟13800000001Z华为高级工程师#2563EB2李娜13800000002L腾讯产品经理#DC26263王芳13800000003W阿里巴巴运营主管#0596694刘洋13800000004L字节跳动算法工程师#D977065陈静13800000005C百度前端工程师#7C3AED6杨敏13800000006A美团数据分析师#0891B27黄涛13800000007A京东后端工程师#DB27778林晨13800000008L网易游戏策划#4D7C0F9孙悦13800000009A小米测试工程师#2563EB10吴磊13800000010W滴滴司机运营#DC262611徐娇13800000011A携程客户成功#05966912马超13800000012B顺丰物流经理#D9770613朱琳13800000013Z联想财务主管#7C3AED14胡军13800000014A海尔渠道销售#0891B215郭鹏13800000015BTCL项目经理#DB277716何雨13800000016C格力采购专员#4D7C0F17高翔13800000017C比亚迪结构工程师#2563EB18罗敏13800000018L蔚来品牌公关#DC262619周涛13800000019W理想售后经理#05966920赵雪13800000020Z小鹏市场专员#D97706注杨/黄/林/孙/徐/胡/何/高/罗 均以 A 组示例简化首字母映射生产环境按真实拼音。三、分组统计效果字母人数联系人A5杨敏、黄涛、孙悦、徐娇、胡军B2马超、郭鹏C3陈静、何雨、高翔L4李娜、刘洋、林晨、罗敏W3王芳、吴磊、周涛Z3张伟、朱琳、赵雪页面效果顶部统计条A·5 B·2 C·3 L·4 W·3 Z·3右侧索引条 26 字母中 6 个高亮可点列表 6 个分组标题 20 行联系人四、种子数据 SQLINSERTINTOcontact(name,phone,email,company,position,avatar_color,pinyin,remark,created_time)VALUES(张伟,13800000001,zhangweiexample.com,华为,高级工程师,#2563EB,Z,项目对接人,1715500800000),(李娜,13800000002,linaexample.com,腾讯,产品经理,#DC2626,L,,1715500860000),(王芳,13800000003,wangfangexample.com,阿里巴巴,运营主管,#059669,W,,1715500920000),(刘洋,13800000004,liuyangexample.com,字节跳动,算法工程师,#D97706,L,老同学,1715500980000),(陈静,13800000005,chenjingexample.com,百度,前端工程师,#7C3AED,C,,1715501040000),(杨敏,13800000006,yangminexample.com,美团,数据分析师,#0891B2,A,,1715501100000),(黄涛,13800000007,huangtaoexample.com,京东,后端工程师,#DB2777,A,,1715501160000),(林晨,13800000008,linchenexample.com,网易,游戏策划,#4D7C0F,L,,1715501220000),(孙悦,13800000009,sunyueexample.com,小米,测试工程师,#2563EB,A,,1715501280000),(吴磊,13800000010,wuleiexample.com,滴滴,司机运营,#DC2626,W,,1715501340000),(徐娇,13800000011,xujiaoexample.com,携程,客户成功,#059669,A,合作方,1715501400000),(马超,13800000012,machaoexample.com,顺丰,物流经理,#D97706,B,,1715501460000),(朱琳,13800000013,zhulinexample.com,联想,财务主管,#7C3AED,Z,,1715501520000),(胡军,13800000014,hujunexample.com,海尔,渠道销售,#0891B2,A,,1715501580000),(郭鹏,13800000015,guopengexample.com,TCL,项目经理,#DB2777,B,,1715501640000),(何雨,13800000016,heyuexample.com,格力,采购专员,#4D7C0F,C,,1715501700000),(高翔,13800000017,gaoxiangexample.com,比亚迪,结构工程师,#2563EB,C,,1715501760000),(罗敏,13800000018,luominexample.com,蔚来,品牌公关,#DC2626,L,,1715501820000),(周涛,13800000019,zhoutaoexample.com,理想,售后经理,#059669,W,,1715501880000),(赵雪,13800000020,zhaoxueexample.com,小鹏,市场专员,#D97706,Z,,1715501940000);五、页面效果对照面板区域填充后效果标题栏「共 20 位联系人」统计条A·5 B·2 C·3 L·4 W·3 Z·36 个标签列表6 组标题 20 行色块头像 8 色循环索引条6 个字母高亮点击跳转对应分组搜索「1380000001」命中 1-10 号联系人搜索「张」命中张伟六、扩展建议方向做法更大量数据循环生成 200 条for i in 1..200拼接姓名与电话头像真实化用ohos.multimedia.image生成首字圆形位图通讯组/标签增加 group 字段 多选筛选号码拨打集成ohos.telephony.call点击拨号七、文章小结20 条种子数据覆盖 6 个字母分组、20 个常用姓氏、8 种头像色让索引条、统计条、分组列表、搜索四个面板区域首次打开就有饱满展示。分组的均匀分布5/2/3/4/3/3也方便验证索引跳转与统计逻辑的正确性。八、20 位种子数据完整清单序号姓名电话分组备注1张伟13800000001Z项目对接人2李娜13800000002L—3王芳13800000003W—4刘洋13800000004L老同学5陈静13800000005C—6杨敏13800000006A—7黄涛13800000007A—8林晨13800000008L—9孙悦13800000009A—10吴磊13800000010W—11徐娇13800000011A合作方12马超13800000012B—13朱琳13800000013Z—14胡军13800000014A—15郭鹏13800000015B—16何雨13800000016C—17高翔13800000017C—18罗敏13800000018L—19周涛13800000019W—20赵雪13800000020Z—本表与第四章 SQL 数据一一对应区别在于按「验收维度」重新组织电话列用于验证搜索、分组列用于验证索引跳转、备注列用于验证详情页展示三列恰好对应三个面板区域的验收点。九、种子数据设计复盘1. 多姓氏覆盖20 个姓氏零重复20 条姓名全部取自高频姓氏且互不重复张李王赵周刘陈杨黄林孙吴徐马朱胡郭何高罗原因有三姓氏是 pinyin 字段的唯一来源同姓会让某个分组多 1 条而挤占其他分组统计条比例失真零重复保证「一行对应一个分组样本」排查数据问题时可按姓名直接定位贴近真实通讯录观感又不引入同姓二次排序的额外复杂度。补充杨/黄/林/孙/徐/胡/何/高/罗 的真实拼音首字母分别为 Y/H/L/S/X/H/H/G/L其中多数会落入 Y、H、S、X、G 等新分组。本文统一简化为 A 组是为了用最少分组数覆盖「多分组 UI 展示」生产环境务必按真实拼音入库。2. 分组分布为什么是 5/2/3/4/3/3分组人数设计意图A5验证统计条首位 索引条首字母点击L4验证中间分组与同组内姓名二次排序C / W各 3验证普通分组的常规渲染B2验证最少人数分组的标题与索引显示Z3验证末位索引跳转到底部刻意避开「每组 3~4 人」的平均分布因为平均分布暴露不出排序抖动、分组标题边界、索引条高低位差异三类问题同时每组至少 2 人避免出现空分组标题闪烁。十、initSeedData 幂等实现种子数据只应在首次安装后注入一次重复启动不能重复插入。实现分两步先查总数做幂等判断再在事务中批量插入。// 1. 种子数据源与第四章 SQL 同构供循环插入constSEED_CONTACTS:ArrayContactSeed[{index:1,name:张伟,phone:13800000001,company:华为,position:高级工程师,avatarColor:#2563EB,pinyin:Z,remark:项目对接人},{index:2,name:李娜,phone:13800000002,company:腾讯,position:产品经理,avatarColor:#DC2626,pinyin:L,remark:},// ... 其余 18 条与第四章 SQL 完全一致此处省略];// 2. 幂等注入count 0 直接返回staticasyncinitSeedData(context:common.Context):Promisevoid{conststoreawaitContactDao.getStore(context);constcountPredicatesnewrelationalStore.RdbPredicates(ContactDao.TABLE);constresultSetawaitstore.query(countPredicates,[COUNT(*) AS cnt]);letcount0;if(resultSet.goToFirstRow()){countresultSet.getLong(resultSet.getColumnIndex(cnt));}resultSet.close();if(count0){console.info(SeedData: 已有数据跳过注入);return;}// 3. 事务包裹批量插入任一条失败整体回滚awaitstore.beginTransaction();try{for(constcofSEED_CONTACTS){constvalues:relationalStore.ValuesBucket{name:c.name,phone:c.phone,email:${c.name}example.com,company:c.company,position:c.position,avatar_color:c.avatarColor,pinyin:c.pinyin,remark:c.remark,created_time:Date.now()c.index*1000,// 递增时间戳避免排序不稳定};awaitstore.insert(ContactDao.TABLE,values);}awaitstore.commit();}catch(e){awaitstore.rollBack();console.error(SeedData: 注入失败${JSON.stringify(e)});}}幂等设计要点场景表现首次启动count0 → 注入 20 条二次启动count20 → 直接 return用户删除部分后启动count0 → 不补插尊重用户操作注入中途崩溃事务回滚下次启动重试十一、注入后的索引条与列表效果预测假设queryAll()返回全部数据并按pinyin, name排序页面渲染效果可预测如下索引条26 个字母中高亮 6 个A/B/C/L/W/Z其余 20 个置灰点 A 滚到顶部点 Z 滚到底部。分组列表滚动顺序为 A杨敏、黄涛、孙悦、徐娇、胡军→ B马超、郭鹏→ C陈静、何雨、高翔→ L李娜、刘洋、林晨、罗敏→ W王芳、吴磊、周涛→ Z张伟、朱琳、赵雪。验证点预期结果统计条标签A·5 B·2 C·3 L·4 W·3 Z·3 共 6 个列表项总数20 行联系人 6 个分组标题头像颜色8 色循环第 1 与第 9 条同色#2563EBL 组内排序李娜 → 林晨 → 罗敏 → 刘洋按拼音 name搜索「1380000001」命中 1~10 号联系人十二、验证方法SQL注入完成后用以下 SQL 核对数据层全部通过即代表种子数据正确-- 1. 总数应为 20SELECTCOUNT(*)FROMcontact;-- 2. 分组统计应为 5/2/3/4/3/3共 6 行SELECTpinyin,COUNT(*)AScntFROMcontactGROUPBYpinyinORDERBYpinyin;-- 3. L 组内姓名排序李娜、林晨、罗敏、刘洋SELECTnameFROMcontactWHEREpinyinLORDERBYname;-- 4. 电话前缀搜索命中 10 条SELECTCOUNT(*)FROMcontactWHEREphoneLIKE1380000001%;-- 5. 幂等验证连续执行两次注入后总数仍为 20SELECTCOUNT(*)FROMcontact;在 DevEco Studio 的 RDB 调试面板或hdc shell进入应用数据库目录执行第 2 条返回 6 行且计数与预期一致说明分组与索引逻辑全部正确。十三、FAQQ1注入为什么放在 onPageShow 而不是 aboutToAppearAaboutToAppear时组件未完全挂载注入失败没有 UI 反馈在首帧渲染后的onPageShow调用initSeedData可配合 loading 提示「正在准备通讯录…」。Q2用户手动删光全部联系人重启会重新注入吗A不会。initSeedData只要count 0就跳过删光是用户主动行为不应被种子数据覆盖如需重置可在设置页提供「恢复示例数据」入口。Q3200 条数据也能复用这套幂等逻辑吗A可以但建议把SEED_CONTACTS改为循环生成并给created_time加随机偏移否则低端设备批量插入可能出现数百毫秒卡顿。Q4pinyin 为什么不直接存全拼A索引条只显示首字母存全拼浪费存储若搜索需匹配全拼可在查询层动态拼接或冗余pinyin_full字段。本实例按首字母索引设计存单字母即可。Q5种子数据与真实业务数据混在一起如何区分A可在 contact 表增加is_seed标记字段或为种子数据统一使用 1380000 号段电话本实例电话号段本身即可作为区分依据清理时按phone LIKE 1380000%删除即可。
实例通讯录管理Contacts20 条种子数据覆盖 6 个字母分组索引条和统计条都有内容一、种子数据设计思路覆盖 6 个首字母组A×5、B×2、C×3、L×4、W×3、Z×3姓名含常见姓氏张/李/王/赵/周/刘/陈/杨/黄/林/孙/吴/徐/马/朱/胡/郭/何/高/罗电话 11 位真实格式、公司职位多样化、头像颜色 8 色循环二、种子数据表20 条idnamephonepinyincompanypositionavatarColor1张伟13800000001Z华为高级工程师#2563EB2李娜13800000002L腾讯产品经理#DC26263王芳13800000003W阿里巴巴运营主管#0596694刘洋13800000004L字节跳动算法工程师#D977065陈静13800000005C百度前端工程师#7C3AED6杨敏13800000006A美团数据分析师#0891B27黄涛13800000007A京东后端工程师#DB27778林晨13800000008L网易游戏策划#4D7C0F9孙悦13800000009A小米测试工程师#2563EB10吴磊13800000010W滴滴司机运营#DC262611徐娇13800000011A携程客户成功#05966912马超13800000012B顺丰物流经理#D9770613朱琳13800000013Z联想财务主管#7C3AED14胡军13800000014A海尔渠道销售#0891B215郭鹏13800000015BTCL项目经理#DB277716何雨13800000016C格力采购专员#4D7C0F17高翔13800000017C比亚迪结构工程师#2563EB18罗敏13800000018L蔚来品牌公关#DC262619周涛13800000019W理想售后经理#05966920赵雪13800000020Z小鹏市场专员#D97706注杨/黄/林/孙/徐/胡/何/高/罗 均以 A 组示例简化首字母映射生产环境按真实拼音。三、分组统计效果字母人数联系人A5杨敏、黄涛、孙悦、徐娇、胡军B2马超、郭鹏C3陈静、何雨、高翔L4李娜、刘洋、林晨、罗敏W3王芳、吴磊、周涛Z3张伟、朱琳、赵雪页面效果顶部统计条A·5 B·2 C·3 L·4 W·3 Z·3右侧索引条 26 字母中 6 个高亮可点列表 6 个分组标题 20 行联系人四、种子数据 SQLINSERTINTOcontact(name,phone,email,company,position,avatar_color,pinyin,remark,created_time)VALUES(张伟,13800000001,zhangweiexample.com,华为,高级工程师,#2563EB,Z,项目对接人,1715500800000),(李娜,13800000002,linaexample.com,腾讯,产品经理,#DC2626,L,,1715500860000),(王芳,13800000003,wangfangexample.com,阿里巴巴,运营主管,#059669,W,,1715500920000),(刘洋,13800000004,liuyangexample.com,字节跳动,算法工程师,#D97706,L,老同学,1715500980000),(陈静,13800000005,chenjingexample.com,百度,前端工程师,#7C3AED,C,,1715501040000),(杨敏,13800000006,yangminexample.com,美团,数据分析师,#0891B2,A,,1715501100000),(黄涛,13800000007,huangtaoexample.com,京东,后端工程师,#DB2777,A,,1715501160000),(林晨,13800000008,linchenexample.com,网易,游戏策划,#4D7C0F,L,,1715501220000),(孙悦,13800000009,sunyueexample.com,小米,测试工程师,#2563EB,A,,1715501280000),(吴磊,13800000010,wuleiexample.com,滴滴,司机运营,#DC2626,W,,1715501340000),(徐娇,13800000011,xujiaoexample.com,携程,客户成功,#059669,A,合作方,1715501400000),(马超,13800000012,machaoexample.com,顺丰,物流经理,#D97706,B,,1715501460000),(朱琳,13800000013,zhulinexample.com,联想,财务主管,#7C3AED,Z,,1715501520000),(胡军,13800000014,hujunexample.com,海尔,渠道销售,#0891B2,A,,1715501580000),(郭鹏,13800000015,guopengexample.com,TCL,项目经理,#DB2777,B,,1715501640000),(何雨,13800000016,heyuexample.com,格力,采购专员,#4D7C0F,C,,1715501700000),(高翔,13800000017,gaoxiangexample.com,比亚迪,结构工程师,#2563EB,C,,1715501760000),(罗敏,13800000018,luominexample.com,蔚来,品牌公关,#DC2626,L,,1715501820000),(周涛,13800000019,zhoutaoexample.com,理想,售后经理,#059669,W,,1715501880000),(赵雪,13800000020,zhaoxueexample.com,小鹏,市场专员,#D97706,Z,,1715501940000);五、页面效果对照面板区域填充后效果标题栏「共 20 位联系人」统计条A·5 B·2 C·3 L·4 W·3 Z·36 个标签列表6 组标题 20 行色块头像 8 色循环索引条6 个字母高亮点击跳转对应分组搜索「1380000001」命中 1-10 号联系人搜索「张」命中张伟六、扩展建议方向做法更大量数据循环生成 200 条for i in 1..200拼接姓名与电话头像真实化用ohos.multimedia.image生成首字圆形位图通讯组/标签增加 group 字段 多选筛选号码拨打集成ohos.telephony.call点击拨号七、文章小结20 条种子数据覆盖 6 个字母分组、20 个常用姓氏、8 种头像色让索引条、统计条、分组列表、搜索四个面板区域首次打开就有饱满展示。分组的均匀分布5/2/3/4/3/3也方便验证索引跳转与统计逻辑的正确性。八、20 位种子数据完整清单序号姓名电话分组备注1张伟13800000001Z项目对接人2李娜13800000002L—3王芳13800000003W—4刘洋13800000004L老同学5陈静13800000005C—6杨敏13800000006A—7黄涛13800000007A—8林晨13800000008L—9孙悦13800000009A—10吴磊13800000010W—11徐娇13800000011A合作方12马超13800000012B—13朱琳13800000013Z—14胡军13800000014A—15郭鹏13800000015B—16何雨13800000016C—17高翔13800000017C—18罗敏13800000018L—19周涛13800000019W—20赵雪13800000020Z—本表与第四章 SQL 数据一一对应区别在于按「验收维度」重新组织电话列用于验证搜索、分组列用于验证索引跳转、备注列用于验证详情页展示三列恰好对应三个面板区域的验收点。九、种子数据设计复盘1. 多姓氏覆盖20 个姓氏零重复20 条姓名全部取自高频姓氏且互不重复张李王赵周刘陈杨黄林孙吴徐马朱胡郭何高罗原因有三姓氏是 pinyin 字段的唯一来源同姓会让某个分组多 1 条而挤占其他分组统计条比例失真零重复保证「一行对应一个分组样本」排查数据问题时可按姓名直接定位贴近真实通讯录观感又不引入同姓二次排序的额外复杂度。补充杨/黄/林/孙/徐/胡/何/高/罗 的真实拼音首字母分别为 Y/H/L/S/X/H/H/G/L其中多数会落入 Y、H、S、X、G 等新分组。本文统一简化为 A 组是为了用最少分组数覆盖「多分组 UI 展示」生产环境务必按真实拼音入库。2. 分组分布为什么是 5/2/3/4/3/3分组人数设计意图A5验证统计条首位 索引条首字母点击L4验证中间分组与同组内姓名二次排序C / W各 3验证普通分组的常规渲染B2验证最少人数分组的标题与索引显示Z3验证末位索引跳转到底部刻意避开「每组 3~4 人」的平均分布因为平均分布暴露不出排序抖动、分组标题边界、索引条高低位差异三类问题同时每组至少 2 人避免出现空分组标题闪烁。十、initSeedData 幂等实现种子数据只应在首次安装后注入一次重复启动不能重复插入。实现分两步先查总数做幂等判断再在事务中批量插入。// 1. 种子数据源与第四章 SQL 同构供循环插入constSEED_CONTACTS:ArrayContactSeed[{index:1,name:张伟,phone:13800000001,company:华为,position:高级工程师,avatarColor:#2563EB,pinyin:Z,remark:项目对接人},{index:2,name:李娜,phone:13800000002,company:腾讯,position:产品经理,avatarColor:#DC2626,pinyin:L,remark:},// ... 其余 18 条与第四章 SQL 完全一致此处省略];// 2. 幂等注入count 0 直接返回staticasyncinitSeedData(context:common.Context):Promisevoid{conststoreawaitContactDao.getStore(context);constcountPredicatesnewrelationalStore.RdbPredicates(ContactDao.TABLE);constresultSetawaitstore.query(countPredicates,[COUNT(*) AS cnt]);letcount0;if(resultSet.goToFirstRow()){countresultSet.getLong(resultSet.getColumnIndex(cnt));}resultSet.close();if(count0){console.info(SeedData: 已有数据跳过注入);return;}// 3. 事务包裹批量插入任一条失败整体回滚awaitstore.beginTransaction();try{for(constcofSEED_CONTACTS){constvalues:relationalStore.ValuesBucket{name:c.name,phone:c.phone,email:${c.name}example.com,company:c.company,position:c.position,avatar_color:c.avatarColor,pinyin:c.pinyin,remark:c.remark,created_time:Date.now()c.index*1000,// 递增时间戳避免排序不稳定};awaitstore.insert(ContactDao.TABLE,values);}awaitstore.commit();}catch(e){awaitstore.rollBack();console.error(SeedData: 注入失败${JSON.stringify(e)});}}幂等设计要点场景表现首次启动count0 → 注入 20 条二次启动count20 → 直接 return用户删除部分后启动count0 → 不补插尊重用户操作注入中途崩溃事务回滚下次启动重试十一、注入后的索引条与列表效果预测假设queryAll()返回全部数据并按pinyin, name排序页面渲染效果可预测如下索引条26 个字母中高亮 6 个A/B/C/L/W/Z其余 20 个置灰点 A 滚到顶部点 Z 滚到底部。分组列表滚动顺序为 A杨敏、黄涛、孙悦、徐娇、胡军→ B马超、郭鹏→ C陈静、何雨、高翔→ L李娜、刘洋、林晨、罗敏→ W王芳、吴磊、周涛→ Z张伟、朱琳、赵雪。验证点预期结果统计条标签A·5 B·2 C·3 L·4 W·3 Z·3 共 6 个列表项总数20 行联系人 6 个分组标题头像颜色8 色循环第 1 与第 9 条同色#2563EBL 组内排序李娜 → 林晨 → 罗敏 → 刘洋按拼音 name搜索「1380000001」命中 1~10 号联系人十二、验证方法SQL注入完成后用以下 SQL 核对数据层全部通过即代表种子数据正确-- 1. 总数应为 20SELECTCOUNT(*)FROMcontact;-- 2. 分组统计应为 5/2/3/4/3/3共 6 行SELECTpinyin,COUNT(*)AScntFROMcontactGROUPBYpinyinORDERBYpinyin;-- 3. L 组内姓名排序李娜、林晨、罗敏、刘洋SELECTnameFROMcontactWHEREpinyinLORDERBYname;-- 4. 电话前缀搜索命中 10 条SELECTCOUNT(*)FROMcontactWHEREphoneLIKE1380000001%;-- 5. 幂等验证连续执行两次注入后总数仍为 20SELECTCOUNT(*)FROMcontact;在 DevEco Studio 的 RDB 调试面板或hdc shell进入应用数据库目录执行第 2 条返回 6 行且计数与预期一致说明分组与索引逻辑全部正确。十三、FAQQ1注入为什么放在 onPageShow 而不是 aboutToAppearAaboutToAppear时组件未完全挂载注入失败没有 UI 反馈在首帧渲染后的onPageShow调用initSeedData可配合 loading 提示「正在准备通讯录…」。Q2用户手动删光全部联系人重启会重新注入吗A不会。initSeedData只要count 0就跳过删光是用户主动行为不应被种子数据覆盖如需重置可在设置页提供「恢复示例数据」入口。Q3200 条数据也能复用这套幂等逻辑吗A可以但建议把SEED_CONTACTS改为循环生成并给created_time加随机偏移否则低端设备批量插入可能出现数百毫秒卡顿。Q4pinyin 为什么不直接存全拼A索引条只显示首字母存全拼浪费存储若搜索需匹配全拼可在查询层动态拼接或冗余pinyin_full字段。本实例按首字母索引设计存单字母即可。Q5种子数据与真实业务数据混在一起如何区分A可在 contact 表增加is_seed标记字段或为种子数据统一使用 1380000 号段电话本实例电话号段本身即可作为区分依据清理时按phone LIKE 1380000%删除即可。
