using System.Text.Json; using WmsLite.Api.Common; using WmsLite.Api.Models.Templates; namespace WmsLite.Api.Common; /// /// 统一解析与校验 sys_template.config_json,供保存模板与库存扩展字段校验共用。 /// public static class TemplateConfigJsonValidator { private static readonly HashSet AllowedTypes = new(StringComparer.OrdinalIgnoreCase) { "text", "number", "decimal", "int", "bool", "date", "datetime" }; private static readonly HashSet AllowedQueryModes = new(StringComparer.OrdinalIgnoreCase) { "eq", "like" }; /// /// 校验并解析为字段列表;非法 JSON、结构或业务规则抛 。 /// public static IReadOnlyList ValidateAndParse(string? configJson) { if (string.IsNullOrWhiteSpace(configJson)) { return Array.Empty(); } JsonDocument doc; try { doc = JsonDocument.Parse(configJson); } catch (JsonException ex) { throw new BusinessException($"Invalid template config JSON: {ex.Message}"); } using (doc) { if (doc.RootElement.ValueKind != JsonValueKind.Array) { throw new BusinessException("ConfigJson must be a JSON array."); } var list = new List(); var seen = new HashSet(StringComparer.OrdinalIgnoreCase); foreach (var element in doc.RootElement.EnumerateArray()) { if (element.ValueKind != JsonValueKind.Object) { throw new BusinessException("Each template field must be a JSON object."); } if (!element.TryGetProperty("field", out var fieldProp)) { throw new BusinessException("Each template field must include a 'field' property."); } var rawField = fieldProp.ValueKind == JsonValueKind.String ? fieldProp.GetString() : null; if (string.IsNullOrWhiteSpace(rawField)) { throw new BusinessException("Template field 'field' must be a non-empty string."); } var fieldName = rawField.Trim(); if (!seen.Add(fieldName)) { throw new BusinessException($"Duplicate template field '{fieldName}'."); } var label = fieldName; if (element.TryGetProperty("label", out var labelProp)) { if (labelProp.ValueKind != JsonValueKind.String) { throw new BusinessException($"Template field '{fieldName}': label must be a string."); } var ls = labelProp.GetString(); if (!string.IsNullOrWhiteSpace(ls)) { label = ls.Trim(); } } var typeNorm = "text"; if (element.TryGetProperty("type", out var typeProp)) { if (typeProp.ValueKind != JsonValueKind.String) { throw new BusinessException($"Template field '{fieldName}': type must be a string."); } var t = typeProp.GetString(); if (!string.IsNullOrWhiteSpace(t)) { typeNorm = t.Trim().ToLowerInvariant(); } } if (!AllowedTypes.Contains(typeNorm)) { throw new BusinessException($"Unsupported template field type '{typeNorm}' for field '{fieldName}'."); } var required = element.TryGetProperty("required", out var reqProp) && reqProp.ValueKind == JsonValueKind.True; var queryable = element.TryGetProperty("queryable", out var qProp) && qProp.ValueKind == JsonValueKind.True; string? queryMode = null; if (element.TryGetProperty("queryMode", out var qmProp)) { if (qmProp.ValueKind == JsonValueKind.Null) { queryMode = null; } else if (qmProp.ValueKind == JsonValueKind.String) { var qm = qmProp.GetString()?.Trim(); if (!string.IsNullOrEmpty(qm)) { if (!AllowedQueryModes.Contains(qm)) { throw new BusinessException($"Unsupported queryMode '{qm}' for field '{fieldName}'."); } queryMode = qm.ToLowerInvariant(); } } else { throw new BusinessException($"Template field '{fieldName}': queryMode must be a string."); } } object? defaultValue = null; if (element.TryGetProperty("defaultValue", out var dvProp)) { defaultValue = ExtractDefaultValueObject(dvProp); ValidateDefaultMatchesType(fieldName, typeNorm, dvProp); } list.Add(new TemplateFieldConfig { Field = fieldName, Label = label, Type = typeNorm, Required = required, Queryable = queryable, QueryMode = queryMode, DefaultValue = defaultValue }); } return list; } } private static object? ExtractDefaultValueObject(JsonElement dvProp) { return dvProp.ValueKind switch { JsonValueKind.Null => null, JsonValueKind.String => dvProp.GetString(), JsonValueKind.True => true, JsonValueKind.False => false, JsonValueKind.Number => dvProp.TryGetInt64(out var l) ? l : dvProp.GetDecimal(), _ => throw new BusinessException("defaultValue must be null, string, number, or boolean.") }; } private static void ValidateDefaultMatchesType(string fieldName, string typeNorm, JsonElement dvProp) { if (dvProp.ValueKind == JsonValueKind.Null) { return; } switch (typeNorm) { case "text": if (dvProp.ValueKind != JsonValueKind.String) { throw new BusinessException($"Template field '{fieldName}': defaultValue for type text must be a string."); } break; case "number": case "decimal": if (dvProp.ValueKind == JsonValueKind.String) { if (string.IsNullOrWhiteSpace(dvProp.GetString())) { break; } if (!decimal.TryParse(dvProp.GetString(), out _)) { throw new BusinessException($"Template field '{fieldName}': defaultValue is not a valid decimal."); } } else if (dvProp.ValueKind != JsonValueKind.Number) { throw new BusinessException($"Template field '{fieldName}': defaultValue for numeric type must be a number or numeric string."); } break; case "int": if (dvProp.ValueKind == JsonValueKind.String) { if (string.IsNullOrWhiteSpace(dvProp.GetString())) { break; } if (!int.TryParse(dvProp.GetString(), out _)) { throw new BusinessException($"Template field '{fieldName}': defaultValue is not a valid integer."); } } else if (dvProp.ValueKind == JsonValueKind.Number) { if (!dvProp.TryGetInt32(out _)) { throw new BusinessException($"Template field '{fieldName}': defaultValue must be a whole number for type int."); } } else { throw new BusinessException($"Template field '{fieldName}': defaultValue for int must be an integer or integer string."); } break; case "bool": if (dvProp.ValueKind is not (JsonValueKind.True or JsonValueKind.False or JsonValueKind.String)) { throw new BusinessException($"Template field '{fieldName}': defaultValue for bool must be true, false, or a string 'true'/'false'."); } if (dvProp.ValueKind == JsonValueKind.String && !bool.TryParse(dvProp.GetString(), out _)) { throw new BusinessException($"Template field '{fieldName}': defaultValue is not a valid boolean."); } break; case "date": case "datetime": if (dvProp.ValueKind == JsonValueKind.String) { if (string.IsNullOrWhiteSpace(dvProp.GetString())) { break; } if (!DateTime.TryParse(dvProp.GetString(), out _)) { throw new BusinessException($"Template field '{fieldName}': defaultValue is not a valid date/time."); } } else { throw new BusinessException($"Template field '{fieldName}': defaultValue for date/datetime must be a string."); } break; } } }