SaveNote:把保存分成可检查的阶段#
- require 检查身份,清理标题/正文两端空格。
- 检查 type、长度、图片数量、topicId 和媒体 URL。
- 图文至少有1张图片,视频必须有 videoUri;数组 nil 规范成
[],序列化 JSON。 - 新建时数据库分配 id;更新时 WHERE 同时限定 id、creator_id、deleted=0。
- 更新影响零行返回403,不能“什么也没改却显示保存成功”。
- 读取真实 Note 作为返回值,前端使用真实作者/ID进入详情。
源码在 notes.go ↗。这里没有先把正文写到另一个服务的分布式事务:标题、正文、图片列表一次 SQL 写入,因此这些字段不会产生跨存储半成功状态。
读取规则集中表达#
noteReadable 要求笔记未删、作者正常、公开或当前作者。Note、SearchNotes、Published、ReadableNoteID 使用相同条件;评论读取再调用 ReadableNoteID。不能只在首页隐藏私密,却让详情或评论按 ID 读取。
noteSelect 连接作者当前昵称/头像,计算赞/藏/评论数和当前人是否有关系。计数字符串保留前端契约,isLiked/isCollected 是布尔值。计数过滤停用或删除用户,评论还过滤已删除根讨论。正文直接作为字符串,不生成 HTML。
点赞为什么无需读出数字再写回#
ReactNote 插入唯一关系行,已经存在则忽略;取消删除关系。读取时 COUNT 对象,避免“并发读到5,各自改为6”丢失更新,也不需要 max(0,count-1) 修补负数。客户端用 desired-state 的 like/unlike,而不是没有上下文的 toggle,所以网络重试不会翻转回去。
如果将来为性能加冗余 count 列,必须设计“新增关系成功才加计数”的同事务规则与重算检查;不能无条件计数加一又保留唯一行忽略。
搜索输入与 SQL#
SearchNotes 将关键词作为参数,用 escapeLike 处理 %、_ 和反斜线,LIKE 匹配标题或正文。排序由有限枚举选择预写的 SQL,不允许把用户传来的列名/方向直接拼进查询。时间范围换算成 UTC 时间阈值。type 可省略,用 *int 区分“0图文”和“未传不限”。
发现推荐和最新共用此方法。关注信息流追加 EXISTS follows 条件并要求登录。搜索没有独立索引副本,刚改私密后新查询立即遵守规则;它也没有中文分词、拼音纠错、ES 相关性与高亮。
两种分页#
搜索、评论、关系列表使用 pageNo + OFFSET:容易理解、可显示总页数,但数据量大时深分页成本高,新增内容可能让分页位置变化。个人笔记使用 id 游标,每次多读一条判断 nextCursor;客户端最多取20条,把第20条ID作为下一次的“小于此ID”。
置顶在当前已加载个人列表排序,游标仍严格按 ID。这是为避免按 is_top + id 排序后游标只有 id 产生漏读;若产品要求任意年代置顶总是第一屏,需要单独查置顶集合并设计复合游标,而不是改一个 ORDER BY 就结束。
读测试#
BusinessLifecycle 检查别人不能更新、私密后详情和评论拒绝、根评论删除后回复不可点赞。FollowingSearchPagination 验证真实关注列表、旧地址别名、23篇分页、LIKE 百分号字面匹配。ConcurrentLike 证明并发唯一和重新连接后的持久结果。
练习:为“按收藏数排序”准备两篇不同收藏数的笔记,验证顺序,而不是断言源码里出现 ORDER BY。