Documentation
¶
Overview ¶
Package state 实现 Layer 4 — State Contract(§9)。
核心原则:StateChange 是观测事实,不是数据库事务。`before`/`after` 都是观测到的 状态片段,由此自然解释 before=null / before==after / version=0(§9.1)。
包依赖约束(§4.3):state 只允许依赖 event 与 schema,禁止 import contract。 因此 CheckAgainst 返回 state 自己的 Issue,由 contract 层 StateChecker 转换为 分层 Violation;规则 ID 沿用 §9.7 的 gt.state.* 命名空间。
Index ¶
Constants ¶
const ( SevError = "error" SevWarn = "warn" SevInfo = "info" )
严重级别复用契约规则的 error | warn | info 三档(§11.2)。
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Change ¶
type Change struct {
SubjectType string `msgpack:"subject_type" yaml:"subject_type"`
SubjectID string `msgpack:"subject_id" yaml:"subject_id"`
Op Op `msgpack:"op" yaml:"op"`
Path string `msgpack:"path" yaml:"path"`
Before event.Value `msgpack:"before,omitempty" yaml:"before,omitempty"`
After event.Value `msgpack:"after,omitempty" yaml:"after,omitempty"`
Version int64 `msgpack:"version,omitempty" yaml:"version,omitempty"`
Metadata event.Value `msgpack:"metadata,omitempty" yaml:"metadata,omitempty"`
}
Change 是一次状态变更观测(字段与 event.StateChange 逐字段一致,§9.4)。
func ExtractChanges ¶
ExtractChanges 从 payload 的 _state_changes 字段抽取状态变更(取代 event.ExtractStateChanges)。 每个元素按字段名映射到 Change;缺失字段留零值,由 Change.Validate 在后续判定。
func (Change) CheckAgainst ¶
CheckAgainst 校验本 change 相对 subject schema 的合法性(§9.5 / §9.7)。 返回 state.Issue 列表(可能多条)。path 越界即提前返回;其余检查尽量全部收集。
type Path ¶
Path 是解析后的状态路径,可静态解析到一个声明字段(§9.3)。