综合平台编程器项目的远程存储
Nie możesz wybrać więcej, niż 25 tematów Tematy muszą się zaczynać od litery lub cyfry, mogą zawierać myślniki ('-') i mogą mieć do 35 znaków.
 
 
 
 

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