From d16f9de2e66d6467be337bcfc51d9c95ec20301c Mon Sep 17 00:00:00 2001 From: STAR <3308186939@qq.com> Date: Fri, 13 Dec 2024 11:16:23 +0800 Subject: [PATCH 01/13] =?UTF-8?q?=E4=BD=A0=E5=A5=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../bus/controller/CustomerController.java | 121 +++++++++--------- 1 file changed, 58 insertions(+), 63 deletions(-) diff --git a/src/main/java/com/yeqifu/bus/controller/CustomerController.java b/src/main/java/com/yeqifu/bus/controller/CustomerController.java index 87057bc..30bc178 100644 --- a/src/main/java/com/yeqifu/bus/controller/CustomerController.java +++ b/src/main/java/com/yeqifu/bus/controller/CustomerController.java @@ -1,25 +1,24 @@ -package com.yeqifu.bus.controller; +package com.yeqifu.bus.controller; // 定义包路径 +import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper; // 导入查询包装器类 +import com.baomidou.mybatisplus.core.metadata.IPage; // 导入分页接口 +import com.baomidou.mybatisplus.extension.plugins.pagination.Page; // 导入分页实现类 +import com.yeqifu.bus.entity.Customer; // 导入客户实体类 +import com.yeqifu.bus.service.ICustomerService; // 导入客户服务接口 +import com.yeqifu.bus.vo.CustomerVo; // 导入客户视图对象 +import com.yeqifu.sys.common.Constast; // 导入常量类 +import com.yeqifu.sys.common.DataGridView; // 导入数据网格返回类 +import com.yeqifu.sys.common.ResultObj; // 导入结果对象类 +import io.swagger.annotations.ApiImplicitParam; // 导入Swagger参数注解 +import io.swagger.annotations.ApiImplicitParams; // 导入Swagger参数列表注解 +import io.swagger.annotations.ApiOperation; // 导入Swagger操作注解 +import org.apache.commons.lang3.StringUtils; // 导入字符串工具类 +import org.springframework.beans.factory.annotation.Autowired; // 导入Spring的依赖注入注解 +import org.springframework.web.bind.annotation.RequestMapping; // 导入请求映射注解 +import org.springframework.web.bind.annotation.RequestMethod; // 导入请求方法注解 +import org.springframework.web.bind.annotation.RestController; // 导入控制器注解 -import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper; -import com.baomidou.mybatisplus.core.metadata.IPage; -import com.baomidou.mybatisplus.extension.plugins.pagination.Page; -import com.yeqifu.bus.entity.Customer; -import com.yeqifu.bus.service.ICustomerService; -import com.yeqifu.bus.vo.CustomerVo; -import com.yeqifu.sys.common.Constast; -import com.yeqifu.sys.common.DataGridView; -import com.yeqifu.sys.common.ResultObj; -import io.swagger.annotations.ApiImplicitParam; -import io.swagger.annotations.ApiImplicitParams; -import io.swagger.annotations.ApiOperation; -import org.apache.commons.lang3.StringUtils; -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.List; +import java.util.List; // 导入列表类 /** *

@@ -29,29 +28,27 @@ import java.util.List; * @author luoyi- * @since 2019-12-05 */ -@RestController -@RequestMapping("/customer") +@RestController // 标注为REST控制器 +@RequestMapping("/customer") // 设置请求路径为/customer public class CustomerController { - @Autowired - private ICustomerService customerService; + @Autowired // 自动注入客户服务接口实现类 + private ICustomerService customerService; // 定义客户服务接口实例 /** * 查询所有的客户 * @param customerVo * @return */ - @RequestMapping("loadAllCustomer") - public DataGridView loadAllCustomer(CustomerVo customerVo){ - //1.声明分页page对象 - IPage page = new Page(customerVo.getPage(),customerVo.getLimit()); - //2.声明queryWrapper - QueryWrapper queryWrapper = new QueryWrapper(); - queryWrapper.like(StringUtils.isNotBlank(customerVo.getCustomername()),"customername",customerVo.getCustomername()); - queryWrapper.like(StringUtils.isNotBlank(customerVo.getConnectionpersion()),"connectionpersion",customerVo.getConnectionpersion()); - queryWrapper.like(StringUtils.isNotBlank(customerVo.getPhone()),"phone",customerVo.getPhone()); - customerService.page(page,queryWrapper); - return new DataGridView(page.getTotal(),page.getRecords()); + @RequestMapping("loadAllCustomer") // 映射路径为/loadAllCustomer + public DataGridView loadAllCustomer(CustomerVo customerVo){ // 查询所有客户方法 + IPage page = new Page(customerVo.getPage(),customerVo.getLimit()); // 声明分页对象 + QueryWrapper queryWrapper = new QueryWrapper(); // 声明查询包装器 + queryWrapper.like(StringUtils.isNotBlank(customerVo.getCustomername()),"customername",customerVo.getCustomername()); // 根据客户名模糊查询 + queryWrapper.like(StringUtils.isNotBlank(customerVo.getConnectionpersion()),"connectionpersion",customerVo.getConnectionpersion()); // 根据联系人模糊查询 + queryWrapper.like(StringUtils.isNotBlank(customerVo.getPhone()),"phone",customerVo.getPhone()); // 根据手机号模糊查询 + customerService.page(page,queryWrapper); // 调用分页查询服务 + return new DataGridView(page.getTotal(),page.getRecords()); // 返回分页数据 } /** @@ -59,14 +56,14 @@ public class CustomerController { * @param customerVo * @return */ - @RequestMapping("addCustomer") - public ResultObj addCustomer(CustomerVo customerVo){ + @RequestMapping("addCustomer") // 映射路径为/addCustomer + public ResultObj addCustomer(CustomerVo customerVo){ // 添加客户方法 try { - customerService.save(customerVo); - return ResultObj.ADD_SUCCESS; + customerService.save(customerVo); // 保存客户数据 + return ResultObj.ADD_SUCCESS; // 返回添加成功结果 } catch (Exception e) { - e.printStackTrace(); - return ResultObj.ADD_ERROR; + e.printStackTrace(); // 打印异常堆栈信息 + return ResultObj.ADD_ERROR; // 返回添加失败结果 } } @@ -75,14 +72,14 @@ public class CustomerController { * @param customerVo * @return */ - @RequestMapping("updateCustomer") - public ResultObj updateCustomer(CustomerVo customerVo){ + @RequestMapping("updateCustomer") // 映射路径为/updateCustomer + public ResultObj updateCustomer(CustomerVo customerVo){ // 修改客户方法 try { - customerService.updateById(customerVo); - return ResultObj.UPDATE_SUCCESS; + customerService.updateById(customerVo); // 根据ID更新客户数据 + return ResultObj.UPDATE_SUCCESS; // 返回更新成功结果 } catch (Exception e) { - e.printStackTrace(); - return ResultObj.UPDATE_ERROR; + e.printStackTrace(); // 打印异常堆栈信息 + return ResultObj.UPDATE_ERROR; // 返回更新失败结果 } } @@ -91,31 +88,29 @@ public class CustomerController { * @param id 客户的ID * @return */ - @ApiOperation(value = "删除一个客户",notes = "删除一个客户") - @ApiImplicitParams({@ApiImplicitParam(name = "id", value = "客户ID",required = true,paramType = "query",dataType = "Integer")}) - @RequestMapping(value = "deleteCustomer",method = RequestMethod.DELETE) - public ResultObj deleteCustomer(Integer id){ + @ApiOperation(value = "删除一个客户",notes = "删除一个客户") // Swagger注解，描述操作内容 + @ApiImplicitParams({@ApiImplicitParam(name = "id", value = "客户ID",required = true,paramType = "query",dataType = "Integer")}) // Swagger注解，描述参数信息 + @RequestMapping(value = "deleteCustomer",method = RequestMethod.DELETE) // 映射路径为/deleteCustomer，方法为DELETE + public ResultObj deleteCustomer(Integer id){ // 删除客户方法 try { - customerService.deleteCustomerById(id); - return ResultObj.DELETE_SUCCESS; + customerService.deleteCustomerById(id); // 调用服务删除客户 + return ResultObj.DELETE_SUCCESS; // 返回删除成功结果 } catch (Exception e) { - e.printStackTrace(); - return ResultObj.DELETE_ERROR; + e.printStackTrace(); // 打印异常堆栈信息 + return ResultObj.DELETE_ERROR; // 返回删除失败结果 } } - /** * 加载所有客户的下拉列表 * @return */ - @RequestMapping("loadAllCustomerForSelect") - public DataGridView loadAllCustomerForSelect(){ - QueryWrapper queryWrapper = new QueryWrapper(); - queryWrapper.eq("available", Constast.AVAILABLE_TRUE); - List list = customerService.list(queryWrapper); - return new DataGridView(list); + @RequestMapping("loadAllCustomerForSelect") // 映射路径为/loadAllCustomerForSelect + public DataGridView loadAllCustomerForSelect(){ // 加载客户下拉列表方法 + QueryWrapper queryWrapper = new QueryWrapper(); // 声明查询包装器 + queryWrapper.eq("available", Constast.AVAILABLE_TRUE); // 查询可用客户数据 + List list = customerService.list(queryWrapper); // 获取客户列表 + return new DataGridView(list); // 返回客户数据 } } - From 7a187c03db31334f3489b243548271877dd68236 Mon Sep 17 00:00:00 2001 From: STAR <3308186939@qq.com> Date: Fri, 13 Dec 2024 11:24:56 +0800 Subject: [PATCH 02/13] =?UTF-8?q?=E4=BD=A0=E5=A5=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../bus/controller/GoodsController.java | 225 ++++++++++-------- 1 file changed, 130 insertions(+), 95 deletions(-) diff --git a/src/main/java/com/yeqifu/bus/controller/GoodsController.java b/src/main/java/com/yeqifu/bus/controller/GoodsController.java index 7ecb48c..10e8821 100644 --- a/src/main/java/com/yeqifu/bus/controller/GoodsController.java +++ b/src/main/java/com/yeqifu/bus/controller/GoodsController.java @@ -1,184 +1,219 @@ package com.yeqifu.bus.controller; - -import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper; -import com.baomidou.mybatisplus.core.metadata.IPage; -import com.baomidou.mybatisplus.extension.plugins.pagination.Page; -import com.yeqifu.bus.entity.Goods; -import com.yeqifu.bus.entity.Provider; -import com.yeqifu.bus.service.IGoodsService; -import com.yeqifu.bus.service.IProviderService; -import com.yeqifu.bus.vo.GoodsVo; -import com.yeqifu.sys.common.AppFileUtils; -import com.yeqifu.sys.common.Constast; -import com.yeqifu.sys.common.DataGridView; -import com.yeqifu.sys.common.ResultObj; -import org.apache.commons.lang3.StringUtils; -import org.springframework.beans.factory.annotation.Autowired; -import org.springframework.web.bind.annotation.RequestMapping; -import org.springframework.web.bind.annotation.RestController; - -import java.util.List; +// 导入必要的类和注解 +import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper; // 用于条件查询的封装器 +import com.baomidou.mybatisplus.core.metadata.IPage; // 分页结果封装类 +import com.baomidou.mybatisplus.extension.plugins.pagination.Page; // 分页类 +import com.yeqifu.bus.entity.Goods; // 商品实体类 +import com.yeqifu.bus.entity.Provider; // 供应商实体类 +import com.yeqifu.bus.service.IGoodsService; // 商品服务接口 +import com.yeqifu.bus.service.IProviderService; // 供应商服务接口 +import com.yeqifu.bus.vo.GoodsVo; // 商品视图对象 +import com.yeqifu.sys.common.AppFileUtils; // 文件操作工具类 +import com.yeqifu.sys.common.Constast; // 常量类 +import com.yeqifu.sys.common.DataGridView; // 数据网格返回格式类 +import com.yeqifu.sys.common.ResultObj; // 结果对象类 +import org.apache.commons.lang3.StringUtils; // 字符串工具类 +import org.springframework.beans.factory.annotation.Autowired; // 自动注入注解 +import org.springframework.web.bind.annotation.RequestMapping; // 映射请求路径注解 +import org.springframework.web.bind.annotation.RestController; // REST 控制器注解 + +import java.util.List; // Java 集合类 /** - *

- * InnoDB free: 9216 kB; (`providerid`) REFER `warehouse/bus_provider`(`id`) 前端控制器 - *

- * - * @author luoyi- - * @since 2019-12-06 + * 商品管理控制器 + * 提供了对商品的查询、添加、修改、删除等功能 */ -@RestController -@RequestMapping("/goods") +@RestController // 标注为 REST 控制器，返回 JSON 数据 +@RequestMapping("/goods") // 设置请求路径的统一前缀 public class GoodsController { - @Autowired + @Autowired // 自动注入商品服务 private IGoodsService goodsService; - @Autowired + @Autowired // 自动注入供应商服务 private IProviderService providerService; /** - * 查询商品 - * @param goodsVo - * @return + * 查询商品信息 + * @param goodsVo 商品视图对象，封装了查询条件 + * @return 返回分页的商品信息 */ - @RequestMapping("loadAllGoods") - public DataGridView loadAllGoods(GoodsVo goodsVo){ - IPage page = new Page(goodsVo.getPage(),goodsVo.getLimit()); + @RequestMapping("loadAllGoods") // 请求映射到 /goods/loadAllGoods + public DataGridView loadAllGoods(GoodsVo goodsVo) { + // 创建分页对象，指定当前页和每页大小 + IPage page = new Page(goodsVo.getPage(), goodsVo.getLimit()); + + // 构造查询条件 QueryWrapper queryWrapper = new QueryWrapper(); - queryWrapper.eq(goodsVo.getProviderid()!=null&&goodsVo.getProviderid()!=0,"providerid",goodsVo.getProviderid()); - queryWrapper.like(StringUtils.isNotBlank(goodsVo.getGoodsname()),"goodsname",goodsVo.getGoodsname()); - queryWrapper.like(StringUtils.isNotBlank(goodsVo.getProductcode()),"productcode",goodsVo.getProductcode()); - queryWrapper.like(StringUtils.isNotBlank(goodsVo.getPromitcode()),"promitcode",goodsVo.getPromitcode()); - queryWrapper.like(StringUtils.isNotBlank(goodsVo.getDescription()),"description",goodsVo.getDescription()); - queryWrapper.like(StringUtils.isNotBlank(goodsVo.getSize()),"size",goodsVo.getSize()); - - queryWrapper.orderByDesc("id"); - goodsService.page(page,queryWrapper); + queryWrapper.eq(goodsVo.getProviderid() != null && goodsVo.getProviderid() != 0, "providerid", goodsVo.getProviderid()); // 按供应商 ID 查询 + queryWrapper.like(StringUtils.isNotBlank(goodsVo.getGoodsname()), "goodsname", goodsVo.getGoodsname()); // 按商品名称模糊查询 + queryWrapper.like(StringUtils.isNotBlank(goodsVo.getProductcode()), "productcode", goodsVo.getProductcode()); // 按商品编码模糊查询 + queryWrapper.like(StringUtils.isNotBlank(goodsVo.getPromitcode()), "promitcode", goodsVo.getPromitcode()); // 按促销编码模糊查询 + queryWrapper.like(StringUtils.isNotBlank(goodsVo.getDescription()), "description", goodsVo.getDescription()); // 按描述模糊查询 + queryWrapper.like(StringUtils.isNotBlank(goodsVo.getSize()), "size", goodsVo.getSize()); // 按尺寸模糊查询 + + queryWrapper.orderByDesc("id"); // 按 ID 降序排序 + + // 执行分页查询 + goodsService.page(page, queryWrapper); + + // 获取查询结果 List records = page.getRecords(); for (Goods goods : records) { + // 根据商品的供应商 ID 查询供应商信息，并设置供应商名称 Provider provider = providerService.getById(goods.getProviderid()); - if (null!=provider){ + if (provider != null) { goods.setProvidername(provider.getProvidername()); } } - return new DataGridView(page.getTotal(),page.getRecords()); + + // 返回分页数据和商品记录 + return new DataGridView(page.getTotal(), page.getRecords()); } /** * 添加商品 - * @param goodsVo - * @return + * @param goodsVo 商品视图对象 + * @return 返回操作结果 */ - @RequestMapping("addGoods") - public ResultObj addGoods(GoodsVo goodsVo){ + @RequestMapping("addGoods") // 请求映射到 /goods/addGoods + public ResultObj addGoods(GoodsVo goodsVo) { try { System.out.println("===================================="); - System.out.println(goodsVo.getGoodsimg()); - if (goodsVo.getGoodsimg()!=null&&goodsVo.getGoodsimg().endsWith("_temp")){ + System.out.println(goodsVo.getGoodsimg()); // 打印上传的商品图片路径 + + // 如果上传的图片路径是临时文件，则重命名为正式文件 + if (goodsVo.getGoodsimg() != null && goodsVo.getGoodsimg().endsWith("_temp")) { String newName = AppFileUtils.renameFile(goodsVo.getGoodsimg()); - goodsVo.setGoodsimg(newName); + goodsVo.setGoodsimg(newName); // 更新图片路径 } + + // 保存商品信息 goodsService.save(goodsVo); + + // 返回添加成功的结果 return ResultObj.ADD_SUCCESS; } catch (Exception e) { - e.printStackTrace(); - return ResultObj.ADD_ERROR; + e.printStackTrace(); // 打印异常堆栈信息 + return ResultObj.ADD_ERROR; // 返回添加失败的结果 } } /** * 修改商品 - * @param goodsVo - * @return + * @param goodsVo 商品视图对象 + * @return 返回操作结果 */ - @RequestMapping("updateGoods") - public ResultObj updateGoods(GoodsVo goodsVo){ + @RequestMapping("updateGoods") // 请求映射到 /goods/updateGoods + public ResultObj updateGoods(GoodsVo goodsVo) { try { - //商品图片不是默认图片 - if (!(goodsVo.getGoodsimg()!=null&&goodsVo.getGoodsimg().equals(Constast.DEFAULT_IMG_GOODS))){ - - if (goodsVo.getGoodsimg().endsWith("_temp")){ - String newName = AppFileUtils.renameFile(goodsVo.getGoodsimg()); + // 如果商品图片不是默认图片，则处理图片路径 + if (!(goodsVo.getGoodsimg() != null && goodsVo.getGoodsimg().equals(Constast.DEFAULT_IMG_GOODS))) { + if (goodsVo.getGoodsimg().endsWith("_temp")) { + String newName = AppFileUtils.renameFile(goodsVo.getGoodsimg()); // 重命名图片文件 goodsVo.setGoodsimg(newName); - //删除原先的图片 + + // 删除原先的图片文件 String oldPath = goodsService.getById(goodsVo.getId()).getGoodsimg(); AppFileUtils.removeFileByPath(oldPath); } } + + // 更新商品信息 goodsService.updateById(goodsVo); + + // 返回更新成功的结果 return ResultObj.UPDATE_SUCCESS; } catch (Exception e) { - e.printStackTrace(); - return ResultObj.UPDATE_ERROR; + e.printStackTrace(); // 打印异常堆栈信息 + return ResultObj.UPDATE_ERROR; // 返回更新失败的结果 } } /** * 删除商品 - * @param id 商品id - * @return + * @param id 商品 ID + * @param goodsimg 商品图片路径 + * @return 返回操作结果 */ - @RequestMapping("deleteGoods") - public ResultObj deleteGoods(Integer id,String goodsimg){ + @RequestMapping("deleteGoods") // 请求映射到 /goods/deleteGoods + public ResultObj deleteGoods(Integer id, String goodsimg) { try { - //删除商品的图片 + // 删除商品的图片文件 AppFileUtils.removeFileByPath(goodsimg); -// goodsService.removeById(id); + + // 删除商品信息 goodsService.deleteGoodsById(id); + + // 返回删除成功的结果 return ResultObj.DELETE_SUCCESS; } catch (Exception e) { - e.printStackTrace(); - return ResultObj.DELETE_ERROR; + e.printStackTrace(); // 打印异常堆栈信息 + return ResultObj.DELETE_ERROR; // 返回删除失败的结果 } } /** * 加载所有可用的商品 - * @return + * @return 返回所有可用商品的信息 */ - @RequestMapping("loadAllGoodsForSelect") - public DataGridView loadAllGoodsForSelect(){ + @RequestMapping("loadAllGoodsForSelect") // 请求映射到 /goods/loadAllGoodsForSelect + public DataGridView loadAllGoodsForSelect() { + // 构造查询条件，仅查询状态为可用的商品 QueryWrapper queryWrapper = new QueryWrapper(); - queryWrapper.eq("available",Constast.AVAILABLE_TRUE); + queryWrapper.eq("available", Constast.AVAILABLE_TRUE); + + // 查询商品列表 List list = goodsService.list(queryWrapper); for (Goods goods : list) { + // 设置供应商名称 Provider provider = providerService.getById(goods.getProviderid()); - if (null!=provider){ + if (provider != null) { goods.setProvidername(provider.getProvidername()); } } + + // 返回商品列表 return new DataGridView(list); } /** - * 根据供应商ID查询商品信息 - * @param providerid 供应商ID - * @return + * 根据供应商 ID 查询商品信息 + * @param providerid 供应商 ID + * @return 返回该供应商的商品信息 */ - @RequestMapping("loadGoodsByProviderId") - public DataGridView loadGoodsByProviderId(Integer providerid){ + @RequestMapping("loadGoodsByProviderId") // 请求映射到 /goods/loadGoodsByProviderId + public DataGridView loadGoodsByProviderId(Integer providerid) { + // 构造查询条件，仅查询状态为可用的商品 QueryWrapper queryWrapper = new QueryWrapper(); - queryWrapper.eq("available",Constast.AVAILABLE_TRUE); - queryWrapper.eq(providerid!=null,"providerid",providerid); + queryWrapper.eq("available", Constast.AVAILABLE_TRUE); + queryWrapper.eq(providerid != null, "providerid", providerid); // 按供应商 ID 查询 + + // 查询商品列表 List list = goodsService.list(queryWrapper); for (Goods goods : list) { + // 设置供应商名称 Provider provider = providerService.getById(goods.getProviderid()); - if (null!=provider){ + if (provider != null) { goods.setProvidername(provider.getProvidername()); } } + + // 返回商品列表 return new DataGridView(list); } - @RequestMapping("loadAllWarningGoods") - public DataGridView loadAllWarningGoods(){ + /** + * 查询所有库存预警的商品 + * @return 返回库存预警商品的信息 + */ + @RequestMapping("loadAllWarningGoods") // 请求映射到 /goods/loadAllWarningGoods + public DataGridView loadAllWarningGoods() { + // 查询所有库存预警的商品 List goods = goodsService.loadAllWarning(); - return new DataGridView((long) goods.size(),goods); - } - - + // 返回预警商品的数量和列表 + return new DataGridView((long) goods.size(), goods); + } } - From 89b546de39a4990c6d7d203ca15869fd2df9094e Mon Sep 17 00:00:00 2001 From: STAR <3308186939@qq.com> Date: Fri, 13 Dec 2024 11:32:18 +0800 Subject: [PATCH 03/13] =?UTF-8?q?=E4=BD=A0=E5=A5=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../bus/controller/InportController.java | 191 ++++++++---------- 1 file changed, 89 insertions(+), 102 deletions(-) diff --git a/src/main/java/com/yeqifu/bus/controller/InportController.java b/src/main/java/com/yeqifu/bus/controller/InportController.java index 2c17889..d0fa11f 100644 --- a/src/main/java/com/yeqifu/bus/controller/InportController.java +++ b/src/main/java/com/yeqifu/bus/controller/InportController.java @@ -1,141 +1,128 @@ -package com.yeqifu.bus.controller; - - -import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper; -import com.baomidou.mybatisplus.core.metadata.IPage; -import com.baomidou.mybatisplus.extension.plugins.pagination.Page; -import com.yeqifu.bus.entity.Goods; -import com.yeqifu.bus.entity.Inport; -import com.yeqifu.bus.entity.Provider; -import com.yeqifu.bus.service.IGoodsService; -import com.yeqifu.bus.service.IInportService; -import com.yeqifu.bus.service.IProviderService; -import com.yeqifu.bus.vo.InportVo; -import com.yeqifu.sys.common.DataGridView; -import com.yeqifu.sys.common.ResultObj; -import com.yeqifu.sys.common.WebUtils; -import com.yeqifu.sys.entity.User; -import org.springframework.beans.factory.annotation.Autowired; -import org.springframework.web.bind.annotation.RequestMapping; -import org.springframework.web.bind.annotation.RestController; - -import java.util.Date; -import java.util.List; +package com.yeqifu.bus.controller; // 定义包名 + +import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper; // 导入条件查询封装器 +import com.baomidou.mybatisplus.core.metadata.IPage; // 导入分页结果封装类 +import com.baomidou.mybatisplus.extension.plugins.pagination.Page; // 导入分页类 +import com.yeqifu.bus.entity.Goods; // 导入商品实体类 +import com.yeqifu.bus.entity.Inport; // 导入商品进货实体类 +import com.yeqifu.bus.entity.Provider; // 导入供应商实体类 +import com.yeqifu.bus.service.IGoodsService; // 导入商品服务接口 +import com.yeqifu.bus.service.IInportService; // 导入商品进货服务接口 +import com.yeqifu.bus.service.IProviderService; // 导入供应商服务接口 +import com.yeqifu.bus.vo.InportVo; // 导入进货视图对象 +import com.yeqifu.sys.common.DataGridView; // 导入数据网格返回格式类 +import com.yeqifu.sys.common.ResultObj; // 导入操作结果对象类 +import com.yeqifu.sys.common.WebUtils; // 导入 Web 工具类 +import com.yeqifu.sys.entity.User; // 导入用户实体类 +import org.springframework.beans.factory.annotation.Autowired; // 导入自动注入注解 +import org.springframework.web.bind.annotation.RequestMapping; // 导入请求映射注解 +import org.springframework.web.bind.annotation.RestController; // 导入 REST 控制器注解 + +import java.util.Date; // 导入日期类 +import java.util.List; // 导入 Java 集合类 /** - *

- * InnoDB free: 9216 kB; (`providerid`) REFER `warehouse/bus_provider`(`id`); (`goo 前端控制器 - *

- * - * @author luoyi- - * @since 2019-12-18 + * 商品进货管理控制器 + * 提供商品进货的查询、添加、修改、删除功能 */ -@RestController -@RequestMapping("inport") +@RestController // 标注为 REST 控制器，返回 JSON 数据 +@RequestMapping("inport") // 设置请求路径的统一前缀 public class InportController { - @Autowired + @Autowired // 自动注入商品进货服务 private IInportService inportService; - @Autowired + @Autowired // 自动注入供应商服务 private IProviderService providerService; - @Autowired + @Autowired // 自动注入商品服务 private IGoodsService goodsService; /** - * 查询商品进货 - * @param inportVo - * @return + * 查询商品进货信息 + * @param inportVo 进货视图对象，封装了查询条件 + * @return 返回分页的进货信息 */ - @RequestMapping("loadAllInport") - public DataGridView loadAllInport(InportVo inportVo){ - IPage page = new Page(inportVo.getPage(),inportVo.getLimit()); - QueryWrapper queryWrapper = new QueryWrapper(); - //对供应商进行查询 - queryWrapper.eq(inportVo.getProviderid()!=null&&inportVo.getProviderid()!=0,"providerid",inportVo.getProviderid()); - //对商品进行查询 - queryWrapper.eq(inportVo.getGoodsid()!=null&&inportVo.getGoodsid()!=0,"goodsid",inportVo.getGoodsid()); - //对时间进行查询要求大于开始时间小于结束时间 - queryWrapper.ge(inportVo.getStartTime()!=null,"inporttime",inportVo.getStartTime()); - queryWrapper.le(inportVo.getEndTime()!=null,"inporttime",inportVo.getEndTime()); - //通过进货时间对商品进行排序 - queryWrapper.orderByDesc("inporttime"); - IPage page1 = inportService.page(page, queryWrapper); - List records = page1.getRecords(); - for (Inport inport : records) { - Provider provider = providerService.getById(inport.getProviderid()); - if (provider!=null){ - //设置供应商姓名 - inport.setProvidername(provider.getProvidername()); + @RequestMapping("loadAllInport") // 请求映射到 /inport/loadAllInport + public DataGridView loadAllInport(InportVo inportVo) { + IPage page = new Page(inportVo.getPage(), inportVo.getLimit()); // 创建分页对象，指定当前页和每页大小 + + QueryWrapper queryWrapper = new QueryWrapper(); // 构造查询条件对象 + queryWrapper.eq(inportVo.getProviderid() != null && inportVo.getProviderid() != 0, "providerid", inportVo.getProviderid()); // 按供应商 ID 查询 + queryWrapper.eq(inportVo.getGoodsid() != null && inportVo.getGoodsid() != 0, "goodsid", inportVo.getGoodsid()); // 按商品 ID 查询 + queryWrapper.ge(inportVo.getStartTime() != null, "inporttime", inportVo.getStartTime()); // 查询大于等于开始时间的数据 + queryWrapper.le(inportVo.getEndTime() != null, "inporttime", inportVo.getEndTime()); // 查询小于等于结束时间的数据 + queryWrapper.orderByDesc("inporttime"); // 按进货时间降序排序 + + IPage page1 = inportService.page(page, queryWrapper); // 执行分页查询 + + List records = page1.getRecords(); // 获取查询结果 + for (Inport inport : records) { // 遍历查询结果 + Provider provider = providerService.getById(inport.getProviderid()); // 根据供应商 ID 查询供应商信息 + if (provider != null) { // 如果供应商信息存在 + inport.setProvidername(provider.getProvidername()); // 设置供应商名称 } - Goods goods = goodsService.getById(inport.getGoodsid()); - if (goods!=null){ - //设置商品名称 - inport.setGoodsname(goods.getGoodsname()); - //设置商品规格 - inport.setSize(goods.getSize()); + + Goods goods = goodsService.getById(inport.getGoodsid()); // 根据商品 ID 查询商品信息 + if (goods != null) { // 如果商品信息存在 + inport.setGoodsname(goods.getGoodsname()); // 设置商品名称 + inport.setSize(goods.getSize()); // 设置商品规格 } } - return new DataGridView(page1.getTotal(),page1.getRecords()); - } + return new DataGridView(page1.getTotal(), page1.getRecords()); // 返回分页数据和进货记录 + } /** * 添加进货商品 - * @param inportVo - * @return + * @param inportVo 进货视图对象 + * @return 返回操作结果 */ - @RequestMapping("addInport") - public ResultObj addInport(InportVo inportVo){ + @RequestMapping("addInport") // 请求映射到 /inport/addInport + public ResultObj addInport(InportVo inportVo) { try { - //获得当前系统用户 - User user = (User) WebUtils.getSession().getAttribute("user"); - //设置操作人 - inportVo.setOperateperson(user.getName()); - //设置进货时间 - inportVo.setInporttime(new Date()); - inportService.save(inportVo); - return ResultObj.ADD_SUCCESS; - } catch (Exception e) { - e.printStackTrace(); - return ResultObj.ADD_ERROR; + User user = (User) WebUtils.getSession().getAttribute("user"); // 获取当前登录用户 + inportVo.setOperateperson(user.getName()); // 设置操作人姓名 + inportVo.setInporttime(new Date()); // 设置进货时间为当前时间 + + inportService.save(inportVo); // 保存进货信息 + + return ResultObj.ADD_SUCCESS; // 返回添加成功的结果 + } catch (Exception e) { // 捕获异常 + e.printStackTrace(); // 打印异常堆栈信息 + return ResultObj.ADD_ERROR; // 返回添加失败的结果 } } /** * 更新进货商品 - * @param inportVo - * @return + * @param inportVo 进货视图对象 + * @return 返回操作结果 */ - @RequestMapping("updateInport") - public ResultObj updateInport(InportVo inportVo){ + @RequestMapping("updateInport") // 请求映射到 /inport/updateInport + public ResultObj updateInport(InportVo inportVo) { try { - inportService.updateById(inportVo); - return ResultObj.UPDATE_SUCCESS; - } catch (Exception e) { - e.printStackTrace(); - return ResultObj.UPDATE_ERROR; + inportService.updateById(inportVo); // 更新进货信息 + return ResultObj.UPDATE_SUCCESS; // 返回更新成功的结果 + } catch (Exception e) { // 捕获异常 + e.printStackTrace(); // 打印异常堆栈信息 + return ResultObj.UPDATE_ERROR; // 返回更新失败的结果 } - } /** * 删除进货商品 - * @param id - * @return + * @param id 进货记录 ID + * @return 返回操作结果 */ - @RequestMapping("deleteInport") - public ResultObj deleteInport(Integer id){ + @RequestMapping("deleteInport") // 请求映射到 /inport/deleteInport + public ResultObj deleteInport(Integer id) { try { - inportService.removeById(id); - return ResultObj.DELETE_SUCCESS; - } catch (Exception e) { - e.printStackTrace(); - return ResultObj.DELETE_ERROR; + inportService.removeById(id); // 删除进货记录 + return ResultObj.DELETE_SUCCESS; // 返回删除成功的结果 + } catch (Exception e) { // 捕获异常 + e.printStackTrace(); // 打印异常堆栈信息 + return ResultObj.DELETE_ERROR; // 返回删除失败的结果 } } - - } - From 31e0aeaf89cb8ebc9ffbf0a78e051fdda94d5adb Mon Sep 17 00:00:00 2001 From: STAR <3308186939@qq.com> Date: Sun, 15 Dec 2024 16:12:49 +0800 Subject: [PATCH 04/13] 12/15 --- .../bus/controller/OutportController.java | 129 +++++++------- .../bus/controller/ProviderController.java | 132 ++++++++++---- .../bus/controller/SalesController.java | 164 +++++++++++++----- .../bus/controller/SalesbackController.java | 146 +++++++++++----- 4 files changed, 384 insertions(+), 187 deletions(-) diff --git a/src/main/java/com/yeqifu/bus/controller/OutportController.java b/src/main/java/com/yeqifu/bus/controller/OutportController.java index fb557a4..6c8d30c 100644 --- a/src/main/java/com/yeqifu/bus/controller/OutportController.java +++ b/src/main/java/com/yeqifu/bus/controller/OutportController.java @@ -1,116 +1,105 @@ -package com.yeqifu.bus.controller; - +package com.yeqifu.bus.controller; // 声明类所在的包 +// 导入MyBatis-Plus框架相关工具类，用于条件查询和分页处理 import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper; import com.baomidou.mybatisplus.core.metadata.IPage; import com.baomidou.mybatisplus.extension.plugins.pagination.Page; +// 导入实体类，分别表示商品、退货记录和供应商 import com.yeqifu.bus.entity.Goods; import com.yeqifu.bus.entity.Outport; import com.yeqifu.bus.entity.Provider; +// 导入服务接口，用于实现业务逻辑的调用 import com.yeqifu.bus.service.IGoodsService; import com.yeqifu.bus.service.IOutportService; import com.yeqifu.bus.service.IProviderService; +// 导入数据传输对象和通用响应结果类 import com.yeqifu.bus.vo.OutportVo; import com.yeqifu.sys.common.DataGridView; import com.yeqifu.sys.common.ResultObj; +// 导入Spring框架注解 import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; -import java.util.List; +import java.util.List; // 导入Java标准库中的List接口，用于处理集合 /** - *

- * InnoDB free: 9216 kB 前端控制器 - *

- * - * @author luoyi- - * @since 2019-12-19 + * OutportController类是一个RESTful控制器，负责退货记录的管理 */ -@RestController -@RequestMapping("/outport") +@RestController // 标识该类为REST风格的控制器，返回结果以JSON格式序列化 +@RequestMapping("/outport") // 设置基础URL路径为"/outport" public class OutportController { - @Autowired + @Autowired // 自动注入退货服务类，用于处理退货业务逻辑 private IOutportService outportService; - @Autowired + @Autowired // 自动注入供应商服务类，用于查询供应商信息 private IProviderService providerService; - @Autowired + @Autowired // 自动注入商品服务类，用于查询商品信息 private IGoodsService goodsService; /** - * 添加退货信息 - * @param id 进货单ID - * @param number 退货数量 - * @param remark 备注 - * @return + * 添加退货记录 + * @param id 进货单ID + * @param number 退货数量 + * @param remark 退货备注 + * @return 返回操作结果 */ - @RequestMapping("addOutport") - public ResultObj addOutport(Integer id,Integer number,String remark){ + @RequestMapping("addOutport") // 映射URL路径为"/outport/addOutport" + public ResultObj addOutport(Integer id, Integer number, String remark) { // 定义添加退货记录的方法 try { - outportService.addOutport(id,number,remark); - return ResultObj.BACKINPORT_SUCCESS; - } catch (Exception e) { - e.printStackTrace(); - return ResultObj.BACKINPORT_ERROR; + outportService.addOutport(id, number, remark); // 调用服务层方法，执行添加退货逻辑 + return ResultObj.BACKINPORT_SUCCESS; // 返回操作成功的结果对象 + } catch (Exception e) { // 捕获异常 + e.printStackTrace(); // 打印异常信息到控制台 + return ResultObj.BACKINPORT_ERROR; // 返回操作失败的结果对象 } } - /**t - * 查询商品退货 - * @param outportVo - * @return + /** + * 查询退货记录 + * @param outportVo 查询条件对象，包含分页信息和过滤条件 + * @return 返回分页数据和退货记录 */ - @RequestMapping("loadAllOutport") - public DataGridView loadAllOuport(OutportVo outportVo){ - IPage page = new Page(outportVo.getPage(),outportVo.getLimit()); - QueryWrapper queryWrapper = new QueryWrapper(); - //对供应商进行查询 - queryWrapper.eq(outportVo.getProviderid()!=null&&outportVo.getProviderid()!=0,"providerid",outportVo.getProviderid()); - //对商品进行查询 - queryWrapper.eq(outportVo.getGoodsid()!=null&&outportVo.getGoodsid()!=0,"goodsid",outportVo.getGoodsid()); - //对时间进行查询要求大于开始时间小于结束时间 - queryWrapper.ge(outportVo.getStartTime()!=null,"outputtime",outportVo.getStartTime()); - queryWrapper.le(outportVo.getEndTime()!=null,"outputtime",outportVo.getEndTime()); - //通过进货时间对商品进行排序 - queryWrapper.orderByDesc("outputtime"); - IPage page1 = outportService.page(page, queryWrapper); - List records = page1.getRecords(); - for (Outport ouport : records) { - Provider provider = providerService.getById(ouport.getProviderid()); - if (provider!=null){ - //设置供应商姓名 - ouport.setProvidername(provider.getProvidername()); + @RequestMapping("loadAllOutport") // 映射URL路径为"/outport/loadAllOutport" + public DataGridView loadAllOuport(OutportVo outportVo) { // 定义查询退货记录的方法 + IPage page = new Page<>(outportVo.getPage(), outportVo.getLimit()); // 创建分页对象，传入当前页和每页大小 + QueryWrapper queryWrapper = new QueryWrapper<>(); // 创建条件查询封装器 + queryWrapper.eq(outportVo.getProviderid() != null && outportVo.getProviderid() != 0, "providerid", outportVo.getProviderid()); // 如果供应商ID不为空且不为0，添加供应商查询条件 + queryWrapper.eq(outportVo.getGoodsid() != null && outportVo.getGoodsid() != 0, "goodsid", outportVo.getGoodsid()); // 如果商品ID不为空且不为0，添加商品查询条件 + queryWrapper.ge(outportVo.getStartTime() != null, "outputtime", outportVo.getStartTime()); // 如果开始时间不为空，添加起始时间查询条件 + queryWrapper.le(outportVo.getEndTime() != null, "outputtime", outportVo.getEndTime()); // 如果结束时间不为空，添加结束时间查询条件 + queryWrapper.orderByDesc("outputtime"); // 按退货时间倒序排序 + IPage page1 = outportService.page(page, queryWrapper); // 调用服务层分页查询方法 + List records = page1.getRecords(); // 获取分页查询结果中的记录列表 + for (Outport ouport : records) { // 遍历每条退货记录 + Provider provider = providerService.getById(ouport.getProviderid()); // 根据供应商ID查询供应商信息 + if (provider != null) { // 如果供应商信息存在 + ouport.setProvidername(provider.getProvidername()); // 设置退货记录中的供应商名称 } - Goods goods = goodsService.getById(ouport.getGoodsid()); - if (goods!=null){ - //设置商品名称 - ouport.setGoodsname(goods.getGoodsname()); - //设置商品规格 - ouport.setSize(goods.getSize()); + Goods goods = goodsService.getById(ouport.getGoodsid()); // 根据商品ID查询商品信息 + if (goods != null) { // 如果商品信息存在 + ouport.setGoodsname(goods.getGoodsname()); // 设置退货记录中的商品名称 + ouport.setSize(goods.getSize()); // 设置退货记录中的商品规格 } } - return new DataGridView(page1.getTotal(),page1.getRecords()); + return new DataGridView(page1.getTotal(), page1.getRecords()); // 返回分页数据和记录列表 } /** - * 删除退货信息 - * @param id - * @return + * 删除退货记录 + * @param id 退货记录ID + * @return 返回操作结果 */ - @RequestMapping("deleteOutport") - public ResultObj deleteOutport(Integer id){ + @RequestMapping("deleteOutport") // 映射URL路径为"/outport/deleteOutport" + public ResultObj deleteOutport(Integer id) { // 定义删除退货记录的方法 try { - outportService.removeById(id); - return ResultObj.DELETE_SUCCESS; - } catch (Exception e) { - e.printStackTrace(); - return ResultObj.DELETE_ERROR; + outportService.removeById(id); // 调用服务层方法，根据ID删除退货记录 + return ResultObj.DELETE_SUCCESS; // 返回操作成功的结果对象 + } catch (Exception e) { // 捕获异常 + e.printStackTrace(); // 打印异常信息到控制台 + return ResultObj.DELETE_ERROR; // 返回操作失败的结果对象 } } - - } - diff --git a/src/main/java/com/yeqifu/bus/controller/ProviderController.java b/src/main/java/com/yeqifu/bus/controller/ProviderController.java index 22c03cb..af38741 100644 --- a/src/main/java/com/yeqifu/bus/controller/ProviderController.java +++ b/src/main/java/com/yeqifu/bus/controller/ProviderController.java @@ -1,117 +1,177 @@ package com.yeqifu.bus.controller; - +// 声明类所在的包 import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper; +// 导入MyBatis-Plus的QueryWrapper类，用于条件查询 + import com.baomidou.mybatisplus.core.metadata.IPage; +// 导入MyBatis-Plus的IPage接口，用于分页 + import com.baomidou.mybatisplus.extension.plugins.pagination.Page; +// 导入MyBatis-Plus的Page类，用于创建分页对象 + import com.yeqifu.bus.entity.Provider; +// 导入Provider实体类，表示供应商信息 + import com.yeqifu.bus.service.IProviderService; +// 导入IProviderService接口，用于调用供应商相关的业务逻辑 + import com.yeqifu.bus.vo.ProviderVo; +// 导入ProviderVo类，封装供应商查询和操作的请求参数 + import com.yeqifu.sys.common.Constast; +// 导入Constast类，包含通用的常量定义 + import com.yeqifu.sys.common.DataGridView; +// 导入DataGridView类，用于返回表格数据格式 + import com.yeqifu.sys.common.ResultObj; +// 导入ResultObj类，用于返回操作结果的统一格式 + import org.apache.commons.lang3.StringUtils; +// 导入StringUtils工具类，用于字符串判空和处理 + import org.springframework.beans.factory.annotation.Autowired; +// 导入Spring框架的Autowired注解，用于自动注入Bean + import org.springframework.web.bind.annotation.RequestMapping; +// 导入RequestMapping注解，用于映射URL路径 + import org.springframework.web.bind.annotation.RestController; +// 导入RestController注解，标识为REST风格的控制器 import java.util.List; +// 导入Java的List接口，用于处理集合 /** - *

- * InnoDB free: 9216 kB 前端控制器 - *

- * - * @author luoyi- - * @since 2019-12-05 + * 供应商控制器类，负责供应商相关的增删改查和查询接口 */ @RestController +// 标识该类为REST风格的控制器，返回JSON格式数据 @RequestMapping("/provider") +// 将该类的基础URL路径设置为"/provider" public class ProviderController { @Autowired + // 自动注入IProviderService接口的实现类 private IProviderService providerService; /** * 查询所有的供应商 - * @param providerVo - * @return + * @param providerVo 封装查询参数的对象 + * @return 返回表格数据，包含供应商列表 */ @RequestMapping("loadAllProvider") - public DataGridView loadAllProvider(ProviderVo providerVo){ - //1.声明一个分页page对象 - IPage page = new Page(providerVo.getPage(),providerVo.getLimit()); - //2.声明一个queryWrapper - QueryWrapper queryWrapper = new QueryWrapper(); - queryWrapper.like(StringUtils.isNotBlank(providerVo.getProvidername()),"providername",providerVo.getProvidername()); - queryWrapper.like(StringUtils.isNotBlank(providerVo.getConnectionperson()),"connectionperson",providerVo.getConnectionperson()); - queryWrapper.like(StringUtils.isNotBlank(providerVo.getPhone()),"phone",providerVo.getPhone()); - providerService.page(page,queryWrapper); - return new DataGridView(page.getTotal(),page.getRecords()); + // 映射URL路径为"/provider/loadAllProvider" + public DataGridView loadAllProvider(ProviderVo providerVo) { + IPage page = new Page<>(providerVo.getPage(), providerVo.getLimit()); + // 创建分页对象，传入当前页和每页大小 + + QueryWrapper queryWrapper = new QueryWrapper<>(); + // 创建QueryWrapper对象，用于构造查询条件 + + queryWrapper.like(StringUtils.isNotBlank(providerVo.getProvidername()), "providername", providerVo.getProvidername()); + // 如果供应商名称不为空，添加模糊查询条件 + + queryWrapper.like(StringUtils.isNotBlank(providerVo.getConnectionperson()), "connectionperson", providerVo.getConnectionperson()); + // 如果联系人名称不为空，添加模糊查询条件 + + queryWrapper.like(StringUtils.isNotBlank(providerVo.getPhone()), "phone", providerVo.getPhone()); + // 如果联系方式不为空，添加模糊查询条件 + + providerService.page(page, queryWrapper); + // 调用服务层的分页查询方法 + + return new DataGridView(page.getTotal(), page.getRecords()); + // 返回DataGridView对象，包含总记录数和分页记录列表 } /** * 添加一个供应商 - * @param providerVo - * @return + * @param providerVo 封装供应商信息的对象 + * @return 返回操作结果 */ @RequestMapping("addProvider") - public ResultObj addProvider(ProviderVo providerVo){ + // 映射URL路径为"/provider/addProvider" + public ResultObj addProvider(ProviderVo providerVo) { try { providerService.save(providerVo); + // 调用服务层方法，保存供应商信息 + return ResultObj.ADD_SUCCESS; + // 返回操作成功的结果对象 } catch (Exception e) { e.printStackTrace(); + // 打印异常信息 + return ResultObj.ADD_ERROR; + // 返回操作失败的结果对象 } } /** * 修改一个供应商 - * @param providerVo - * @return + * @param providerVo 封装供应商信息的对象 + * @return 返回操作结果 */ @RequestMapping("updateProvider") - public ResultObj updateProvider(ProviderVo providerVo){ + // 映射URL路径为"/provider/updateProvider" + public ResultObj updateProvider(ProviderVo providerVo) { try { providerService.updateById(providerVo); + // 调用服务层方法，根据ID更新供应商信息 + return ResultObj.UPDATE_SUCCESS; + // 返回操作成功的结果对象 } catch (Exception e) { e.printStackTrace(); + // 打印异常信息 + return ResultObj.UPDATE_ERROR; + // 返回操作失败的结果对象 } } - /** * 删除一个供应商 - * @param id - * @return + * @param id 供应商ID + * @return 返回操作结果 */ @RequestMapping("deleteProvider") - public ResultObj deleteProvider(Integer id){ + // 映射URL路径为"/provider/deleteProvider" + public ResultObj deleteProvider(Integer id) { try { providerService.deleteProviderById(id); + // 调用服务层方法，根据ID删除供应商信息 + return ResultObj.DELETE_SUCCESS; + // 返回操作成功的结果对象 } catch (Exception e) { e.printStackTrace(); + // 打印异常信息 + return ResultObj.DELETE_ERROR; + // 返回操作失败的结果对象 } } - /** * 加载所有可用的供应商 - * @return + * @return 返回供应商列表 */ @RequestMapping("loadAllProviderForSelect") - public DataGridView loadAllProviderForSelect(){ - QueryWrapper queryWrapper = new QueryWrapper(); + // 映射URL路径为"/provider/loadAllProviderForSelect" + public DataGridView loadAllProviderForSelect() { + QueryWrapper queryWrapper = new QueryWrapper<>(); + // 创建QueryWrapper对象，用于构造查询条件 + queryWrapper.eq("available", Constast.AVAILABLE_TRUE); + // 查询条件为供应商状态可用 + List list = providerService.list(queryWrapper); + // 调用服务层方法，获取符合条件的供应商列表 + return new DataGridView(list); + // 返回DataGridView对象，包含供应商列表 } - - } - diff --git a/src/main/java/com/yeqifu/bus/controller/SalesController.java b/src/main/java/com/yeqifu/bus/controller/SalesController.java index 7c3c046..0ffe046 100644 --- a/src/main/java/com/yeqifu/bus/controller/SalesController.java +++ b/src/main/java/com/yeqifu/bus/controller/SalesController.java @@ -1,137 +1,219 @@ package com.yeqifu.bus.controller; - +// 声明类所在的包 import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper; +// 导入QueryWrapper类，用于构建查询条件 + import com.baomidou.mybatisplus.core.metadata.IPage; +// 导入IPage接口，用于分页功能 + import com.baomidou.mybatisplus.extension.plugins.pagination.Page; +// 导入Page类，用于创建分页对象 + import com.yeqifu.bus.entity.Customer; +// 导入Customer实体类，表示客户信息 + import com.yeqifu.bus.entity.Goods; +// 导入Goods实体类，表示商品信息 + import com.yeqifu.bus.entity.Sales; +// 导入Sales实体类，表示销售信息 + import com.yeqifu.bus.service.ICustomerService; +// 导入ICustomerService接口，用于处理客户业务逻辑 + import com.yeqifu.bus.service.IGoodsService; +// 导入IGoodsService接口，用于处理商品业务逻辑 + import com.yeqifu.bus.service.ISalesService; +// 导入ISalesService接口，用于处理销售信息的业务逻辑 + import com.yeqifu.bus.vo.SalesVo; +// 导入SalesVo类，用于封装查询参数 + import com.yeqifu.sys.common.DataGridView; +// 导入DataGridView类，用于返回表格数据 + import com.yeqifu.sys.common.ResultObj; +// 导入ResultObj类，用于统一返回操作结果 + import com.yeqifu.sys.common.WebUtils; +// 导入WebUtils工具类，用于处理会话信息 + import com.yeqifu.sys.entity.User; +// 导入User实体类，表示用户信息 + import org.springframework.beans.factory.annotation.Autowired; +// 导入@Autowired注解，用于自动注入服务对象 + import org.springframework.web.bind.annotation.RequestMapping; +// 导入@RequestMapping注解，用于映射请求路径 + import org.springframework.web.bind.annotation.RestController; +// 导入@RestController注解，标识该类为REST控制器 import java.util.Date; +// 导入Date类，用于处理日期时间 + import java.util.List; +// 导入Java集合类List，用于处理列表数据 /** - *

- * InnoDB free: 9216 kB 前端控制器 - *

- * - * @author luoyi- - * @since 2019-12-21 + * 商品销售控制器类 + * 负责处理与商品销售信息相关的请求 */ @RestController +// 标识该类为REST风格的控制器 @RequestMapping("/sales") +// 将类的基础URL路径映射为"/sales" public class SalesController { @Autowired + // 自动注入ISalesService接口的实现类 private ISalesService salesService; @Autowired + // 自动注入ICustomerService接口的实现类 private ICustomerService customerService; @Autowired + // 自动注入IGoodsService接口的实现类 private IGoodsService goodsService; /** * 查询所有商品销售信息 - * @param salesVo - * @return + * @param salesVo 封装查询参数的对象 + * @return 返回表格数据 */ @RequestMapping("loadAllSales") - public DataGridView loadAllSales(SalesVo salesVo){ - IPage page = new Page<>(salesVo.getPage(),salesVo.getLimit()); - QueryWrapper queryWrapper = new QueryWrapper(); - //根据客户进行模糊查询 - queryWrapper.eq(salesVo.getCustomerid()!=null&&salesVo.getCustomerid()!=0,"customerid",salesVo.getCustomerid()); - //根据商品模糊查询 - queryWrapper.eq(salesVo.getGoodsid()!=null&&salesVo.getGoodsid()!=0,"goodsid",salesVo.getGoodsid()); - //根据时间进行模糊查询 - queryWrapper.ge(salesVo.getStartTime()!=null,"salestime",salesVo.getStartTime()); - queryWrapper.le(salesVo.getEndTime()!=null,"salestime",salesVo.getEndTime()); + // 映射URL路径为"/sales/loadAllSales" + public DataGridView loadAllSales(SalesVo salesVo) { + IPage page = new Page<>(salesVo.getPage(), salesVo.getLimit()); + // 创建分页对象，指定当前页和每页记录数 + + QueryWrapper queryWrapper = new QueryWrapper<>(); + // 创建QueryWrapper对象，用于构建查询条件 + + queryWrapper.eq(salesVo.getCustomerid() != null && salesVo.getCustomerid() != 0, "customerid", salesVo.getCustomerid()); + // 如果客户ID不为空且不为0，添加客户ID的查询条件 + + queryWrapper.eq(salesVo.getGoodsid() != null && salesVo.getGoodsid() != 0, "goodsid", salesVo.getGoodsid()); + // 如果商品ID不为空且不为0，添加商品ID的查询条件 + + queryWrapper.ge(salesVo.getStartTime() != null, "salestime", salesVo.getStartTime()); + // 如果开始时间不为空，添加大于等于开始时间的查询条件 + + queryWrapper.le(salesVo.getEndTime() != null, "salestime", salesVo.getEndTime()); + // 如果结束时间不为空，添加小于等于结束时间的查询条件 + IPage page1 = salesService.page(page, queryWrapper); + // 调用服务层分页查询方法，获取分页数据 + List records = page1.getRecords(); + // 获取分页记录列表 + for (Sales sales : records) { - //设置客户姓名 + // 遍历销售信息列表 + Customer customer = customerService.getById(sales.getCustomerid()); - if(null!=customer){ + // 根据销售信息中的客户ID查询客户信息 + + if (null != customer) { sales.setCustomername(customer.getCustomername()); + // 如果客户信息存在，设置客户名称 } - //设置商品名称 + Goods goods = goodsService.getById(sales.getGoodsid()); - if (null!=goods){ - //设置商品名称 + // 根据销售信息中的商品ID查询商品信息 + + if (null != goods) { sales.setGoodsname(goods.getGoodsname()); - //设置商品规格 + // 如果商品信息存在，设置商品名称 + sales.setSize(goods.getSize()); + // 设置商品规格 } } - return new DataGridView(page1.getTotal(),page1.getRecords()); + + return new DataGridView(page1.getTotal(), page1.getRecords()); + // 返回DataGridView对象，包含总记录数和分页记录列表 } /** * 添加商品销售信息 - * @param salesVo - * @return + * @param salesVo 封装销售信息的对象 + * @return 返回操作结果 */ @RequestMapping("addSales") - public ResultObj addSales(SalesVo salesVo){ + // 映射URL路径为"/sales/addSales" + public ResultObj addSales(SalesVo salesVo) { try { - //获得当前系统用户 User user = (User) WebUtils.getSession().getAttribute("user"); - //设置操作人 + // 从会话中获取当前系统用户 + salesVo.setOperateperson(user.getName()); - //设置销售时间 + // 设置操作人姓名 + salesVo.setSalestime(new Date()); + // 设置销售时间为当前时间 + salesService.save(salesVo); + // 调用服务层方法保存销售信息 + return ResultObj.ADD_SUCCESS; - }catch (Exception e) { + // 返回添加成功的结果对象 + } catch (Exception e) { e.printStackTrace(); + // 打印异常信息 + return ResultObj.ADD_ERROR; + // 返回添加失败的结果对象 } } /** * 更新商品销售信息 - * @param salesVo - * @return + * @param salesVo 封装需要更新的销售信息 + * @return 返回操作结果 */ @RequestMapping("updateSales") - public ResultObj updateSales(SalesVo salesVo){ + // 映射URL路径为"/sales/updateSales" + public ResultObj updateSales(SalesVo salesVo) { try { salesService.updateById(salesVo); + // 调用服务层方法根据ID更新销售信息 + return ResultObj.UPDATE_SUCCESS; + // 返回更新成功的结果对象 } catch (Exception e) { e.printStackTrace(); + // 打印异常信息 + return ResultObj.UPDATE_ERROR; + // 返回更新失败的结果对象 } } /** * 删除商品销售信息 - * @param id - * @return + * @param id 要删除的销售信息ID + * @return 返回操作结果 */ @RequestMapping("deleteSales") - public ResultObj deleteSales(Integer id){ + // 映射URL路径为"/sales/deleteSales" + public ResultObj deleteSales(Integer id) { try { salesService.removeById(id); + // 调用服务层方法根据ID删除销售信息 + return ResultObj.DELETE_SUCCESS; + // 返回删除成功的结果对象 } catch (Exception e) { e.printStackTrace(); + // 打印异常信息 + return ResultObj.DELETE_ERROR; + // 返回删除失败的结果对象 } } - } - diff --git a/src/main/java/com/yeqifu/bus/controller/SalesbackController.java b/src/main/java/com/yeqifu/bus/controller/SalesbackController.java index 05a1e77..878036a 100644 --- a/src/main/java/com/yeqifu/bus/controller/SalesbackController.java +++ b/src/main/java/com/yeqifu/bus/controller/SalesbackController.java @@ -1,116 +1,182 @@ package com.yeqifu.bus.controller; - +// 声明类所在的包 import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper; +// 导入QueryWrapper类，用于构建查询条件 + import com.baomidou.mybatisplus.core.metadata.IPage; +// 导入IPage接口，用于分页功能 + import com.baomidou.mybatisplus.extension.plugins.pagination.Page; +// 导入Page类，用于创建分页对象 + import com.yeqifu.bus.entity.Customer; +// 导入Customer实体类，表示客户信息 + import com.yeqifu.bus.entity.Goods; +// 导入Goods实体类，表示商品信息 + import com.yeqifu.bus.entity.Salesback; +// 导入Salesback实体类，表示销售退货信息 + import com.yeqifu.bus.service.ICustomerService; +// 导入ICustomerService接口，用于处理客户业务逻辑 + import com.yeqifu.bus.service.IGoodsService; +// 导入IGoodsService接口，用于处理商品业务逻辑 + import com.yeqifu.bus.service.ISalesbackService; +// 导入ISalesbackService接口，用于处理销售退货业务逻辑 + import com.yeqifu.bus.vo.SalesbackVo; +// 导入SalesbackVo类，用于封装查询参数 + import com.yeqifu.sys.common.DataGridView; +// 导入DataGridView类，用于返回表格数据 + import com.yeqifu.sys.common.ResultObj; +// 导入ResultObj类，用于统一返回操作结果 + import org.springframework.beans.factory.annotation.Autowired; +// 导入@Autowired注解，用于自动注入服务对象 + import org.springframework.web.bind.annotation.RequestMapping; +// 导入@RequestMapping注解，用于映射请求路径 + import org.springframework.web.bind.annotation.RestController; +// 导入@RestController注解，标识该类为REST控制器 import java.util.List; +// 导入Java集合类List，用于处理列表数据 /** - *

- * InnoDB free: 9216 kB 前端控制器 - *

- * - * @author luoyi- - * @since 2019-12-23 + * 销售退货控制器类 + * 负责处理与销售退货相关的请求 */ @RestController +// 标识该类为REST风格的控制器 @RequestMapping("/salesback") +// 将类的基础URL路径映射为"/salesback" public class SalesbackController { @Autowired + // 自动注入ISalesbackService接口的实现类 private ISalesbackService salesbackService; @Autowired + // 自动注入ICustomerService接口的实现类 private ICustomerService customerService; @Autowired + // 自动注入IGoodsService接口的实现类 private IGoodsService goodsService; /** * 添加退货信息 - * @param id 进货单ID - * @param number 退货数量 - * @param remark 备注 - * @return + * @param id 退货的销售单ID + * @param number 退货数量 + * @param remark 备注信息 + * @return 返回操作结果 */ @RequestMapping("addSalesback") - public ResultObj addSalesback(Integer id,Integer number,String remark){ + // 映射URL路径为"/salesback/addSalesback" + public ResultObj addSalesback(Integer id, Integer number, String remark) { try { - salesbackService.addSalesback(id,number,remark); + salesbackService.addSalesback(id, number, remark); + // 调用服务层方法添加退货记录 + return ResultObj.BACKINPORT_SUCCESS; + // 返回退货成功的结果对象 } catch (Exception e) { e.printStackTrace(); + // 打印异常信息 + return ResultObj.BACKINPORT_ERROR; + // 返回退货失败的结果对象 } } /** - * 查询商品销售退货 - * @param salesbackVo - * @return + * 查询商品销售退货记录 + * @param salesbackVo 封装查询参数的对象 + * @return 返回表格数据 */ @RequestMapping("loadAllSalesback") - public DataGridView loadAllSalesback(SalesbackVo salesbackVo){ - IPage page = new Page(salesbackVo.getPage(),salesbackVo.getLimit()); - QueryWrapper queryWrapper = new QueryWrapper(); - //对客户进行查询 - queryWrapper.eq(salesbackVo.getCustomerid()!=null&&salesbackVo.getCustomerid()!=0,"customerid",salesbackVo.getCustomerid()); - //对商品进行查询 - queryWrapper.eq(salesbackVo.getGoodsid()!=null&&salesbackVo.getGoodsid()!=0,"goodsid",salesbackVo.getGoodsid()); - //对时间进行查询要求大于开始时间小于结束时间 - queryWrapper.ge(salesbackVo.getStartTime()!=null,"salesbacktime",salesbackVo.getStartTime()); - queryWrapper.le(salesbackVo.getEndTime()!=null,"salesbacktime",salesbackVo.getEndTime()); - //通过商品退货时间对商品进行排序 + // 映射URL路径为"/salesback/loadAllSalesback" + public DataGridView loadAllSalesback(SalesbackVo salesbackVo) { + IPage page = new Page<>(salesbackVo.getPage(), salesbackVo.getLimit()); + // 创建分页对象，指定当前页和每页记录数 + + QueryWrapper queryWrapper = new QueryWrapper<>(); + // 创建QueryWrapper对象，用于构建查询条件 + + queryWrapper.eq(salesbackVo.getCustomerid() != null && salesbackVo.getCustomerid() != 0, "customerid", salesbackVo.getCustomerid()); + // 如果客户ID不为空且不为0，添加客户ID的查询条件 + + queryWrapper.eq(salesbackVo.getGoodsid() != null && salesbackVo.getGoodsid() != 0, "goodsid", salesbackVo.getGoodsid()); + // 如果商品ID不为空且不为0，添加商品ID的查询条件 + + queryWrapper.ge(salesbackVo.getStartTime() != null, "salesbacktime", salesbackVo.getStartTime()); + // 如果开始时间不为空，添加大于等于开始时间的查询条件 + + queryWrapper.le(salesbackVo.getEndTime() != null, "salesbacktime", salesbackVo.getEndTime()); + // 如果结束时间不为空，添加小于等于结束时间的查询条件 + queryWrapper.orderByDesc("salesbacktime"); + // 按照退货时间降序排列 + salesbackService.page(page, queryWrapper); + // 调用服务层分页查询方法，获取分页数据 + List records = page.getRecords(); + // 获取分页记录列表 + for (Salesback salesback : records) { - System.out.println("============================"); + // 遍历退货记录列表 Customer customer = customerService.getById(salesback.getCustomerid()); - if (customer!=null){ - //设置客户姓名 + // 根据退货记录中的客户ID查询客户信息 + + if (customer != null) { salesback.setCustomername(customer.getCustomername()); + // 如果客户信息存在，设置客户名称 } + Goods goods = goodsService.getById(salesback.getGoodsid()); - if (goods!=null){ - //设置商品名称 + // 根据退货记录中的商品ID查询商品信息 + + if (goods != null) { salesback.setGoodsname(goods.getGoodsname()); - //设置商品规格 + // 如果商品信息存在，设置商品名称 + salesback.setSize(goods.getSize()); + // 设置商品规格 } } - return new DataGridView(page.getTotal(),page.getRecords()); + + return new DataGridView(page.getTotal(), page.getRecords()); + // 返回DataGridView对象，包含总记录数和分页记录列表 } /** - * 删除商品销售退回信息 - * @param id - * @return + * 删除商品销售退货记录 + * @param id 要删除的退货记录ID + * @return 返回操作结果 */ @RequestMapping("deleteSalesback") - public ResultObj deleteSalesback(Integer id){ + // 映射URL路径为"/salesback/deleteSalesback" + public ResultObj deleteSalesback(Integer id) { try { salesbackService.removeById(id); + // 调用服务层方法，根据ID删除退货记录 + return ResultObj.DELETE_SUCCESS; + // 返回删除成功的结果对象 } catch (Exception e) { e.printStackTrace(); + // 打印异常信息 + return ResultObj.DELETE_ERROR; + // 返回删除失败的结果对象 } } - } - From 6fad05f1a2dd2d6f010cbbf580d0d8b6e63ea51d Mon Sep 17 00:00:00 2001 From: STAR <3308186939@qq.com> Date: Tue, 17 Dec 2024 15:37:14 +0800 Subject: [PATCH 05/13] 12/15 --- .../java/com/yeqifu/bus/entity/Goods.java | 70 +++++++++---------- 1 file changed, 34 insertions(+), 36 deletions(-) diff --git a/src/main/java/com/yeqifu/bus/entity/Goods.java b/src/main/java/com/yeqifu/bus/entity/Goods.java index 70be889..564ea97 100644 --- a/src/main/java/com/yeqifu/bus/entity/Goods.java +++ b/src/main/java/com/yeqifu/bus/entity/Goods.java @@ -1,15 +1,15 @@ -package com.yeqifu.bus.entity; +package com.yeqifu.bus.entity; // 包名 -import com.baomidou.mybatisplus.annotation.IdType; -import com.baomidou.mybatisplus.annotation.TableField; -import com.baomidou.mybatisplus.annotation.TableId; -import com.baomidou.mybatisplus.annotation.TableName; -import lombok.Data; -import lombok.EqualsAndHashCode; -import lombok.ToString; -import lombok.experimental.Accessors; +import com.baomidou.mybatisplus.annotation.IdType; // MyBatis-Plus主键类型注解 +import com.baomidou.mybatisplus.annotation.TableField; // MyBatis-Plus字段映射注解 +import com.baomidou.mybatisplus.annotation.TableId; // MyBatis-Plus主键注解 +import com.baomidou.mybatisplus.annotation.TableName; // MyBatis-Plus表名注解 +import lombok.Data; // Lombok注解，自动生成getter和setter +import lombok.EqualsAndHashCode; // Lombok注解，自动生成equals和hashCode方法 +import lombok.ToString; // Lombok注解，自动生成toString方法 +import lombok.experimental.Accessors; // Lombok注解，支持链式调用 -import java.io.Serializable; +import java.io.Serializable; // 序列化接口 /** *

@@ -19,46 +19,44 @@ import java.io.Serializable; * @author luoyi- * @since 2019-12-06 */ -@Data -@EqualsAndHashCode(callSuper = false) -@Accessors(chain = true) -@TableName("bus_goods") -@ToString -public class Goods implements Serializable { +@Data // Lombok注解，自动生成getter和setter方法 +@EqualsAndHashCode(callSuper = false) // Lombok注解，重写equals和hashCode方法，且不调用父类 +@Accessors(chain = true) // Lombok注解，支持链式调用 +@TableName("bus_goods") // MyBatis-Plus注解，指定表名为bus_goods +@ToString // Lombok注解，自动生成toString方法 +public class Goods implements Serializable { // 定义Goods类，实现Serializable接口 - private static final long serialVersionUID=1L; + private static final long serialVersionUID = 1L; // 序列化版本号 - @TableId(value = "id", type = IdType.AUTO) - private Integer id; + @TableId(value = "id", type = IdType.AUTO) // MyBatis-Plus注解，指定主键字段id为自增类型 + private Integer id; // 商品ID - private String goodsname; + private String goodsname; // 商品名称 - private String produceplace; + private String produceplace; // 生产地 - private String size; + private String size; // 商品规格 - private String goodspackage; + private String goodspackage; // 商品包装 - private String productcode; + private String productcode; // 商品编码 - private String promitcode; + private String promitcode; // 批准文号 - private String description; + private String description; // 商品描述 - private Double price; + private Double price; // 商品价格 - private Integer number; + private Integer number; // 商品库存数量 - private Integer dangernum; + private Integer dangernum; // 商品警戒库存数量 - private String goodsimg; + private String goodsimg; // 商品图片地址 - private Integer available; - - private Integer providerid; - - @TableField(exist = false) - private String providername; + private Integer available; // 商品是否可用，1表示可用，0表示不可用 + private Integer providerid; // 供应商ID，外键关联供应商表 + @TableField(exist = false) // MyBatis-Plus注解，表示此字段在数据库表中不存在 + private String providername; // 供应商名称（冗余字段，用于显示） } From efd7438fbd9b422d3db003d9bb5d286eeb8dd6ef Mon Sep 17 00:00:00 2001 From: STAR <3308186939@qq.com> Date: Tue, 17 Dec 2024 15:44:35 +0800 Subject: [PATCH 06/13] 12/15 --- .../java/com/yeqifu/bus/entity/Inport.java | 64 +++++++++--------- .../java/com/yeqifu/bus/entity/Outport.java | 66 ++++++++++--------- 2 files changed, 66 insertions(+), 64 deletions(-) diff --git a/src/main/java/com/yeqifu/bus/entity/Inport.java b/src/main/java/com/yeqifu/bus/entity/Inport.java index 1d7b0ef..01f8b21 100644 --- a/src/main/java/com/yeqifu/bus/entity/Inport.java +++ b/src/main/java/com/yeqifu/bus/entity/Inport.java @@ -1,15 +1,15 @@ -package com.yeqifu.bus.entity; +package com.yeqifu.bus.entity; // 包名 -import com.baomidou.mybatisplus.annotation.IdType; -import com.baomidou.mybatisplus.annotation.TableField; -import com.baomidou.mybatisplus.annotation.TableId; -import com.baomidou.mybatisplus.annotation.TableName; -import lombok.Data; -import lombok.EqualsAndHashCode; -import lombok.experimental.Accessors; +import com.baomidou.mybatisplus.annotation.IdType; // MyBatis-Plus主键类型注解 +import com.baomidou.mybatisplus.annotation.TableField; // MyBatis-Plus字段映射注解 +import com.baomidou.mybatisplus.annotation.TableId; // MyBatis-Plus主键注解 +import com.baomidou.mybatisplus.annotation.TableName; // MyBatis-Plus表名注解 +import lombok.Data; // Lombok注解，自动生成getter和setter方法 +import lombok.EqualsAndHashCode; // Lombok注解，自动生成equals和hashCode方法 +import lombok.experimental.Accessors; // Lombok注解，支持链式调用 -import java.io.Serializable; -import java.util.Date; +import java.io.Serializable; // 序列化接口 +import java.util.Date; // 日期类 /** *

@@ -19,49 +19,49 @@ import java.util.Date; * @author luoyi- * @since 2019-12-18 */ -@Data -@EqualsAndHashCode(callSuper = false) -@Accessors(chain = true) -@TableName("bus_inport") -public class Inport implements Serializable { +@Data // Lombok注解，自动生成getter和setter方法 +@EqualsAndHashCode(callSuper = false) // Lombok注解，重写equals和hashCode方法，不调用父类 +@Accessors(chain = true) // Lombok注解，支持链式调用 +@TableName("bus_inport") // MyBatis-Plus注解，指定表名为bus_inport +public class Inport implements Serializable { // 定义Inport类，实现Serializable接口 - private static final long serialVersionUID=1L; + private static final long serialVersionUID = 1L; // 序列化版本号 - @TableId(value = "id", type = IdType.AUTO) - private Integer id; + @TableId(value = "id", type = IdType.AUTO) // MyBatis-Plus注解，指定主键字段id为自增类型 + private Integer id; // 入库单ID - private String paytype; + private String paytype; // 支付类型 - private Date inporttime; + private Date inporttime; // 入库时间 - private String operateperson; + private String operateperson; // 操作员姓名 - private Integer number; + private Integer number; // 入库数量 - private String remark; + private String remark; // 备注信息 - private Double inportprice; + private Double inportprice; // 入库价格 - private Integer providerid; + private Integer providerid; // 供应商ID，外键关联供应商表 - private Integer goodsid; + private Integer goodsid; // 商品ID，外键关联商品表 /** * 供应商姓名 */ - @TableField(exist = false) - private String providername; + @TableField(exist = false) // MyBatis-Plus注解，表示此字段在数据库表中不存在 + private String providername; // 供应商名称（冗余字段，用于显示） /** * 商品名称 */ - @TableField(exist = false) - private String goodsname; + @TableField(exist = false) // MyBatis-Plus注解，表示此字段在数据库表中不存在 + private String goodsname; // 商品名称（冗余字段，用于显示） /** * 商品规格 */ - @TableField(exist = false) - private String size; + @TableField(exist = false) // MyBatis-Plus注解，表示此字段在数据库表中不存在 + private String size; // 商品规格（冗余字段，用于显示） } diff --git a/src/main/java/com/yeqifu/bus/entity/Outport.java b/src/main/java/com/yeqifu/bus/entity/Outport.java index 09e02ac..cc57664 100644 --- a/src/main/java/com/yeqifu/bus/entity/Outport.java +++ b/src/main/java/com/yeqifu/bus/entity/Outport.java @@ -1,67 +1,69 @@ -package com.yeqifu.bus.entity; +package com.yeqifu.bus.entity; // 包名 -import com.baomidou.mybatisplus.annotation.IdType; -import com.baomidou.mybatisplus.annotation.TableField; -import com.baomidou.mybatisplus.annotation.TableId; -import com.baomidou.mybatisplus.annotation.TableName; -import lombok.Data; -import lombok.EqualsAndHashCode; -import lombok.experimental.Accessors; +import com.baomidou.mybatisplus.annotation.IdType; // MyBatis-Plus主键类型注解 +import com.baomidou.mybatisplus.annotation.TableField; // MyBatis-Plus字段映射注解 +import com.baomidou.mybatisplus.annotation.TableId; // MyBatis-Plus主键注解 +import com.baomidou.mybatisplus.annotation.TableName; // MyBatis-Plus表名注解 +import lombok.Data; // Lombok注解，自动生成getter和setter方法 +import lombok.EqualsAndHashCode; // Lombok注解，自动生成equals和hashCode方法 +import lombok.experimental.Accessors; // Lombok注解，支持链式调用 -import java.io.Serializable; -import java.util.Date; +import java.io.Serializable; // 序列化接口 +import java.util.Date; // 日期类 /** *

* InnoDB free: 9216 kB *

* + * 出库表实体类，用于描述商品出库记录 + * * @author luoyi- * @since 2019-12-19 */ -@Data -@EqualsAndHashCode(callSuper = false) -@Accessors(chain = true) -@TableName("bus_outport") -public class Outport implements Serializable { +@Data // Lombok注解，自动生成getter和setter方法 +@EqualsAndHashCode(callSuper = false) // Lombok注解，重写equals和hashCode方法，不调用父类 +@Accessors(chain = true) // Lombok注解，支持链式调用 +@TableName("bus_outport") // MyBatis-Plus注解，指定表名为bus_outport +public class Outport implements Serializable { // 定义Outport类，实现Serializable接口 - private static final long serialVersionUID=1L; + private static final long serialVersionUID = 1L; // 序列化版本号 - @TableId(value = "id", type = IdType.AUTO) - private Integer id; + @TableId(value = "id", type = IdType.AUTO) // MyBatis-Plus注解，指定主键字段id为自增类型 + private Integer id; // 出库单ID - private Integer providerid; + private Integer providerid; // 供应商ID，外键关联供应商表 - private String paytype; + private String paytype; // 支付类型 - private Date outputtime; + private Date outputtime; // 出库时间 - private String operateperson; + private String operateperson; // 操作员姓名 - private Double outportprice; + private Double outportprice; // 出库价格 - private Integer number; + private Integer number; // 出库数量 - private String remark; + private String remark; // 备注信息 - private Integer goodsid; + private Integer goodsid; // 商品ID，外键关联商品表 /** * 供应商姓名 */ - @TableField(exist = false) - private String providername; + @TableField(exist = false) // MyBatis-Plus注解，表示此字段在数据库表中不存在 + private String providername; // 供应商名称（冗余字段，用于显示） /** * 商品名称 */ - @TableField(exist = false) - private String goodsname; + @TableField(exist = false) // MyBatis-Plus注解，表示此字段在数据库表中不存在 + private String goodsname; // 商品名称（冗余字段，用于显示） /** * 商品规格 */ - @TableField(exist = false) - private String size; + @TableField(exist = false) // MyBatis-Plus注解，表示此字段在数据库表中不存在 + private String size; // 商品规格（冗余字段，用于显示） } From f1af3e872cd251f2a7a0411fcee9c3fd9e414701 Mon Sep 17 00:00:00 2001 From: STAR <3308186939@qq.com> Date: Tue, 17 Dec 2024 15:48:11 +0800 Subject: [PATCH 07/13] 12/15 --- .../java/com/yeqifu/bus/entity/Provider.java | 60 ++++++++--------- .../java/com/yeqifu/bus/entity/Sales.java | 66 +++++++++---------- .../java/com/yeqifu/bus/entity/Salesback.java | 66 +++++++++---------- 3 files changed, 96 insertions(+), 96 deletions(-) diff --git a/src/main/java/com/yeqifu/bus/entity/Provider.java b/src/main/java/com/yeqifu/bus/entity/Provider.java index 6301b11..ad5f6c7 100644 --- a/src/main/java/com/yeqifu/bus/entity/Provider.java +++ b/src/main/java/com/yeqifu/bus/entity/Provider.java @@ -1,56 +1,56 @@ -package com.yeqifu.bus.entity; +package com.yeqifu.bus.entity; // 包名 -import com.baomidou.mybatisplus.annotation.IdType; -import com.baomidou.mybatisplus.annotation.TableId; -import com.baomidou.mybatisplus.annotation.TableName; -import lombok.Data; -import lombok.EqualsAndHashCode; -import lombok.ToString; -import lombok.experimental.Accessors; +import com.baomidou.mybatisplus.annotation.IdType; // MyBatis-Plus主键类型注解 +import com.baomidou.mybatisplus.annotation.TableId; // MyBatis-Plus主键注解 +import com.baomidou.mybatisplus.annotation.TableName; // MyBatis-Plus表名注解 +import lombok.Data; // Lombok注解，自动生成getter和setter方法 +import lombok.EqualsAndHashCode; // Lombok注解，自动生成equals和hashCode方法 +import lombok.ToString; // Lombok注解，自动生成toString方法 +import lombok.experimental.Accessors; // Lombok注解，支持链式调用 -import java.io.Serializable; +import java.io.Serializable; // 序列化接口 /** *

+ * 供应商实体类，用于描述供应商信息 * InnoDB free: 9216 kB *

* * @author luoyi- * @since 2019-12-05 */ -@Data -@EqualsAndHashCode(callSuper = false) -@Accessors(chain = true) -@TableName("bus_provider") -@ToString -public class Provider implements Serializable { +@Data // Lombok注解，自动生成getter和setter方法 +@EqualsAndHashCode(callSuper = false) // Lombok注解，重写equals和hashCode方法，不调用父类 +@Accessors(chain = true) // Lombok注解，支持链式调用 +@TableName("bus_provider") // MyBatis-Plus注解，指定表名为bus_provider +@ToString // Lombok注解，自动生成toString方法 +public class Provider implements Serializable { // 定义Provider类，实现Serializable接口 - private static final long serialVersionUID=1L; + private static final long serialVersionUID = 1L; // 序列化版本号 - @TableId(value = "id", type = IdType.AUTO) - private Integer id; + @TableId(value = "id", type = IdType.AUTO) // MyBatis-Plus注解，指定主键字段id为自增类型 + private Integer id; // 供应商ID - private String providername; + private String providername; // 供应商名称 - private String zip; + private String zip; // 邮政编码 - private String address; + private String address; // 供应商地址 - private String telephone; + private String telephone; // 供应商联系电话 - private String connectionperson; + private String connectionperson; // 联系人姓名 - private String phone; + private String phone; // 联系人手机号码 - private String bank; + private String bank; // 开户银行 - private String account; + private String account; // 银行账号 - private String email; + private String email; // 电子邮箱 - private String fax; - - private Integer available; + private String fax; // 传真号码 + private Integer available; // 是否可用，1表示可用，0表示不可用 } diff --git a/src/main/java/com/yeqifu/bus/entity/Sales.java b/src/main/java/com/yeqifu/bus/entity/Sales.java index 4dc450c..b29c5aa 100644 --- a/src/main/java/com/yeqifu/bus/entity/Sales.java +++ b/src/main/java/com/yeqifu/bus/entity/Sales.java @@ -1,67 +1,67 @@ -package com.yeqifu.bus.entity; +package com.yeqifu.bus.entity; // 包名 -import com.baomidou.mybatisplus.annotation.IdType; -import com.baomidou.mybatisplus.annotation.TableField; -import com.baomidou.mybatisplus.annotation.TableId; -import com.baomidou.mybatisplus.annotation.TableName; -import lombok.Data; -import lombok.EqualsAndHashCode; -import lombok.experimental.Accessors; +import com.baomidou.mybatisplus.annotation.IdType; // MyBatis-Plus主键类型注解 +import com.baomidou.mybatisplus.annotation.TableField; // MyBatis-Plus字段映射注解 +import com.baomidou.mybatisplus.annotation.TableId; // MyBatis-Plus主键注解 +import com.baomidou.mybatisplus.annotation.TableName; // MyBatis-Plus表名注解 +import lombok.Data; // Lombok注解，自动生成getter和setter方法 +import lombok.EqualsAndHashCode; // Lombok注解，自动生成equals和hashCode方法 +import lombok.experimental.Accessors; // Lombok注解，支持链式调用 -import java.io.Serializable; -import java.util.Date; +import java.io.Serializable; // 序列化接口 +import java.util.Date; // 日期类 /** *

+ * 销售记录实体类，用于描述销售信息 * InnoDB free: 9216 kB *

* - * @author luoyi- * @since 2019-12-21 */ -@Data -@EqualsAndHashCode(callSuper = false) -@Accessors(chain = true) -@TableName("bus_sales") -public class Sales implements Serializable { +@Data // Lombok注解，自动生成getter和setter方法 +@EqualsAndHashCode(callSuper = false) // Lombok注解，重写equals和hashCode方法，不调用父类 +@Accessors(chain = true) // Lombok注解，支持链式调用 +@TableName("bus_sales") // MyBatis-Plus注解，指定表名为bus_sales +public class Sales implements Serializable { // 定义Sales类，实现Serializable接口 - private static final long serialVersionUID=1L; + private static final long serialVersionUID = 1L; // 序列化版本号 - @TableId(value = "id", type = IdType.AUTO) - private Integer id; + @TableId(value = "id", type = IdType.AUTO) // MyBatis-Plus注解，指定主键字段id为自增类型 + private Integer id; // 销售记录ID - private Integer customerid; + private Integer customerid; // 客户ID，外键关联客户表 - private String paytype; + private String paytype; // 支付类型 - private Date salestime; + private Date salestime; // 销售时间 - private String operateperson; + private String operateperson; // 操作员姓名 - private Integer number; + private Integer number; // 销售数量 - private String remark; + private String remark; // 备注信息 - private Double saleprice; + private Double saleprice; // 销售价格 - private Integer goodsid; + private Integer goodsid; // 商品ID，外键关联商品表 /** * 客户名称 */ - @TableField(exist = false) - private String customername; + @TableField(exist = false) // MyBatis-Plus注解，表示此字段在数据库表中不存在 + private String customername; // 客户名称（冗余字段，用于显示） /** * 商品名称 */ - @TableField(exist = false) - private String goodsname; + @TableField(exist = false) // MyBatis-Plus注解，表示此字段在数据库表中不存在 + private String goodsname; // 商品名称（冗余字段，用于显示） /** * 商品规格 */ - @TableField(exist = false) - private String size; + @TableField(exist = false) // MyBatis-Plus注解，表示此字段在数据库表中不存在 + private String size; // 商品规格（冗余字段，用于显示） } diff --git a/src/main/java/com/yeqifu/bus/entity/Salesback.java b/src/main/java/com/yeqifu/bus/entity/Salesback.java index e385b78..9f6bc04 100644 --- a/src/main/java/com/yeqifu/bus/entity/Salesback.java +++ b/src/main/java/com/yeqifu/bus/entity/Salesback.java @@ -1,67 +1,67 @@ -package com.yeqifu.bus.entity; +package com.yeqifu.bus.entity; // 包名 -import com.baomidou.mybatisplus.annotation.IdType; -import com.baomidou.mybatisplus.annotation.TableField; -import com.baomidou.mybatisplus.annotation.TableId; -import com.baomidou.mybatisplus.annotation.TableName; -import lombok.Data; -import lombok.EqualsAndHashCode; -import lombok.experimental.Accessors; +import com.baomidou.mybatisplus.annotation.IdType; // MyBatis-Plus主键类型注解 +import com.baomidou.mybatisplus.annotation.TableField; // MyBatis-Plus字段映射注解 +import com.baomidou.mybatisplus.annotation.TableId; // MyBatis-Plus主键注解 +import com.baomidou.mybatisplus.annotation.TableName; // MyBatis-Plus表名注解 +import lombok.Data; // Lombok注解，自动生成getter和setter方法 +import lombok.EqualsAndHashCode; // Lombok注解，自动生成equals和hashCode方法 +import lombok.experimental.Accessors; // Lombok注解，支持链式调用 -import java.io.Serializable; -import java.util.Date; +import java.io.Serializable; // 序列化接口 +import java.util.Date; // 日期类 /** *

+ * 销售退货记录实体类，用于描述销售退货信息 * InnoDB free: 9216 kB *

* - * @author luoyi- * @since 2019-12-23 */ -@Data -@EqualsAndHashCode(callSuper = false) -@Accessors(chain = true) -@TableName("bus_salesback") -public class Salesback implements Serializable { +@Data // Lombok注解，自动生成getter和setter方法 +@EqualsAndHashCode(callSuper = false) // Lombok注解，重写equals和hashCode方法，不调用父类 +@Accessors(chain = true) // Lombok注解，支持链式调用 +@TableName("bus_salesback") // MyBatis-Plus注解，指定表名为bus_salesback +public class Salesback implements Serializable { // 定义Salesback类，实现Serializable接口 - private static final long serialVersionUID=1L; + private static final long serialVersionUID = 1L; // 序列化版本号 - @TableId(value = "id", type = IdType.AUTO) - private Integer id; + @TableId(value = "id", type = IdType.AUTO) // MyBatis-Plus注解，指定主键字段id为自增类型 + private Integer id; // 销售退货记录ID - private Integer customerid; + private Integer customerid; // 客户ID，外键关联客户表 - private String paytype; + private String paytype; // 支付类型 - private Date salesbacktime; + private Date salesbacktime; // 退货时间 - private Double salebackprice; + private Double salebackprice; // 退货价格 - private String operateperson; + private String operateperson; // 操作员姓名 - private Integer number; + private Integer number; // 退货数量 - private String remark; + private String remark; // 备注信息 - private Integer goodsid; + private Integer goodsid; // 商品ID，外键关联商品表 /** * 客户姓名 */ - @TableField(exist = false) - private String customername; + @TableField(exist = false) // MyBatis-Plus注解，表示此字段在数据库表中不存在 + private String customername; // 客户名称（冗余字段，用于显示） /** * 商品名称 */ - @TableField(exist = false) - private String goodsname; + @TableField(exist = false) // MyBatis-Plus注解，表示此字段在数据库表中不存在 + private String goodsname; // 商品名称（冗余字段，用于显示） /** * 商品规格 */ - @TableField(exist = false) - private String size; + @TableField(exist = false) // MyBatis-Plus注解，表示此字段在数据库表中不存在 + private String size; // 商品规格（冗余字段，用于显示） } From 85988a93536345691259cd84803c2e0c2b6853f1 Mon Sep 17 00:00:00 2001 From: STAR <3308186939@qq.com> Date: Tue, 17 Dec 2024 16:08:40 +0800 Subject: [PATCH 08/13] 12/15 --- .../com/yeqifu/bus/mapper/GoodsMapper.java | 56 +++++++++---------- .../com/yeqifu/bus/mapper/InportMapper.java | 13 +++-- .../com/yeqifu/bus/mapper/OutportMapper.java | 13 +++-- .../com/yeqifu/bus/mapper/ProviderMapper.java | 34 +++++------ .../com/yeqifu/bus/mapper/SalesMapper.java | 13 +++-- .../yeqifu/bus/mapper/SalesbackMapper.java | 13 +++-- .../com/yeqifu/bus/service/IGoodsService.java | 28 +++++----- .../yeqifu/bus/service/IInportService.java | 13 +++-- .../yeqifu/bus/service/IOutportService.java | 22 ++++---- .../yeqifu/bus/service/IProviderService.java | 20 ++++--- .../com/yeqifu/bus/service/ISalesService.java | 14 +++-- .../yeqifu/bus/service/ISalesbackService.java | 23 ++++---- 12 files changed, 137 insertions(+), 125 deletions(-) diff --git a/src/main/java/com/yeqifu/bus/mapper/GoodsMapper.java b/src/main/java/com/yeqifu/bus/mapper/GoodsMapper.java index cfc5b19..b7c072f 100644 --- a/src/main/java/com/yeqifu/bus/mapper/GoodsMapper.java +++ b/src/main/java/com/yeqifu/bus/mapper/GoodsMapper.java @@ -1,60 +1,60 @@ -package com.yeqifu.bus.mapper; +package com.yeqifu.bus.mapper; // 包名 -import com.baomidou.mybatisplus.core.mapper.BaseMapper; -import com.yeqifu.bus.entity.Goods; -import org.apache.ibatis.annotations.Param; +import com.baomidou.mybatisplus.core.mapper.BaseMapper; // MyBatis-Plus核心Mapper类 +import com.yeqifu.bus.entity.Goods; // 商品实体类 +import org.apache.ibatis.annotations.Param; // MyBatis参数注解 -import java.util.List; +import java.util.List; // Java集合类 /** *

- * InnoDB free: 9216 kB; (`providerid`) REFER `warehouse/bus_provider`(`id`) Mapper 接口 + * 商品Mapper接口，用于定义与商品相关的数据库操作 + * InnoDB free: 9216 kB; (`providerid`) REFER `warehouse/bus_provider`(`id`) *

* - * @author luoyi- * @since 2019-12-06 */ -public interface GoodsMapper extends BaseMapper { +public interface GoodsMapper extends BaseMapper { // 继承MyBatis-Plus的BaseMapper类 /** - * 根据商品id删除商品销售信息 - * @param id1 + * 根据商品ID删除商品销售信息 + * @param id1 商品ID */ - void deleteSaleByGoodsId(@Param("goodsid") Integer id1); + void deleteSaleByGoodsId(@Param("goodsid") Integer id1); // 自定义SQL方法，传入商品ID删除相关销售信息 /** - * 根据商品id删除商品销售退货信息 - * @param id1 + * 根据商品ID删除商品销售退货信息 + * @param id1 商品ID */ - void deleteSaleBackByGoodsId(@Param("goodsid") Integer id1); + void deleteSaleBackByGoodsId(@Param("goodsid") Integer id1); // 自定义SQL方法，传入商品ID删除相关销售退货信息 /** - * 根据商品id删除商品进货信息 - * @param id + * 根据商品ID删除商品进货信息 + * @param id 商品ID */ - void deleteInportByGoodsId(@Param("goodsid") Integer id); - + void deleteInportByGoodsId(@Param("goodsid") Integer id); // 自定义SQL方法，传入商品ID删除相关进货信息 /** - * 根据商品id删除商品退货信息 - * @param id + * 根据商品ID删除商品退货信息 + * @param id 商品ID */ - void deleteOutportByGoodsId(@Param("goodsid") Integer id); + void deleteOutportByGoodsId(@Param("goodsid") Integer id); // 自定义SQL方法，传入商品ID删除相关退货信息 /** - * 根据客户id删除商品销售 - * @param id 客户id + * 根据客户ID删除商品销售记录 + * @param id 客户ID */ - void deleteSaleByCustomerId(Integer id); + void deleteSaleByCustomerId(Integer id); // 自定义SQL方法，传入客户ID删除相关销售信息 /** - * 根据客户id删除商品销售退货信息 - * @param id 客户id + * 根据客户ID删除商品销售退货记录 + * @param id 客户ID */ - void deleteSaleBackByCustomerId(Integer id); + void deleteSaleBackByCustomerId(Integer id); // 自定义SQL方法，传入客户ID删除相关销售退货信息 /** * 加载所有库存预警商品 + * @return 商品列表，包含所有库存预警的商品信息 */ - List loadAllWarning(); + List loadAllWarning(); // 自定义SQL方法，返回库存预警商品列表 } diff --git a/src/main/java/com/yeqifu/bus/mapper/InportMapper.java b/src/main/java/com/yeqifu/bus/mapper/InportMapper.java index e4939f1..16eafc0 100644 --- a/src/main/java/com/yeqifu/bus/mapper/InportMapper.java +++ b/src/main/java/com/yeqifu/bus/mapper/InportMapper.java @@ -1,16 +1,17 @@ -package com.yeqifu.bus.mapper; +package com.yeqifu.bus.mapper; // 包名 -import com.yeqifu.bus.entity.Inport; -import com.baomidou.mybatisplus.core.mapper.BaseMapper; +import com.yeqifu.bus.entity.Inport; // 导入进货实体类 +import com.baomidou.mybatisplus.core.mapper.BaseMapper; // 导入MyBatis-Plus核心BaseMapper接口 /** *

- * InnoDB free: 9216 kB; (`providerid`) REFER `warehouse/bus_provider`(`id`); (`goo Mapper 接口 + * 进货Mapper接口，提供对进货数据的数据库操作 + * InnoDB free: 9216 kB; (`providerid`) REFER `warehouse/bus_provider`(`id`) *

* - * @author luoyi- * @since 2019-12-18 + * @author luoyi- */ -public interface InportMapper extends BaseMapper { +public interface InportMapper extends BaseMapper { // Mapper接口继承BaseMapper，自动实现通用数据操作 } diff --git a/src/main/java/com/yeqifu/bus/mapper/OutportMapper.java b/src/main/java/com/yeqifu/bus/mapper/OutportMapper.java index 5d56b9f..b2386e7 100644 --- a/src/main/java/com/yeqifu/bus/mapper/OutportMapper.java +++ b/src/main/java/com/yeqifu/bus/mapper/OutportMapper.java @@ -1,16 +1,17 @@ -package com.yeqifu.bus.mapper; +package com.yeqifu.bus.mapper; // 包名 -import com.yeqifu.bus.entity.Outport; -import com.baomidou.mybatisplus.core.mapper.BaseMapper; +import com.yeqifu.bus.entity.Outport; // 导入出货实体类 +import com.baomidou.mybatisplus.core.mapper.BaseMapper; // 导入MyBatis-Plus核心BaseMapper接口 /** *

- * InnoDB free: 9216 kB Mapper 接口 + * 出货Mapper接口，提供对出货数据的数据库操作 + * InnoDB free: 9216 kB *

* - * @author luoyi- * @since 2019-12-19 + * @author luoyi- */ -public interface OutportMapper extends BaseMapper { +public interface OutportMapper extends BaseMapper { // Mapper接口继承BaseMapper，自动实现通用数据操作 } diff --git a/src/main/java/com/yeqifu/bus/mapper/ProviderMapper.java b/src/main/java/com/yeqifu/bus/mapper/ProviderMapper.java index b0f52b9..29cbee1 100644 --- a/src/main/java/com/yeqifu/bus/mapper/ProviderMapper.java +++ b/src/main/java/com/yeqifu/bus/mapper/ProviderMapper.java @@ -1,36 +1,36 @@ -package com.yeqifu.bus.mapper; +package com.yeqifu.bus.mapper; // 包名 -import com.yeqifu.bus.entity.Provider; -import com.baomidou.mybatisplus.core.mapper.BaseMapper; -import org.apache.ibatis.annotations.Param; +import com.yeqifu.bus.entity.Provider; // 导入供应商实体类 +import com.baomidou.mybatisplus.core.mapper.BaseMapper; // 导入MyBatis-Plus核心BaseMapper接口 +import org.apache.ibatis.annotations.Param; // 导入MyBatis的参数注解 /** *

- * InnoDB free: 9216 kB Mapper 接口 + * 供应商Mapper接口，提供对供应商相关数据的数据库操作 + * InnoDB free: 9216 kB *

* - * @author luoyi- * @since 2019-12-05 + * @author luoyi- */ -public interface ProviderMapper extends BaseMapper { +public interface ProviderMapper extends BaseMapper { // Mapper接口继承BaseMapper，自动实现通用数据操作 /** - * 根据供应商id删除商品信息 - * @param id + * 根据供应商ID删除商品信息 + * @param id 供应商ID */ - void deleteGoodsByProviderId(@Param("pid") Integer id); + void deleteGoodsByProviderId(@Param("pid") Integer id); // 自定义SQL方法，传入供应商ID删除相关商品信息 /** - * 根据供应商id删除商品进货信息 - * @param id + * 根据供应商ID删除商品进货信息 + * @param id 供应商ID */ - void deleteInportByProviderId(@Param("pid") Integer id); + void deleteInportByProviderId(@Param("pid") Integer id); // 自定义SQL方法，传入供应商ID删除相关进货信息 /** - * 根据供应商id删除商品退货信息 - * @param id + * 根据供应商ID删除商品退货信息 + * @param id 供应商ID */ - void deleteOutPortByProviderId(@Param("pid") Integer id); - + void deleteOutPortByProviderId(@Param("pid") Integer id); // 自定义SQL方法，传入供应商ID删除相关退货信息 } diff --git a/src/main/java/com/yeqifu/bus/mapper/SalesMapper.java b/src/main/java/com/yeqifu/bus/mapper/SalesMapper.java index ef9c4c9..1d98889 100644 --- a/src/main/java/com/yeqifu/bus/mapper/SalesMapper.java +++ b/src/main/java/com/yeqifu/bus/mapper/SalesMapper.java @@ -1,16 +1,17 @@ -package com.yeqifu.bus.mapper; +package com.yeqifu.bus.mapper; // 包名 -import com.yeqifu.bus.entity.Sales; -import com.baomidou.mybatisplus.core.mapper.BaseMapper; +import com.yeqifu.bus.entity.Sales; // 导入销售实体类 +import com.baomidou.mybatisplus.core.mapper.BaseMapper; // 导入MyBatis-Plus核心BaseMapper接口 /** *

- * InnoDB free: 9216 kB Mapper 接口 + * 销售Mapper接口，提供对销售数据的数据库操作 + * InnoDB free: 9216 kB *

* - * @author luoyi- * @since 2019-12-21 + * @author luoyi- */ -public interface SalesMapper extends BaseMapper { +public interface SalesMapper extends BaseMapper { // Mapper接口继承BaseMapper，自动实现通用数据操作 } diff --git a/src/main/java/com/yeqifu/bus/mapper/SalesbackMapper.java b/src/main/java/com/yeqifu/bus/mapper/SalesbackMapper.java index 2a047f9..4f3d225 100644 --- a/src/main/java/com/yeqifu/bus/mapper/SalesbackMapper.java +++ b/src/main/java/com/yeqifu/bus/mapper/SalesbackMapper.java @@ -1,16 +1,17 @@ -package com.yeqifu.bus.mapper; +package com.yeqifu.bus.mapper; // 包名 -import com.yeqifu.bus.entity.Salesback; -import com.baomidou.mybatisplus.core.mapper.BaseMapper; +import com.yeqifu.bus.entity.Salesback; // 导入销售退货实体类 +import com.baomidou.mybatisplus.core.mapper.BaseMapper; // 导入MyBatis-Plus核心BaseMapper接口 /** *

- * InnoDB free: 9216 kB Mapper 接口 + * 销售退货Mapper接口，提供对销售退货数据的数据库操作 + * InnoDB free: 9216 kB *

* - * @author luoyi- * @since 2019-12-23 + * @author luoyi- */ -public interface SalesbackMapper extends BaseMapper { +public interface SalesbackMapper extends BaseMapper { // Mapper接口继承BaseMapper，自动实现通用数据操作 } diff --git a/src/main/java/com/yeqifu/bus/service/IGoodsService.java b/src/main/java/com/yeqifu/bus/service/IGoodsService.java index 21bad66..b1b2030 100644 --- a/src/main/java/com/yeqifu/bus/service/IGoodsService.java +++ b/src/main/java/com/yeqifu/bus/service/IGoodsService.java @@ -1,29 +1,29 @@ -package com.yeqifu.bus.service; +package com.yeqifu.bus.service; // 包名 -import com.baomidou.mybatisplus.extension.service.IService; -import com.yeqifu.bus.entity.Goods; - -import java.util.List; +import com.baomidou.mybatisplus.extension.service.IService; // 导入MyBatis-Plus服务层通用接口 +import com.yeqifu.bus.entity.Goods; // 导入商品实体类 +import java.util.List; // 导入Java集合List /** *

- * InnoDB free: 9216 kB; (`providerid`) REFER `warehouse/bus_provider`(`id`) 服务类 + * 商品服务接口，定义商品相关业务操作 + * InnoDB free: 9216 kB; (`providerid`) REFER `warehouse/bus_provider`(`id`) *

* - * @author luoyi- * @since 2019-12-06 + * @author luoyi- */ -public interface IGoodsService extends IService { +public interface IGoodsService extends IService { // IService 是 MyBatis-Plus 提供的通用服务层接口 /** - * 根据商品id删除商品 - * @param id + * 根据商品ID删除商品信息 + * @param id 商品ID */ - void deleteGoodsById(Integer id); + void deleteGoodsById(Integer id); // 自定义方法，用于根据商品ID删除商品信息 /** - * 加载所有的库存预警商品 - * @return + * 加载所有的库存预警商品列表 + * @return 返回所有需要预警的商品信息列表 */ - List loadAllWarning(); + List loadAllWarning(); // 自定义方法，用于获取所有库存预警商品列表 } diff --git a/src/main/java/com/yeqifu/bus/service/IInportService.java b/src/main/java/com/yeqifu/bus/service/IInportService.java index 2e88cd2..bf63256 100644 --- a/src/main/java/com/yeqifu/bus/service/IInportService.java +++ b/src/main/java/com/yeqifu/bus/service/IInportService.java @@ -1,16 +1,17 @@ -package com.yeqifu.bus.service; +package com.yeqifu.bus.service; // 包名 -import com.yeqifu.bus.entity.Inport; -import com.baomidou.mybatisplus.extension.service.IService; +import com.yeqifu.bus.entity.Inport; // 导入进货实体类 +import com.baomidou.mybatisplus.extension.service.IService; // 导入MyBatis-Plus提供的通用服务接口 /** *

- * InnoDB free: 9216 kB; (`providerid`) REFER `warehouse/bus_provider`(`id`); (`goo 服务类 + * 进货服务接口，提供对进货数据的业务操作 + * InnoDB free: 9216 kB; (`providerid`) REFER `warehouse/bus_provider`(`id`) *

* - * @author luoyi- * @since 2019-12-18 + * @author luoyi- */ -public interface IInportService extends IService { +public interface IInportService extends IService { // IService 是 MyBatis-Plus 提供的通用服务接口 } diff --git a/src/main/java/com/yeqifu/bus/service/IOutportService.java b/src/main/java/com/yeqifu/bus/service/IOutportService.java index a98f414..fd13ffd 100644 --- a/src/main/java/com/yeqifu/bus/service/IOutportService.java +++ b/src/main/java/com/yeqifu/bus/service/IOutportService.java @@ -1,23 +1,25 @@ -package com.yeqifu.bus.service; +package com.yeqifu.bus.service; // 包名 -import com.yeqifu.bus.entity.Outport; -import com.baomidou.mybatisplus.extension.service.IService; +import com.yeqifu.bus.entity.Outport; // 导入退货实体类 +import com.baomidou.mybatisplus.extension.service.IService; // 导入 MyBatis-Plus 提供的通用服务接口 /** *

- * InnoDB free: 9216 kB 服务类 + * 出库退货服务接口，提供对退货相关数据的业务操作 + * InnoDB free: 9216 kB *

* - * @author luoyi- * @since 2019-12-19 + * @author luoyi- */ -public interface IOutportService extends IService { +public interface IOutportService extends IService { // IService 是 MyBatis-Plus 提供的通用服务接口 /** * 对商品进货进行退货处理 - * @param id 进货单ID - * @param number 退货数量 - * @param remark 备注 + * + * @param id 进货单ID，用于标识进货数据 + * @param number 退货数量，需要退回的商品数量 + * @param remark 备注信息，用于记录退货原因或其他说明信息 */ - void addOutport(Integer id, Integer number, String remark); + void addOutport(Integer id, Integer number, String remark); // 自定义方法，处理退货操作 } diff --git a/src/main/java/com/yeqifu/bus/service/IProviderService.java b/src/main/java/com/yeqifu/bus/service/IProviderService.java index 9433a09..3baf1b9 100644 --- a/src/main/java/com/yeqifu/bus/service/IProviderService.java +++ b/src/main/java/com/yeqifu/bus/service/IProviderService.java @@ -1,21 +1,23 @@ -package com.yeqifu.bus.service; +package com.yeqifu.bus.service; // 包名 -import com.yeqifu.bus.entity.Provider; -import com.baomidou.mybatisplus.extension.service.IService; +import com.yeqifu.bus.entity.Provider; // 导入供应商实体类 +import com.baomidou.mybatisplus.extension.service.IService; // 导入 MyBatis-Plus 提供的通用服务接口 /** *

- * InnoDB free: 9216 kB 服务类 + * 供应商服务接口，定义与供应商相关的业务操作 + * InnoDB free: 9216 kB *

* - * @author luoyi- * @since 2019-12-05 + * @author luoyi- */ -public interface IProviderService extends IService { +public interface IProviderService extends IService { // IService 是 MyBatis-Plus 提供的通用服务接口 /** - * 根据供应商ID删除供应商 - * @param id + * 根据供应商ID删除供应商信息 + * + * @param id 供应商ID，用于唯一标识需要删除的供应商 */ - void deleteProviderById(Integer id); + void deleteProviderById(Integer id); // 自定义方法，处理删除操作 } diff --git a/src/main/java/com/yeqifu/bus/service/ISalesService.java b/src/main/java/com/yeqifu/bus/service/ISalesService.java index 27f7d49..0e5f09c 100644 --- a/src/main/java/com/yeqifu/bus/service/ISalesService.java +++ b/src/main/java/com/yeqifu/bus/service/ISalesService.java @@ -1,16 +1,18 @@ -package com.yeqifu.bus.service; +package com.yeqifu.bus.service; // 包名，定义服务层的包路径 -import com.yeqifu.bus.entity.Sales; -import com.baomidou.mybatisplus.extension.service.IService; +import com.yeqifu.bus.entity.Sales; // 导入销售实体类 +import com.baomidou.mybatisplus.extension.service.IService; // 导入 MyBatis-Plus 提供的通用服务接口 /** *

- * InnoDB free: 9216 kB 服务类 + * 销售服务接口，定义与销售相关的业务操作 + * InnoDB free: 9216 kB *

* - * @author luoyi- * @since 2019-12-21 + * @author luoyi- */ -public interface ISalesService extends IService { +public interface ISalesService extends IService { // IService 是 MyBatis-Plus 提供的通用服务接口 + // 由于未定义自定义方法，这里继承 IService 后可自动具备基本的 CRUD 功能 } diff --git a/src/main/java/com/yeqifu/bus/service/ISalesbackService.java b/src/main/java/com/yeqifu/bus/service/ISalesbackService.java index e2cfd95..66ed918 100644 --- a/src/main/java/com/yeqifu/bus/service/ISalesbackService.java +++ b/src/main/java/com/yeqifu/bus/service/ISalesbackService.java @@ -1,24 +1,25 @@ -package com.yeqifu.bus.service; +package com.yeqifu.bus.service; // 包名 -import com.yeqifu.bus.entity.Salesback; -import com.baomidou.mybatisplus.extension.service.IService; +import com.yeqifu.bus.entity.Salesback; // 导入销售退货实体类 +import com.baomidou.mybatisplus.extension.service.IService; // 导入 MyBatis-Plus 提供的通用服务接口 /** *

- * InnoDB free: 9216 kB 服务类 + * 销售退货服务接口，提供对销售退货相关数据的业务操作 + * InnoDB free: 9216 kB *

* - * @author luoyi- * @since 2019-12-23 + * @author luoyi- */ -public interface ISalesbackService extends IService { +public interface ISalesbackService extends IService { // IService 是 MyBatis-Plus 提供的通用服务接口 /** * 对商品销售进行退货处理 - * @param id 销售单ID - * @param number 退货数量 - * @param remark 备注 + * + * @param id 销售单ID，标识需要退货的销售记录 + * @param number 退货数量，表示退回的商品数量 + * @param remark 备注信息，用于记录退货原因或其他补充信息 */ - void addSalesback(Integer id, Integer number, String remark); - + void addSalesback(Integer id, Integer number, String remark); // 自定义退货处理方法 } From 0e5e886813671d3de2b14e0a0f50de00fd662d71 Mon Sep 17 00:00:00 2001 From: STAR <3308186939@qq.com> Date: Tue, 17 Dec 2024 16:29:01 +0800 Subject: [PATCH 09/13] 12/15 --- src/main/java/com/yeqifu/bus/vo/GoodsVo.java | 21 ++++----- src/main/java/com/yeqifu/bus/vo/InportVo.java | 34 +++++++------- .../java/com/yeqifu/bus/vo/OutportVo.java | 38 +++++++++++----- .../java/com/yeqifu/bus/vo/ProviderVo.java | 34 +++++++++----- src/main/java/com/yeqifu/bus/vo/SalesVo.java | 44 ++++++++++++------ .../java/com/yeqifu/bus/vo/SalesbackVo.java | 45 +++++++++++++------ 6 files changed, 138 insertions(+), 78 deletions(-) diff --git a/src/main/java/com/yeqifu/bus/vo/GoodsVo.java b/src/main/java/com/yeqifu/bus/vo/GoodsVo.java index c0b99ea..03c6ec0 100644 --- a/src/main/java/com/yeqifu/bus/vo/GoodsVo.java +++ b/src/main/java/com/yeqifu/bus/vo/GoodsVo.java @@ -1,18 +1,19 @@ -package com.yeqifu.bus.vo; +package com.yeqifu.bus.vo; // 包名，定义视图层的包路径 -import com.yeqifu.bus.entity.Goods; -import lombok.Data; -import lombok.EqualsAndHashCode; +import com.yeqifu.bus.entity.Goods; // 导入 Goods 实体类 +import lombok.Data; // 导入 Lombok 提供的 @Data 注解 +import lombok.EqualsAndHashCode; // 导入 Lombok 提供的 @EqualsAndHashCode 注解 /** * @Author: 落亦- * @Date: 2019/12/6 22:30 + * + * 数据传输对象 (VO)，用于与前端交互时携带 Goods 实体数据以及分页信息 */ -@Data -@EqualsAndHashCode(callSuper = false) -public class GoodsVo extends Goods { - - private Integer page=1; - private Integer limit=10; +@Data // 自动生成 getter、setter、toString 等常用方法 +@EqualsAndHashCode(callSuper = false) // 生成 equals 和 hashCode 方法，且不考虑父类属性 +public class GoodsVo extends Goods { // 继承 Goods 实体类 + private Integer page = 1; // 分页查询起始页码，默认为第 1 页 + private Integer limit = 10; // 分页查询的限制记录数，默认为每页 10 条数据 } diff --git a/src/main/java/com/yeqifu/bus/vo/InportVo.java b/src/main/java/com/yeqifu/bus/vo/InportVo.java index cf6f993..e8d20b6 100644 --- a/src/main/java/com/yeqifu/bus/vo/InportVo.java +++ b/src/main/java/com/yeqifu/bus/vo/InportVo.java @@ -1,28 +1,28 @@ -package com.yeqifu.bus.vo; +package com.yeqifu.bus.vo; // 包路径，定义视图层的包路径 -import com.yeqifu.bus.entity.Inport; -import lombok.Data; -import lombok.EqualsAndHashCode; -import org.springframework.format.annotation.DateTimeFormat; - -import java.util.Date; +import com.yeqifu.bus.entity.Inport; // 导入 Inport 实体类 +import lombok.Data; // 导入 Lombok 提供的 @Data 注解 +import lombok.EqualsAndHashCode; // 导入 Lombok 提供的 @EqualsAndHashCode 注解 +import org.springframework.format.annotation.DateTimeFormat; // 导入日期格式注解 +import java.util.Date; // 导入 Date 类 /** * @Author: 落亦- * @Date: 2019/12/18 10:29 + * + * 数据传输对象 (VO)，用于视图层与前端交互时传递 Inport 实体数据以及分页信息和时间查询条件 */ -@Data -@EqualsAndHashCode(callSuper = false) -public class InportVo extends Inport { - - private Integer page = 1; +@Data // 自动生成 getter、setter、toString 等常用方法 +@EqualsAndHashCode(callSuper = false) // 生成 equals 和 hashCode 方法，且不考虑其父类属性 +public class InportVo extends Inport { // 继承 Inport 实体类 - private Integer limit = 10; + private Integer page = 1; // 分页查询起始页码，默认为第 1 页 - @DateTimeFormat(pattern = "yyyy-MM-dd") - private Date startTime; + private Integer limit = 10; // 分页查询的限制记录数，默认为每页 10 条数据 - @DateTimeFormat(pattern = "yyyy-MM-dd") - private Date endTime; + @DateTimeFormat(pattern = "yyyy-MM-dd") // 格式化日期为 yyyy-MM-dd 格式 + private Date startTime; // 查询时间范围的起始时间 + @DateTimeFormat(pattern = "yyyy-MM-dd") // 格式化日期为 yyyy-MM-dd 格式 + private Date endTime; // 查询时间范围的结束时间 } diff --git a/src/main/java/com/yeqifu/bus/vo/OutportVo.java b/src/main/java/com/yeqifu/bus/vo/OutportVo.java index 0897df0..ff32ad5 100644 --- a/src/main/java/com/yeqifu/bus/vo/OutportVo.java +++ b/src/main/java/com/yeqifu/bus/vo/OutportVo.java @@ -1,29 +1,43 @@ -package com.yeqifu.bus.vo; +package com.yeqifu.bus.vo; // 定义视图层包路径 -import com.yeqifu.bus.entity.Outport; -import lombok.Data; -import lombok.EqualsAndHashCode; -import org.springframework.format.annotation.DateTimeFormat; - -import java.util.Date; +import com.yeqifu.bus.entity.Outport; // 导入 Outport 实体类 +import lombok.Data; // 导入 Lombok 提供的 @Data 注解 +import lombok.EqualsAndHashCode; // 导入 Lombok 提供的 @EqualsAndHashCode 注解 +import org.springframework.format.annotation.DateTimeFormat; // 导入日期格式化注解 +import java.util.Date; // 导入 Date 类 /** * @Author: 落亦- * @Date: 2019/12/18 10:29 + * + * 数据传输对象 (VO)，用于视图层与前端交互时传递 Outport 实体数据 + * 同时包含分页信息和时间过滤条件。 */ -@Data -@EqualsAndHashCode(callSuper = false) -public class OutportVo extends Outport { +@Data // 自动生成 getter、setter、toString 等常用方法 +@EqualsAndHashCode(callSuper = false) // 生成 equals 和 hashCode 方法，且不考虑其父类的属性 +public class OutportVo extends Outport { // 继承 Outport 实体类 + /** + * 分页查询当前页码，默认为第 1 页 + */ private Integer page = 1; + /** + * 分页查询每页显示的记录数，默认为每页 10 条数据 + */ private Integer limit = 10; + /** + * 查询时间范围的起始日期 + * 使用 @DateTimeFormat 注解，确保从前端接收到的日期字符串能被解析为 Date 类型 + */ @DateTimeFormat(pattern = "yyyy-MM-dd") private Date startTime; + /** + * 查询时间范围的结束日期 + * 使用 @DateTimeFormat 注解，确保从前端接收到的日期字符串能被解析为 Date 类型 + */ @DateTimeFormat(pattern = "yyyy-MM-dd") private Date endTime; - - } diff --git a/src/main/java/com/yeqifu/bus/vo/ProviderVo.java b/src/main/java/com/yeqifu/bus/vo/ProviderVo.java index b9c400b..d36b0ab 100644 --- a/src/main/java/com/yeqifu/bus/vo/ProviderVo.java +++ b/src/main/java/com/yeqifu/bus/vo/ProviderVo.java @@ -1,26 +1,36 @@ -package com.yeqifu.bus.vo; +package com.yeqifu.bus.vo; // 定义视图层包路径 -import com.yeqifu.bus.entity.Customer; -import com.yeqifu.bus.entity.Provider; -import lombok.Data; -import lombok.EqualsAndHashCode; +import com.yeqifu.bus.entity.Customer; // 导入 Customer 实体类 +import com.yeqifu.bus.entity.Provider; // 导入 Provider 实体类 +import lombok.Data; // 导入 Lombok 提供的 @Data 注解 +import lombok.EqualsAndHashCode; // 导入 Lombok 提供的 @EqualsAndHashCode 注解 /** * @Author: 落亦- * @Date: 2019/12/5 9:30 + * + * 数据传输对象 (VO)，用于视图层与前端交互时传递 Provider 实体数据， + * 同时支持分页查询和批量删除。 */ -@Data -@EqualsAndHashCode(callSuper = false) -public class ProviderVo extends Provider{ +@Data // 自动生成 getter、setter、toString 等常用方法 +@EqualsAndHashCode(callSuper = false) // 生成 equals 和 hashCode 方法，且不考虑其父类的属性 +public class ProviderVo extends Provider { // 继承 Provider 实体类 /** - * 分页参数，当前是第一页，每页10条数据 + * 分页参数 - 当前页码 + * 默认设置为 1，表示从第一页开始查询。 */ - private Integer page=1; - private Integer limit=10; + private Integer page = 1; /** - * 批量删除供应商，存放供应商ID的数组 + * 分页参数 - 每页数据的记录数 + * 默认设置为 10，表示每页显示 10 条数据。 + */ + private Integer limit = 10; + + /** + * 批量删除供应商时，存储要删除的供应商ID的数组。 + * 前端传递选中供应商的ID，服务层根据该ID数组进行批量删除操作。 */ private Integer[] ids; diff --git a/src/main/java/com/yeqifu/bus/vo/SalesVo.java b/src/main/java/com/yeqifu/bus/vo/SalesVo.java index 8947e79..d612d78 100644 --- a/src/main/java/com/yeqifu/bus/vo/SalesVo.java +++ b/src/main/java/com/yeqifu/bus/vo/SalesVo.java @@ -1,28 +1,46 @@ -package com.yeqifu.bus.vo; +package com.yeqifu.bus.vo; // 定义视图层的包路径 -import com.yeqifu.bus.entity.Sales; -import lombok.Data; -import lombok.EqualsAndHashCode; -import org.springframework.format.annotation.DateTimeFormat; - -import java.util.Date; +import com.yeqifu.bus.entity.Sales; // 导入 Sales 实体类 +import lombok.Data; // 导入 Lombok 提供的 @Data 注解 +import lombok.EqualsAndHashCode; // 导入 Lombok 提供的 @EqualsAndHashCode 注解 +import org.springframework.format.annotation.DateTimeFormat; // 导入日期格式注解 +import java.util.Date; // 导入 Date 类 /** * @Author: 落亦- * @Date: 2019/12/18 10:29 + * + * 数据传输对象 (VO)，用于视图层与前端交互时传递 Sales 实体数据。 + * 同时支持分页查询和时间范围过滤。 */ -@Data -@EqualsAndHashCode(callSuper = false) -public class SalesVo extends Sales { - +@Data // 自动生成 getter、setter、toString 等常用方法 +@EqualsAndHashCode(callSuper = false) // 生成 equals 和 hashCode 方法，且不考虑其父类的属性 +public class SalesVo extends Sales { // 继承 Sales 实体类 + + /** + * 分页参数 - 当前页码 + * 默认设置为 1，表示从第一页开始查询。 + */ private Integer page = 1; + /** + * 分页参数 - 每页数据的记录数 + * 默认设置为 10，表示每页显示 10 条数据。 + */ private Integer limit = 10; - @DateTimeFormat(pattern = "yyyy-MM-dd") + /** + * 起始时间范围过滤参数。 + * 用于根据时间范围过滤销售数据。 + */ + @DateTimeFormat(pattern = "yyyy-MM-dd") // 格式化日期为 yyyy-MM-dd 格式 private Date startTime; - @DateTimeFormat(pattern = "yyyy-MM-dd") + /** + * 结束时间范围过滤参数。 + * 用于根据时间范围过滤销售数据。 + */ + @DateTimeFormat(pattern = "yyyy-MM-dd") // 格式化日期为 yyyy-MM-dd 格式 private Date endTime; } diff --git a/src/main/java/com/yeqifu/bus/vo/SalesbackVo.java b/src/main/java/com/yeqifu/bus/vo/SalesbackVo.java index 0c61c95..d0a55e1 100644 --- a/src/main/java/com/yeqifu/bus/vo/SalesbackVo.java +++ b/src/main/java/com/yeqifu/bus/vo/SalesbackVo.java @@ -1,29 +1,46 @@ -package com.yeqifu.bus.vo; +package com.yeqifu.bus.vo; // 定义视图层的包路径 -import com.yeqifu.bus.entity.Salesback; -import lombok.Data; -import lombok.EqualsAndHashCode; -import org.springframework.format.annotation.DateTimeFormat; - -import java.util.Date; +import com.yeqifu.bus.entity.Salesback; // 导入 Salesback 实体类 +import lombok.Data; // 导入 Lombok 提供的 @Data 注解 +import lombok.EqualsAndHashCode; // 导入 Lombok 提供的 @EqualsAndHashCode 注解 +import org.springframework.format.annotation.DateTimeFormat; // 导入日期格式注解 +import java.util.Date; // 导入 Date 类 /** * @Author: 落亦- * @Date: 2019/12/18 10:29 + * + * 数据传输对象 (VO)，用于视图层与前端交互时传递 Salesback 实体数据。 + * 同时支持分页查询和时间范围过滤。 */ -@Data -@EqualsAndHashCode(callSuper = false) -public class SalesbackVo extends Salesback { - +@Data // 自动生成 getter、setter、toString 等常用方法 +@EqualsAndHashCode(callSuper = false) // 生成 equals 和 hashCode 方法，且不考虑其父类的属性 +public class SalesbackVo extends Salesback { // 继承 Salesback 实体类 + + /** + * 分页参数 - 当前页码 + * 默认设置为 1，表示从第一页开始查询。 + */ private Integer page = 1; + /** + * 分页参数 - 每页数据的记录数 + * 默认设置为 10，表示每页显示 10 条数据。 + */ private Integer limit = 10; - @DateTimeFormat(pattern = "yyyy-MM-dd") + /** + * 起始时间范围过滤参数。 + * 用于根据时间范围过滤销售退货记录。 + */ + @DateTimeFormat(pattern = "yyyy-MM-dd") // 格式化日期为 yyyy-MM-dd 格式 private Date startTime; - @DateTimeFormat(pattern = "yyyy-MM-dd") + /** + * 结束时间范围过滤参数。 + * 用于根据时间范围过滤销售退货记录。 + */ + @DateTimeFormat(pattern = "yyyy-MM-dd") // 格式化日期为 yyyy-MM-dd 格式 private Date endTime; - } From b50f045dac4e17c8773c1e6f670c5651103448bf Mon Sep 17 00:00:00 2001 From: STAR <3308186939@qq.com> Date: Tue, 17 Dec 2024 19:29:18 +0800 Subject: [PATCH 10/13] 12/17 --- .../business/goods/goodsManager.html | 412 +++--------------- 1 file changed, 67 insertions(+), 345 deletions(-) diff --git a/src/main/resources/templates/business/goods/goodsManager.html b/src/main/resources/templates/business/goods/goodsManager.html index 2451cf8..997bf23 100644 --- a/src/main/resources/templates/business/goods/goodsManager.html +++ b/src/main/resources/templates/business/goods/goodsManager.html @@ -1,54 +1,56 @@ - + + xmlns:shiro="http://www.pollix.at/thymeleaf/shiro"> - - Right - - - - - - - - + + Right + + + + + + + + + + + + + + + + + - + +
- 搜索条件 + 搜索条件
+ +
+ @@ -57,6 +59,7 @@
+
@@ -64,21 +67,23 @@
+
+
-
+
@@ -86,361 +91,78 @@
+
- -
- +
-
+
+ + + +
- - - - + - - \ No newline at end of file + From fb1f0a1dd32d7562aed104940c1cae80ccfa8d0b Mon Sep 17 00:00:00 2001 From: STAR <3308186939@qq.com> Date: Tue, 17 Dec 2024 19:35:57 +0800 Subject: [PATCH 11/13] 12/17 --- .../business/goods/goodsManager.html | 83 +++++++++---------- 1 file changed, 39 insertions(+), 44 deletions(-) diff --git a/src/main/resources/templates/business/goods/goodsManager.html b/src/main/resources/templates/business/goods/goodsManager.html index 997bf23..19626f4 100644 --- a/src/main/resources/templates/business/goods/goodsManager.html +++ b/src/main/resources/templates/business/goods/goodsManager.html @@ -1,106 +1,111 @@ + xmlns:shiro="http://www.pollix.at/thymeleaf/shiro"> - Right - + Right + - - + + - - - + + + - + - + - + - + - +
- 搜索条件 + 搜索条件
- +
+
-
+ +
-
+ +
-
+ +
-
+
+
-
+ +
-
+ +
- - @@ -110,30 +115,20 @@
-
+
- + - - -
- + + - - \ No newline at end of file +