服务目录基础接口

ruoyi-modules/guoyan-platform/src/main/java/org/dromara/platform/controller/ServiceCatalogCategoryController.java

@@ -0,0 +1,129 @@
+package org.dromara.platform.controller;
+
+import java.util.List;
+
+import lombok.RequiredArgsConstructor;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.constraints.*;
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import org.dromara.platform.domain.ServiceCatalogCategory;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.validation.annotation.Validated;
+import org.dromara.common.idempotent.annotation.RepeatSubmit;
+import org.dromara.common.log.annotation.Log;
+import org.dromara.common.web.core.BaseController;
+import org.dromara.common.mybatis.core.page.PageQuery;
+import org.dromara.common.core.domain.R;
+import org.dromara.common.core.validate.AddGroup;
+import org.dromara.common.core.validate.EditGroup;
+import org.dromara.common.log.enums.BusinessType;
+import org.dromara.common.excel.utils.ExcelUtil;
+import org.dromara.platform.domain.vo.ServiceCatalogCategoryVo;
+import org.dromara.platform.domain.bo.ServiceCatalogCategoryBo;
+import org.dromara.platform.service.IServiceCatalogCategoryService;
+import org.dromara.common.mybatis.core.page.TableDataInfo;
+
+/**
+ * 服务目录-类别
+ *
+ * @author gejunhao
+ * @date 2025-03-07
+ */
+@Validated
+@RequiredArgsConstructor
+@RestController
+@RequestMapping("/platform/catalogCategory")
+public class ServiceCatalogCategoryController extends BaseController {
+
+    private final IServiceCatalogCategoryService serviceCatalogCategoryService;
+
+    /**
+     * 查询服务目录-类别列表
+     */
+    @SaCheckPermission("platform:catalogCategory:list")
+    @GetMapping("/list")
+    public TableDataInfo<ServiceCatalogCategoryVo> list(ServiceCatalogCategoryBo bo, PageQuery pageQuery) {
+        return serviceCatalogCategoryService.queryPageList(bo, pageQuery);
+    }
+
+    /**
+     * 导出服务目录-类别列表
+     */
+    @SaCheckPermission("platform:catalogCategory:export")
+    @Log(title = "服务目录-类别", businessType = BusinessType.EXPORT)
+    @PostMapping("/export")
+    public void export(ServiceCatalogCategoryBo bo, HttpServletResponse response) {
+        List<ServiceCatalogCategoryVo> list = serviceCatalogCategoryService.queryList(bo);
+        ExcelUtil.exportExcel(list, "服务目录-类别", ServiceCatalogCategoryVo.class, response);
+    }
+
+    /**
+     * 获取服务目录-类别详细信息
+     *
+     * @param id 主键
+     */
+    @SaCheckPermission("platform:catalogCategory:query")
+    @GetMapping("/{id}")
+    public R<ServiceCatalogCategoryVo> getInfo(@NotNull(message = "主键不能为空")
+                                     @PathVariable String id) {
+        return R.ok(serviceCatalogCategoryService.queryById(id));
+    }
+
+    /**
+     * 新增服务目录-类别
+     */
+    @SaCheckPermission("platform:catalogCategory:add")
+    @Log(title = "服务目录-类别", businessType = BusinessType.INSERT)
+    @RepeatSubmit()
+    @PostMapping()
+    public R<Void> add(@Validated(AddGroup.class) @RequestBody ServiceCatalogCategoryBo bo) {
+        return toAjax(serviceCatalogCategoryService.insertByBo(bo));
+    }
+
+    /**
+     * 修改服务目录-类别
+     */
+    @SaCheckPermission("platform:catalogCategory:edit")
+    @Log(title = "服务目录-类别", businessType = BusinessType.UPDATE)
+    @RepeatSubmit()
+    @PutMapping()
+    public R<Void> edit(@Validated(EditGroup.class) @RequestBody ServiceCatalogCategoryBo bo) {
+        return toAjax(serviceCatalogCategoryService.updateByBo(bo));
+    }
+
+    /**
+     * 删除服务目录-类别
+     *
+     * @param ids 主键串
+     */
+    @SaCheckPermission("platform:catalogCategory:remove")
+    @Log(title = "服务目录-类别", businessType = BusinessType.DELETE)
+    @DeleteMapping("/{ids}")
+    public R<Void> remove(@NotEmpty(message = "主键不能为空")
+                          @PathVariable String[] ids) {
+        return toAjax(serviceCatalogCategoryService.deleteWithValidByIds(List.of(ids), true));
+    }
+
+    /**
+     * 获取服务目录-  (父+子)
+     *
+     */
+    @SaCheckPermission("platform:catalogCategory:queryAll")
+    @GetMapping("/queryAll")
+    public R<List<ServiceCatalogCategory>> queryAll() {
+        return R.ok(serviceCatalogCategoryService.queryAll());
+    }
+
+
+    /**
+     * 获取服务目录-子集信息 (暂时未使用)
+     *
+     * @param id 主键
+     */
+    @SaCheckPermission("platform:catalogCategory:querySubInfoById")
+    @GetMapping("querySubInfoById/{id}")
+    public R<List<ServiceCatalogCategoryVo>> querySubInfoById(@NotNull(message = "主键不能为空")
+                                                              @PathVariable String id) {
+        return R.ok(serviceCatalogCategoryService.querySubInfoById(id));
+    }
+}

ruoyi-modules/guoyan-platform/src/main/java/org/dromara/platform/domain/ServiceCatalogCategory.java

@@ -0,0 +1,75 @@
+package org.dromara.platform.domain;
+
+import org.dromara.common.tenant.core.TenantEntity;
+import com.baomidou.mybatisplus.annotation.*;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.io.Serial;
+import java.util.List;
+
+/**
+ * 服务目录-类别对象 service_catalog_category
+ *
+ * @author gejunhao
+ * @date 2025-03-07
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@TableName("service_catalog_category")
+public class ServiceCatalogCategory extends TenantEntity {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+    @TableField(exist = false)
+    List<ServiceCatalogCategory> children;
+
+    /**
+     * 目录ID，唯一标识每个目录条目
+     */
+    @TableId(value = "id")
+    private String id;
+
+    /**
+     * 目录名称，表示目录的名字
+     */
+    private String name;
+
+    /**
+     * 描述
+     */
+    private String description;
+
+    /**
+     * 编号，用于额外标识或排序目的
+     */
+    private String code;
+
+    /**
+     * 是否为子目录，true表示是子目录，false则不是
+     */
+    private Long isChildren;
+
+    /**
+     * 上级目录id，指向父目录的id，如果没有父目录则为空
+     */
+    private String ownerId;
+
+    /**
+     * 上级目录名称，冗余存储父目录的名称以便查询优化
+     */
+    private String ownerName;
+
+    /**
+     * 当前状态
+     */
+    private Long status;
+
+    /**
+     * 删除标志（0代表存在 2代表删除）
+     */
+    @TableLogic
+    private String delFlag;
+
+
+}

ruoyi-modules/guoyan-platform/src/main/java/org/dromara/platform/domain/bo/ServiceCatalogCategoryBo.java

@@ -0,0 +1,72 @@
+package org.dromara.platform.domain.bo;
+
+import org.dromara.platform.domain.ServiceCatalogCategory;
+import org.dromara.common.mybatis.core.domain.BaseEntity;
+import org.dromara.common.core.validate.AddGroup;
+import org.dromara.common.core.validate.EditGroup;
+import io.github.linpeilie.annotations.AutoMapper;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import jakarta.validation.constraints.*;
+
+/**
+ * 服务目录-类别业务对象 service_catalog_category
+ *
+ * @author gejunhao
+ * @date 2025-03-07
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@AutoMapper(target = ServiceCatalogCategory.class, reverseConvertGenerate = false)
+public class ServiceCatalogCategoryBo extends BaseEntity {
+
+    /**
+     * 目录ID，唯一标识每个目录条目
+     */
+    @NotBlank(message = "目录ID，唯一标识每个目录条目不能为空", groups = { EditGroup.class })
+    private String id;
+
+    /**
+     * 目录名称，表示目录的名字
+     */
+    @NotBlank(message = "目录名称，表示目录的名字不能为空", groups = { AddGroup.class, EditGroup.class })
+    private String name;
+
+    /**
+     * 描述
+     */
+    @NotBlank(message = "描述不能为空", groups = { AddGroup.class, EditGroup.class })
+    private String description;
+
+    /**
+     * 编号，用于额外标识或排序目的
+     */
+    @NotBlank(message = "编号，用于额外标识或排序目的不能为空", groups = { AddGroup.class, EditGroup.class })
+    private String code;
+
+    /**
+     * 是否为子目录，true表示是子目录，false则不是
+     */
+    @NotNull(message = "是否为子目录，true表示是子目录，false则不是不能为空", groups = { AddGroup.class, EditGroup.class })
+    private Long isChildren;
+
+    /**
+     * 上级目录id，指向父目录的id，如果没有父目录则为空
+     */
+    @NotBlank(message = "上级目录id，指向父目录的id，如果没有父目录则为空不能为空", groups = { AddGroup.class, EditGroup.class })
+    private String ownerId;
+
+    /**
+     * 上级目录名称，冗余存储父目录的名称以便查询优化
+     */
+    @NotBlank(message = "上级目录名称，冗余存储父目录的名称以便查询优化不能为空", groups = { AddGroup.class, EditGroup.class })
+    private String ownerName;
+
+    /**
+     * 当前状态
+     */
+    @NotNull(message = "当前状态不能为空", groups = { AddGroup.class, EditGroup.class })
+    private Long status;
+
+
+}

ruoyi-modules/guoyan-platform/src/main/java/org/dromara/platform/domain/vo/ServiceCatalogCategoryVo.java

@@ -0,0 +1,80 @@
+package org.dromara.platform.domain.vo;
+
+import org.dromara.platform.domain.ServiceCatalogCategory;
+import com.alibaba.excel.annotation.ExcelIgnoreUnannotated;
+import com.alibaba.excel.annotation.ExcelProperty;
+import org.dromara.common.excel.annotation.ExcelDictFormat;
+import org.dromara.common.excel.convert.ExcelDictConvert;
+import io.github.linpeilie.annotations.AutoMapper;
+import lombok.Data;
+
+import java.io.Serial;
+import java.io.Serializable;
+import java.util.Date;
+
+
+
+/**
+ * 服务目录-类别视图对象 service_catalog_category
+ *
+ * @author gejunhao
+ * @date 2025-03-07
+ */
+@Data
+@ExcelIgnoreUnannotated
+@AutoMapper(target = ServiceCatalogCategory.class)
+public class ServiceCatalogCategoryVo implements Serializable {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /**
+     * 目录ID，唯一标识每个目录条目
+     */
+    @ExcelProperty(value = "目录ID，唯一标识每个目录条目")
+    private String id;
+
+    /**
+     * 目录名称，表示目录的名字
+     */
+    @ExcelProperty(value = "目录名称，表示目录的名字")
+    private String name;
+
+    /**
+     * 描述
+     */
+    @ExcelProperty(value = "描述")
+    private String description;
+
+    /**
+     * 编号，用于额外标识或排序目的
+     */
+    @ExcelProperty(value = "编号，用于额外标识或排序目的")
+    private String code;
+
+    /**
+     * 是否为子目录，true表示是子目录，false则不是
+     */
+    @ExcelProperty(value = "是否为子目录，true表示是子目录，false则不是")
+    private Long isChildren;
+
+    /**
+     * 上级目录id，指向父目录的id，如果没有父目录则为空
+     */
+    @ExcelProperty(value = "上级目录id，指向父目录的id，如果没有父目录则为空")
+    private String ownerId;
+
+    /**
+     * 上级目录名称，冗余存储父目录的名称以便查询优化
+     */
+    @ExcelProperty(value = "上级目录名称，冗余存储父目录的名称以便查询优化")
+    private String ownerName;
+
+    /**
+     * 当前状态
+     */
+    @ExcelProperty(value = "当前状态")
+    private Long status;
+
+
+}

ruoyi-modules/guoyan-platform/src/main/java/org/dromara/platform/mapper/ServiceCatalogCategoryMapper.java

@@ -0,0 +1,15 @@
+package org.dromara.platform.mapper;
+
+import org.dromara.platform.domain.ServiceCatalogCategory;
+import org.dromara.platform.domain.vo.ServiceCatalogCategoryVo;
+import org.dromara.common.mybatis.core.mapper.BaseMapperPlus;
+
+/**
+ * 服务目录-类别Mapper接口
+ *
+ * @author gejunhao
+ * @date 2025-03-07
+ */
+public interface ServiceCatalogCategoryMapper extends BaseMapperPlus<ServiceCatalogCategory, ServiceCatalogCategoryVo> {
+
+}

ruoyi-modules/guoyan-platform/src/main/java/org/dromara/platform/service/IServiceCatalogCategoryService.java

@@ -0,0 +1,78 @@
+package org.dromara.platform.service;
+
+import org.dromara.platform.domain.ServiceCatalogCategory;
+import org.dromara.platform.domain.vo.ServiceCatalogCategoryVo;
+import org.dromara.platform.domain.bo.ServiceCatalogCategoryBo;
+import org.dromara.common.mybatis.core.page.TableDataInfo;
+import org.dromara.common.mybatis.core.page.PageQuery;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * 服务目录-类别Service接口
+ *
+ * @author gejunhao
+ * @date 2025-03-07
+ */
+public interface IServiceCatalogCategoryService {
+
+    /**
+     * 查询服务目录-类别
+     *
+     * @param id 主键
+     * @return 服务目录-类别
+     */
+    ServiceCatalogCategoryVo queryById(String id);
+
+    /**
+     * 分页查询服务目录-类别列表
+     *
+     * @param bo        查询条件
+     * @param pageQuery 分页参数
+     * @return 服务目录-类别分页列表
+     */
+    TableDataInfo<ServiceCatalogCategoryVo> queryPageList(ServiceCatalogCategoryBo bo, PageQuery pageQuery);
+
+    /**
+     * 查询符合条件的服务目录-类别列表
+     *
+     * @param bo 查询条件
+     * @return 服务目录-类别列表
+     */
+    List<ServiceCatalogCategoryVo> queryList(ServiceCatalogCategoryBo bo);
+
+    /**
+     * 新增服务目录-类别
+     *
+     * @param bo 服务目录-类别
+     * @return 是否新增成功
+     */
+    Boolean insertByBo(ServiceCatalogCategoryBo bo);
+
+    /**
+     * 修改服务目录-类别
+     *
+     * @param bo 服务目录-类别
+     * @return 是否修改成功
+     */
+    Boolean updateByBo(ServiceCatalogCategoryBo bo);
+
+    /**
+     * 校验并批量删除服务目录-类别信息
+     *
+     * @param ids     待删除的主键集合
+     * @param isValid 是否进行有效性校验
+     * @return 是否删除成功
+     */
+    Boolean deleteWithValidByIds(Collection<String> ids, Boolean isValid);
+
+
+    /**
+     * 查询所有服务目录 父+子
+     * @return
+     */
+    List<ServiceCatalogCategory> queryAll();
+
+    List<ServiceCatalogCategoryVo> querySubInfoById(String id);
+}

ruoyi-modules/guoyan-platform/src/main/java/org/dromara/platform/service/impl/ServiceCatalogCategoryServiceImpl.java

@@ -0,0 +1,187 @@
+package org.dromara.platform.service.impl;
+
+import org.dromara.common.core.utils.MapstructUtils;
+import org.dromara.common.core.utils.StringUtils;
+import org.dromara.common.mybatis.core.page.TableDataInfo;
+import org.dromara.common.mybatis.core.page.PageQuery;
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import com.baomidou.mybatisplus.core.toolkit.Wrappers;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.dromara.platform.domain.bo.ServiceCatalogCategoryBo;
+import org.dromara.platform.domain.vo.ServiceCatalogCategoryVo;
+import org.dromara.platform.domain.ServiceCatalogCategory;
+import org.dromara.platform.mapper.ServiceCatalogCategoryMapper;
+import org.dromara.platform.service.IServiceCatalogCategoryService;
+
+import java.util.*;
+
+/**
+ * 服务目录-类别Service业务层处理
+ *
+ * @author gejunhao
+ * @date 2025-03-07
+ */
+@RequiredArgsConstructor
+@Service
+public class ServiceCatalogCategoryServiceImpl implements IServiceCatalogCategoryService {
+
+    private final ServiceCatalogCategoryMapper baseMapper;
+
+    /**
+     * 查询服务目录-类别
+     *
+     * @param id 主键
+     * @return 服务目录-类别
+     */
+    @Override
+    public ServiceCatalogCategoryVo queryById(String id){
+        return baseMapper.selectVoById(id);
+    }
+
+    /**
+     * 分页查询服务目录-类别列表
+     *
+     * @param bo        查询条件
+     * @param pageQuery 分页参数
+     * @return 服务目录-类别分页列表
+     */
+    @Override
+    public TableDataInfo<ServiceCatalogCategoryVo> queryPageList(ServiceCatalogCategoryBo bo, PageQuery pageQuery) {
+        LambdaQueryWrapper<ServiceCatalogCategory> lqw = buildQueryWrapper(bo);
+        Page<ServiceCatalogCategoryVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
+        return TableDataInfo.build(result);
+    }
+
+    /**
+     * 查询符合条件的服务目录-类别列表
+     *
+     * @param bo 查询条件
+     * @return 服务目录-类别列表
+     */
+    @Override
+    public List<ServiceCatalogCategoryVo> queryList(ServiceCatalogCategoryBo bo) {
+        LambdaQueryWrapper<ServiceCatalogCategory> lqw = buildQueryWrapper(bo);
+        return baseMapper.selectVoList(lqw);
+    }
+
+    private LambdaQueryWrapper<ServiceCatalogCategory> buildQueryWrapper(ServiceCatalogCategoryBo bo) {
+        Map<String, Object> params = bo.getParams();
+        LambdaQueryWrapper<ServiceCatalogCategory> lqw = Wrappers.lambdaQuery();
+        lqw.like(StringUtils.isNotBlank(bo.getName()), ServiceCatalogCategory::getName, bo.getName());
+        lqw.eq(StringUtils.isNotBlank(bo.getDescription()), ServiceCatalogCategory::getDescription, bo.getDescription());
+        lqw.eq(StringUtils.isNotBlank(bo.getCode()), ServiceCatalogCategory::getCode, bo.getCode());
+        lqw.eq(bo.getIsChildren() != null, ServiceCatalogCategory::getIsChildren, bo.getIsChildren());
+        lqw.eq(StringUtils.isNotBlank(bo.getOwnerId()), ServiceCatalogCategory::getOwnerId, bo.getOwnerId());
+        lqw.like(StringUtils.isNotBlank(bo.getOwnerName()), ServiceCatalogCategory::getOwnerName, bo.getOwnerName());
+        lqw.eq(bo.getStatus() != null, ServiceCatalogCategory::getStatus, bo.getStatus());
+        return lqw;
+    }
+
+    /**
+     * 新增服务目录-类别
+     *
+     * @param bo 服务目录-类别
+     * @return 是否新增成功
+     */
+    @Override
+    public Boolean insertByBo(ServiceCatalogCategoryBo bo) {
+        ServiceCatalogCategory add = MapstructUtils.convert(bo, ServiceCatalogCategory.class);
+        validEntityBeforeSave(add);
+        boolean flag = baseMapper.insert(add) > 0;
+        if (flag) {
+            bo.setId(add.getId());
+        }
+        return flag;
+    }
+
+    /**
+     * 修改服务目录-类别
+     *
+     * @param bo 服务目录-类别
+     * @return 是否修改成功
+     */
+    @Override
+    public Boolean updateByBo(ServiceCatalogCategoryBo bo) {
+        ServiceCatalogCategory update = MapstructUtils.convert(bo, ServiceCatalogCategory.class);
+        validEntityBeforeSave(update);
+        return baseMapper.updateById(update) > 0;
+    }
+
+    /**
+     * 保存前的数据校验
+     */
+    private void validEntityBeforeSave(ServiceCatalogCategory entity){
+        //TODO 做一些数据校验,如唯一约束
+    }
+
+    /**
+     * 校验并批量删除服务目录-类别信息
+     *
+     * @param ids     待删除的主键集合
+     * @param isValid 是否进行有效性校验
+     * @return 是否删除成功
+     */
+    @Override
+    public Boolean deleteWithValidByIds(Collection<String> ids, Boolean isValid) {
+        if(isValid){
+            //TODO 做一些业务上的校验,判断是否需要校验
+        }
+        return baseMapper.deleteByIds(ids) > 0;
+    }
+
+    @Override
+    public List<ServiceCatalogCategory> queryAll() {
+        LambdaQueryWrapper<ServiceCatalogCategory> qw = new LambdaQueryWrapper<>();
+        qw.eq(ServiceCatalogCategory::getIsChildren, false);
+
+        // 查询所有父级目录
+        List<ServiceCatalogCategory> serviceCatalogCategories = baseMapper.selectList(qw);
+        if (serviceCatalogCategories == null) {
+            serviceCatalogCategories = new ArrayList<>();
+        }
+
+        LambdaQueryWrapper<ServiceCatalogCategory> subQw = new LambdaQueryWrapper<>();
+        subQw.eq(ServiceCatalogCategory::getIsChildren, true);
+        List<ServiceCatalogCategory> subList = baseMapper.selectList(subQw);
+        if (subList == null) {
+            subList = new ArrayList<>();
+        }
+
+        // 创建一个 Map 来快速查找子目录
+        Map<String, List<ServiceCatalogCategory>> subCategoryMap = new HashMap<>();
+        for (ServiceCatalogCategory subCategory : subList) {
+            String ownerId = subCategory.getOwnerId();
+            if (ownerId != null) { // 判空检查
+                subCategoryMap.computeIfAbsent(ownerId, k -> new ArrayList<>()).add(subCategory);
+            }
+        }
+
+        // 遍历父级目录，并填充子目录
+        for (ServiceCatalogCategory category : serviceCatalogCategories) {
+            String parentId = category.getId();
+            if (subCategoryMap.containsKey(parentId)) { // 判空检查
+                category.setChildren(subCategoryMap.get(parentId));
+            } else {
+                // 如果没有子目录，则设置一个空列表
+                category.setChildren(new ArrayList<>());
+            }
+        }
+
+        return serviceCatalogCategories;
+    }
+
+    @Override
+    public List<ServiceCatalogCategoryVo> querySubInfoById(String id) {
+        LambdaQueryWrapper<ServiceCatalogCategory> qw = new LambdaQueryWrapper<>();
+        qw.eq(ServiceCatalogCategory::getOwnerId, id);
+        List<ServiceCatalogCategory> serviceCatalogCategories = baseMapper.selectList(qw);
+        if (serviceCatalogCategories != null) {
+            return MapstructUtils.convert(serviceCatalogCategories, ServiceCatalogCategoryVo.class);
+        }
+        return new ArrayList<>();
+    }
+
+
+}