Document optimistic concurrency: _metadata.version, ETag, If-Match → 412 (bundle #561)
还没有人认领这个 Issue。
评估
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 新手友好度
- 73/100
- Issue 类型
- 文档
- 描述清晰度
- 描述清楚
- 活跃度
- 活跃
调研方向
阅读现有的组件和页面数据 API 文档，然后根据本 issue 中列出的行为，确定并发和升级指南应放在哪里。记录 _metadata.version、ETag 和 If-Match 的行为、412 的情况、迁移命令以及 CORS 要求；当 API 文档涵盖这些细节，并将模块侧 UI 和排序指南指向模块文档时，即视为完成。
由索引模型根据 Issue 内容生成。
描述
Bundle PR components-web-app/api-components-bundle#562 (issue #561) adds optimistic concurrency for components and page data. To document:
_metadata.version: an integer for each row, set by Doctrine's#[ORM\Version]. A draft has its own version, starting at 1. Signed-in responses also sendETag: "<version>"; anonymous responses are unchanged.If-Match: "<version>"on PATCH, PUT and DELETE is compared with the row the URL addresses. A stale version gets 412 with the current resource in GET shape. A write to a published IRI that would be redirected to an existing draft also gets 412, with the draft as the body.- A save that loses a race at commit gets 412 too, with or without
If-Match. A DELETE is checked only againstIf-Match. - The order PATCH and
/moveignoreIf-Match. - Upgrade: a new
resource_versioncolumn, so rundoctrine:migrations:diff. - CORS for cross-origin apps: expose
ETagand allowIf-Match.
The module side (conflict UI, ordering updates by version) is the module's own docs.
- 主要语言
- TypeScript
- 星标
- 0
- 派生
- 0
- 平均合并
- 1 小时 20 分钟
- 30 天内合并 PR
- 1
环境准备
这个项目没有提供开发容器、Dockerfile 或贡献指南，环境需要你自己搭建：先看它的 README，通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
components-web-app/docs 的其他 Issue
-
documentation
难度 4/5 3-5 天 新手友好度 45/100
components-web-app/docs#290 · 2 条评论 ·
-
难度 5/5 一周以上 新手友好度 35/100
components-web-app/docs#289 · 2 条评论 ·
-
enhancement
难度 5/5 一周以上 新手友好度 15/100
components-web-app/docs#237 · 2 条评论 ·
-
难度 5/5 一周以上 新手友好度 35/100
components-web-app/docs#1 · 3 条评论 ·
查看 components-web-app/docs 的全部 Issue
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 68/100
awesome-dsh-plugin/awesome-dsh-plugin#9184 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 75/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 85/100
farion1231/cc-switch#8829 ·
维护者通常 1 天内回复
-
[core-client] Remove unused hand-maintained transport helpers after the definition-table cutover未关闭doc-audit enhancement
难度 2/5 1-3 小时 新手友好度 88/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 85/100