12/15

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 条数据
 }

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; // 查询时间范围的结束时间
 }

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;
-
-
 }

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;
 

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;
 
 }

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;
 
-
 }