GlobalVariableModel.cs 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420
  1. using Newtonsoft.Json;
  2. using Prism.Mvvm;
  3. using System;
  4. using System.Collections;
  5. using System.Collections.Generic;
  6. using System.Globalization;
  7. using System.Linq;
  8. namespace TeamAAS.Communication.Models
  9. {
  10. /// <summary>变量作用域:Global=机器级固定(不随产品变);Product=随产品变(存各产品快照)。</summary>
  11. public enum VarScope { Global, Product }
  12. /// <summary>
  13. /// 全局变量。
  14. /// 持久化以 <see cref="Text"/> 为唯一载体(<see cref="Value"/> 标了 JsonIgnore):
  15. /// 反序列化时先落 DataType 再由 Text 解析出强类型值,避免 object 属性被 Newtonsoft
  16. /// 还原成 long / JArray 而导致下游类型不匹配。
  17. /// </summary>
  18. [Serializable]
  19. public class GlobalVariableModel : BindableBase
  20. {
  21. /// <summary>Text ↔ Value 双向同步的重入保护</summary>
  22. [JsonIgnore]
  23. private bool _syncing;
  24. private int _index;
  25. public int Index
  26. {
  27. get => _index;
  28. set => SetProperty(ref _index, value);
  29. }
  30. private string _name = "";
  31. public string Name
  32. {
  33. get => _name;
  34. set
  35. {
  36. if (SetProperty(ref _name, value))
  37. {
  38. RaisePropertyChanged(nameof(IsValid));
  39. }
  40. }
  41. }
  42. private string _dataType = "int";
  43. public string DataType
  44. {
  45. get => _dataType;
  46. set
  47. {
  48. if (!SetProperty(ref _dataType, value)) return;
  49. // 换类型后同时重置 Value 和 Text:只改 Value 会让"值"列继续显示旧文本,
  50. // 与实际值错位(原实现的 Bug)
  51. _value = GetDefaultValue(value);
  52. var t = ValueToText(_value);
  53. if (_text != t)
  54. {
  55. _text = t;
  56. RaisePropertyChanged(nameof(Text));
  57. }
  58. RaisePropertyChanged(nameof(DisplayValue));
  59. RaisePropertyChanged(nameof(IsValid));
  60. }
  61. }
  62. private object _value = 0;
  63. /// <summary>
  64. /// 变量值。可由代码写入任意类型(object 类型变量尤其如此);写入后自动同步 Text 显示。
  65. /// 不参与 JSON 序列化——持久化走 Text,加载时按 DataType 重新解析出强类型值。
  66. /// </summary>
  67. [JsonIgnore]
  68. public object Value
  69. {
  70. get => _value;
  71. set
  72. {
  73. if (!SetProperty(ref _value, value)) return;
  74. SyncTextFromValue();
  75. RaisePropertyChanged(nameof(DisplayValue));
  76. }
  77. }
  78. private string _text = "0";
  79. /// <summary>值列编辑用的文本表示,也是持久化载体。修改后按 DataType 解析进 Value。</summary>
  80. public string Text
  81. {
  82. get => _text;
  83. set
  84. {
  85. if (!SetProperty(ref _text, value)) return;
  86. ParseValue(value);
  87. }
  88. }
  89. private VarScope _scope = VarScope.Product;
  90. /// <summary>作用域:Global(机器级固定)/Product(随产品变)。默认 Product,兼容旧快照。</summary>
  91. public VarScope Scope
  92. {
  93. get => _scope;
  94. set => SetProperty(ref _scope, value);
  95. }
  96. private string _note = "";
  97. public string Note
  98. {
  99. get => _note;
  100. set => SetProperty(ref _note, value);
  101. }
  102. /// <summary>只读展示值:集合统一渲染成 [a, b, c],其余取 ToString。</summary>
  103. [JsonIgnore]
  104. public string DisplayValue
  105. {
  106. get
  107. {
  108. if (_value == null) return "";
  109. if (_value is string s) return s;
  110. if (_value is IEnumerable en)
  111. return "[" + string.Join(", ", en.Cast<object>().Select(x => x?.ToString() ?? "null")) + "]";
  112. return _value.ToString();
  113. }
  114. }
  115. [JsonIgnore]
  116. public bool IsValid => !string.IsNullOrWhiteSpace(Name);
  117. #region 默认值 / 文本互转
  118. /// <summary>该类型新建变量时的初始文本(数组/字符串/object 给空,bool 给 False,数值给 0)</summary>
  119. public static string GetDefaultText(string dataType)
  120. {
  121. switch (dataType)
  122. {
  123. case "bool": return "False";
  124. case "string":
  125. case "object":
  126. case "short[]":
  127. case "int[]":
  128. case "double[]":
  129. case "string[]":
  130. case "bool[]":
  131. return "";
  132. default: return "0";
  133. }
  134. }
  135. private static object GetDefaultValue(string dataType)
  136. {
  137. switch (dataType)
  138. {
  139. case "short": return (short)0;
  140. case "short[]": return new List<short>();
  141. case "int": return 0;
  142. case "int[]": return new List<int>();
  143. case "double": return 0.0;
  144. case "double[]": return new List<double>();
  145. case "string": return "";
  146. case "string[]": return new List<string>();
  147. case "bool": return false;
  148. case "bool[]": return new List<bool>();
  149. // object:任意类型容器,默认空引用(由代码 SetValue 写入实际对象)
  150. case "object": return null;
  151. default: return 0;
  152. }
  153. }
  154. /// <summary>值 → 文本(集合用逗号连接,bool 用 True/False,数值用不变文化格式)</summary>
  155. private static string ValueToText(object value)
  156. {
  157. if (value == null) return "";
  158. if (value is string s) return s;
  159. if (value is bool b) return b ? "True" : "False";
  160. if (value is IEnumerable en)
  161. return string.Join(",", en.Cast<object>().Select(FormatElement));
  162. return FormatElement(value);
  163. }
  164. private static string FormatElement(object x)
  165. {
  166. if (x == null) return "";
  167. if (x is bool b) return b ? "True" : "False";
  168. if (x is IFormattable f) return f.ToString(null, CultureInfo.InvariantCulture);
  169. return x.ToString();
  170. }
  171. #endregion
  172. #region 文本解析
  173. /// <summary>
  174. /// Text → Value。解析失败时回落到该类型默认值,并把文本框还原为默认值文本
  175. /// (原实现只改 _text 字段不通知,界面仍显示非法输入)。
  176. /// </summary>
  177. private void ParseValue(string text)
  178. {
  179. if (_syncing) return;
  180. _syncing = true;
  181. try
  182. {
  183. object parsed;
  184. if (TryParse(text, _dataType, out parsed))
  185. {
  186. _value = parsed;
  187. }
  188. else
  189. {
  190. _value = GetDefaultValue(_dataType);
  191. var t = ValueToText(_value);
  192. if (_text != t)
  193. {
  194. _text = t;
  195. RaisePropertyChanged(nameof(Text));
  196. }
  197. }
  198. RaisePropertyChanged(nameof(DisplayValue));
  199. }
  200. finally
  201. {
  202. _syncing = false;
  203. }
  204. }
  205. /// <summary>Value → Text(代码写入值时同步界面文本)</summary>
  206. private void SyncTextFromValue()
  207. {
  208. if (_syncing) return;
  209. _syncing = true;
  210. try
  211. {
  212. var t = ValueToText(_value);
  213. if (_text != t)
  214. {
  215. _text = t;
  216. RaisePropertyChanged(nameof(Text));
  217. }
  218. }
  219. finally
  220. {
  221. _syncing = false;
  222. }
  223. }
  224. private static bool TryParse(string text, string dataType, out object value)
  225. {
  226. value = null;
  227. var s = (text ?? "").Trim();
  228. switch (dataType)
  229. {
  230. case "short":
  231. {
  232. short r;
  233. if (!short.TryParse(s, NumberStyles.Any, CultureInfo.InvariantCulture, out r)) return false;
  234. value = r; return true;
  235. }
  236. case "int":
  237. {
  238. int r;
  239. if (!int.TryParse(s, NumberStyles.Any, CultureInfo.InvariantCulture, out r)) return false;
  240. value = r; return true;
  241. }
  242. case "double":
  243. {
  244. double r;
  245. if (!double.TryParse(s, NumberStyles.Any, CultureInfo.InvariantCulture, out r)) return false;
  246. value = r; return true;
  247. }
  248. case "bool":
  249. {
  250. bool r;
  251. if (!TryParseBool(s, out r)) return false;
  252. value = r; return true;
  253. }
  254. case "string":
  255. // 字符串保留原文(不 Trim),避免吃掉用户有意输入的首尾空格
  256. value = text ?? ""; return true;
  257. case "object":
  258. // 文本编辑时按字符串存;代码可通过 Value/SetValue 写入任意类型对象
  259. value = text ?? ""; return true;
  260. case "short[]": return TryParseArray<short>(s, x => { short r; return short.TryParse(x, NumberStyles.Any, CultureInfo.InvariantCulture, out r) ? (object)r : null; }, out value);
  261. case "int[]": return TryParseArray<int>(s, x => { int r; return int.TryParse(x, NumberStyles.Any, CultureInfo.InvariantCulture, out r) ? (object)r : null; }, out value);
  262. case "double[]": return TryParseArray<double>(s, x => { double r; return double.TryParse(x, NumberStyles.Any, CultureInfo.InvariantCulture, out r) ? (object)r : null; }, out value);
  263. case "bool[]": return TryParseArray<bool>(s, x => { bool r; return TryParseBool(x, out r) ? (object)r : null; }, out value);
  264. case "string[]": return TryParseArray<string>(s, x => (object)x, out value);
  265. default:
  266. value = text ?? ""; return true;
  267. }
  268. }
  269. /// <summary>
  270. /// 布尔宽松解析:除 True/False 外还接受 1/0、on/off、yes/no、是/否。
  271. /// 原实现用 bool.Parse,输入 1 会抛异常并把值静默重置为 false。
  272. /// </summary>
  273. private static bool TryParseBool(string s, out bool result)
  274. {
  275. result = false;
  276. if (string.IsNullOrWhiteSpace(s)) return false;
  277. var t = s.Trim();
  278. if (bool.TryParse(t, out result)) return true;
  279. switch (t.ToLowerInvariant())
  280. {
  281. case "1": case "on": case "yes": case "y": case "是": case "真": result = true; return true;
  282. case "0": case "off": case "no": case "n": case "否": case "假": result = false; return true;
  283. default: return false;
  284. }
  285. }
  286. /// <summary>
  287. /// 数组解析:支持中英文逗号/分号分隔,空串 = 空列表;任一元素解析失败则整体失败。
  288. /// 泛型参数保证空列表也是正确的强类型(不能靠首元素推断类型)。
  289. /// 原实现完全没有数组分支,数组类型变量的值永远设不进去。
  290. /// </summary>
  291. private static bool TryParseArray<T>(string s, Func<string, object> parseElement, out object value)
  292. {
  293. value = null;
  294. var items = new List<T>();
  295. if (!string.IsNullOrWhiteSpace(s))
  296. {
  297. var parts = s.Split(new[] { ',', ',', ';', ';' }, StringSplitOptions.RemoveEmptyEntries);
  298. foreach (var p in parts)
  299. {
  300. var el = parseElement(p.Trim());
  301. if (el == null) return false;
  302. items.Add((T)el);
  303. }
  304. }
  305. value = items;
  306. return true;
  307. }
  308. #endregion
  309. /// <summary>
  310. /// 复制一份变量。不用 MemberwiseClone:它会连带复制 PropertyChanged 订阅
  311. /// (克隆体改动会通知原对象的监听者),且 List 值是浅拷贝(与原对象共享同一实例)。
  312. /// </summary>
  313. public GlobalVariableModel Clone()
  314. {
  315. // 直接拷字段,绕开各 setter 的联动逻辑,得到与原件完全一致的副本
  316. return new GlobalVariableModel
  317. {
  318. _index = _index,
  319. _name = _name,
  320. _dataType = _dataType,
  321. _value = CopyValue(_value),
  322. _text = _text,
  323. _note = _note,
  324. _scope = _scope,
  325. };
  326. }
  327. /// <summary>创建新变量(统一 Index/Name/默认 Text/Scope 构造,供管理器与编辑器共用)。</summary>
  328. public static GlobalVariableModel Create(string dataType, VarScope scope, int index)
  329. {
  330. var v = new GlobalVariableModel
  331. {
  332. Index = index,
  333. Name = $"Var{index + 1}",
  334. DataType = dataType,
  335. Scope = scope,
  336. };
  337. v.Text = GetDefaultText(dataType);
  338. return v;
  339. }
  340. private static object CopyValue(object value)
  341. {
  342. if (value == null) return null;
  343. if (value is List<short> ls) return new List<short>(ls);
  344. if (value is List<int> li) return new List<int>(li);
  345. if (value is List<double> ld) return new List<double>(ld);
  346. if (value is List<bool> lb) return new List<bool>(lb);
  347. if (value is List<string> lstr) return new List<string>(lstr);
  348. // 基元/字符串不可变;object 变量持有的任意引用无法安全深拷贝,按原样共享
  349. return value;
  350. }
  351. }
  352. public static class GlobalVariableTypes
  353. {
  354. public static readonly string[] SimpleTypes = { "short", "int", "double", "string", "bool" };
  355. public static readonly string[] ArrayTypes = { "short[]", "int[]", "double[]", "string[]", "bool[]" };
  356. /// <summary>任意类型:可被代码写入任何对象(图像/集合/自定义类型),文本编辑时按字符串存取</summary>
  357. public static readonly string[] AnyTypes = { "object" };
  358. public static readonly string[] AllTypes = SimpleTypes.Concat(ArrayTypes).Concat(AnyTypes).ToArray();
  359. public static string GetDisplayName(string type)
  360. {
  361. switch (type)
  362. {
  363. case "short": return "16位整数 (short)";
  364. case "short[]": return "16位整数数组";
  365. case "int": return "整数 (int)";
  366. case "int[]": return "整数数组";
  367. case "double": return "双精度浮点 (double)";
  368. case "double[]": return "双精度浮点数组";
  369. case "string": return "字符串 (string)";
  370. case "string[]": return "字符串数组";
  371. case "bool": return "布尔 (bool)";
  372. case "bool[]": return "布尔数组";
  373. case "object": return "任意对象 (object)";
  374. default: return type;
  375. }
  376. }
  377. }
  378. }