From 8e42d0c1b7ae36cff2e7c69999117911a4b6f300 Mon Sep 17 00:00:00 2001
From: wanshenmean <cathay_xy@163.com>
Date: 星期四, 26 三月 2026 17:31:06 +0800
Subject: [PATCH] feat(WCS): 完善 WIDESEAWCS_Tasks 模块代码注释
---
Code/WCS/WIDESEAWCS_Server/WIDESEAWCS_Tasks/StackerCraneJob/StackerCraneCommandBuilder.cs | 191 +++++++++++++++++++++++++++++++++++++++++++----
1 files changed, 172 insertions(+), 19 deletions(-)
diff --git a/Code/WCS/WIDESEAWCS_Server/WIDESEAWCS_Tasks/StackerCraneJob/StackerCraneCommandBuilder.cs b/Code/WCS/WIDESEAWCS_Server/WIDESEAWCS_Tasks/StackerCraneJob/StackerCraneCommandBuilder.cs
index 1b00df1..d7b8602 100644
--- a/Code/WCS/WIDESEAWCS_Server/WIDESEAWCS_Tasks/StackerCraneJob/StackerCraneCommandBuilder.cs
+++ b/Code/WCS/WIDESEAWCS_Server/WIDESEAWCS_Tasks/StackerCraneJob/StackerCraneCommandBuilder.cs
@@ -1,4 +1,4 @@
-锘縰sing System;
+using System;
using System.Diagnostics.CodeAnalysis;
using WIDESEAWCS_Common.TaskEnum;
using WIDESEAWCS_ITaskInfoService;
@@ -10,14 +10,40 @@
namespace WIDESEAWCS_Tasks
{
/// <summary>
- /// 鍫嗗灈鏈哄懡浠ゆ瀯寤哄櫒锛氬皝瑁呬换鍔″埌鍛戒护瀵硅薄鐨勮浆鎹笌鍦板潃瑙ｆ瀽銆�
+ /// 鍫嗗灈鏈哄懡浠ゆ瀯寤哄櫒 - 灏佽浠诲姟鍒板懡浠ゅ璞＄殑杞崲涓庡湴鍧�瑙ｆ瀽
/// </summary>
+ /// <remarks>
+ /// 鏍稿績鑱岃矗锛�
+ /// 1. 鏍规嵁宸烽亾绫诲瀷閫夋嫨鍛戒护鏍煎紡锛堟爣鍑嗗懡浠�/鎴愬瀷鍛戒护锛�
+ /// 2. 鏋勫缓鍏ュ簱銆佸嚭搴撱�佺Щ搴撲换鍔＄殑鍛戒护瀵硅薄
+ /// 3. 瑙ｆ瀽浠诲姟鍦板潃锛堣-鍒�-灞傛牸寮忥級鍒板懡浠ゅ潗鏍�
+ /// 4. 鏌ヨ璺敱淇℃伅锛岀‘瀹氬爢鍨涙満鐨勫彇璐�/鏀捐揣绔欏彴
+ ///
+ /// 鍦板潃鏍煎紡绾﹀畾锛氬湴鍧�瀛楃涓叉牸寮忎负 "琛�-鍒�-灞�"锛屼緥濡� "1-2-3" 琛ㄧず绗�1琛屻�佺2鍒椼�佺3灞傘��
+ /// </remarks>
public class StackerCraneCommandBuilder
{
+ /// <summary>
+ /// 浠诲姟鏈嶅姟
+ /// </summary>
private readonly ITaskService _taskService;
+
+ /// <summary>
+ /// 璺敱鏈嶅姟
+ /// </summary>
private readonly IRouterService _routerService;
+
+ /// <summary>
+ /// 鍫嗗灈鏈哄懡浠ら厤缃�
+ /// </summary>
private readonly StackerCraneCommandConfig _config;
+ /// <summary>
+ /// 鏋勯�犲嚱鏁�
+ /// </summary>
+ /// <param name="taskService">浠诲姟鏈嶅姟</param>
+ /// <param name="routerService">璺敱鏈嶅姟</param>
+ /// <param name="config">鍛戒护閰嶇疆</param>
public StackerCraneCommandBuilder(
ITaskService taskService,
IRouterService routerService,
@@ -28,16 +54,36 @@
_config = config;
}
+ /// <summary>
+ /// 灏嗕换鍔¤浆鎹负鍫嗗灈鏈哄懡浠�
+ /// </summary>
+ /// <remarks>
+ /// 鏍规嵁宸烽亾绫诲瀷閫夋嫨涓嶅悓鐨勫懡浠ゆ瀯寤虹瓥鐣ャ��
+ /// </remarks>
+ /// <param name="task">浠诲姟瀵硅薄</param>
+ /// <returns>鍫嗗灈鏈哄懡浠ゅ璞★紝杞崲澶辫触杩斿洖 null</returns>
public object? ConvertToStackerCraneTaskCommand([NotNull] Dt_Task task)
{
+ // 鏍规嵁宸烽亾鑾峰彇鍛戒护绫诲瀷
string commandType = GetCommandType(task.Roadway);
+
+ // 鏍规嵁鍛戒护绫诲瀷璋冪敤鐩稿簲鐨勬瀯寤烘柟娉�
return commandType switch
{
- "Formation" => BuildCommand(task, CreateFormationCommand(task)),
- _ => BuildCommand(task, CreateStandardCommand(task))
+ "Formation" => BuildCommand(task, CreateFormationCommand(task)), // 鎴愬瀷鍛戒护
+ _ => BuildCommand(task, CreateStandardCommand(task)) // 鏍囧噯鍛戒护
};
}
+ /// <summary>
+ /// 鏍规嵁宸烽亾鑾峰彇鍛戒护绫诲瀷
+ /// </summary>
+ /// <remarks>
+ /// 閬嶅巻閰嶇疆涓殑鏄犲皠鍏崇郴锛屾壘鍒板尮閰嶇殑鍛戒护绫诲瀷銆�
+ /// 濡傛灉涓嶅尮閰嶄换浣曟槧灏勶紝杩斿洖榛樿鍛戒护绫诲瀷銆�
+ /// </remarks>
+ /// <param name="roadway">宸烽亾缂栫爜</param>
+ /// <returns>鍛戒护绫诲瀷锛圫tandard 鎴� Formation锛�</returns>
private string GetCommandType(string roadway)
{
foreach (var mapping in _config.RoadwayCommandMapping)
@@ -51,45 +97,88 @@
return _config.DefaultCommandType;
}
+ /// <summary>
+ /// 鍒涘缓鏍囧噯鍛戒护
+ /// </summary>
+ /// <remarks>
+ /// 鐢ㄤ簬鏍囧噯鍫嗗灈鏈猴紙GW銆丆W 寮�澶村贩閬擄級銆�
+ /// </remarks>
+ /// <param name="task">浠诲姟瀵硅薄</param>
+ /// <returns>鏍囧噯鍛戒护瀵硅薄</returns>
private static StackerCraneTaskCommand CreateStandardCommand(Dt_Task task)
{
return new StackerCraneTaskCommand
{
- TaskNum = task.TaskNum,
- WorkType = 1,
- WorkAction = 1
+ TaskNum = task.TaskNum, // 浠诲姟鍙�
+ WorkType = 1, // 浣滀笟绫诲瀷
+ WorkAction = 1 // 浣滀笟鎸囦护锛氬紑濮嬫墽琛�
};
}
+ /// <summary>
+ /// 鍒涘缓鎴愬瀷鍛戒护
+ /// </summary>
+ /// <remarks>
+ /// 鐢ㄤ簬鎴愬瀷鍫嗗灈鏈猴紙HC 寮�澶村贩閬擄級銆�
+ /// 鍖呭惈鏉＄爜瀛楁锛岀敤浜庣數姹犺拷婧��
+ /// </remarks>
+ /// <param name="task">浠诲姟瀵硅薄</param>
+ /// <returns>鎴愬瀷鍛戒护瀵硅薄</returns>
private static FormationStackerCraneTaskCommand CreateFormationCommand(Dt_Task task)
{
return new FormationStackerCraneTaskCommand
{
- Barcode = task.PalletCode,
- TaskNum = task.TaskNum,
- WorkType = 1,
- WorkAction = 1,
- FireAlarm = 0,
- HeartBeat = 0,
- FieldName = string.Empty
+ Barcode = task.PalletCode, // 鎵樼洏鏉＄爜
+ TaskNum = task.TaskNum, // 浠诲姟鍙�
+ WorkType = 1, // 浣滀笟绫诲瀷
+ WorkAction = 1, // 浣滀笟鎸囦护锛氬紑濮嬫墽琛�
+ FireAlarm = 0, // 鐏锛氭甯�
+ HeartBeat = 0, // 蹇冭烦
+ FieldName = string.Empty // 淇濈暀瀛楁
};
}
+ /// <summary>
+ /// 鏋勫缓鍛戒护锛堥�氱敤锛�
+ /// </summary>
+ /// <remarks>
+ /// 鏍规嵁浠诲姟绫诲瀷锛堝叆搴�/鍑哄簱/绉诲簱锛夎皟鐢ㄧ浉搴旂殑鏋勫缓鏂规硶銆�
+ /// </remarks>
+ /// <typeparam name="T">鍛戒护绫诲瀷</typeparam>
+ /// <param name="task">浠诲姟瀵硅薄</param>
+ /// <param name="command">鍒濆鍛戒护瀵硅薄</param>
+ /// <returns>濉厖濂界殑鍛戒护瀵硅薄</returns>
private T? BuildCommand<T>(Dt_Task task, T command) where T : class
{
+ // 鑾峰彇浠诲姟绫诲瀷鍒嗙粍
TaskTypeGroup taskTypeGroup = task.TaskType.GetTaskTypeGroup();
+ // 鏍规嵁浠诲姟绫诲瀷鍒嗗彂鏋勫缓
return taskTypeGroup switch
{
- TaskTypeGroup.InboundGroup => BuildInboundCommand(task, command),
- TaskTypeGroup.OutbondGroup => BuildOutboundCommand(task, command),
- TaskTypeGroup.RelocationGroup => BuildRelocationCommand(task, command),
- _ => command
+ TaskTypeGroup.InboundGroup => BuildInboundCommand(task, command), // 鍏ュ簱
+ TaskTypeGroup.OutbondGroup => BuildOutboundCommand(task, command), // 鍑哄簱
+ TaskTypeGroup.RelocationGroup => BuildRelocationCommand(task, command), // 绉诲簱
+ _ => command // 鏈煡绫诲瀷锛岃繑鍥炲師鍛戒护
};
}
+ /// <summary>
+ /// 鏋勫缓鍏ュ簱鍛戒护
+ /// </summary>
+ /// <remarks>
+ /// 鍏ュ簱浠诲姟闇�瑕侊細
+ /// 1. 鏌ヨ鍫嗗灈鏈哄彇璐х珯鍙帮紙鏍规嵁褰撳墠鍦板潃鍜屼换鍔＄被鍨嬶級
+ /// 2. 璁剧疆璧峰鍧愭爣锛堟潵鑷珯鍙帮級
+ /// 3. 瑙ｆ瀽鐩爣鍦板潃锛岃缃粓鐐瑰潗鏍�
+ /// </remarks>
+ /// <typeparam name="T">鍛戒护绫诲瀷</typeparam>
+ /// <param name="task">浠诲姟瀵硅薄</param>
+ /// <param name="command">鍛戒护瀵硅薄</param>
+ /// <returns>濉厖濂界殑鍛戒护瀵硅薄</returns>
private T? BuildInboundCommand<T>(Dt_Task task, T command) where T : class
{
+ // 纭畾浠诲姟绫诲瀷锛堢┖鎵樼洏鐢ㄧ壒娈婄被鍨� 100锛�
int taskType = 0;
if (task.TaskType == (int)TaskOutboundTypeEnum.OutEmpty)
{
@@ -97,23 +186,29 @@
}
else
taskType = task.TaskType;
+
+ // 鏌ヨ鍫嗗灈鏈哄彇璐х珯鍙拌矾鐢�
Dt_Router? router = _routerService.QueryNextRoute(task.CurrentAddress, task.Roadway, taskType);
if (router == null)
{
+ // 鏈壘鍒扮珯鍙帮紝鏇存柊寮傚父淇℃伅
_taskService.UpdateTaskExceptionMessage(task.TaskNum, $"鏈壘鍒扮珯鍙般�恵task.CurrentAddress}銆戜俊鎭紝鏃犳硶鑾峰彇瀵瑰簲鐨勫爢鍨涙満鍙栬揣绔欏彴淇℃伅");
return null;
}
+ // 璁剧疆璧峰鍧愭爣锛堟潵鑷矾鐢遍厤缃級
SetCommandProperty(command, "StartRow", Convert.ToInt16(router.SrmRow));
SetCommandProperty(command, "StartColumn", Convert.ToInt16(router.SrmColumn));
SetCommandProperty(command, "StartLayer", Convert.ToInt16(router.SrmLayer));
+ // 瑙ｆ瀽鐩爣鍦板潃锛堝簱浣嶅湴鍧�锛�
if (!TryParseAddress(task.NextAddress, out short endRow, out short endColumn, out short endLayer))
{
_taskService.UpdateTaskExceptionMessage(task.TaskNum, $"鍏ュ簱浠诲姟缁堢偣閿欒锛岀粓鐐癸細銆恵task.NextAddress}銆�");
return null;
}
+ // 璁剧疆缁堢偣鍧愭爣
SetCommandProperty(command, "EndRow", endRow);
SetCommandProperty(command, "EndColumn", endColumn);
SetCommandProperty(command, "EndLayer", endLayer);
@@ -121,8 +216,22 @@
return command;
}
+ /// <summary>
+ /// 鏋勫缓鍑哄簱鍛戒护
+ /// </summary>
+ /// <remarks>
+ /// 鍑哄簱浠诲姟闇�瑕侊細
+ /// 1. 鏌ヨ鍫嗗灈鏈烘斁璐х珯鍙帮紙鏍规嵁鐩爣鍦板潃鍜屼换鍔＄被鍨嬶級
+ /// 2. 璁剧疆缁堢偣鍧愭爣锛堟潵鑷珯鍙帮級
+ /// 3. 瑙ｆ瀽璧峰鍦板潃锛岃缃捣鐐瑰潗鏍�
+ /// </remarks>
+ /// <typeparam name="T">鍛戒护绫诲瀷</typeparam>
+ /// <param name="task">浠诲姟瀵硅薄</param>
+ /// <param name="command">鍛戒护瀵硅薄</param>
+ /// <returns>濉厖濂界殑鍛戒护瀵硅薄</returns>
private T? BuildOutboundCommand<T>(Dt_Task task, T command) where T : class
{
+ // 纭畾浠诲姟绫诲瀷
int taskType = 0;
if (task.TaskType == (int)TaskOutboundTypeEnum.OutEmpty)
{
@@ -131,6 +240,7 @@
else
taskType = task.TaskType;
+ // 鏌ヨ鍫嗗灈鏈烘斁璐х珯鍙拌矾鐢�
Dt_Router? router = _routerService.QueryNextRoute(task.Roadway, task.TargetAddress, taskType);
if (router == null)
{
@@ -138,16 +248,19 @@
return null;
}
+ // 璁剧疆缁堢偣鍧愭爣锛堟潵鑷矾鐢遍厤缃級
SetCommandProperty(command, "EndRow", Convert.ToInt16(router.SrmRow));
SetCommandProperty(command, "EndColumn", Convert.ToInt16(router.SrmColumn));
SetCommandProperty(command, "EndLayer", Convert.ToInt16(router.SrmLayer));
+ // 瑙ｆ瀽璧峰鍦板潃锛堝簱浣嶅湴鍧�锛�
if (!TryParseAddress(task.CurrentAddress, out short startRow, out short startColumn, out short startLayer))
{
_taskService.UpdateTaskExceptionMessage(task.TaskNum, $"鍑哄簱浠诲姟璧风偣閿欒锛岃捣鐐癸細銆恵task.CurrentAddress}銆�");
return null;
}
+ // 璁剧疆璧风偣鍧愭爣
SetCommandProperty(command, "StartRow", startRow);
SetCommandProperty(command, "StartColumn", startColumn);
SetCommandProperty(command, "StartLayer", startLayer);
@@ -155,24 +268,41 @@
return command;
}
+ /// <summary>
+ /// 鏋勫缓绉诲簱鍛戒护
+ /// </summary>
+ /// <remarks>
+ /// 绉诲簱浠诲姟闇�瑕侊細
+ /// 1. 瑙ｆ瀽鐩爣鍦板潃锛堟柊鐨勫簱浣嶏級
+ /// 2. 瑙ｆ瀽璧峰鍦板潃锛堝師鏉ョ殑搴撲綅锛�
+ /// 3. 璁剧疆璧锋鍧愭爣
+ /// </remarks>
+ /// <typeparam name="T">鍛戒护绫诲瀷</typeparam>
+ /// <param name="task">浠诲姟瀵硅薄</param>
+ /// <param name="command">鍛戒护瀵硅薄</param>
+ /// <returns>濉厖濂界殑鍛戒护瀵硅薄</returns>
private T? BuildRelocationCommand<T>(Dt_Task task, T command) where T : class
{
+ // 瑙ｆ瀽鐩爣鍦板潃
if (!TryParseAddress(task.NextAddress, out short endRow, out short endColumn, out short endLayer))
{
_taskService.UpdateTaskExceptionMessage(task.TaskNum, $"绉诲簱浠诲姟缁堢偣閿欒锛岀粓鐐癸細銆恵task.NextAddress}銆�");
return null;
}
+ // 璁剧疆缁堢偣鍧愭爣
SetCommandProperty(command, "EndRow", endRow);
SetCommandProperty(command, "EndColumn", endColumn);
SetCommandProperty(command, "EndLayer", endLayer);
+ // 瑙ｆ瀽璧峰鍦板潃
if (!TryParseAddress(task.CurrentAddress, out short startRow, out short startColumn, out short startLayer))
{
_taskService.UpdateTaskExceptionMessage(task.TaskNum, $"绉诲簱浠诲姟璧风偣閿欒锛岃捣鐐癸細銆恵task.CurrentAddress}銆�");
return null;
}
+ // 璁剧疆璧风偣鍧愭爣
SetCommandProperty(command, "StartRow", startRow);
SetCommandProperty(command, "StartColumn", startColumn);
SetCommandProperty(command, "StartLayer", startLayer);
@@ -180,22 +310,45 @@
return command;
}
+ /// <summary>
+ /// 璁剧疆鍛戒护灞炴�у�硷紙閫氳繃鍙嶅皠锛�
+ /// </summary>
+ /// <remarks>
+ /// 浣跨敤鍙嶅皠鍔ㄦ�佽缃懡浠ゅ璞＄殑灞炴�у�笺��
+ /// </remarks>
+ /// <typeparam name="T">鍛戒护绫诲瀷</typeparam>
+ /// <param name="command">鍛戒护瀵硅薄</param>
+ /// <param name="propertyName">灞炴�у悕绉�</param>
+ /// <param name="value">灞炴�у��</param>
private static void SetCommandProperty<T>(T command, string propertyName, object value) where T : class
{
var property = typeof(T).GetProperty(propertyName);
property?.SetValue(command, value);
}
+ /// <summary>
+ /// 瑙ｆ瀽鍦板潃瀛楃涓�
+ /// </summary>
+ /// <remarks>
+ /// 鍦板潃鏍煎紡锛氳-鍒�-灞傦紝渚嬪 "1-2-3" 琛ㄧず绗�1琛屻�佺2鍒椼�佺3灞傘��
+ /// </remarks>
+ /// <param name="address">鍦板潃瀛楃涓�</param>
+ /// <param name="row">瑙ｆ瀽鍑虹殑琛屽潗鏍�</param>
+ /// <param name="column">瑙ｆ瀽鍑虹殑鍒楀潗鏍�</param>
+ /// <param name="layer">瑙ｆ瀽鍑虹殑灞傚潗鏍�</param>
+ /// <returns>瑙ｆ瀽鎴愬姛杩斿洖 true</returns>
private static bool TryParseAddress(string address, out short row, out short column, out short layer)
{
row = column = layer = 0;
- string[] parts = address.Split("-");
+ // 鎸� "-" 鍒嗛殧鍦板潃
+ string[] parts = address.Split('-');
if (parts.Length != 3)
{
return false;
}
+ // 瑙ｆ瀽鍚勯儴鍒嗕负 short 绫诲瀷
return short.TryParse(parts[0], out row)
&& short.TryParse(parts[1], out column)
&& short.TryParse(parts[2], out layer);
--
Gitblit v1.9.3