程序文档工具分类归档 - 永夜

一个用户对于一个资源的是否具有一系列操作权限的判断的重构

永夜 — Sat, 18 Apr 2020 09:32:56 +0000

本文针对用户对资源操作权限的判断逻辑进行了重构。原逻辑在删除资源时需分两步验证，即先查询资源列表确认所有权，再校验权限字段，导致列表接口增加时需兼容多个 SQL。重构后简化了第一步并完善第二步，改为直接校验接口响应参数中的权限字段值。该方案实现了完整的权限控制，并降低了判断性能开销。

一个用户对于一个资源的是否具有一系列操作权限的判断的重构最先出现在永夜。

从 Rap 迁移至 ShowDoc 的文档编写设计，支持多级参数

永夜 — Wed, 01 Apr 2020 02:39:04 +0000

本文探讨了从 Rap 迁移至 ShowDoc 的接口文档编写设计，分析了两者在 JSON 导入功能及参数层级展示上的差异。鉴于 ShowDoc 默认模板仅支持一级参数且无 JSON 导入功能，文章排除了京东文档中高难度的合并单元格方案，转而定制了支持多级参数的互动运营 API 接口模板，最终验证其显示效果符合预期，解决了多级参数的展示需求。

从 Rap 迁移至 ShowDoc 的文档编写设计，支持多级参数最先出现在永夜。

在 Rap 工具中，某个接口文档的字号相对于其他接口文档更小的分析解决

永夜 — Thu, 14 Nov 2019 02:51:45 +0000

在 Rap 工具的使用中发现某接口文档的字号显示异常小于其他文档。经排查分析，定位原因为数据结构定义中的 object 标记丢失，随后决定将数据类型描述由 array 修改为 array。修改操作完成后，文档字号显示恢复正常，符合预期效果，成功解决了字号不一致的问题。

在 Rap 工具中，某个接口文档的字号相对于其他接口文档更小的分析解决最先出现在永夜。

程序文档工具 分类归档 - 永夜

一个用户对于一个资源的是否具有一系列操作权限的判断的重构

从 Rap 迁移至 ShowDoc 的文档编写设计，支持多级参数

在 Rap 工具中，某个接口文档的字号相对于其他接口文档更小的分析解决

程序文档工具分类归档 - 永夜