feat(wms): 添加客户基础信息模块
- 新增客户基础信息相关的实体类、BO、VO、Mapper、Service、Controller等 - 实现客户基础信息的增删查改功能 - 添加分页查询、导出Excel等功能master
parent
668850dc3a
commit
d497f61c48
@ -0,0 +1,117 @@
|
||||
package org.dromara.wms.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.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.wms.domain.vo.WmsBaseCustomerVo;
|
||||
import org.dromara.wms.domain.bo.WmsBaseCustomerBo;
|
||||
import org.dromara.wms.service.IWmsBaseCustomerService;
|
||||
import org.dromara.common.mybatis.core.page.TableDataInfo;
|
||||
|
||||
/**
|
||||
* 客户基础信息
|
||||
* 前端访问路由地址为:/wms/wmsBaseCustomer
|
||||
*
|
||||
* @author zch
|
||||
* @date 2025-08-21
|
||||
*/
|
||||
@Validated
|
||||
@RequiredArgsConstructor
|
||||
@RestController
|
||||
@RequestMapping("/wmsBaseCustomer")
|
||||
public class WmsBaseCustomerController extends BaseController {
|
||||
|
||||
private final IWmsBaseCustomerService wmsBaseCustomerService;
|
||||
|
||||
/**
|
||||
* 查询客户基础信息列表
|
||||
*/
|
||||
@SaCheckPermission("wms:wmsBaseCustomer:list")
|
||||
@GetMapping("/list")
|
||||
public TableDataInfo<WmsBaseCustomerVo> list(WmsBaseCustomerBo bo, PageQuery pageQuery) {
|
||||
return wmsBaseCustomerService.queryPageList(bo, pageQuery);
|
||||
}
|
||||
|
||||
/**
|
||||
* 导出客户基础信息列表
|
||||
*/
|
||||
@SaCheckPermission("wms:wmsBaseCustomer:export")
|
||||
@Log(title = "客户基础信息", businessType = BusinessType.EXPORT)
|
||||
@PostMapping("/export")
|
||||
public void export(WmsBaseCustomerBo bo, HttpServletResponse response) {
|
||||
List<WmsBaseCustomerVo> list = wmsBaseCustomerService.queryList(bo);
|
||||
ExcelUtil.exportExcel(list, "客户基础信息", WmsBaseCustomerVo.class, response);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取客户基础信息详细信息
|
||||
*
|
||||
* @param customerId 主键
|
||||
*/
|
||||
@SaCheckPermission("wms:wmsBaseCustomer:query")
|
||||
@GetMapping("/{customerId}")
|
||||
public R<WmsBaseCustomerVo> getInfo(@NotNull(message = "主键不能为空")
|
||||
@PathVariable Long customerId) {
|
||||
return R.ok(wmsBaseCustomerService.queryById(customerId));
|
||||
}
|
||||
|
||||
/**
|
||||
* 新增客户基础信息
|
||||
*/
|
||||
@SaCheckPermission("wms:wmsBaseCustomer:add")
|
||||
@Log(title = "客户基础信息", businessType = BusinessType.INSERT)
|
||||
@RepeatSubmit()
|
||||
@PostMapping()
|
||||
public R<Void> add(@Validated(AddGroup.class) @RequestBody WmsBaseCustomerBo bo) {
|
||||
return toAjax(wmsBaseCustomerService.insertByBo(bo));
|
||||
}
|
||||
|
||||
/**
|
||||
* 修改客户基础信息
|
||||
*/
|
||||
@SaCheckPermission("wms:wmsBaseCustomer:edit")
|
||||
@Log(title = "客户基础信息", businessType = BusinessType.UPDATE)
|
||||
@RepeatSubmit()
|
||||
@PutMapping()
|
||||
public R<Void> edit(@Validated(EditGroup.class) @RequestBody WmsBaseCustomerBo bo) {
|
||||
return toAjax(wmsBaseCustomerService.updateByBo(bo));
|
||||
}
|
||||
|
||||
/**
|
||||
* 删除客户基础信息
|
||||
*
|
||||
* @param customerIds 主键串
|
||||
*/
|
||||
@SaCheckPermission("wms:wmsBaseCustomer:remove")
|
||||
@Log(title = "客户基础信息", businessType = BusinessType.DELETE)
|
||||
@DeleteMapping("/{customerIds}")
|
||||
public R<Void> remove(@NotEmpty(message = "主键不能为空")
|
||||
@PathVariable Long[] customerIds) {
|
||||
return toAjax(wmsBaseCustomerService.deleteWithValidByIds(List.of(customerIds), true));
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* 下拉框查询客户基础信息列表
|
||||
*/
|
||||
|
||||
@GetMapping("/getWmsBaseCustomerList")
|
||||
public R<List<WmsBaseCustomerVo>> getWmsBaseCustomerList(WmsBaseCustomerBo bo) {
|
||||
List<WmsBaseCustomerVo> list = wmsBaseCustomerService.queryList(bo);
|
||||
return R.ok(list);
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,15 @@
|
||||
package org.dromara.wms.mapper;
|
||||
|
||||
import org.dromara.wms.domain.WmsBaseCustomer;
|
||||
import org.dromara.wms.domain.vo.WmsBaseCustomerVo;
|
||||
import org.dromara.common.mybatis.core.mapper.BaseMapperPlus;
|
||||
|
||||
/**
|
||||
* 客户基础信息Mapper接口
|
||||
*
|
||||
* @author zch
|
||||
* @date 2025-08-21
|
||||
*/
|
||||
public interface WmsBaseCustomerMapper extends BaseMapperPlus<WmsBaseCustomer, WmsBaseCustomerVo> {
|
||||
|
||||
}
|
||||
@ -0,0 +1,69 @@
|
||||
package org.dromara.wms.service;
|
||||
|
||||
import org.dromara.wms.domain.WmsBaseCustomer;
|
||||
import org.dromara.wms.domain.vo.WmsBaseCustomerVo;
|
||||
import org.dromara.wms.domain.bo.WmsBaseCustomerBo;
|
||||
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 zch
|
||||
* @date 2025-08-21
|
||||
*/
|
||||
public interface IWmsBaseCustomerService {
|
||||
|
||||
/**
|
||||
* 查询客户基础信息
|
||||
*
|
||||
* @param customerId 主键
|
||||
* @return 客户基础信息
|
||||
*/
|
||||
WmsBaseCustomerVo queryById(Long customerId);
|
||||
|
||||
/**
|
||||
* 分页查询客户基础信息列表
|
||||
*
|
||||
* @param bo 查询条件
|
||||
* @param pageQuery 分页参数
|
||||
* @return 客户基础信息分页列表
|
||||
*/
|
||||
TableDataInfo<WmsBaseCustomerVo> queryPageList(WmsBaseCustomerBo bo, PageQuery pageQuery);
|
||||
|
||||
/**
|
||||
* 查询符合条件的客户基础信息列表
|
||||
*
|
||||
* @param bo 查询条件
|
||||
* @return 客户基础信息列表
|
||||
*/
|
||||
List<WmsBaseCustomerVo> queryList(WmsBaseCustomerBo bo);
|
||||
|
||||
/**
|
||||
* 新增客户基础信息
|
||||
*
|
||||
* @param bo 客户基础信息
|
||||
* @return 是否新增成功
|
||||
*/
|
||||
Boolean insertByBo(WmsBaseCustomerBo bo);
|
||||
|
||||
/**
|
||||
* 修改客户基础信息
|
||||
*
|
||||
* @param bo 客户基础信息
|
||||
* @return 是否修改成功
|
||||
*/
|
||||
Boolean updateByBo(WmsBaseCustomerBo bo);
|
||||
|
||||
/**
|
||||
* 校验并批量删除客户基础信息信息
|
||||
*
|
||||
* @param ids 待删除的主键集合
|
||||
* @param isValid 是否进行有效性校验
|
||||
* @return 是否删除成功
|
||||
*/
|
||||
Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
|
||||
}
|
||||
@ -0,0 +1,140 @@
|
||||
package org.dromara.wms.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.github.yulichang.toolkit.JoinWrappers;
|
||||
import com.github.yulichang.wrapper.MPJLambdaWrapper;
|
||||
import com.baomidou.mybatisplus.core.toolkit.Wrappers;
|
||||
import lombok.RequiredArgsConstructor;
|
||||
import org.springframework.stereotype.Service;
|
||||
import org.dromara.wms.domain.bo.WmsBaseCustomerBo;
|
||||
import org.dromara.wms.domain.vo.WmsBaseCustomerVo;
|
||||
import org.dromara.wms.domain.WmsBaseCustomer;
|
||||
import org.dromara.wms.mapper.WmsBaseCustomerMapper;
|
||||
import org.dromara.wms.service.IWmsBaseCustomerService;
|
||||
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
import java.util.Collection;
|
||||
|
||||
/**
|
||||
* 客户基础信息Service业务层处理
|
||||
*
|
||||
* @author zch
|
||||
* @date 2025-08-21
|
||||
*/
|
||||
@RequiredArgsConstructor
|
||||
@Service
|
||||
public class WmsBaseCustomerServiceImpl implements IWmsBaseCustomerService {
|
||||
|
||||
private final WmsBaseCustomerMapper baseMapper;
|
||||
|
||||
/**
|
||||
* 查询客户基础信息
|
||||
*
|
||||
* @param customerId 主键
|
||||
* @return 客户基础信息
|
||||
*/
|
||||
@Override
|
||||
public WmsBaseCustomerVo queryById(Long customerId){
|
||||
return baseMapper.selectVoById(customerId);
|
||||
}
|
||||
|
||||
/**
|
||||
* 分页查询客户基础信息列表
|
||||
*
|
||||
* @param bo 查询条件
|
||||
* @param pageQuery 分页参数
|
||||
* @return 客户基础信息分页列表
|
||||
*/
|
||||
@Override
|
||||
public TableDataInfo<WmsBaseCustomerVo> queryPageList(WmsBaseCustomerBo bo, PageQuery pageQuery) {
|
||||
MPJLambdaWrapper<WmsBaseCustomer> lqw = buildQueryWrapper(bo);
|
||||
Page<WmsBaseCustomerVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
|
||||
return TableDataInfo.build(result);
|
||||
}
|
||||
|
||||
/**
|
||||
* 查询符合条件的客户基础信息列表
|
||||
*
|
||||
* @param bo 查询条件
|
||||
* @return 客户基础信息列表
|
||||
*/
|
||||
@Override
|
||||
public List<WmsBaseCustomerVo> queryList(WmsBaseCustomerBo bo) {
|
||||
MPJLambdaWrapper<WmsBaseCustomer> lqw = buildQueryWrapper(bo);
|
||||
return baseMapper.selectVoList(lqw);
|
||||
}
|
||||
|
||||
private MPJLambdaWrapper<WmsBaseCustomer> buildQueryWrapper(WmsBaseCustomerBo bo) {
|
||||
Map<String, Object> params = bo.getParams();
|
||||
MPJLambdaWrapper<WmsBaseCustomer> lqw = JoinWrappers.lambda(WmsBaseCustomer.class)
|
||||
.selectAll(WmsBaseCustomer.class)
|
||||
.eq(bo.getCustomerId() != null, WmsBaseCustomer::getCustomerId, bo.getCustomerId())
|
||||
.eq(StringUtils.isNotBlank(bo.getCustomerCode()), WmsBaseCustomer::getCustomerCode, bo.getCustomerCode())
|
||||
.like(StringUtils.isNotBlank(bo.getCustomerName()), WmsBaseCustomer::getCustomerName, bo.getCustomerName())
|
||||
.eq(StringUtils.isNotBlank(bo.getContactPerson()), WmsBaseCustomer::getContactPerson, bo.getContactPerson())
|
||||
.eq(StringUtils.isNotBlank(bo.getContactPhone()), WmsBaseCustomer::getContactPhone, bo.getContactPhone())
|
||||
.eq(StringUtils.isNotBlank(bo.getAddress()), WmsBaseCustomer::getAddress, bo.getAddress())
|
||||
.eq(StringUtils.isNotBlank(bo.getFax()), WmsBaseCustomer::getFax, bo.getFax())
|
||||
.eq(StringUtils.isNotBlank(bo.getEmail()), WmsBaseCustomer::getEmail, bo.getEmail())
|
||||
.eq(StringUtils.isNotBlank(bo.getStatus()), WmsBaseCustomer::getStatus, bo.getStatus())
|
||||
.orderByDesc(WmsBaseCustomer::getCreateTime);
|
||||
return lqw;
|
||||
}
|
||||
|
||||
/**
|
||||
* 新增客户基础信息
|
||||
*
|
||||
* @param bo 客户基础信息
|
||||
* @return 是否新增成功
|
||||
*/
|
||||
@Override
|
||||
public Boolean insertByBo(WmsBaseCustomerBo bo) {
|
||||
WmsBaseCustomer add = MapstructUtils.convert(bo, WmsBaseCustomer.class);
|
||||
validEntityBeforeSave(add);
|
||||
boolean flag = baseMapper.insert(add) > 0;
|
||||
if (flag) {
|
||||
bo.setCustomerId(add.getCustomerId());
|
||||
}
|
||||
return flag;
|
||||
}
|
||||
|
||||
/**
|
||||
* 修改客户基础信息
|
||||
*
|
||||
* @param bo 客户基础信息
|
||||
* @return 是否修改成功
|
||||
*/
|
||||
@Override
|
||||
public Boolean updateByBo(WmsBaseCustomerBo bo) {
|
||||
WmsBaseCustomer update = MapstructUtils.convert(bo, WmsBaseCustomer.class);
|
||||
validEntityBeforeSave(update);
|
||||
return baseMapper.updateById(update) > 0;
|
||||
}
|
||||
|
||||
/**
|
||||
* 保存前的数据校验
|
||||
*/
|
||||
private void validEntityBeforeSave(WmsBaseCustomer entity){
|
||||
//TODO 做一些数据校验,如唯一约束
|
||||
}
|
||||
|
||||
/**
|
||||
* 校验并批量删除客户基础信息信息
|
||||
*
|
||||
* @param ids 待删除的主键集合
|
||||
* @param isValid 是否进行有效性校验
|
||||
* @return 是否删除成功
|
||||
*/
|
||||
@Override
|
||||
public Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid) {
|
||||
if(isValid){
|
||||
//TODO 做一些业务上的校验,判断是否需要校验
|
||||
}
|
||||
return baseMapper.deleteByIds(ids) > 0;
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,7 @@
|
||||
<?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="org.dromara.wms.mapper.WmsBaseCustomerMapper">
|
||||
|
||||
</mapper>
|
||||
Loading…
Reference in New Issue