12345678

src/main/java/com/yeqifu/WarehouseApplication.java

@@ -1,39 +1,44 @@
-package com.yeqifu;
+package com.yeqifu;  // 定义该类所在的包路径
 
-import org.mybatis.spring.annotation.MapperScan;
-import org.springframework.boot.SpringApplication;
-import org.springframework.boot.autoconfigure.SpringBootApplication;
-import org.springframework.boot.web.servlet.MultipartConfigFactory;
-import org.springframework.context.annotation.Bean;
-import org.springframework.context.annotation.Configuration;
-import org.springframework.util.unit.DataSize;
+import org.mybatis.spring.annotation.MapperScan;  // 导入 MyBatis 的 @MapperScan 注解，用于扫描 Mapper 接口
+import org.springframework.boot.SpringApplication;  // 导入 Spring Boot 的 SpringApplication 类，用于启动 Spring Boot 应用
+import org.springframework.boot.autoconfigure.SpringBootApplication;  // 导入 Spring Boot 的 @SpringBootApplication 注解，表示该类是 Spring Boot 应用的入口
+import org.springframework.boot.web.servlet.MultipartConfigFactory;  // 导入 MultipartConfigFactory，用于配置文件上传的相关设置
+import org.springframework.context.annotation.Bean;  // 导入 Spring 的 @Bean 注解，用于注册 Bean 到 Spring 容器
+import org.springframework.context.annotation.Configuration;  // 导入 Spring 的 @Configuration 注解，用于标记该类为配置类
+import org.springframework.util.unit.DataSize;  // 导入 DataSize 类，用于处理文件大小的单位转换
 
-import javax.servlet.MultipartConfigElement;
+import javax.servlet.MultipartConfigElement;  // 导入 MultipartConfigElement 类，用于配置文件上传的限制
 
 /**
  * @author luoyi-
  */
-@Configuration
-@SpringBootApplication
-@MapperScan(basePackages = {"com.yeqifu.*.mapper"})
+@Configuration  // 标注该类是配置类
+@SpringBootApplication  // 标注该类为 Spring Boot 应用的启动类
+@MapperScan(basePackages = {"com.yeqifu.*.mapper"})  // 扫描指定包路径下的 Mapper 接口
 public class WarehouseApplication {
 
 	public static void main(String[] args) {
+		// 启动 Spring Boot 应用
 		SpringApplication.run(WarehouseApplication.class, args);
 	}
 
 	@Bean
 	public MultipartConfigElement multipartConfigElement() {
+		// 创建 MultipartConfigFactory 实例
 		MultipartConfigFactory factory = new MultipartConfigFactory();
+
 		/**
-		 * 单个数据大小
+		 * 设置单个上传文件的最大大小，单位为 KB
 		 */
-		factory.setMaxFileSize(DataSize.parse("102400KB"));
+		factory.setMaxFileSize(DataSize.parse("102400KB"));  // 设置单个文件最大大小为 102400KB
+
 		/**
-		 * 总上传数据大小6
+		 * 设置请求中所有上传文件的总大小限制，单位为 KB
 		 */
-		factory.setMaxRequestSize(DataSize.parse("102400KB"));
+		factory.setMaxRequestSize(DataSize.parse("102400KB"));  // 设置总上传大小为 102400KB
+
+		// 创建并返回 MultipartConfigElement 实例
 		return factory.createMultipartConfig();
 	}
-
 }

src/main/java/com/yeqifu/bus/service/ICustomerService.java

@@ -1,21 +1,20 @@
-package com.yeqifu.bus.service;
+package com.yeqifu.bus.service;  // 定义该接口所在的包路径，属于业务层接口
 
-import com.yeqifu.bus.entity.Customer;
-import com.baomidou.mybatisplus.extension.service.IService;
+import com.yeqifu.bus.entity.Customer;  // 导入客户实体类 Customer，表示客户数据
+import com.baomidou.mybatisplus.extension.service.IService;  // 导入 MyBatis-Plus 提供的 IService 接口，包含通用的 CRUD 操作
 
 /**
  * <p>
- * InnoDB free: 9216 kB 服务类
+ * 客户服务接口
  * </p>
  *
- * @author luoyi-
  * @since 2019-12-05
  */
-public interface ICustomerService extends IService<Customer> {
+public interface ICustomerService extends IService<Customer> {  // 继承 IService 接口，泛型为 Customer，表示该接口提供 Customer 实体的基本业务操作
 
     /**
      * 根据客户id删除客户
-     * @param id    客户id
+     * @param id 客户id
      */
-    void deleteCustomerById(Integer id);
+    void deleteCustomerById(Integer id);  // 声明一个根据客户ID删除客户的抽象方法
 }

src/main/java/com/yeqifu/bus/service/IGoodsService.java

@@ -1,29 +1,28 @@
-package com.yeqifu.bus.service;
+package com.yeqifu.bus.service;  // 定义该接口所在的包路径，属于业务层接口
 
-import com.baomidou.mybatisplus.extension.service.IService;
-import com.yeqifu.bus.entity.Goods;
+import com.baomidou.mybatisplus.extension.service.IService;  // 导入 MyBatis-Plus 提供的 IService 接口，包含通用的 CRUD 操作
+import com.yeqifu.bus.entity.Goods;  // 导入商品实体类 Goods，表示商品相关数据
 
-import java.util.List;
+import java.util.List;  // 导入 List 类，用于返回多个商品
 
 /**
  * <p>
- * InnoDB free: 9216 kB; (`providerid`) REFER `warehouse/bus_provider`(`id`) 服务类
+ * 商品服务接口
  * </p>
  *
- * @author luoyi-
  * @since 2019-12-06
  */
-public interface IGoodsService extends IService<Goods> {
+public interface IGoodsService extends IService<Goods> {  // 继承 IService 接口，泛型为 Goods，表示该接口提供 Goods 实体的基本业务操作
 
     /**
      * 根据商品id删除商品
-     * @param id
+     * @param id 商品id
      */
-    void deleteGoodsById(Integer id);
+    void deleteGoodsById(Integer id);  // 声明一个根据商品ID删除商品的抽象方法
 
     /**
      * 加载所有的库存预警商品
-     * @return
+     * @return 返回所有库存预警商品的列表
      */
-    List<Goods> loadAllWarning();
+    List<Goods> loadAllWarning();  // 声明一个方法，用于加载所有库存预警商品
 }

src/main/java/com/yeqifu/bus/service/IInportService.java

@@ -1,16 +1,14 @@
-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;  // 导入商品进货实体类 Inport，表示商品进货相关数据
+import com.baomidou.mybatisplus.extension.service.IService;  // 导入 MyBatis-Plus 提供的 IService 接口，包含通用的 CRUD 操作
 
 /**
  * <p>
- * InnoDB free: 9216 kB; (`providerid`) REFER `warehouse/bus_provider`(`id`); (`goo 服务类
+ * 商品进货服务接口
  * </p>
  *
- * @author luoyi-
  * @since 2019-12-18
  */
-public interface IInportService extends IService<Inport> {
-
+public interface IInportService extends IService<Inport> {  // 继承 IService 接口，泛型为 Inport，表示该接口提供 Inport 实体的基本业务操作
 }

src/main/java/com/yeqifu/bus/service/IOutportService.java

@@ -1,17 +1,16 @@
-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;  // 导入商品退货实体类 Outport，表示商品退货相关数据
+import com.baomidou.mybatisplus.extension.service.IService;  // 导入 MyBatis-Plus 提供的 IService 接口，包含通用的 CRUD 操作
 
 /**
  * <p>
- * InnoDB free: 9216 kB 服务类
+ * 商品退货服务接口
  * </p>
  *
- * @author luoyi-
  * @since 2019-12-19
  */
-public interface IOutportService extends IService<Outport> {
+public interface IOutportService extends IService<Outport> {  // 继承 IService 接口，泛型为 Outport，表示该接口提供 Outport 实体的基本业务操作
 
     /**
      * 对商品进货进行退货处理
@@ -19,5 +18,5 @@ public interface IOutportService extends IService<Outport> {
      * @param number    退货数量
      * @param remark    备注
      */
-    void addOutport(Integer id, Integer number, String remark);
+    void addOutport(Integer id, Integer number, String remark);  // 自定义方法：添加退货处理，接收进货单ID、退货数量和备注
 }

src/main/java/com/yeqifu/bus/service/IProviderService.java

@@ -1,21 +1,21 @@
-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;  // 导入供应商实体类 Provider，表示供应商相关的数据
+import com.baomidou.mybatisplus.extension.service.IService;  // 导入 MyBatis-Plus 提供的 IService 接口，包含通用的 CRUD 操作
 
 /**
  * <p>
- * InnoDB free: 9216 kB 服务类
+ * 供应商服务接口
  * </p>
  *
- * @author luoyi-
  * @since 2019-12-05
  */
-public interface IProviderService extends IService<Provider> {
+public interface IProviderService extends IService<Provider> {  // 继承 IService 接口，泛型为 Provider，表示该接口提供 Provider 实体的基本业务操作
 
     /**
      * 根据供应商ID删除供应商
-     * @param id
+     * @param id    供应商ID
      */
-    void deleteProviderById(Integer id);
+    void deleteProviderById(Integer id);  // 自定义方法：根据供应商ID删除供应商及其相关信息
 }
+

src/main/java/com/yeqifu/bus/service/ISalesService.java

@@ -1,16 +1,14 @@
-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;  // 导入商品销售实体类 Sales，表示商品销售相关的数据
+import com.baomidou.mybatisplus.extension.service.IService;  // 导入 MyBatis-Plus 提供的 IService 接口，包含通用的 CRUD 操作
 
 /**
  * <p>
- * InnoDB free: 9216 kB 服务类
+ * 商品销售服务接口
  * </p>
  *
- * @author luoyi-
  * @since 2019-12-21
  */
-public interface ISalesService extends IService<Sales> {
-
+public interface ISalesService extends IService<Sales> {  // 继承 IService 接口，泛型为 Sales，表示该接口提供 Sales 实体的基本业务操作
 }

src/main/java/com/yeqifu/bus/service/ISalesbackService.java

@@ -1,17 +1,16 @@
-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;  // 导入商品销售退货实体类 Salesback，表示销售退货相关的数据
+import com.baomidou.mybatisplus.extension.service.IService;  // 导入 MyBatis-Plus 提供的 IService 接口，包含通用的 CRUD 操作
 
 /**
  * <p>
- * InnoDB free: 9216 kB 服务类
+ * 商品销售退货服务接口
  * </p>
  *
- * @author luoyi-
  * @since 2019-12-23
  */
-public interface ISalesbackService extends IService<Salesback> {
+public interface ISalesbackService extends IService<Salesback> {  // 继承 IService 接口，泛型为 Salesback，表示该接口提供 Salesback 实体的基本业务操作
 
     /**
      * 对商品销售进行退货处理
@@ -19,6 +18,5 @@ public interface ISalesbackService extends IService<Salesback> {
      * @param number    退货数量
      * @param remark    备注
      */
-    void addSalesback(Integer id, Integer number, String remark);
-
+    void addSalesback(Integer id, Integer number, String remark);  // 自定义方法：根据销售单ID、退货数量和备注处理商品销售退货
 }

src/main/java/com/yeqifu/bus/vo/CustomerVo.java

@@ -1,26 +1,25 @@
-package com.yeqifu.bus.vo;
+package com.yeqifu.bus.vo;  // 定义该类所在的包路径，属于视图层的对象包
 
-import com.yeqifu.bus.entity.Customer;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
+import com.yeqifu.bus.entity.Customer;  // 导入 Customer 实体类，表示客户信息
+import lombok.Data;  // 导入 Lombok 提供的 @Data 注解，自动生成 getter、setter、toString 等方法
+import lombok.EqualsAndHashCode;  // 导入 Lombok 提供的 @EqualsAndHashCode 注解，自动生成 equals 和 hashCode 方法
 
 /**
  * @Author: 落亦-
  * @Date: 2019/12/5 9:30
  */
-@Data
-@EqualsAndHashCode(callSuper = false)
-public class CustomerVo extends Customer{
+@Data  // Lombok 注解，自动生成 getter、setter、toString、equals 和 hashCode 方法
+@EqualsAndHashCode(callSuper = false)  // Lombok 注解，自动生成 equals 和 hashCode 方法，不考虑父类的字段
+public class CustomerVo extends Customer {  // CustomerVo 继承自 Customer，表示客户视图对象，添加一些分页和批量操作功能
 
     /**
      * 分页参数，当前是第一页，每页10条数据
      */
-    private Integer page=1;
-    private Integer limit=10;
+    private Integer page = 1;  // 分页参数，默认为第一页
+    private Integer limit = 10;  // 分页参数，默认为每页显示10条数据
 
     /**
      * 批量删除客户，存放客户ID的数组
      */
-    private Integer[] ids;
-
+    private Integer[] ids;  // 用于批量删除客户，存储客户ID的数组
 }

src/main/java/com/yeqifu/bus/vo/GoodsVo.java

@@ -1,18 +1,17 @@
-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 注解，自动生成 getter、setter、toString 等方法
+import lombok.EqualsAndHashCode;  // 导入 Lombok 提供的 @EqualsAndHashCode 注解，自动生成 equals 和 hashCode 方法
 
 /**
  * @Author: 落亦-
  * @Date: 2019/12/6 22:30
  */
-@Data
-@EqualsAndHashCode(callSuper = false)
-public class GoodsVo extends Goods {
-
-    private Integer page=1;
-    private Integer limit=10;
+@Data  // Lombok 注解，自动生成 getter、setter、toString、equals 和 hashCode 方法
+@EqualsAndHashCode(callSuper = false)  // Lombok 注解，自动生成 equals 和 hashCode 方法，不考虑父类的字段
+public class GoodsVo extends Goods {  // GoodsVo 继承自 Goods，表示商品视图对象，添加了分页功能
 
+    private Integer page = 1;  // 分页参数，默认为第一页
+    private Integer limit = 10;  // 分页参数，默认为每页显示10条数据
 }

src/main/java/com/yeqifu/bus/vo/InportVo.java

@@ -1,28 +1,26 @@
-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 com.yeqifu.bus.entity.Inport;  // 导入 Inport 实体类，表示进货信息
+import lombok.Data;  // 导入 Lombok 提供的 @Data 注解，自动生成 getter、setter、toString 等方法
+import lombok.EqualsAndHashCode;  // 导入 Lombok 提供的 @EqualsAndHashCode 注解，自动生成 equals 和 hashCode 方法
+import org.springframework.format.annotation.DateTimeFormat;  // 导入用于格式化日期的注解
 
-import java.util.Date;
+import java.util.Date;  // 导入日期类
 
 /**
  * @Author: 落亦-
  * @Date: 2019/12/18 10:29
  */
-@Data
-@EqualsAndHashCode(callSuper = false)
-public class InportVo extends Inport {
+@Data  // Lombok 注解，自动生成 getter、setter、toString、equals 和 hashCode 方法
+@EqualsAndHashCode(callSuper = false)  // Lombok 注解，自动生成 equals 和 hashCode 方法，不考虑父类的字段
+public class InportVo extends Inport {  // InportVo 继承自 Inport，表示进货视图对象，添加了分页和时间筛选功能
 
-    private Integer page = 1;
+    private Integer page = 1;  // 分页参数，默认为第一页
+    private Integer limit = 10;  // 分页参数，默认为每页显示10条数据
 
-    private Integer limit = 10;
-
-    @DateTimeFormat(pattern = "yyyy-MM-dd")
-    private Date startTime;
-
-    @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;  // 结束时间，用于筛选进货记录的结束时间
 }

src/main/java/com/yeqifu/bus/vo/OutportVo.java

@@ -1,29 +1,26 @@
-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 com.yeqifu.bus.entity.Outport;  // 导入 Outport 实体类，表示出货信息
+import lombok.Data;  // 导入 Lombok 提供的 @Data 注解，自动生成 getter、setter、toString 等方法
+import lombok.EqualsAndHashCode;  // 导入 Lombok 提供的 @EqualsAndHashCode 注解，自动生成 equals 和 hashCode 方法
+import org.springframework.format.annotation.DateTimeFormat;  // 导入用于格式化日期的注解
 
-import java.util.Date;
+import java.util.Date;  // 导入日期类
 
 /**
  * @Author: 落亦-
  * @Date: 2019/12/18 10:29
  */
-@Data
-@EqualsAndHashCode(callSuper = false)
-public class OutportVo extends Outport {
+@Data  // Lombok 注解，自动生成 getter、setter、toString、equals 和 hashCode 方法
+@EqualsAndHashCode(callSuper = false)  // Lombok 注解，自动生成 equals 和 hashCode 方法，不考虑父类的字段
+public class OutportVo extends Outport {  // OutportVo 继承自 Outport，表示出货视图对象，添加了分页和时间筛选功能
 
-    private Integer page = 1;
-
-    private Integer limit = 10;
-
-    @DateTimeFormat(pattern = "yyyy-MM-dd")
-    private Date startTime;
-
-    @DateTimeFormat(pattern = "yyyy-MM-dd")
-    private Date endTime;
+    private Integer page = 1;  // 分页参数，默认为第一页
+    private Integer limit = 10;  // 分页参数，默认为每页显示10条数据
 
+    @DateTimeFormat(pattern = "yyyy-MM-dd")  // 格式化日期字段，要求日期格式为 "yyyy-MM-dd"
+    private Date startTime;  // 开始时间，用于筛选出货记录的起始时间
 
+    @DateTimeFormat(pattern = "yyyy-MM-dd")  // 格式化日期字段，要求日期格式为 "yyyy-MM-dd"
+    private Date endTime;  // 结束时间，用于筛选出货记录的结束时间
 }

src/main/java/com/yeqifu/bus/vo/ProviderVo.java

@@ -1,27 +1,25 @@
-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.Provider;  // 导入 Provider 实体类，表示供应商信息
+import lombok.Data;  // 导入 Lombok 提供的 @Data 注解，自动生成 getter、setter、toString 等方法
+import lombok.EqualsAndHashCode;  // 导入 Lombok 提供的 @EqualsAndHashCode 注解，自动生成 equals 和 hashCode 方法
 
 /**
  * @Author: 落亦-
  * @Date: 2019/12/5 9:30
  */
-@Data
-@EqualsAndHashCode(callSuper = false)
-public class ProviderVo extends Provider{
+@Data  // Lombok 注解，自动生成 getter、setter、toString、equals 和 hashCode 方法
+@EqualsAndHashCode(callSuper = false)  // Lombok 注解，自动生成 equals 和 hashCode 方法，不考虑父类的字段
+public class ProviderVo extends Provider {  // ProviderVo 继承自 Provider，表示供应商视图对象，添加了分页和批量删除功能
 
     /**
      * 分页参数，当前是第一页，每页10条数据
      */
-    private Integer page=1;
-    private Integer limit=10;
+    private Integer page = 1;  // 分页参数，默认为第一页
+    private Integer limit = 10;  // 分页参数，默认为每页显示10条数据
 
     /**
      * 批量删除供应商，存放供应商ID的数组
      */
-    private Integer[] ids;
-
+    private Integer[] ids;  // 存放多个供应商ID，用于批量删除
 }

src/main/java/com/yeqifu/bus/vo/SalesVo.java

@@ -1,28 +1,27 @@
-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 com.yeqifu.bus.entity.Sales;  // 导入 Sales 实体类，表示销售信息
+import lombok.Data;  // 导入 Lombok 提供的 @Data 注解，自动生成 getter、setter、toString 等方法
+import lombok.EqualsAndHashCode;  // 导入 Lombok 提供的 @EqualsAndHashCode 注解，自动生成 equals 和 hashCode 方法
+import org.springframework.format.annotation.DateTimeFormat;  // 导入 Spring 的 @DateTimeFormat 注解，用于格式化日期
 
-import java.util.Date;
+import java.util.Date;  // 导入 Date 类，表示日期类型
 
 /**
  * @Author: 落亦-
  * @Date: 2019/12/18 10:29
  */
-@Data
-@EqualsAndHashCode(callSuper = false)
-public class SalesVo extends Sales {
+@Data  // Lombok 注解，自动生成 getter、setter、toString、equals 和 hashCode 方法
+@EqualsAndHashCode(callSuper = false)  // Lombok 注解，自动生成 equals 和 hashCode 方法，不考虑父类的字段
+public class SalesVo extends Sales {  // SalesVo 继承自 Sales，表示销售的视图对象，添加了分页和日期过滤功能
 
-    private Integer page = 1;
+    private Integer page = 1;  // 分页参数，默认为第一页
 
-    private Integer limit = 10;
+    private Integer limit = 10;  // 分页参数，默认为每页显示10条数据
 
-    @DateTimeFormat(pattern = "yyyy-MM-dd")
-    private Date startTime;
-
-    @DateTimeFormat(pattern = "yyyy-MM-dd")
-    private Date endTime;
+    @DateTimeFormat(pattern = "yyyy-MM-dd")  // 设置日期格式化的注解，适用于 startTime 字段
+    private Date startTime;  // 查询的起始时间，用于过滤销售数据的时间范围
 
+    @DateTimeFormat(pattern = "yyyy-MM-dd")  // 设置日期格式化的注解，适用于 endTime 字段
+    private Date endTime;  // 查询的结束时间，用于过滤销售数据的时间范围
 }

src/main/java/com/yeqifu/bus/vo/SalesbackVo.java

@@ -1,29 +1,27 @@
-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 com.yeqifu.bus.entity.Salesback;  // 导入 Salesback 实体类，表示销售退货信息
+import lombok.Data;  // 导入 Lombok 提供的 @Data 注解，自动生成 getter、setter、toString 等方法
+import lombok.EqualsAndHashCode;  // 导入 Lombok 提供的 @EqualsAndHashCode 注解，自动生成 equals 和 hashCode 方法
+import org.springframework.format.annotation.DateTimeFormat;  // 导入 Spring 的 @DateTimeFormat 注解，用于格式化日期
 
-import java.util.Date;
+import java.util.Date;  // 导入 Date 类，表示日期类型
 
 /**
  * @Author: 落亦-
  * @Date: 2019/12/18 10:29
  */
-@Data
-@EqualsAndHashCode(callSuper = false)
-public class SalesbackVo extends Salesback {
+@Data  // Lombok 注解，自动生成 getter、setter、toString、equals 和 hashCode 方法
+@EqualsAndHashCode(callSuper = false)  // Lombok 注解，自动生成 equals 和 hashCode 方法，不考虑父类的字段
+public class SalesbackVo extends Salesback {  // SalesbackVo 继承自 Salesback，表示销售退货的视图对象，添加了分页和日期过滤功能
 
-    private Integer page = 1;
+    private Integer page = 1;  // 分页参数，默认为第一页
 
-    private Integer limit = 10;
-
-    @DateTimeFormat(pattern = "yyyy-MM-dd")
-    private Date startTime;
-
-    @DateTimeFormat(pattern = "yyyy-MM-dd")
-    private Date endTime;
+    private Integer limit = 10;  // 分页参数，默认为每页显示10条数据
 
+    @DateTimeFormat(pattern = "yyyy-MM-dd")  // 设置日期格式化的注解，适用于 startTime 字段
+    private Date startTime;  // 查询的起始时间，用于过滤销售退货数据的时间范围
 
+    @DateTimeFormat(pattern = "yyyy-MM-dd")  // 设置日期格式化的注解，适用于 endTime 字段
+    private Date endTime;  // 查询的结束时间，用于过滤销售退货数据的时间范围
 }