标签生命周期

标签、字段和选项在其一生中都会经历特定的状态。此外,标签可能具有不同的修订版本。下图显示了标签生命周期,包括修订:

标签生命周期图。
图 3. 标签的生命周期
  1. 创建标签 (create()) - 系统会创建标签并将其作为 revision_id=1 存储在数据库中。标签的状态为 UNPUBLISHED_DRAFT。在此状态下:
    • 用户无法查看标签
    • 用户无法将标签应用于云端硬盘内容。
  2. (可选)更新标签、字段或选项 (delta()) - 每次更新(即使是在发布之前)都会存储在数据库中,并且标签的修订版本会递增。
  3. 发布标签 (publish()) - 标签的状态为 PUBLISHED,用户可以应用该标签。发布标签会使其修订版本递增。
  4. (可选)更新标签、字段或选项 (delta()) - 标签、字段或选项会更新并作为草稿标签存储在数据库中。该标签的状态为 PUBLISHED,其中 hasUnpublishedChanges=true 表示存在草稿更改,但它们无法供用户使用。每次更新都会递增标签的修订版本。
  5. (可选)发布标签 (publish()) - 如果有,系统会发布最新的草稿。标签的状态为 PUBLISHED,用户可以应用此标签。发布标签会使其版本递增。
  6. 停用标签 (disable()) - 该标签的状态为 DISABLED,但用户可以通过 API 应用该标签。但是,除非配置为显示已停用的标签,否则它不会在界面中显示。弃用标签会递增其修订版本。
  7. 启用标签 (enable()) - 该标签会返回到 PUBLISHED 状态,并且用户可以应用该标签。发布标签会使其修订版本递增。
  8. 删除标签 (delete()) - 标签的状态为 DELETED,因此无法应用。已删除的标签最终会被完全清除。

需要强调的是,每次对标签进行更新都会使标签的修订版本递增。并且,如果标签已发布,则在 n 次更新后再次发布意味着其已发布的修订版本号是修订版本 + n + 1 次连续更新的次数。