184 lines
5.3 KiB
Go
184 lines
5.3 KiB
Go
// 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
|
|
}
|