using System.Globalization; using ZB.MOM.WW.MxGateway.Contracts.Proto; namespace ZB.MOM.WW.MxGateway.Server.Dashboard; /// /// Formats an into the short, human-readable text the /// dashboard's Browse subscription panel shows. Kept separate from the /// view layer so the formatting rules are unit-testable without a worker. /// public static class DashboardMxValueFormatter { /// Maximum array elements rendered inline before the value is truncated. private const int MaxArrayElements = 24; /// Formats the value payload of an . /// The value to format; may be null. /// A display string — never null. public static string FormatValue(MxValue? value) { if (value is null) { return "-"; } if (value.IsNull) { return "(null)"; } return value.KindCase switch { MxValue.KindOneofCase.BoolValue => value.BoolValue ? "true" : "false", MxValue.KindOneofCase.Int32Value => value.Int32Value.ToString(CultureInfo.InvariantCulture), MxValue.KindOneofCase.Int64Value => value.Int64Value.ToString(CultureInfo.InvariantCulture), MxValue.KindOneofCase.FloatValue => value.FloatValue.ToString("G7", CultureInfo.InvariantCulture), MxValue.KindOneofCase.DoubleValue => value.DoubleValue.ToString("G15", CultureInfo.InvariantCulture), MxValue.KindOneofCase.StringValue => value.StringValue, MxValue.KindOneofCase.TimestampValue => value.TimestampValue .ToDateTimeOffset() .UtcDateTime .ToString("yyyy-MM-dd HH:mm:ss.fff 'UTC'", CultureInfo.InvariantCulture), MxValue.KindOneofCase.ArrayValue => FormatArray(value.ArrayValue), MxValue.KindOneofCase.RawValue => $"({value.RawValue.Length} bytes)", _ => "-", }; } /// Formats the MXAccess data type of an . /// The value whose data type to describe; may be null. /// The data-type name — never null. Arrays render as Element[dims]. public static string FormatDataType(MxValue? value) { if (value is null) { return "-"; } // A scalar carries its type in MxValue.DataType, but an array leaves // that Unspecified and carries the element type on the MxArray itself. return value.KindCase == MxValue.KindOneofCase.ArrayValue ? FormatArrayDataType(value.ArrayValue) : value.DataType.ToString(); } private static string FormatArrayDataType(MxArray array) { string dimensions = array.Dimensions.Count > 0 ? string.Join(",", array.Dimensions) : string.Empty; return $"{array.ElementDataType}[{dimensions}]"; } private static string FormatArray(MxArray array) { IReadOnlyList elements = array.ValuesCase switch { MxArray.ValuesOneofCase.BoolValues => array.BoolValues.Values.Select(item => item ? "true" : "false").ToArray(), MxArray.ValuesOneofCase.Int32Values => array.Int32Values.Values.Select(item => item.ToString(CultureInfo.InvariantCulture)).ToArray(), MxArray.ValuesOneofCase.Int64Values => array.Int64Values.Values.Select(item => item.ToString(CultureInfo.InvariantCulture)).ToArray(), MxArray.ValuesOneofCase.FloatValues => array.FloatValues.Values.Select(item => item.ToString("G7", CultureInfo.InvariantCulture)).ToArray(), MxArray.ValuesOneofCase.DoubleValues => array.DoubleValues.Values.Select(item => item.ToString("G15", CultureInfo.InvariantCulture)).ToArray(), MxArray.ValuesOneofCase.StringValues => array.StringValues.Values.Select(item => $"\"{item}\"").ToArray(), MxArray.ValuesOneofCase.TimestampValues => array.TimestampValues.Values .Select(item => item.ToDateTimeOffset().UtcDateTime .ToString("yyyy-MM-dd HH:mm:ss 'UTC'", CultureInfo.InvariantCulture)) .ToArray(), MxArray.ValuesOneofCase.RawValues => array.RawValues.Values.Select(item => $"({item.Length} bytes)").ToArray(), _ => [], }; if (elements.Count == 0) { return "[]"; } string body = string.Join(", ", elements.Take(MaxArrayElements)); return elements.Count > MaxArrayElements ? $"[{body}, … {elements.Count} total]" : $"[{body}]"; } }