综合平台编程器项目的远程存储
Nevar pievienot vairāk kā 25 tēmas Tēmai ir jāsākas ar burtu vai ciparu, tā var saturēt domu zīmes ('-') un var būt līdz 35 simboliem gara.
 
 
 
 

300 rindas
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. rung.stages.push_back({"stage-1", {contact, hold_contact}});
  85. rung.stages.push_back({"stage-2", {compare}});
  86. rung.output = coil;
  87. logic.rungs.push_back(rung);
  88. Project project;
  89. project.metadata = {"example-project", "Example project", "1.0"};
  90. project.hmiPages.push_back(page);
  91. project.controlLogics.push_back(logic);
  92. return project;
  93. }
  94. void writeText(const QString &path, const QByteArray &content)
  95. {
  96. // 直接写入故障样本文件,以验证加载失败时的保护行为
  97. QFile file(path);
  98. require(file.open(QIODevice::WriteOnly), "test file must be writable");
  99. require(file.write(content) == content.size(), "test file must be written completely");
  100. }
  101. QByteArray readBytes(const QString &path)
  102. {
  103. QFile file(path);
  104. require(file.open(QIODevice::ReadOnly), "saved project must be readable");
  105. return file.readAll();
  106. }
  107. void testEmptyProjectRoundTrip()
  108. {
  109. // 空工程是合法工程,保存再加载后不应凭空产生页面或逻辑
  110. QTemporaryDir directory;
  111. require(directory.isValid(), "temporary directory must be valid");
  112. JsonProjectStorage storage;
  113. ProjectService service(storage);
  114. require(service.createNewProject("Empty project").succeeded,
  115. "empty project creation must succeed");
  116. const QString path = directory.filePath("empty.json");
  117. require(service.saveAs(path.toStdString()).succeeded,
  118. "empty project save must succeed");
  119. require(!service.isModified(), "saved project must not be marked modified");
  120. require(service.load(path.toStdString()).succeeded,
  121. "empty project load must succeed");
  122. require(service.project().metadata.name == "Empty project",
  123. "empty project name must survive round trip");
  124. require(service.project().hmiPages.empty(), "empty project must have no HMI pages");
  125. require(service.project().controlLogics.empty(),
  126. "empty project must have no control logics");
  127. }
  128. void testExampleProjectRoundTrip()
  129. {
  130. // 验证各层嵌套字段往返后保持不变且序列化结果稳定
  131. QTemporaryDir directory;
  132. require(directory.isValid(), "temporary directory must be valid");
  133. JsonProjectStorage storage;
  134. ProjectService service(storage);
  135. service.editProject() = makeExampleProject();
  136. const QString first_path = directory.filePath("example.json");
  137. const QString second_path = directory.filePath("example-copy.json");
  138. require(service.saveAs(first_path.toStdString()).succeeded,
  139. "example project save must succeed");
  140. const QByteArray saved_json = readBytes(first_path);
  141. require(saved_json.contains("\"rungs\"")
  142. && saved_json.contains("\"stages\"")
  143. && saved_json.contains("\"branches\"")
  144. && saved_json.contains("\"output\""),
  145. "saved logic must use the ladder hierarchy");
  146. require(!saved_json.contains("\"position\"")
  147. && !saved_json.contains("\"connections\""),
  148. "saved ladder logic must not contain free-graph fields");
  149. require(service.load(first_path.toStdString()).succeeded,
  150. "example project load must succeed");
  151. const Project &project = service.project();
  152. require(project.metadata.id == "example-project", "project id must survive round trip");
  153. require(project.hmiPages.size() == 1, "HMI page count must survive round trip");
  154. require(project.hmiPages.front().controls.size() == 4,
  155. "all basic HMI controls must survive round trip");
  156. require(project.hmiPages.front().controls.front().binding->area()
  157. == RegisterArea::M,
  158. "HMI M binding must survive round trip");
  159. require(project.hmiPages.front().controls.front().properties.at("color") == "green",
  160. "HMI properties must survive round trip");
  161. require(project.hmiPages.front().controls.at(1).type == HmiControlType::Indicator,
  162. "indicator control type must survive round trip");
  163. require(project.hmiPages.front().controls.at(2).binding->area() == RegisterArea::D,
  164. "numeric display D binding must survive round trip");
  165. require(project.hmiPages.front().controls.at(3).bounds.x == 150,
  166. "numeric input bounds must survive round trip");
  167. require(project.controlLogics.size() == 1,
  168. "control logic count must survive round trip");
  169. require(!project.controlLogics.front().enabled,
  170. "control logic enabled state must survive round trip");
  171. const LadderRung &rung = project.controlLogics.front().rungs.front();
  172. require(rung.stages.size() == 2,
  173. "ladder stage count must survive round trip");
  174. require(rung.stages.front().branches.size() == 2,
  175. "parallel ladder branches must survive round trip");
  176. require(rung.output.has_value(),
  177. "ladder output must survive round trip");
  178. const auto &compare = std::get<CompareNodeConfig>(
  179. rung.stages.at(1).branches.front().config);
  180. require(compare.address.index() == 2 && compare.value == 100,
  181. "comparison configuration must survive round trip");
  182. require(service.saveAs(second_path.toStdString()).succeeded,
  183. "save as must succeed after load");
  184. require(readBytes(first_path) == readBytes(second_path),
  185. "save and save as must produce stable JSON");
  186. }
  187. void testInvalidFiles()
  188. {
  189. // 非法文件必须被拒绝,并且不得覆盖服务中当前工程
  190. QTemporaryDir directory;
  191. require(directory.isValid(), "temporary directory must be valid");
  192. JsonProjectStorage storage;
  193. ProjectService service(storage);
  194. service.editProject().metadata.name = "Current project";
  195. const QString invalid_json = directory.filePath("invalid-json.json");
  196. const QString missing_field = directory.filePath("missing-field.json");
  197. const QString unsupported_version = directory.filePath("unsupported-version.json");
  198. writeText(invalid_json, "{");
  199. auto result = service.load(invalid_json.toStdString());
  200. require(!result.succeeded
  201. && result.storageError == ProjectStorageError::InvalidJson,
  202. "invalid JSON must be rejected");
  203. require(service.project().metadata.name == "Current project",
  204. "invalid load must keep current project");
  205. writeText(missing_field, R"({"formatVersion":"1.0"})");
  206. result = service.load(missing_field.toStdString());
  207. require(!result.succeeded
  208. && result.storageError == ProjectStorageError::MissingField,
  209. "missing fields must be rejected");
  210. writeText(unsupported_version, R"({"formatVersion":"2.0"})");
  211. result = service.load(unsupported_version.toStdString());
  212. require(!result.succeeded
  213. && result.storageError == ProjectStorageError::UnsupportedVersion,
  214. "unsupported versions must be rejected");
  215. }
  216. void testServiceStateAndSaveErrors()
  217. {
  218. // 保存路径和修改标记只在成功持久化后更新
  219. QTemporaryDir directory;
  220. require(directory.isValid(), "temporary directory must be valid");
  221. JsonProjectStorage storage;
  222. ProjectService service(storage);
  223. require(service.save().error == ProjectServiceError::FilePathRequired,
  224. "save without a current path must be rejected");
  225. require(service.createNewProject(" ").error
  226. == ProjectServiceError::InvalidProjectName,
  227. "blank project names must be rejected");
  228. const QString path = directory.filePath("state.json");
  229. service.editProject().metadata.name = "State project";
  230. require(service.saveAs(path.toStdString()).succeeded,
  231. "state project save must succeed");
  232. service.editProject().metadata.name = "Changed project";
  233. require(service.isModified(), "editing the project must mark it modified");
  234. require(service.save().succeeded, "save must use the current file path");
  235. require(!service.isModified(), "successful save must clear modified state");
  236. const QString failed_path = directory.filePath("missing/subdir/state.json");
  237. require(!service.saveAs(failed_path.toStdString()).succeeded,
  238. "save to an unavailable path must fail");
  239. require(service.currentFilePath() == path.toStdString(),
  240. "failed save as must keep the previous current path");
  241. }
  242. } // namespace
  243. int main()
  244. {
  245. try
  246. {
  247. // 工程服务和 JSON 存储在同一测试进程中验证完整闭环
  248. testEmptyProjectRoundTrip();
  249. testExampleProjectRoundTrip();
  250. testInvalidFiles();
  251. testServiceStateAndSaveErrors();
  252. }
  253. catch (const std::exception &error)
  254. {
  255. std::cerr << "project management tests failed: " << error.what() << '\n';
  256. return 1;
  257. }
  258. std::cout << "project management tests passed\n";
  259. return 0;
  260. }