feat: add enum dto APIs and batch save

This commit is contained in:
2026-05-20 23:25:30 +08:00
parent 16f9a325d7
commit 7188dd49b5
20 changed files with 571 additions and 24 deletions

View File

@@ -1,8 +1,8 @@
package com.bruce.common.controller;
import com.bruce.common.domain.entity.SysAttachment;
import com.bruce.common.domain.model.RequestResult;
import com.bruce.common.dto.request.SysAttachmentUploadRequest;
import com.bruce.common.dto.response.SysAttachmentResponse;
import com.bruce.common.service.ISysAttachmentService;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;
@@ -22,7 +22,7 @@ public class SysAttachmentController {
@Operation(summary = "上传附件")
@PostMapping("/upload")
public RequestResult<SysAttachment> upload(@ModelAttribute SysAttachmentUploadRequest request) {
return RequestResult.success(sysAttachmentService.upload(request));
public RequestResult<SysAttachmentResponse> upload(@ModelAttribute SysAttachmentUploadRequest request) {
return RequestResult.success(SysAttachmentResponse.fromEntity(sysAttachmentService.upload(request)));
}
}

View File

@@ -1,9 +1,11 @@
package com.bruce.common.controller;
import com.bruce.common.domain.entity.SysEnum;
import com.bruce.common.domain.model.RequestResult;
import com.bruce.common.dto.request.SysEnumBatchSaveRequest;
import com.bruce.common.dto.request.SysEnumManageQueryRequest;
import com.bruce.common.dto.request.SysEnumQueryRequest;
import com.bruce.common.dto.request.SysEnumSaveRequest;
import com.bruce.common.dto.response.SysEnumResponse;
import com.bruce.common.service.ISysEnumService;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;
@@ -28,14 +30,26 @@ public class SysEnumController {
@Operation(summary = "查询全部系统枚举")
@GetMapping
public RequestResult<List<SysEnum>> list() {
return RequestResult.success(sysEnumService.list());
public RequestResult<List<SysEnumResponse>> list() {
return RequestResult.success(sysEnumService.listResponses());
}
@Operation(summary = "根据模块和类型查询系统枚举")
@PostMapping("/query")
public RequestResult<List<SysEnum>> queryByCatalogAndType(@RequestBody SysEnumQueryRequest request) {
return RequestResult.success(sysEnumService.listByCatalogAndType(request));
public RequestResult<List<SysEnumResponse>> queryByCatalogAndType(@RequestBody SysEnumQueryRequest request) {
return RequestResult.success(sysEnumService.listByCatalogAndTypeResponses(request));
}
@Operation(summary = "管理端查询系统枚举")
@PostMapping("/manage/query")
public RequestResult<List<SysEnumResponse>> queryForManagement(@RequestBody(required = false) SysEnumManageQueryRequest request) {
return RequestResult.success(sysEnumService.listForManagement(request));
}
@Operation(summary = "查询系统枚举详情")
@GetMapping("/{id}")
public RequestResult<SysEnumResponse> getById(@PathVariable Long id) {
return RequestResult.success(sysEnumService.getResponseById(id));
}
@Operation(summary = "新增或修改系统枚举")
@@ -44,6 +58,12 @@ public class SysEnumController {
return RequestResult.success(sysEnumService.saveOrUpdate(request));
}
@Operation(summary = "批量新增系统枚举")
@PostMapping("/batch")
public RequestResult<Boolean> batchSave(@RequestBody SysEnumBatchSaveRequest request) {
return RequestResult.success(sysEnumService.batchSave(request));
}
@Operation(summary = "删除系统枚举")
@DeleteMapping("/{id}")
public RequestResult<Boolean> deleteById(@PathVariable Long id) {

View File

@@ -0,0 +1,40 @@
package com.bruce.common.dto.request;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
import java.util.List;
@Data
@Schema(description = "系统枚举批量保存请求")
public class SysEnumBatchSaveRequest {
@Schema(description = "模块目录")
private String catalog;
@Schema(description = "枚举类型")
private String type;
@Schema(description = "枚举项")
private List<Item> items;
@Data
@Schema(description = "系统枚举批量保存项")
public static class Item {
@Schema(description = "枚举名称")
private String name;
@Schema(description = "整型值")
private Integer value;
@Schema(description = "字符串值")
private String strvalue;
@Schema(description = "排序")
private Integer sort;
@Schema(description = "备注")
private String remark;
}
}

View File

@@ -0,0 +1,18 @@
package com.bruce.common.dto.request;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
@Data
@Schema(description = "系统枚举管理查询请求")
public class SysEnumManageQueryRequest {
@Schema(description = "模块目录")
private String catalog;
@Schema(description = "枚举类型")
private String type;
@Schema(description = "关键字,匹配目录、类型、名称、字符串值或备注")
private String keyword;
}

View File

@@ -0,0 +1,53 @@
package com.bruce.common.dto.response;
import com.bruce.common.domain.entity.SysAttachment;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
import org.springframework.beans.BeanUtils;
@Data
@Schema(description = "系统附件响应")
public class SysAttachmentResponse {
@Schema(description = "主键ID")
private Long id;
@Schema(description = "来源业务类型")
private String sourceType;
@Schema(description = "来源业务ID")
private Long sourceId;
@Schema(description = "原始文件名")
private String originalName;
@Schema(description = "存储文件名")
private String fileName;
@Schema(description = "文件后缀")
private String fileSuffix;
@Schema(description = "文件MIME类型")
private String contentType;
@Schema(description = "文件大小(字节)")
private Long fileSize;
@Schema(description = "存储类型")
private String storageType;
@Schema(description = "文件访问地址")
private String fileUrl;
@Schema(description = "备注")
private String remark;
public static SysAttachmentResponse fromEntity(SysAttachment entity) {
if (entity == null) {
return null;
}
SysAttachmentResponse response = new SysAttachmentResponse();
BeanUtils.copyProperties(entity, response);
return response;
}
}

View File

@@ -0,0 +1,44 @@
package com.bruce.common.dto.response;
import com.bruce.common.domain.entity.SysEnum;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
import org.springframework.beans.BeanUtils;
@Data
@Schema(description = "系统枚举响应")
public class SysEnumResponse {
@Schema(description = "主键ID")
private Long id;
@Schema(description = "模块目录")
private String catalog;
@Schema(description = "枚举类型")
private String type;
@Schema(description = "枚举名称")
private String name;
@Schema(description = "整型值")
private Integer value;
@Schema(description = "字符串值")
private String strvalue;
@Schema(description = "排序")
private Integer sort;
@Schema(description = "备注")
private String remark;
public static SysEnumResponse fromEntity(SysEnum entity) {
if (entity == null) {
return null;
}
SysEnumResponse response = new SysEnumResponse();
BeanUtils.copyProperties(entity, response);
return response;
}
}

View File

@@ -2,8 +2,11 @@ package com.bruce.common.service;
import com.baomidou.mybatisplus.extension.service.IService;
import com.bruce.common.domain.entity.SysEnum;
import com.bruce.common.dto.request.SysEnumBatchSaveRequest;
import com.bruce.common.dto.request.SysEnumManageQueryRequest;
import com.bruce.common.dto.request.SysEnumQueryRequest;
import com.bruce.common.dto.request.SysEnumSaveRequest;
import com.bruce.common.dto.response.SysEnumResponse;
import java.util.List;
@@ -11,5 +14,15 @@ public interface ISysEnumService extends IService<SysEnum> {
List<SysEnum> listByCatalogAndType(SysEnumQueryRequest request);
List<SysEnumResponse> listResponses();
List<SysEnumResponse> listByCatalogAndTypeResponses(SysEnumQueryRequest request);
List<SysEnumResponse> listForManagement(SysEnumManageQueryRequest request);
SysEnumResponse getResponseById(Long id);
boolean saveOrUpdate(SysEnumSaveRequest request);
boolean batchSave(SysEnumBatchSaveRequest request);
}

View File

@@ -2,14 +2,19 @@ package com.bruce.common.service.impl;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.bruce.common.domain.entity.SysEnum;
import com.bruce.common.dto.request.SysEnumBatchSaveRequest;
import com.bruce.common.dto.request.SysEnumManageQueryRequest;
import com.bruce.common.dto.request.SysEnumQueryRequest;
import com.bruce.common.dto.request.SysEnumSaveRequest;
import com.bruce.common.dto.response.SysEnumResponse;
import com.bruce.common.mapper.SysEnumMapper;
import com.bruce.common.service.ISysEnumService;
import org.springframework.stereotype.Service;
import org.springframework.util.StringUtils;
import java.util.HashSet;
import java.util.List;
import java.util.Set;
@Service
public class SysEnumServiceImpl extends ServiceImpl<SysEnumMapper, SysEnum> implements ISysEnumService {
@@ -26,6 +31,45 @@ public class SysEnumServiceImpl extends ServiceImpl<SysEnumMapper, SysEnum> impl
.list();
}
@Override
public List<SysEnumResponse> listResponses() {
return toResponses(list());
}
@Override
public List<SysEnumResponse> listByCatalogAndTypeResponses(SysEnumQueryRequest request) {
return toResponses(listByCatalogAndType(request));
}
@Override
public List<SysEnumResponse> listForManagement(SysEnumManageQueryRequest request) {
SysEnumManageQueryRequest queryRequest = request == null ? new SysEnumManageQueryRequest() : request;
String keyword = queryRequest.getKeyword();
return toResponses(lambdaQuery()
.eq(StringUtils.hasText(queryRequest.getCatalog()), SysEnum::getCatalog, queryRequest.getCatalog())
.eq(StringUtils.hasText(queryRequest.getType()), SysEnum::getType, queryRequest.getType())
.and(StringUtils.hasText(keyword), wrapper -> wrapper
.like(SysEnum::getCatalog, keyword)
.or()
.like(SysEnum::getType, keyword)
.or()
.like(SysEnum::getName, keyword)
.or()
.like(SysEnum::getStrvalue, keyword)
.or()
.like(SysEnum::getRemark, keyword))
.orderByAsc(SysEnum::getCatalog)
.orderByAsc(SysEnum::getType)
.orderByAsc(SysEnum::getSort)
.orderByAsc(SysEnum::getId)
.list());
}
@Override
public SysEnumResponse getResponseById(Long id) {
return SysEnumResponse.fromEntity(getById(id));
}
@Override
public boolean saveOrUpdate(SysEnumSaveRequest request) {
if (request == null) {
@@ -43,4 +87,77 @@ public class SysEnumServiceImpl extends ServiceImpl<SysEnumMapper, SysEnum> impl
sysEnum.setRemark(request.getRemark());
return super.saveOrUpdate(sysEnum);
}
@Override
public boolean batchSave(SysEnumBatchSaveRequest request) {
List<SysEnum> existingEnums = lambdaQuery()
.eq(request != null && StringUtils.hasText(request.getCatalog()), SysEnum::getCatalog, request == null ? null : request.getCatalog())
.eq(request != null && StringUtils.hasText(request.getType()), SysEnum::getType, request == null ? null : request.getType())
.list();
validateBatchSaveRequest(request, existingEnums);
List<SysEnum> enums = request.getItems().stream()
.map(item -> {
SysEnum sysEnum = new SysEnum();
sysEnum.setCatalog(request.getCatalog());
sysEnum.setType(request.getType());
sysEnum.setName(item.getName());
sysEnum.setValue(item.getValue());
sysEnum.setStrvalue(item.getStrvalue());
sysEnum.setSort(item.getSort());
sysEnum.setRemark(item.getRemark());
return sysEnum;
})
.toList();
return saveBatch(enums);
}
public void validateBatchSaveRequest(SysEnumBatchSaveRequest request, List<SysEnum> existingEnums) {
if (request == null) {
throw new IllegalArgumentException("批量保存请求不能为空");
}
if (!StringUtils.hasText(request.getCatalog())) {
throw new IllegalArgumentException("模块目录不能为空");
}
if (!StringUtils.hasText(request.getType())) {
throw new IllegalArgumentException("枚举类型不能为空");
}
if (request.getItems() == null || request.getItems().isEmpty()) {
throw new IllegalArgumentException("枚举项不能为空");
}
Set<Integer> requestValues = new HashSet<>();
for (SysEnumBatchSaveRequest.Item item : request.getItems()) {
if (item == null) {
throw new IllegalArgumentException("枚举项不能为空");
}
if (!StringUtils.hasText(item.getName())) {
throw new IllegalArgumentException("枚举名称不能为空");
}
if (item.getValue() == null) {
throw new IllegalArgumentException("枚举整型值不能为空");
}
if (!requestValues.add(item.getValue())) {
throw new IllegalArgumentException("批量保存请求中存在重复枚举值: " + item.getValue());
}
}
Set<Integer> existingValues = new HashSet<>();
if (existingEnums != null) {
existingEnums.stream()
.map(SysEnum::getValue)
.forEach(existingValues::add);
}
for (Integer value : requestValues) {
if (existingValues.contains(value)) {
throw new IllegalArgumentException("枚举值已存在: " + value);
}
}
}
private List<SysEnumResponse> toResponses(List<SysEnum> enums) {
return enums.stream()
.map(SysEnumResponse::fromEntity)
.toList();
}
}