综合平台编程器项目的远程存储
選択できるのは25トピックまでです。 トピックは、先頭が英数字で、英数字とダッシュ('-')を使用した35文字以内のものにしてください。
 
 
 
 

318 行
12 KiB

  1. #include "domain/project_storage.h"
  2. #include "infrastructure/json_project_storage.h"
  3. #include "services/project_service.h"
  4. #include <QFile>
  5. #include <QTemporaryDir>
  6. #include <exception>
  7. #include <iostream>
  8. #include <stdexcept>
  9. #include <string>
  10. namespace {
  11. void require(bool condition, const std::string &message)
  12. {
  13. if (!condition)
  14. {
  15. throw std::runtime_error(message);
  16. }
  17. }
  18. Project makeExampleProject()
  19. {
  20. // 构造覆盖 HMI 控件和梯形图串并联结构的完整 JSON 往返样本
  21. HmiControl start_button;
  22. start_button.id = "start-button";
  23. start_button.type = HmiControlType::Button;
  24. start_button.bounds = {10, 20, 120, 48};
  25. start_button.text = "Start";
  26. start_button.binding = RegisterAddress{RegisterArea::M, 0};
  27. start_button.properties.emplace("color", "green");
  28. HmiControl running_indicator;
  29. running_indicator.id = "running-indicator";
  30. running_indicator.type = HmiControlType::Indicator;
  31. running_indicator.bounds = {150, 20, 64, 64};
  32. running_indicator.text = "Running";
  33. running_indicator.binding = RegisterAddress{RegisterArea::M, 1};
  34. running_indicator.properties.emplace("activeColor", "#24a148");
  35. HmiControl temperature_display;
  36. temperature_display.id = "temperature-display";
  37. temperature_display.type = HmiControlType::NumericDisplay;
  38. temperature_display.bounds = {10, 90, 120, 40};
  39. temperature_display.text = "Temperature";
  40. temperature_display.binding = RegisterAddress{RegisterArea::D, 2};
  41. temperature_display.properties.emplace("format", "decimal");
  42. HmiControl target_input;
  43. target_input.id = "target-input";
  44. target_input.type = HmiControlType::NumericInput;
  45. target_input.bounds = {150, 90, 120, 40};
  46. target_input.text = "Target";
  47. target_input.binding = RegisterAddress{RegisterArea::D, 3};
  48. target_input.properties.emplace("minimum", "-100");
  49. HmiPage page;
  50. page.id = "main-page";
  51. page.name = "Main";
  52. page.controls.push_back(start_button);
  53. page.controls.push_back(running_indicator);
  54. page.controls.push_back(temperature_display);
  55. page.controls.push_back(target_input);
  56. LogicNode contact;
  57. contact.id = "start-contact";
  58. contact.config = ContactNodeConfig{
  59. RegisterAddress{RegisterArea::M, 0},
  60. ContactMode::NormallyOpen};
  61. LogicNode compare;
  62. compare.id = "temperature-check";
  63. compare.config = CompareNodeConfig{
  64. RegisterAddress{RegisterArea::D, 2},
  65. ComparisonOperator::GreaterThanOrEqual,
  66. static_cast<std::int16_t>(100)};
  67. LogicNode hold_contact;
  68. hold_contact.id = "hold-contact";
  69. hold_contact.config = ContactNodeConfig{
  70. RegisterAddress{RegisterArea::M, 1},
  71. ContactMode::NormallyOpen};
  72. LogicNode coil;
  73. coil.id = "run-coil";
  74. coil.config = CoilNodeConfig{
  75. RegisterAddress{RegisterArea::M, 1},
  76. CoilMode::Set};
  77. ControlLogic logic;
  78. logic.id = "start-logic";
  79. logic.name = "Start logic";
  80. logic.enabled = false;
  81. LadderRung rung;
  82. rung.id = "rung-1";
  83. rung.name = "Network 1";
  84. ConditionExpression parallel;
  85. parallel.id = "parallel-start";
  86. parallel.kind = ConditionExpressionKind::Parallel;
  87. parallel.children = {
  88. ConditionExpression::fromNode(contact),
  89. ConditionExpression::fromNode(hold_contact)};
  90. ConditionExpression series;
  91. series.id = "series-root";
  92. series.kind = ConditionExpressionKind::Series;
  93. series.children = {
  94. std::move(parallel),
  95. ConditionExpression::fromNode(compare)};
  96. rung.condition = std::move(series);
  97. rung.output = coil;
  98. logic.rungs.push_back(rung);
  99. Project project;
  100. project.metadata = {"example-project", "Example project", "1.0"};
  101. project.hmiPages.push_back(page);
  102. project.controlLogics.push_back(logic);
  103. return project;
  104. }
  105. void writeText(const QString &path, const QByteArray &content)
  106. {
  107. // 直接写入故障样本文件,以验证加载失败时的保护行为
  108. QFile file(path);
  109. require(file.open(QIODevice::WriteOnly), "test file must be writable");
  110. require(file.write(content) == content.size(), "test file must be written completely");
  111. }
  112. QByteArray readBytes(const QString &path)
  113. {
  114. QFile file(path);
  115. require(file.open(QIODevice::ReadOnly), "saved project must be readable");
  116. return file.readAll();
  117. }
  118. void testEmptyProjectRoundTrip()
  119. {
  120. // 空工程是合法工程,保存再加载后不应凭空产生页面或逻辑
  121. QTemporaryDir directory;
  122. require(directory.isValid(), "temporary directory must be valid");
  123. JsonProjectStorage storage;
  124. ProjectService service(storage);
  125. require(service.createNewProject("Empty project").succeeded,
  126. "empty project creation must succeed");
  127. const QString path = directory.filePath("empty.json");
  128. require(service.saveAs(path.toStdString()).succeeded,
  129. "empty project save must succeed");
  130. require(!service.isModified(), "saved project must not be marked modified");
  131. require(service.load(path.toStdString()).succeeded,
  132. "empty project load must succeed");
  133. require(service.project().metadata.name == "Empty project",
  134. "empty project name must survive round trip");
  135. require(service.project().hmiPages.empty(), "empty project must have no HMI pages");
  136. require(service.project().controlLogics.empty(),
  137. "empty project must have no control logics");
  138. }
  139. void testExampleProjectRoundTrip()
  140. {
  141. // 验证各层嵌套字段往返后保持不变且序列化结果稳定
  142. QTemporaryDir directory;
  143. require(directory.isValid(), "temporary directory must be valid");
  144. JsonProjectStorage storage;
  145. ProjectService service(storage);
  146. service.editProject() = makeExampleProject();
  147. const QString first_path = directory.filePath("example.json");
  148. const QString second_path = directory.filePath("example-copy.json");
  149. require(service.saveAs(first_path.toStdString()).succeeded,
  150. "example project save must succeed");
  151. const QByteArray saved_json = readBytes(first_path);
  152. require(saved_json.contains("\"rungs\"")
  153. && saved_json.contains("\"condition\"")
  154. && saved_json.contains("\"children\"")
  155. && saved_json.contains("\"output\""),
  156. "saved project must use structured ladder expressions");
  157. require(!saved_json.contains("\"dataPoints\""),
  158. "saved project must not contain the removed data point model");
  159. require(!saved_json.contains("\"stages\"")
  160. && !saved_json.contains("\"branches\""),
  161. "current project format must not contain the removed stage model");
  162. require(!saved_json.contains("\"position\"")
  163. && !saved_json.contains("\"connections\""),
  164. "saved ladder logic must not contain free-graph fields");
  165. require(service.load(first_path.toStdString()).succeeded,
  166. "example project load must succeed");
  167. const Project &project = service.project();
  168. require(project.metadata.id == "example-project", "project id must survive round trip");
  169. require(project.hmiPages.size() == 1, "HMI page count must survive round trip");
  170. require(project.hmiPages.front().controls.size() == 4,
  171. "all basic HMI controls must survive round trip");
  172. require(project.hmiPages.front().controls.front().binding->area()
  173. == RegisterArea::M,
  174. "HMI M binding must survive round trip");
  175. require(project.hmiPages.front().controls.front().properties.at("color") == "green",
  176. "HMI properties must survive round trip");
  177. require(project.hmiPages.front().controls.at(1).type == HmiControlType::Indicator,
  178. "indicator control type must survive round trip");
  179. require(project.hmiPages.front().controls.at(2).binding->area() == RegisterArea::D,
  180. "numeric display D binding must survive round trip");
  181. require(project.hmiPages.front().controls.at(3).bounds.x == 150,
  182. "numeric input bounds must survive round trip");
  183. require(project.controlLogics.size() == 1,
  184. "control logic count must survive round trip");
  185. require(!project.controlLogics.front().enabled,
  186. "control logic enabled state must survive round trip");
  187. const LadderRung &rung = project.controlLogics.front().rungs.front();
  188. require(rung.condition.has_value()
  189. && rung.condition->kind == ConditionExpressionKind::Series,
  190. "series root expression must survive round trip");
  191. require(rung.condition->children.front().kind
  192. == ConditionExpressionKind::Parallel
  193. && rung.condition->children.front().children.size() == 2U,
  194. "parallel expression branches must survive round trip");
  195. require(rung.output.has_value(),
  196. "ladder output must survive round trip");
  197. const auto &compare = std::get<CompareNodeConfig>(
  198. rung.condition->children.at(1).node->config);
  199. require(compare.address.index() == 2 && compare.value == 100,
  200. "comparison configuration must survive round trip");
  201. require(service.saveAs(second_path.toStdString()).succeeded,
  202. "save as must succeed after load");
  203. require(readBytes(first_path) == readBytes(second_path),
  204. "save and save as must produce stable JSON");
  205. }
  206. void testInvalidFiles()
  207. {
  208. // 非法文件必须被拒绝,并且不得覆盖服务中当前工程
  209. QTemporaryDir directory;
  210. require(directory.isValid(), "temporary directory must be valid");
  211. JsonProjectStorage storage;
  212. ProjectService service(storage);
  213. service.editProject().metadata.name = "Current project";
  214. const QString invalid_json = directory.filePath("invalid-json.json");
  215. const QString missing_field = directory.filePath("missing-field.json");
  216. const QString unsupported_version = directory.filePath("unsupported-version.json");
  217. writeText(invalid_json, "{");
  218. auto result = service.load(invalid_json.toStdString());
  219. require(!result.succeeded
  220. && result.storageError == ProjectStorageError::InvalidJson,
  221. "invalid JSON must be rejected");
  222. require(service.project().metadata.name == "Current project",
  223. "invalid load must keep current project");
  224. writeText(missing_field, R"({"formatVersion":"1.0"})");
  225. result = service.load(missing_field.toStdString());
  226. require(!result.succeeded
  227. && result.storageError == ProjectStorageError::MissingField,
  228. "missing fields must be rejected");
  229. writeText(unsupported_version, R"({"formatVersion":"2.0"})");
  230. result = service.load(unsupported_version.toStdString());
  231. require(!result.succeeded
  232. && result.storageError == ProjectStorageError::UnsupportedVersion,
  233. "unsupported versions must be rejected");
  234. }
  235. void testServiceStateAndSaveErrors()
  236. {
  237. // 保存路径和修改标记只在成功持久化后更新
  238. QTemporaryDir directory;
  239. require(directory.isValid(), "temporary directory must be valid");
  240. JsonProjectStorage storage;
  241. ProjectService service(storage);
  242. require(service.save().error == ProjectServiceError::FilePathRequired,
  243. "save without a current path must be rejected");
  244. require(service.createNewProject(" ").error
  245. == ProjectServiceError::InvalidProjectName,
  246. "blank project names must be rejected");
  247. const QString path = directory.filePath("state.json");
  248. service.editProject().metadata.name = "State project";
  249. require(service.saveAs(path.toStdString()).succeeded,
  250. "state project save must succeed");
  251. service.editProject().metadata.name = "Changed project";
  252. require(service.isModified(), "editing the project must mark it modified");
  253. require(service.save().succeeded, "save must use the current file path");
  254. require(!service.isModified(), "successful save must clear modified state");
  255. const QString failed_path = directory.filePath("missing/subdir/state.json");
  256. require(!service.saveAs(failed_path.toStdString()).succeeded,
  257. "save to an unavailable path must fail");
  258. require(service.currentFilePath() == path.toStdString(),
  259. "failed save as must keep the previous current path");
  260. }
  261. } // namespace
  262. int main()
  263. {
  264. try
  265. {
  266. // 工程服务和 JSON 存储在同一测试进程中验证完整闭环
  267. testEmptyProjectRoundTrip();
  268. testExampleProjectRoundTrip();
  269. testInvalidFiles();
  270. testServiceStateAndSaveErrors();
  271. }
  272. catch (const std::exception &error)
  273. {
  274. std::cerr << "project management tests failed: " << error.what() << '\n';
  275. return 1;
  276. }
  277. std::cout << "project management tests passed\n";
  278. return 0;
  279. }