Files
bj_power/bj_power_mes/internal/verr/verr.go
T
SunYF b0c048d9aa feat: 新增收集式校验错误弹窗及工位报警语音播报
新增 ErrorListDialog 组件用于统一展示结构化校验错误信息,实现报错一次收全;新增工位报警语音播报功能,通过浏览器 SpeechSynthesis 播放本工位相关报警;调整物料类别及序列号字段文案,移除「其他」类别;新增工单实际开始字段及采集方式配置;优化 AGV 及 PlcSend 页签刷新逻辑;新增看板物料追溯及工位报警接口;删除 PLC 强制写 M 位及相关测试代码;同步数据库字段注释及补丁。
2026-10-20 16:36:26 +08:00

68 lines
2.3 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// Package verr 收集式校验错误(报错一次收全 + 每条带怎么办,2026-10-20 拍板):
// 校验函数从「发现错就 return」改为逐条收集,收尾用 OrNil() 一次性返回全部问题,
// 由 handler 层 FailErr 识别后输出 code=3015 + data.errors 结构化响应,
// 前端拦截器识别后用 ErrorListDialog 一次弹全,不再挤牙膏。
package verr
import "fmt"
// ErrAction 可跳转动作:前端渲染为按钮,点击新开标签页跳转 URL(当前页表单草稿保留)。
type ErrAction struct {
Label string `json:"label"`
URL string `json:"url"`
}
// FieldError 单条校验错误:现象(Message)+ 怎么办(Suggestion)+ 可选跳转(Action)。
type FieldError struct {
Field string `json:"field"`
Message string `json:"message"`
Suggestion string `json:"suggestion"`
Action *ErrAction `json:"action,omitempty"`
}
// ValidationError 收集容器:errors 非空时整体作为一个 error 返回。
type ValidationError struct {
Errors []FieldError
}
// New 新建收集器。
func New() *ValidationError { return &ValidationError{} }
// Add 追加一条「现象 + 怎么办」。
func (e *ValidationError) Add(field, message, suggestion string) {
e.Errors = append(e.Errors, FieldError{Field: field, Message: message, Suggestion: suggestion})
}
// AddAction 追加一条带跳转按钮的错误(label=按钮文案,url=新标签页打开的路由)。
func (e *ValidationError) AddAction(field, message, suggestion, label, url string) {
e.Errors = append(e.Errors, FieldError{Field: field, Message: message, Suggestion: suggestion,
Action: &ErrAction{Label: label, URL: url}})
}
// Merge 把另一个收集器的条目并入本收集器。
func (e *ValidationError) Merge(o *ValidationError) {
if o != nil && len(o.Errors) > 0 {
e.Errors = append(e.Errors, o.Errors...)
}
}
// Len 已收集条数。
func (e *ValidationError) Len() int {
if e == nil {
return 0
}
return len(e.Errors)
}
// OrNil 收尾:无错误返回 nil,有错误返回自身(校验函数统一调用)。
func (e *ValidationError) OrNil() error {
if e == nil || len(e.Errors) == 0 {
return nil
}
return e
}
func (e *ValidationError) Error() string {
return fmt.Sprintf("保存失败,共 %d 项需要处理", len(e.Errors))
}