package cn.iocoder.yudao.module.mdm.api.item;
|
|
import cn.iocoder.yudao.framework.common.pojo.CommonResult;
|
import cn.iocoder.yudao.framework.common.pojo.PageResult;
|
import cn.iocoder.yudao.module.mdm.api.item.dto.MdmItemCreateReqDTO;
|
import cn.iocoder.yudao.module.mdm.api.item.dto.MdmItemRespDTO;
|
import cn.iocoder.yudao.module.mdm.api.item.dto.MdmItemUpdateReqDTO;
|
|
import java.util.Collection;
|
import java.util.List;
|
import java.util.Map;
|
|
import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
|
|
/**
|
* MDM 物料 API 接口
|
*
|
* @author 芋道源码
|
*/
|
public interface MdmItemApi {
|
|
String PREFIX = "/rpc-api/mdm/item";
|
|
/**
|
* 创建物料
|
*
|
* @param createReqDTO 创建信息
|
* @return 物料编号
|
*/
|
CommonResult<Long> createItem(MdmItemCreateReqDTO createReqDTO);
|
|
/**
|
* 更新物料
|
*
|
* @param updateReqDTO 更新信息
|
* @return 是否成功
|
*/
|
CommonResult<Boolean> updateItem(MdmItemUpdateReqDTO updateReqDTO);
|
|
/**
|
* 获取物料
|
*
|
* @param id 物料编号
|
* @return 物料
|
*/
|
CommonResult<MdmItemRespDTO> getItem(Long id);
|
|
/**
|
* 获取物料列表
|
*
|
* @param ids 物料编号列表
|
* @return 物料列表
|
*/
|
CommonResult<List<MdmItemRespDTO>> getItemList(Collection<Long> ids);
|
|
/**
|
* 获取物料 Map
|
*
|
* @param ids 物料编号列表
|
* @return 物料 Map
|
*/
|
default Map<Long, MdmItemRespDTO> getItemMap(Collection<Long> ids) {
|
List<MdmItemRespDTO> list = getItemList(ids).getCheckedData();
|
return convertMap(list, MdmItemRespDTO::getId);
|
}
|
|
/**
|
* 获取物料分页
|
*
|
* @param itemType 物料类型
|
* @param status 状态
|
* @param pageNo 页码
|
* @param pageSize 每页数量
|
* @return 物料分页
|
*/
|
CommonResult<PageResult<MdmItemRespDTO>> getItemPage(Integer itemType, Integer status, Integer pageNo, Integer pageSize);
|
|
/**
|
* 根据状态获取物料列表
|
*
|
* @param status 状态
|
* @return 物料列表
|
*/
|
CommonResult<List<MdmItemRespDTO>> getItemListByStatus(Integer status);
|
|
/**
|
* 校验物料存在
|
*
|
* @param id 物料编号
|
* @return 物料
|
*/
|
CommonResult<MdmItemRespDTO> validateItemExists(Long id);
|
|
/**
|
* 校验物料存在且启用
|
*
|
* @param id 物料编号
|
* @return 物料
|
*/
|
CommonResult<MdmItemRespDTO> validateItemExistsAndEnable(Long id);
|
|
/**
|
* 根据编码获取物料
|
*
|
* @param code 物料编码
|
* @return 物料
|
*/
|
CommonResult<MdmItemRespDTO> getItemByCode(String code);
|
|
/**
|
* 根据条码获取物料
|
*
|
* @param barCode 物料条码
|
* @return 物料
|
*/
|
CommonResult<MdmItemRespDTO> getItemByBarCode(String barCode);
|
|
/**
|
* 根据分类编号统计物料数量
|
*
|
* @param categoryId 分类编号
|
* @return 物料数量
|
*/
|
CommonResult<Long> getItemCountByCategoryId(Long categoryId);
|
|
/**
|
* 根据单位编号统计物料数量
|
*
|
* @param unitMeasureId 单位编号
|
* @return 物料数量
|
*/
|
CommonResult<Long> getItemCountByUnitMeasureId(Long unitMeasureId);
|
|
/**
|
* 更新物料状态
|
*
|
* @param id 物料编号
|
* @param status 状态
|
* @return 是否成功
|
*/
|
CommonResult<Boolean> updateItemStatus(Long id, Integer status);
|
|
}
|
