rentaiming
2024-06-13 fe2d5b14031edbe43238770fb1fc21e8a322b51a
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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
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.HomeGoodsSkuDTO;
import com.ruoyi.system.api.domain.dto.ListStatusDTO;
import com.ruoyi.system.api.domain.vo.HomeGoodsSkuInfoVO;
import com.ruoyi.system.api.domain.vo.HomeGoodsSkuListVO;
import java.util.List;
 
import com.ruoyi.system.api.domain.vo.getHomeGoodsSkuXxiVO;
import org.springframework.web.bind.annotation.RequestBody;
 
/**
 * <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 updGoodsStock(List<GoodsStockUpdDTO> goodsStockUpdDTOS);
 
    PageDTO<HomeGoodsSkuListVO> getHomeGoodsSkuVOList(@RequestBody HomeGoodsSkuDTO homeGoodsSkuDTO);
 
    HomeGoodsSkuInfoVO getHomeGoodsSkuInfo(@RequestBody HomeGoodsSkuDTO homeGoodsSkuDTO);
 
    List<getHomeGoodsSkuXxiVO> getHomeGoodsSkuXxi(@RequestBody HomeGoodsSkuDTO homeGoodsSkuDTO);
 
    GoodsSkuVO getGoodsDetail(Long id);
}