// schema v2 的协商、点与边扩展校验;这些纯检查被快照、连接和事务命令复用。 package platform import ( "encoding/json" "math" "mime" "net/http" "strconv" "strings" ) // canvasSchema 只读取版本字段,无法解码时返回零;不能替代 normalizeCanvas 的完整验证。 func canvasSchema(raw json.RawMessage) int { var d struct { Version int `json:"schema_version"` } _ = json.Unmarshal(raw, &d) return d.Version } // acceptsCanvasV2 逐项解析 Accept 媒体类型,要求明确 version=2,且存在 q 时必须在 (0,1]。 func acceptsCanvasV2(r *http.Request) bool { for _, value := range strings.Split(r.Header.Get("Accept"), ",") { typ, params, err := mime.ParseMediaType(strings.TrimSpace(value)) if err == nil && typ == "application/vnd.foundry.canvas+json" && params["version"] == "2" { if value, exists := params["q"]; exists { q, e := strconv.ParseFloat(value, 64) if e != nil || !(q > 0 && q <= 1) { continue } } return true } } return false } // canvasPoint 要求完整 x/y 与有限百万坐标范围,供贝塞尔控制点和结点偏移使用。 func canvasPoint(v any) bool { p, ok := v.(map[string]any) return ok && canvasFields(p, "x", "y") && canvasNumber(p["x"], -1e6, 1e6) && canvasNumber(p["y"], -1e6, 1e6) } // validCanvasEdgeData 分别检查外观、动画、执行开关和贝塞尔链;省略分组合法,出现时拒绝未知键。 func validCanvasEdgeData(v any) bool { d, ok := v.(map[string]any) if !ok || !canvasFields(d, "appearance", "animation", "path", "execution") { return false } for key, value := range d { m, ok := value.(map[string]any) if !ok { return false } switch key { case "appearance": if !canvasFields(m, "color", "width", "opacity", "line", "head", "tail") { return false } for k, v := range m { switch k { case "color": s, ok := v.(string) if !ok || !canvasColor.MatchString(s) { return false } case "width": if !canvasNumber(v, .5, 20) { return false } case "opacity": if !canvasNumber(v, .05, 1) { return false } case "line": if !canvasChoice(v, "solid", "dashed", "dotted") { return false } case "head", "tail": marker, ok := v.(map[string]any) if !ok || !canvasFields(marker, "type", "size", "filled") || !canvasChoice(marker["type"], "none", "open-arrow", "triangle", "circle", "diamond", "square") { return false } if v, exists := marker["size"]; exists && !canvasNumber(v, 4, 32) { return false } if v, exists := marker["filled"]; exists { if _, ok := v.(bool); !ok { return false } } } } case "animation": if !canvasFields(m, "mode", "effect", "direction", "durationMs", "color") { return false } for k, v := range m { switch k { case "mode": if !canvasChoice(v, "off", "always", "executing") { return false } case "effect": if !canvasChoice(v, "flow", "dash", "pulse") { return false } case "direction": if !canvasChoice(v, "forward", "reverse") { return false } case "durationMs": if !canvasNumber(v, 250, 30000) { return false } case "color": s, ok := v.(string) if !ok || !canvasColor.MatchString(s) { return false } } } case "execution": // 执行事件是否启用与展示动画独立,协议只允许布尔 enabled。 if !canvasFields(m, "enabled") { return false } if v, exists := m["enabled"]; exists { if _, ok := v.(bool); !ok { return false } } case "path": // 路径仅支持 bezier-chain,最多 64 个唯一 ID 的 knot,每个 knot 有位置与进/出切线。 if !canvasFields(m, "type", "startControl", "endControl", "knots") || m["type"] != "bezier-chain" { return false } for _, k := range []string{"startControl", "endControl"} { if v, exists := m[k]; exists && !canvasPoint(v) { return false } } knots, ok := m["knots"].([]any) if !ok || len(knots) > 64 { return false } seen := map[string]bool{} for _, v := range knots { knot, ok := v.(map[string]any) if !ok || !canvasFields(knot, "id", "position", "in", "out", "mode") { return false } id, ok := knot["id"].(string) if !ok || !canvasID.MatchString(id) || seen[id] { return false } seen[id] = true for _, k := range []string{"position", "in", "out"} { if !canvasPoint(knot[k]) { return false } } if !canvasChoice(knot["mode"], "corner", "smooth", "symmetric") { return false } // smooth 要求非零切线反向共线;symmetric 进一步要求长度相等,使用相对误差容忍浮点噪声。 if knot["mode"] != "corner" { a, b := knot["in"].(map[string]any), knot["out"].(map[string]any) ax, ay, bx, by := a["x"].(float64), a["y"].(float64), b["x"].(float64), b["y"].(float64) la, lb := math.Hypot(ax, ay), math.Hypot(bx, by) if la > 0 && lb > 0 && (math.Abs((ax/la)*(by/lb)-(ay/la)*(bx/lb)) > 1e-6 || (ax/la)*(bx/lb)+(ay/la)*(by/lb) > 0) { return false } if knot["mode"] == "symmetric" && math.Abs(la-lb) > 1e-6*math.Max(la, lb) { return false } } } } } return true }