SpringBoot 企業微信點餐系統實戰三：商品信息及買家商品api開發

這是【SpringBoot企業微信點餐系統實戰】系列第三篇

源碼地址：github.com/cachecats/s…

SpringBoot 企業微信點餐系統實戰一：環境搭建和數據庫設計

SpringBoot 企業微信點餐系統實戰二：日誌配置、商品類目開發

1、商品信息

1.1 商品信息 dto

按照數據庫的字段寫出對應的實體類 ProductInfo。@Data 是 lombok 的註解，用於自動生成 getter, setter, toString 方法，不懂的能夠自行查詢相關資料。

@Entity
@Data
public class ProductInfo {

    @Id
    private String productId;

    //商品名字
    private String productName;

    //商品價格
    private BigDecimal productPrice;

    //商品庫存
    private Integer productStock;

    //商品描述
    private String productDescription;

    //商品狀態
    private Integer productStatus;

    //商品圖標
    private String productIcon;

    //商品類目編號
    private Integer categoryType;

    public ProductInfo() {
    }
}
複製代碼

1.2 商品信息repository

新加了一個方法 findByProductStatus，根據商品的狀態查詢商品列表，用於查詢全部上架商品。

package com.solo.sell.repository;

import com.solo.sell.dto.ProductInfo;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;

import java.util.List;
@Repository
public interface ProductInfoRepository extends JpaRepository<ProductInfo, String>{

    List<ProductInfo> findByProductStatus(Integer status);
}
複製代碼

1.3 商品信息 service

暫時先想到如下幾個方法，作到後面不夠了再加。加庫存和減庫存後面再實現。

package com.solo.sell.service;

import com.solo.sell.dto.ProductInfo;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;

import java.util.List;

public interface ProductInfoService {

    /** * 經過id查詢單個商品 * @param id * @return */
    ProductInfo findById(String id);

    /** * 查詢上架的產品 * @return */
    List<ProductInfo> findUpAll();

    /** * 查詢全部商品 帶分頁 * @param pageable * @return */
    Page<ProductInfo> findAll(Pageable pageable);

    /** * 保存一個商品 * @param productInfo * @return */
    ProductInfo save(ProductInfo productInfo);

    //加庫存

    //減庫存

}
複製代碼

實現類 ProductInfoServiceImpl

package com.solo.sell.service.impl;

import com.solo.sell.dto.ProductInfo;
import com.solo.sell.enums.ProductStatusEnum;
import com.solo.sell.repository.ProductInfoRepository;
import com.solo.sell.service.ProductInfoService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class ProductInfoServiceImpl implements ProductInfoService {

    @Autowired
    private ProductInfoRepository repository;

    @Override
    public ProductInfo findById(String id) {
        return repository.findById(id).get();
    }

    @Override
    public List<ProductInfo> findUpAll() {
        return repository.findByProductStatus(ProductStatusEnum.UP.getCode());
    }

    @Override
    public Page<ProductInfo> findAll(Pageable pageable) {
        return repository.findAll(pageable);
    }

    @Override
    public ProductInfo save(ProductInfo productInfo) {
        return repository.save(productInfo);
    }
}
複製代碼

2、商品信息測試

商品信息的 repository 和 service 都寫完了，養成好習慣，別忘了測試。

2.1 repository 測試

@RunWith(SpringRunner.class)
@SpringBootTest
public class ProductInfoRepositoryTest {

    @Autowired
    private ProductInfoRepository repository;

    @Test
    public void add(){
        ProductInfo info = new ProductInfo();
        info.setProductId("haha123");
        info.setProductName("酸菜魚");
        info.setProductPrice(new BigDecimal(36));
        info.setProductDescription("好吃的酸菜魚，不可錯過");
        info.setProductIcon("http://abc.png");
        info.setProductStatus(0);
        info.setProductStock(10);
        info.setCategoryType(3);
        ProductInfo result = repository.save(info);
        Assert.assertNotNull(result);
    }

    @Test
    public void findOne(){
        ProductInfo info = repository.findById("haha123").get();
        Assert.assertEquals("haha123", info.getProductId());
    }

    @Test
    public void findByProductStatus() {
        List<ProductInfo> list = repository.findByProductStatus(0);
        Assert.assertNotEquals(0, list.size());
    }
}
複製代碼

2.2 service 測試

@RunWith(SpringRunner.class)
@SpringBootTest
public class ProductInfoServiceImplTest {

    @Autowired
    private ProductInfoServiceImpl service;

    @Test
    public void findById() {
        ProductInfo info = service.findById("haha123");
        Assert.assertEquals("haha123", info.getProductId());
    }

    @Test
    public void findUpAll() {
        List<ProductInfo> all = service.findUpAll();
        Assert.assertNotEquals(0, all.size());
    }

    @Test
    public void findAll() {
        PageRequest pageRequest = PageRequest.of(0, 3);
        Page<ProductInfo> productInfoPage = service.findAll(pageRequest);
        Assert.assertNotEquals(0, productInfoPage.getTotalElements());
    }

    @Test
    public void save() {
        ProductInfo info = new ProductInfo();
        info.setProductId("haha456");
        info.setProductName("皮皮蝦");
        info.setProductPrice(new BigDecimal(49));
        info.setProductDescription("皮皮蝦咱們走");
        info.setProductIcon("http://abc.png");
        info.setProductStatus(0);
        info.setProductStock(99);
        info.setCategoryType(4);
        ProductInfo save = service.save(info);
        Assert.assertNotNull(save);
    }
}
複製代碼

3、買家商品 api 開發

商品分類和商品信息開發完以後，就能夠開發買家 api 了。

買家最簡單的一個需求就是查詢上架商品列表，先實現這個功能。

3.1 返回結果分析

原本返回的數據格式應該是後端定的，但這個項目是先有的前端，已經規定好了數據格式，看看數據格式是什麼樣的吧

{
    "code": 0,
    "msg": "成功",
    "data": [
        {
            "name": "熱榜",
            "type": 1,
            "foods": [
                {
                    "id": "123456",
                    "name": "皮蛋粥",
                    "price": 1.2,
                    "description": "好吃的皮蛋粥",
                    "icon": "http://xxx.com",
                }
            ]
        },
        {
            "name": "好吃的",
            "type": 2,
            "foods": [
                {
                    "id": "123457",
                    "name": "慕斯蛋糕",
                    "price": 10.9,
                    "description": "美味爽口",
                    "icon": "http://xxx.com",
                }
            ]
        }
    ]
}
複製代碼

先約定一下全部返回給前端的對象都放在 VO 包下，對象名以 VO結尾便於區分。猜想 VO 應該是 view object 的縮寫吧…

返回結果有三層對象，最外層應該是整個項目統一的數據結構，咱們定義爲 ResultVO。data 字段裏先是商品分類 ProdoctVO，而後每一個分類裏的 foods 字段纔是具體商品 ProductInfoVO。

統一返回結果 ResultVO

package com.solo.sell.VO;

import lombok.Data;

/** * 返回的統一結果格式 * @param <T> */
@Data
public class ResultVO<T> {

    /** 狀態碼 */
    private Integer code;

    /** 返回信息 */
    private String msg;

    /** 返回數據 */
    private T data;

    public ResultVO() {}
}
複製代碼

返回商品對象 ProductVO

package com.solo.sell.VO;

import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Data;

import java.util.List;

/** * 商品信息(包含類目) */
@Data
public class ProductVO {

    @JsonProperty("name")
    private String categoryName;

    @JsonProperty("type")
    private Integer categoryType;

    @JsonProperty("foods")
    private List<ProductInfoVO> productInfoVOList ;
}
複製代碼

屬性名儘可能起的一看就知道是什麼，不要只是叫 name，時間久了不知道具體指哪一個name 了。

但返回的數據就叫 name 怎麼辦呢？在屬性上面加個註解 @JsonProperty("name") ，這樣對應的屬性名就是 name 了。

返回的商品信息 ProductInfoVO

package com.solo.sell.VO;

import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Data;

import java.math.BigDecimal;

@Data
public class ProductInfoVO {

    @JsonProperty("id")
    private String productId;

    @JsonProperty("name")
    private String productName;

    @JsonProperty("price")
    private BigDecimal productPrice;

    @JsonProperty("description")
    private String productDescription;

    @JsonProperty("icon")
    private String productIcon;

}
複製代碼

3.2 買家商品 controller

返回結果格式知道了，就開始寫 controller 邏輯啦。

全部的 controller 都放在 controller 包下，新建 controller 包，而後新建 BuyerProductController

package com.solo.sell.controller;

import com.solo.sell.VO.ProductInfoVO;
import com.solo.sell.VO.ProductVO;
import com.solo.sell.VO.ResultVO;
import com.solo.sell.dto.ProductCategory;
import com.solo.sell.dto.ProductInfo;
import com.solo.sell.service.ProductCategoryService;
import com.solo.sell.service.ProductInfoService;
import com.solo.sell.utils.ResultVOUtils;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.beans.BeanUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;

import java.util.ArrayList;
import java.util.List;
import java.util.stream.Collectors;

@RestController
@RequestMapping("/buyer/product")
@Api("買家端獲取商品")
public class BuyerProductController {

    @Autowired
    private ProductInfoService productInfoService;

    @Autowired
    private ProductCategoryService categoryService;

    @ApiOperation(value = "獲取全部上架商品", notes = "獲取全部上架商品,下架商品除外")
    @RequestMapping(value = "/list", method = RequestMethod.GET)
    public ResultVO list() {

        // 1.查詢全部上架商品
        List<ProductInfo> productInfoList = productInfoService.findUpAll();

        // 2.查詢類目（一次性查詢）
        //用 java8 的特性獲取到上架商品的全部類型
        List<Integer> categoryTypes = productInfoList.stream().map(e -> e.getCategoryType()).collect(Collectors.toList());
        List<ProductCategory> productCategoryList = categoryService.findByCategoryTypeIn(categoryTypes);

        List<ProductVO> productVOList = new ArrayList<>();
        //數據拼裝
        for (ProductCategory category : productCategoryList) {
            ProductVO productVO = new ProductVO();
            //屬性拷貝
            BeanUtils.copyProperties(category, productVO);
            //把類型匹配的商品添加進去
            List<ProductInfoVO> productInfoVOList = new ArrayList<>();
            for (ProductInfo productInfo : productInfoList) {
                if (productInfo.getCategoryType().equals(category.getCategoryType())) {
                    ProductInfoVO productInfoVO = new ProductInfoVO();
                    BeanUtils.copyProperties(productInfo, productInfoVO);
                    productInfoVOList.add(productInfoVO);
                }
            }
            productVO.setProductInfoVOList(productInfoVOList);
            productVOList.add(productVO);
        }

        return ResultVOUtils.success(productVOList);
    }
}
複製代碼

註釋寫的比較詳細就很少解釋了，就是按照前端要求的格式把數據拼接在一塊兒。

@Api 和 @ApiOperation 註解能夠先不用管，這是集成了 swagger , 調試接口更加方便。下篇文章會專門講 swagger 和 Spring Boot 的整合。

3.3 驗證

打開瀏覽器，輸入地址 http://127.0.0.1:8080/sell/buyer/product/list 能夠看到正確返回了數據

---

以上就是本節的內容，下期見~

源碼地址：github.com/cachecats/s…

SpringBoot 企業微信點餐系統實戰一：環境搭建和數據庫設計

SpringBoot 企業微信點餐系統實戰二：日誌配置、商品類目開發