From d71974c74d885eb44bfacf186345f4762c7f9158 Mon Sep 17 00:00:00 2001
From: rain <1679827795@qq.com>
Date: Sat, 31 Jan 2026 15:41:34 +0800
Subject: [PATCH] 优化部分私有类注释
---
drone-service/drone-gd/src/main/java/org/sxkj/gd/workorder/service/impl/GdPatrolTaskServiceImpl.java | 42 ++++++++++++++++++++++++++++++++++++++++++
1 files changed, 42 insertions(+), 0 deletions(-)
diff --git a/drone-service/drone-gd/src/main/java/org/sxkj/gd/workorder/service/impl/GdPatrolTaskServiceImpl.java b/drone-service/drone-gd/src/main/java/org/sxkj/gd/workorder/service/impl/GdPatrolTaskServiceImpl.java
index 1b48181..a455b6f 100644
--- a/drone-service/drone-gd/src/main/java/org/sxkj/gd/workorder/service/impl/GdPatrolTaskServiceImpl.java
+++ b/drone-service/drone-gd/src/main/java/org/sxkj/gd/workorder/service/impl/GdPatrolTaskServiceImpl.java
@@ -486,6 +486,12 @@
return baseDesc + newStatus.getDesc();
}
+ /**
+ * 根据部门ID获取部门名称
+ *
+ * @param deptId 部门ID
+ * @return 部门名称，缺失时返回"/"
+ */
private String getDeptName(Long deptId) {
if (deptId == null) {
return "/";
@@ -498,6 +504,12 @@
return dept.getDeptName();
}
+ /**
+ * 根据用户ID获取用户姓名
+ *
+ * @param userId 用户ID
+ * @return 用户姓名，缺失时返回"/"
+ */
private String getUserName(Long userId) {
if (userId == null) {
return "/";
@@ -514,6 +526,13 @@
return StringUtil.isBlank(realName) ? "/" : realName;
}
+ /**
+ * 上传巡查报告并保存附件信息
+ *
+ * @param reportFile 报告文件
+ * @param taskEntity 巡查任务
+ * @return 是否保存成功
+ */
private boolean saveAttachFile(File reportFile, GdPatrolTaskEntity taskEntity) throws IOException {
if (reportFile == null || !reportFile.exists()) {
throw new RuntimeException("巡查报告文件不存在");
@@ -537,6 +556,16 @@
return true;
}
+ /**
+ * 构建附件元数据
+ *
+ * @param taskEntity 巡查任务
+ * @param reportFile 报告文件
+ * @param bladeFile 文件上传结果
+ * @param resultType 结果类型
+ * @param desiredName 期望文件名
+ * @return 附件信息
+ */
private Attach buildAttachInfo(GdPatrolTaskEntity taskEntity, File reportFile, BladeFile bladeFile, Integer resultType, String desiredName) {
Attach attach = new Attach();
attach.setDomainUrl(bladeFile.getDomain());
@@ -568,6 +597,13 @@
return attach;
}
+ /**
+ * 生成报告附件名称
+ *
+ * @param taskEntity 巡查任务
+ * @param fallbackName 兜底文件名
+ * @return 附件名称
+ */
private String buildReportAttachName(GdPatrolTaskEntity taskEntity, String fallbackName) {
String taskNo = taskEntity != null ? taskEntity.getTaskNo() : null;
if (StringUtil.isBlank(taskNo)) {
@@ -576,6 +612,12 @@
return taskNo + ".docx";
}
+ /**
+ * 解析巡查任务类型为结果类型
+ *
+ * @param patrolTaskType 巡查任务类型
+ * @return 结果类型
+ */
private Integer parseResultType(String patrolTaskType) {
if (StringUtil.isBlank(patrolTaskType)) {
return null;
--
Gitblit v1.9.3