feat(wms): 添加二维码生成记录功能

- 新增二维码生成记录相关的实体类、Mapper、Service、Controller等
- 实现二维码生成记录的增删查改功能- 添加二维码生成记录的导出功能
- 新增相关接口和页面访问权限
This commit is contained in:
2025-09-10 14:33:28 +08:00
parent 52cc671ca3
commit 3e2519fb7c
9 changed files with 482 additions and 0 deletions

View File

@@ -157,6 +157,7 @@ security:
- /websocket/direct/**
# 测试接口
- /test/**
- /klp/generateRecord
# MyBatisPlus配置

View File

@@ -0,0 +1,99 @@
package com.klp.controller;
import java.util.List;
import java.util.Arrays;
import lombok.RequiredArgsConstructor;
import javax.servlet.http.HttpServletResponse;
import javax.validation.constraints.*;
import org.springframework.web.bind.annotation.*;
import org.springframework.validation.annotation.Validated;
import com.klp.common.annotation.RepeatSubmit;
import com.klp.common.annotation.Log;
import com.klp.common.core.controller.BaseController;
import com.klp.common.core.domain.PageQuery;
import com.klp.common.core.domain.R;
import com.klp.common.core.validate.AddGroup;
import com.klp.common.core.validate.EditGroup;
import com.klp.common.enums.BusinessType;
import com.klp.common.utils.poi.ExcelUtil;
import com.klp.domain.vo.WmsGenerateRecordVo;
import com.klp.domain.bo.WmsGenerateRecordBo;
import com.klp.service.IWmsGenerateRecordService;
import com.klp.common.core.page.TableDataInfo;
/**
* 二维码生成记录
*
* @author klp
* @date 2025-09-10
*/
@Validated
@RequiredArgsConstructor
@RestController
@RequestMapping("/klp/generateRecord")
public class WmsGenerateRecordController extends BaseController {
private final IWmsGenerateRecordService iWmsGenerateRecordService;
/**
* 查询二维码生成记录列表
*/
@GetMapping("/list")
public TableDataInfo<WmsGenerateRecordVo> list(WmsGenerateRecordBo bo, PageQuery pageQuery) {
return iWmsGenerateRecordService.queryPageList(bo, pageQuery);
}
/**
* 导出二维码生成记录列表
*/
@Log(title = "二维码生成记录", businessType = BusinessType.EXPORT)
@PostMapping("/export")
public void export(WmsGenerateRecordBo bo, HttpServletResponse response) {
List<WmsGenerateRecordVo> list = iWmsGenerateRecordService.queryList(bo);
ExcelUtil.exportExcel(list, "二维码生成记录", WmsGenerateRecordVo.class, response);
}
/**
* 获取二维码生成记录详细信息
*
* @param recordId 主键
*/
@GetMapping("/{recordId}")
public R<WmsGenerateRecordVo> getInfo(@NotNull(message = "主键不能为空")
@PathVariable Long recordId) {
return R.ok(iWmsGenerateRecordService.queryById(recordId));
}
/**
* 新增二维码生成记录
*/
@Log(title = "二维码生成记录", businessType = BusinessType.INSERT)
@RepeatSubmit()
@PostMapping()
public R<Void> add(@Validated(AddGroup.class) @RequestBody WmsGenerateRecordBo bo) {
return toAjax(iWmsGenerateRecordService.insertByBo(bo));
}
/**
* 修改二维码生成记录
*/
@Log(title = "二维码生成记录", businessType = BusinessType.UPDATE)
@RepeatSubmit()
@PutMapping()
public R<Void> edit(@Validated(EditGroup.class) @RequestBody WmsGenerateRecordBo bo) {
return toAjax(iWmsGenerateRecordService.updateByBo(bo));
}
/**
* 删除二维码生成记录
*
* @param recordIds 主键串
*/
@Log(title = "二维码生成记录", businessType = BusinessType.DELETE)
@DeleteMapping("/{recordIds}")
public R<Void> remove(@NotEmpty(message = "主键不能为空")
@PathVariable Long[] recordIds) {
return toAjax(iWmsGenerateRecordService.deleteWithValidByIds(Arrays.asList(recordIds), true));
}
}

View File

@@ -0,0 +1,57 @@
package com.klp.domain;
import com.baomidou.mybatisplus.annotation.*;
import com.klp.common.core.domain.BaseEntity;
import lombok.Data;
import lombok.EqualsAndHashCode;
/**
* 二维码生成记录对象 wms_generate_record
*
* @author klp
* @date 2025-09-10
*/
@Data
@EqualsAndHashCode(callSuper = true)
@TableName("wms_generate_record")
public class WmsGenerateRecord extends BaseEntity {
private static final long serialVersionUID=1L;
/**
* 主键
*/
@TableId(value = "record_id")
private Long recordId;
/**
* 二维码类型字典默认为0
*/
private Long qrcodeType;
/**
* 二维码内容JSON格式
*/
private String content;
/**
* 是否启用0启用1禁用
*/
private Long isEnabled;
/**
* 编号
*/
private String serialNumber;
/**
* 二维码尺寸(像素)
*/
private Long size;
/**
* 删除标志0=正常1=已删除)
*/
@TableLogic
private Integer delFlag;
/**
* 备注
*/
private String remark;
}

View File

@@ -0,0 +1,56 @@
package com.klp.domain.bo;
import com.klp.common.core.domain.BaseEntity;
import lombok.Data;
import lombok.EqualsAndHashCode;
import javax.validation.constraints.*;
/**
* 二维码生成记录业务对象 wms_generate_record
*
* @author klp
* @date 2025-09-10
*/
@Data
@EqualsAndHashCode(callSuper = true)
public class WmsGenerateRecordBo extends BaseEntity {
/**
* 主键
*/
private Long recordId;
/**
* 二维码类型字典默认为0
*/
private Long qrcodeType;
/**
* 二维码内容JSON格式
*/
private String content;
/**
* 是否启用0启用1禁用
*/
private Long isEnabled;
/**
* 编号
*/
private String serialNumber;
/**
* 二维码尺寸(像素)
*/
private Long size;
/**
* 备注
*/
private String remark;
}

View File

@@ -0,0 +1,69 @@
package com.klp.domain.vo;
import com.alibaba.excel.annotation.ExcelIgnoreUnannotated;
import com.alibaba.excel.annotation.ExcelProperty;
import com.klp.common.annotation.ExcelDictFormat;
import com.klp.common.convert.ExcelDictConvert;
import lombok.Data;
/**
* 二维码生成记录视图对象 wms_generate_record
*
* @author klp
* @date 2025-09-10
*/
@Data
@ExcelIgnoreUnannotated
public class WmsGenerateRecordVo {
private static final long serialVersionUID = 1L;
/**
* 主键
*/
@ExcelProperty(value = "主键")
private Long recordId;
/**
* 二维码类型字典默认为0
*/
@ExcelProperty(value = "二维码类型", converter = ExcelDictConvert.class)
@ExcelDictFormat(readConverterExp = "字=典默认为0")
private Long qrcodeType;
/**
* 二维码内容JSON格式
*/
@ExcelProperty(value = "二维码内容", converter = ExcelDictConvert.class)
@ExcelDictFormat(readConverterExp = "J=SON格式")
private String content;
/**
* 是否启用0启用1禁用
*/
@ExcelProperty(value = "是否启用", converter = ExcelDictConvert.class)
@ExcelDictFormat(readConverterExp = "0=启用1禁用")
private Long isEnabled;
/**
* 编号
*/
@ExcelProperty(value = "编号")
private String serialNumber;
/**
* 二维码尺寸(像素)
*/
@ExcelProperty(value = "二维码尺寸", converter = ExcelDictConvert.class)
@ExcelDictFormat(readConverterExp = "像=素")
private Long size;
/**
* 备注
*/
@ExcelProperty(value = "备注")
private String remark;
}

View File

@@ -0,0 +1,15 @@
package com.klp.mapper;
import com.klp.domain.WmsGenerateRecord;
import com.klp.domain.vo.WmsGenerateRecordVo;
import com.klp.common.core.mapper.BaseMapperPlus;
/**
* 二维码生成记录Mapper接口
*
* @author klp
* @date 2025-09-10
*/
public interface WmsGenerateRecordMapper extends BaseMapperPlus<WmsGenerateRecordMapper, WmsGenerateRecord, WmsGenerateRecordVo> {
}

View File

@@ -0,0 +1,49 @@
package com.klp.service;
import com.klp.domain.WmsGenerateRecord;
import com.klp.domain.vo.WmsGenerateRecordVo;
import com.klp.domain.bo.WmsGenerateRecordBo;
import com.klp.common.core.page.TableDataInfo;
import com.klp.common.core.domain.PageQuery;
import java.util.Collection;
import java.util.List;
/**
* 二维码生成记录Service接口
*
* @author klp
* @date 2025-09-10
*/
public interface IWmsGenerateRecordService {
/**
* 查询二维码生成记录
*/
WmsGenerateRecordVo queryById(Long recordId);
/**
* 查询二维码生成记录列表
*/
TableDataInfo<WmsGenerateRecordVo> queryPageList(WmsGenerateRecordBo bo, PageQuery pageQuery);
/**
* 查询二维码生成记录列表
*/
List<WmsGenerateRecordVo> queryList(WmsGenerateRecordBo bo);
/**
* 新增二维码生成记录
*/
Boolean insertByBo(WmsGenerateRecordBo bo);
/**
* 修改二维码生成记录
*/
Boolean updateByBo(WmsGenerateRecordBo bo);
/**
* 校验并批量删除二维码生成记录信息
*/
Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
}

View File

@@ -0,0 +1,113 @@
package com.klp.service.impl;
import cn.hutool.core.bean.BeanUtil;
import com.klp.common.core.page.TableDataInfo;
import com.klp.common.core.domain.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 com.klp.common.utils.StringUtils;
import lombok.RequiredArgsConstructor;
import org.springframework.stereotype.Service;
import com.klp.domain.bo.WmsGenerateRecordBo;
import com.klp.domain.vo.WmsGenerateRecordVo;
import com.klp.domain.WmsGenerateRecord;
import com.klp.mapper.WmsGenerateRecordMapper;
import com.klp.service.IWmsGenerateRecordService;
import java.util.List;
import java.util.Map;
import java.util.Collection;
/**
* 二维码生成记录Service业务层处理
*
* @author klp
* @date 2025-09-10
*/
@RequiredArgsConstructor
@Service
public class WmsGenerateRecordServiceImpl implements IWmsGenerateRecordService {
private final WmsGenerateRecordMapper baseMapper;
/**
* 查询二维码生成记录
*/
@Override
public WmsGenerateRecordVo queryById(Long recordId){
return baseMapper.selectVoById(recordId);
}
/**
* 查询二维码生成记录列表
*/
@Override
public TableDataInfo<WmsGenerateRecordVo> queryPageList(WmsGenerateRecordBo bo, PageQuery pageQuery) {
LambdaQueryWrapper<WmsGenerateRecord> lqw = buildQueryWrapper(bo);
Page<WmsGenerateRecordVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
return TableDataInfo.build(result);
}
/**
* 查询二维码生成记录列表
*/
@Override
public List<WmsGenerateRecordVo> queryList(WmsGenerateRecordBo bo) {
LambdaQueryWrapper<WmsGenerateRecord> lqw = buildQueryWrapper(bo);
return baseMapper.selectVoList(lqw);
}
private LambdaQueryWrapper<WmsGenerateRecord> buildQueryWrapper(WmsGenerateRecordBo bo) {
Map<String, Object> params = bo.getParams();
LambdaQueryWrapper<WmsGenerateRecord> lqw = Wrappers.lambdaQuery();
lqw.eq(bo.getQrcodeType() != null, WmsGenerateRecord::getQrcodeType, bo.getQrcodeType());
lqw.eq(StringUtils.isNotBlank(bo.getContent()), WmsGenerateRecord::getContent, bo.getContent());
lqw.eq(bo.getIsEnabled() != null, WmsGenerateRecord::getIsEnabled, bo.getIsEnabled());
lqw.eq(StringUtils.isNotBlank(bo.getSerialNumber()), WmsGenerateRecord::getSerialNumber, bo.getSerialNumber());
lqw.eq(bo.getSize() != null, WmsGenerateRecord::getSize, bo.getSize());
return lqw;
}
/**
* 新增二维码生成记录
*/
@Override
public Boolean insertByBo(WmsGenerateRecordBo bo) {
WmsGenerateRecord add = BeanUtil.toBean(bo, WmsGenerateRecord.class);
validEntityBeforeSave(add);
boolean flag = baseMapper.insert(add) > 0;
if (flag) {
bo.setRecordId(add.getRecordId());
}
return flag;
}
/**
* 修改二维码生成记录
*/
@Override
public Boolean updateByBo(WmsGenerateRecordBo bo) {
WmsGenerateRecord update = BeanUtil.toBean(bo, WmsGenerateRecord.class);
validEntityBeforeSave(update);
return baseMapper.updateById(update) > 0;
}
/**
* 保存前的数据校验
*/
private void validEntityBeforeSave(WmsGenerateRecord entity){
//TODO 做一些数据校验,如唯一约束
}
/**
* 批量删除二维码生成记录
*/
@Override
public Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid) {
if(isValid){
//TODO 做一些业务上的校验,判断是否需要校验
}
return baseMapper.deleteBatchIds(ids) > 0;
}
}

View File

@@ -0,0 +1,23 @@
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.klp.mapper.WmsGenerateRecordMapper">
<resultMap type="com.klp.domain.WmsGenerateRecord" id="WmsGenerateRecordResult">
<result property="recordId" column="record_id"/>
<result property="qrcodeType" column="qrcode_type"/>
<result property="content" column="content"/>
<result property="isEnabled" column="is_enabled"/>
<result property="serialNumber" column="serial_number"/>
<result property="size" column="size"/>
<result property="delFlag" column="del_flag"/>
<result property="remark" column="remark"/>
<result property="createTime" column="create_time"/>
<result property="createBy" column="create_by"/>
<result property="updateTime" column="update_time"/>
<result property="updateBy" column="update_by"/>
</resultMap>
</mapper>