rentaiming
2024-05-30 9bcc40d213a44498c46dae5e678e592b918b40b0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
package com.ruoyi.goods.service;
 
import com.baomidou.mybatisplus.extension.service.IService;
import com.fasterxml.jackson.core.JsonProcessingException;
import com.ruoyi.common.core.utils.page.PageDTO;
import com.ruoyi.goods.controller.management.dto.GoodsSkuDTO;
import com.ruoyi.goods.controller.management.dto.GoodsSkuQuery;
import com.ruoyi.goods.controller.management.vo.GoodsSkuVO;
import com.ruoyi.system.api.domain.GoodsSku;
import com.ruoyi.system.api.domain.dto.GoodsStockUpdDTO;
import com.ruoyi.system.api.domain.dto.ListStatusDTO;
import java.util.List;
 
/**
 * <p>
 * 商品表 服务类
 * </p>
 *
 * @author mitao
 * @since 2024-05-16
 */
public interface IGoodsSkuService extends IService<GoodsSku> {
 
    /**
     * 保存商品SKU信息。
     *
     * @param dto 商品SKU的DTO(数据传输对象),包含要保存或更新的商品SKU的详细信息。
     * @throws JsonProcessingException 当处理JSON数据时发生错误。
     */
    void saveGoods(GoodsSkuDTO dto) throws JsonProcessingException;
 
    /**
     * 获取商品SKU分页数据
     *
     * @param query 查询条件,包括SKU名称、上架状态、页码和页大小
     * @return 分页数据对象,包含商品SKU的信息
     */
    PageDTO<GoodsSkuVO> getGoodsPage(GoodsSkuQuery query);
 
    /**
     * 更新商品SKU的状态。
     *
     * @param dto 数据传输对象,包含需要更新的SKU的ID和新的上架状态。 其中,ID用于指定要更新的具体SKU,listingStatus用于指定新的上架状态。
     * @return 无返回值。
     */
    void updStatus(ListStatusDTO dto);
 
    /**
     * 根据商品名称查询商品SKU列表。
     *
     * @param goodsSkuName 商品名称
     * @return List<GoodsSku>商品SKU列表
     */
    List<GoodsSku> getGoodsByName(String goodsSkuName);
    
    /**
     * 批量退回商品库存
     *
     * @param goodsStockUpdDTOS 退货库存数据传输对象
     */
    void returningStock(List<GoodsStockUpdDTO> goodsStockUpdDTOS);
}