【Lilishop商城】No3-6.模块详细设计，商品模块-2（商品及强关联附属商品sku、批发、图册等等）的详细设计

news2025/1/10 3:31:12

仅涉及后端，全部目录看顶部专栏，代码、文档、接口路径在：

【Lilishop商城】记录一下B2B2C商城系统学习笔记~_清晨敲代码的博客-CSDN博客

全篇会结合业务介绍重点设计逻辑，其中重点包括接口类、业务类，具体的结合源代码分析，读起来也不复杂~

谨慎：源代码中有一些注释是错误的，有的注释意思完全相反，有的注释对不上号，我在阅读过程中就顺手更新了，并且在我不会的地方添加了新的注释，所以在读源代码过程中一定要谨慎啊！

A1.商品信息

B1.S端（属于显式操作）

备注（业务逻辑，可略过）：

B2.M端（属于显式操作）

A2.商品模板信息

B1.S端（属于显式操作）

图再放一遍，本篇重点在右侧商品及商品强关联信息~

A1.商品信息

首先商品信息是需要单独页面进行管理的，而商品里面信息，例如图册、批发信息、SKU信息，这些都是跟着商品存在的，删除商品后这些也都会删除，并且他们也不会有单独配置的页面~和商品分类、品牌等是不一样的。

所以只有商品有单独操作页面，而他的附属信息在新增、编辑页面进行编辑~所以是没有单独的controller接口的~只是在业务层进行操作的。

B1.S端（属于显式操作）

先说店铺S端，因为商品是店铺添加的，先从添加的端说起~

这些是添加、编辑是需要获取的数据，在这里再说明一下吧~~~

商家运费模板列表（见 No3-5- 店铺端,规格接口）
查询某分类下绑定的参数信息（见 No3-5- 店铺端,规格接口）
获取所选分类关联的品牌信息（见 No3-5- 店铺端,商品分类接口）
根据categoryId获取分类规格（见 No3-5- 店铺端,规格接口）
分页获取商品计量单位（见 No3-5- 店铺端,单位接口）
获取当前店铺商品分类列表（见 No3-5- 店铺端,店铺分类接口）

商品模块的接口

分页获取商品列表、通过id获取
新增商品、修改商品、下架商品、上架商品、删除商品
批量设置商品运费模板、分页获取商品Sku列表、修改商品库存

备注（业务逻辑，可略过）：

简单说一声，添加商品时，在商品业务层里面添加参数、添加商品sku、添加Gallery图片，然后在商品sku里面添加批量销售信息~

//添加商品时，在商品业务层里面添加参数、添加商品sku、添加Gallery图片
@Service
public class GoodsServiceImpl extends ServiceImpl<GoodsMapper, Goods> implements GoodsService {

    @Override
    @Transactional(rollbackFor = Exception.class)
    public void addGoods(GoodsOperationDTO goodsOperationDTO) {
        Goods goods = new Goods(goodsOperationDTO);
        //检查商品
        this.checkGoods(goods);
        //向goods加入图片
        if (goodsOperationDTO.getGoodsGalleryList().size() > 0 ) {
            this.setGoodsGalleryParam(goodsOperationDTO.getGoodsGalleryList().get(0), goods);
        }
        //添加商品参数
        if (goodsOperationDTO.getGoodsParamsDTOList() != null && !goodsOperationDTO.getGoodsParamsDTOList().isEmpty()) {
            //给商品参数填充值
            goods.setParams(JSONUtil.toJsonStr(goodsOperationDTO.getGoodsParamsDTOList()));
        }
        //添加商品
        this.save(goods);
        //添加商品sku信息
        this.goodsSkuService.add(goods, goodsOperationDTO);
        //添加相册
        if (goodsOperationDTO.getGoodsGalleryList() != null && !goodsOperationDTO.getGoodsGalleryList().isEmpty()) {
            this.goodsGalleryService.add(goodsOperationDTO.getGoodsGalleryList(), goods.getId());
        }
        this.generateEs(goods);
    }

}


//在商品sku里面添加批量销售信息~
@Service
public class GoodsSkuServiceImpl extends ServiceImpl<GoodsSkuMapper, GoodsSku> implements GoodsSkuService {

    @Override
    @Transactional(rollbackFor = Exception.class)
    public void add(Goods goods, GoodsOperationDTO goodsOperationDTO) {
        // 是否存在规格
        if (goodsOperationDTO.getSkuList() == null || goodsOperationDTO.getSkuList().isEmpty()) {
            throw new ServiceException(ResultCode.MUST_HAVE_GOODS_SKU);
        }
        // 检查是否需要生成索引
        List<GoodsSku> goodsSkus = GoodsSkuBuilder.buildBatch(goods, goodsOperationDTO.getSkuList());
        //渲染商品sku
        this.renderGoodsSkuList(goodsSkus, goodsOperationDTO);

        if (!goodsSkus.isEmpty()) {
            this.saveOrUpdateBatch(goodsSkus);
            this.updateStock(goodsSkus);
        }
    }

    /**
     * 批量渲染商品sku
     *
     * @param goodsSkuList      sku集合
     * @param goodsOperationDTO 商品操作DTO
     */
    @Override
    public void renderGoodsSkuList(List<GoodsSku> goodsSkuList, GoodsOperationDTO goodsOperationDTO) {
        // 商品销售模式渲染器
        salesModelRenders.stream()
                .filter(i -> i.getSalesMode().equals(goodsOperationDTO.getSalesModel()))
                .findFirst()
                .ifPresent(i -> i.renderBatch(goodsSkuList, goodsOperationDTO));
        for (GoodsSku goodsSku : goodsSkuList) {
            extendOldSkuValue(goodsSku);
            this.renderImages(goodsSku);
        }
    }

}