project 商品甄选 神奇海螺 2026-01-23 2026-03-02 开发环境 若依框架：https://doc.ruoyi.vip/
技术栈 后端 SpringBoot 简化Spring应用配置与开发
前端 ECMAScript 6:也称为ECMAScript2015，是JavaScript的一个版本，引入了许多新的语法和功能。
docker环境搭建 1.下载minio、mysql、nacos、rabbitmq、redis、sentinel镜像
基础环境搭建 对Ruoyi-Cloud进行了修改，将Cloud版本改为了3.6.3，将jdk版本改为了17，还有一些名称的修改
项目结构图 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 com.spzx
spzx-monitor 使用spring boot admin健康监测组件实现
前端项目搭建 使用若依配套的前端框架，进行一些名称上的修改
业务编写 创建商品模块 创建pom.xml 配置 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 77 78 79 80 81 82 83 84 85 86 87 88 <?xml version="1.0" encoding="UTF-8"?>
创建bootstrap.yml 配置文件 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 # Tomcat
创建logback.xml 日志配置文件 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 <?xml version="1.0" encoding="UTF-8"?>
创建banner.txt 启动日志信息配置 1 2 3 4 5 6 7 8 9 10 Spring Boot Version: ${spring-boot.version}
创建nacos配置中心配置文件 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 mybatis-plus:
创建启动类 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 package com.spzx;
使用Mybatis-plus代码生成 在根模块下锁定版本 1 2 3 4 5 6 7 8 9 10 <dependency>
在使用的项目中添加依赖 1 2 3 4 5 6 7 8 <dependency>
创建代码生成器 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 package com.spzx.product;
minio文件上传 若依框架自带了文件上传接口，直接使用即可
minio存储桶权限配置 1 2 3 4 5 6 7 8 9 {
品牌分页查询 Controller 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 @RestController
Service 接口 1 2 3 4 public interface IBrandService extends IService<Brand> {
实现类 1 2 3 4 5 6 7 8 9 10 @Service
品牌增删改查 Controller 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 package com.spzx.product.controller;
Service 接口 1 2 3 4 5 6 7 8 public interface IBrandService extends IService<Brand> {
实现类 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 package com.spzx.product.service.impl;
前端整合 配置nocos 1 2 3 4 5 6 7 # 商品服务
用户登录与权限 Ruoyi遵循RBAC模型开发的权限控制，基于角色的权限控制
日志 采用AOP在操作前获取操作信息并记录到数据库/本地/文件存储服务器
商品管理-商品单位
Controller
* 商品单位 前端控制器
*
*
* @author atguigu
* @since 2026-02-01
*/
@RestController
@RequestMapping("/productUnit")
public class ProductUnitController extends BaseController {
@Autowired
private IProductUnitService productUnitService;
@Operation(summary = "查询单位列表")
@Log(title="查询操作",operatorType = OperatorType.OTHER)
@RequiresPermissions("product:unit:list")
@GetMapping("/list")
public TableDataInfo list(@Parameter(description="名称") String name)
{
startPage();
List list = productUnitService.selectProductUnitList(name);
return getDataTable(list);
}
@Operation(summary = "根据id查询指定单位")
@GetMapping("/{id}")
public AjaxResult byId(@PathVariable Long id)
{
ProductUnit productUnit = productUnitService.getById(id);
return AjaxResult.success(productUnit);
}
@Operation(summary = "新增单位")
@PostMapping
public AjaxResult insert(@Parameter(description = "新增") @RequestBody ProductUnit productUnit)
{
productUnitService.save(productUnit);
return AjaxResult.success();
}
@Operation(summary = "修改单位")
@PutMapping
public AjaxResult update(@Parameter(description = "修改") @RequestBody ProductUnit productUnit)
{
productUnitService.updateProductUnit(productUnit);
return AjaxResult.success();
}
@Operation(summary = "删除单位")
@DeleteMapping("/{ids}")
public AjaxResult delete(@PathVariable List ids)
{
productUnitService.removeBatchByIds(ids);
return AjaxResult.success();
}
}
Service interface {
List selectProductUnitList(String name);
void updateProductUnit(ProductUnit productUnit);
}
Service implement implements IProductUnitService {
@Override
public List selectProductUnitList(String name) {
LambdaQueryWrapper wrapper = new LambdaQueryWrapper<>();
wrapper.like(StringUtils.isNotBlank(name),ProductUnit::getName, name);
return list(wrapper);
}
@Override
public void updateProductUnit(ProductUnit productUnit) {
LambdaQueryWrapper wrapper = new LambdaQueryWrapper<>();
wrapper.eq(ProductUnit::getId, productUnit.getId());
update(productUnit, wrapper);
}
}
商品分类
Controller list=categoryService.getList(parent_id);
return AjaxResult.success(list);
}
}
Service Interface {
List getList(Long parentId);
}
Service Implement implements ICategoryService {
@Override
public List getList(Long parentId) {
LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper<>();
queryWrapper.eq(Category::getParentId,parentId);
queryWrapper.select(Category::getId,Category::getName,Category::getParentId,Category::getStatus,Category::getImageUrl,Category::getOrderNum);
List list = this.list(queryWrapper);
if(!ObjectUtils.isEmpty(list)){
for (Category category : list) {
Long count=this.count(new LambdaQueryWrapper().eq(Category::getParentId,category.getId()));
category.setHasChildren(count>0);
}
}
return list;
}
}
分类品牌
Controller
* 分类品牌 前端控制器
*
*
* @author atguigu
* @since 2026-02-01
*/
@RestController
@RequestMapping("/categoryBrand")
public class CategoryBrandController extends BaseController {
@Autowired
private ICategoryBrandService categoryBrandService;
@Operation(summary = "查询分类品牌列表")
@Log(title="查询操作",operatorType = OperatorType.OTHER)
@RequiresPermissions("product:categoryBrand:list")
@GetMapping("/list")
public TableDataInfo list(){
startPage();
List list = categoryBrandService.getCategoryBrandList();
return getDataTable(list);
}
@Operation(summary = "新增分类品牌")
@Log(title="新增操作",operatorType = OperatorType.OTHER)
@PostMapping
public AjaxResult insertCategoryBrand(@RequestBody CategoryBrand categoryBrand){
categoryBrandService.insertCategoryBrand(categoryBrand);
return AjaxResult.success();
}
@Operation(summary = "删除分类品牌")
@Log(title="删除操作",operatorType = OperatorType.OTHER)
@DeleteMapping("{ids}")
public AjaxResult deleteCategoryBrands(@PathVariable List ids){
categoryBrandService.removeByIds(ids);
return AjaxResult.success();
}
}
Service Interface {
List getCategoryBrandList();
void insertCategoryBrand(CategoryBrand categoryBrand);
}
Service Implement
* 分类品牌 服务实现类
*
*
* @author atguigu
* @since 2026-02-01
*/
@Service
public class CategoryBrandServiceImpl extends ServiceImpl implements ICategoryBrandService {
@Autowired
private CategoryBrandMapper categoryBrandMapper;
@Autowired
private IBrandService brandService;
@Override
public List getCategoryBrandList() {
return categoryBrandMapper.selectCategoryBrandList();
}
@Override
public void insertCategoryBrand(CategoryBrand categoryBrand) {
long count = count(new LambdaQueryWrapper()
.eq(CategoryBrand::getCategoryId, categoryBrand.getCategoryId())
.eq(CategoryBrand::getBrandId, categoryBrand.getBrandId())
);
if(count>0){
throw new ServiceException("该分类已有此品牌");
}
categoryBrand.setCreateBy(SecurityUtils.getUsername());
categoryBrand.setUpdateBy(SecurityUtils.getUsername());
Brand brand = brandService.getById(categoryBrand.getBrandId());
categoryBrand.setLogo(brand.getLogo());
categoryBrandMapper.insert(categoryBrand);
}
}
Mapper Interface {
List selectCategoryBrandList();
}
Mapper XML
select cb.id,c.name categoryName,b.name brandName,b.logo logo,cb.update_time
from category c inner join category_brand cb on c.id=cb.category_id
inner join brand b on b.id=cb.brand_id
where c.del_flag=0 and b.del_flag=0 and cb.del_flag=0
商品规格
Controller
* 商品规格 前端控制器
*
*
* @author atguigu
* @since 2026-02-01
*/
@RestController
@RequestMapping("/productSpec")
public class ProductSpecController extends BaseController {
@Autowired
private IProductSpecService productSpecService;
@Operation(summary = "查询商品规格列表")
@Log(title="查询操作",operatorType = OperatorType.OTHER)
@RequiresPermissions("product:productSpec:list")
@GetMapping("/list")
public TableDataInfo list(){
startPage();
List list = productSpecService.selectProductSpecList();
return getDataTable(list);
}
@Operation(summary = "添加商品规格")
@Log(title="添加操作",operatorType = OperatorType.OTHER)
@PostMapping
public AjaxResult insertProductSpec(@RequestBody ProductSpec productSpec) throws JsonProcessingException {
productSpecService.saveProductSpec(productSpec);
return AjaxResult.success();
}
@Operation(summary = "删除商品规格")
@Log(title="删除操作",operatorType = OperatorType.OTHER)
@DeleteMapping("{ids}")
public AjaxResult deleteProductSpec(@PathVariable List ids){
productSpecService.removeByIds(ids);
return AjaxResult.success();
}
}
Service Interface {
List selectProductSpecList();
void saveProductSpec(ProductSpec productSpec) throws JsonProcessingException;
}
Service Implement
* 商品规格 服务实现类
*
*
* @author atguigu
* @since 2026-02-01
*/
@Service
public class ProductSpecServiceImpl extends ServiceImpl implements IProductSpecService {
@Autowired
private ProductSpecMapper productSpecMapper;
@Override
public List selectProductSpecList() {
return productSpecMapper.selectAll();
}
@Override
public void saveProductSpec(ProductSpec productSpec){
String specValue = productSpec.getSpecValue();
validateSpecJson(specValue);
productSpec.setCreateBy(SecurityUtils.getUsername());
productSpec.setUpdateBy(SecurityUtils.getUsername());
this.save(productSpec);
}
private static final ObjectMapper MAPPER = new ObjectMapper();
public static void validateSpecJson(String specValueJson) {
try {
JsonNode root = MAPPER.readTree(specValueJson);
if (root == null || !root.isArray()) {
throw new ServiceException("规格格式错误：应为 JSON 数组");
}
// 校验 key 全局唯一
Set keySet = new HashSet<>();
for (JsonNode item : root) {
if (item == null || !item.isObject()) {
throw new ServiceException("规格格式错误：数组元素必须是对象");
}
String key = item.path("key").asText("").trim();
if (key.isEmpty()) {
throw new ServiceException("规格名称为空");
}
if (!keySet.add(key)) {
throw new ServiceException("规格名称重复：" + key);
}
JsonNode valueListNode = item.path("valueList");
if (!valueListNode.isArray() || valueListNode.size() == 0) {
throw new ServiceException("规格值为空：" + key);
}
// 校验当前 key 的 valueList 唯一
Set valueSet = new HashSet<>();
for (JsonNode v : valueListNode) {
String val = v.asText("").trim();
if (val.isEmpty()) {
throw new ServiceException("规格值为空：" + key);
}
if (!valueSet.add(val)) {
throw new ServiceException("规格值重复：" + key + " = " + val);
}
}
}
} catch (ServiceException e) {
throw e;
} catch (Exception e) {
// JSON 解析失败等
throw new ServiceException("规格 JSON 解析失败：" + e.getMessage());
}
}
}
Mapper Interface {
List selectAll();
}
Mapper XML
select ps.id,ps.spec_name,ps.spec_value,ps.create_time,c.name categoryName
from category c inner join product_spec ps
on c.id=ps.category_id
where c.del_flag=0 and ps.del_flag=0
开发日志 day…?
项目初始化
商品管理-品牌管理
基础数据-单位管理
基础数据-商品分类
基础数据-分类品牌
基础数据-商品规格
day+1 …
Controller 
