Browse Source

服务目录基础接口

ops-management-platform-backend-dev
gjh 1 week ago
parent
commit
aad7aa92c3
  1. 129
      ruoyi-modules/guoyan-platform/src/main/java/org/dromara/platform/controller/ServiceCatalogCategoryController.java
  2. 75
      ruoyi-modules/guoyan-platform/src/main/java/org/dromara/platform/domain/ServiceCatalogCategory.java
  3. 72
      ruoyi-modules/guoyan-platform/src/main/java/org/dromara/platform/domain/bo/ServiceCatalogCategoryBo.java
  4. 80
      ruoyi-modules/guoyan-platform/src/main/java/org/dromara/platform/domain/vo/ServiceCatalogCategoryVo.java
  5. 15
      ruoyi-modules/guoyan-platform/src/main/java/org/dromara/platform/mapper/ServiceCatalogCategoryMapper.java
  6. 78
      ruoyi-modules/guoyan-platform/src/main/java/org/dromara/platform/service/IServiceCatalogCategoryService.java
  7. 187
      ruoyi-modules/guoyan-platform/src/main/java/org/dromara/platform/service/impl/ServiceCatalogCategoryServiceImpl.java

129
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));
}
}

75
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;
}

72
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;
}

80
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;
}

15
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> {
}

78
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);
}

187
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<>();
}
}
Loading…
Cancel
Save