fix:新增注释

ruoyi-modules/ruoyi-commodityManagement/src/main/java/org/dromara/commodityManagement/mapper/DaHuoNumberMapper.java

@@ -15,7 +15,17 @@ import org.dromara.common.mybatis.core.mapper.BaseMapperPlus;
  */
 @Mapper
 public interface DaHuoNumberMapper extends BaseMapperPlus<DaHuoNumber, DaHuoNumberVo> {
+    /**
+     * 分页查询大货管理和版图
+     * @param page 分页对象
+     * @param wrapper 查询条件
+     * @return 分页结果
+     */
     Page<DaHuoNumberVo> selectVoPageWithTemplate(IPage<DaHuoNumberVo> page,@Param(Constants.WRAPPER) Wrapper<DaHuoNumber> wrapper);
 
+    /**
+     * 查询最新一条的大货id
+     * @return 大货id
+     */
     Long selectLastId();
 }

ruoyi-modules/ruoyi-commodityManagement/src/main/java/org/dromara/commodityManagement/service/DaHuoNumberService.java

@@ -10,6 +10,9 @@ import org.dromara.common.mybatis.core.page.TableDataInfo;
 
 import java.util.List;
 
+/**
+ * 大货编号管理服务
+ */
 public interface DaHuoNumberService {
     /**
      * 分页查询大货编号管理
@@ -52,5 +55,9 @@ public interface DaHuoNumberService {
      */
     List<DaHuoNumber> selectDaHuoNumberList();
 
-    int insertImportExcel(ExcelResult<DaHuoNumberImportVo> importVo);
+    /**
+     * 导入大货编号
+     * @param importVo 导入的大货编号对象
+     */
+    void insertImportExcel(ExcelResult<DaHuoNumberImportVo> importVo);
 }

ruoyi-modules/ruoyi-commodityManagement/src/main/java/org/dromara/commodityManagement/service/impl/DaHuoNumberImpl.java

@@ -24,6 +24,9 @@ import java.util.List;
 
 import static org.dromara.commodityManagement.emum.ItemType.DAHUO_TYPE;
 
+/**
+ * 大货编号业务实现
+ */
 @Service
 @RequiredArgsConstructor
 public class DaHuoNumberImpl implements DaHuoNumberService {
@@ -31,6 +34,12 @@ public class DaHuoNumberImpl implements DaHuoNumberService {
     private final DaHuoNumberMapper daHuoNumberMapper;
     private final TemplateMapper templateMapper;
 
+    /**
+     * 查询大货编号列表
+     * @param daHuoNumberBo 大货编号BO对象
+     * @param pageQuery 分页参数
+     * @return 分页结果
+     */
     @Override
     public TableDataInfo<DaHuoNumberVo> selectPageDaHuoNumberList(DaHuoNumberBo daHuoNumberBo, PageQuery pageQuery) {
         QueryWrapper<DaHuoNumber> qw = new QueryWrapper<>();
@@ -44,6 +53,11 @@ public class DaHuoNumberImpl implements DaHuoNumberService {
         return TableDataInfo.build(page);
     }
 
+    /**
+     * 新增大货编号
+     * @param daHuoNumberBo 大货编号BO对象
+     * @return 插入数量
+     */
     @Override
     public int insertDaHuoNumber(DaHuoNumberBo daHuoNumberBo) {
         DaHuoNumber daHuoNumber = MapstructUtils.convert(daHuoNumberBo, DaHuoNumber.class);
@@ -59,6 +73,11 @@ public class DaHuoNumberImpl implements DaHuoNumberService {
         return allRow;
     }
 
+    /**
+     * 修改大货编号
+     * @param daHuoNumberBo 大货编号BO对象
+     * @return 更新数量
+     */
     @Override
     public int updateDaHuoNumber(DaHuoNumberBo daHuoNumberBo) {
         DaHuoNumber daHuoNumber = MapstructUtils.convert(daHuoNumberBo, DaHuoNumber.class);
@@ -77,6 +96,11 @@ public class DaHuoNumberImpl implements DaHuoNumberService {
         return daHuoNumberMapper.updateById(daHuoNumber);
     }
 
+    /**
+     * 删除大货编号
+     * @param daHuoNumberIds 大货编号ID
+     * @return 删除数量
+     */
     @Override
     public int deleteDaHuoNumberByIds(Long[] daHuoNumberIds) {
         for (Long daHuoNumberId : daHuoNumberIds) {
@@ -85,18 +109,31 @@ public class DaHuoNumberImpl implements DaHuoNumberService {
         return daHuoNumberMapper.deleteByIds(Arrays.asList(daHuoNumberIds));
     }
 
+    /**
+     * 根据ID查询大货编号
+     * @param daHuoNumberIds 大货编号ID
+     * @return 大货编号基类
+     */
     @Override
     public List<DaHuoNumber> selectDaHuoNumberListByIds(Long[] daHuoNumberIds) {
         return MapstructUtils.convert(daHuoNumberMapper.selectVoByIds(Arrays.asList(daHuoNumberIds)), DaHuoNumber.class);
     }
 
+    /**
+     * 查询大货编号列表
+     * @return 大货编号列表
+     */
     @Override
     public List<DaHuoNumber> selectDaHuoNumberList() {
         return daHuoNumberMapper.selectList();
     }
 
+    /**
+     * 处理导入的Excel数据
+     * @param result Excel数据
+     */
     @Override
-    public int insertImportExcel(ExcelResult<DaHuoNumberImportVo> result){
+    public void insertImportExcel(ExcelResult<DaHuoNumberImportVo> result){
         for (DaHuoNumberImportVo importVo : result.getList()){
             String[] templateNames = importVo.getTemplate().split(",");
             List<Template> templates = new ArrayList<>();
@@ -109,6 +146,5 @@ public class DaHuoNumberImpl implements DaHuoNumberService {
             }
             insertDaHuoNumber(daHuoNumber);
         }
-        return 1;
     }
 }