111

snailmall-shipping-service/src/main/java/com/njupt/swg/entity/Shipping.java

@@ -7,32 +7,48 @@ import lombok.NoArgsConstructor;
 
 import java.util.Date;
 
+// 使用lombok的@Data注解，该注解会自动为类生成一系列常用方法，包括所有非静态成员变量的Getter、Setter方法，以及equals、hashCode、toString方法等，方便在其他地方对类的对象进行属性访问、比较以及以字符串形式展示等操作，减少了手动编写这些重复代码的工作量。
 @Data
+// 使用lombok的@NoArgsConstructor注解，会为该类生成一个无参构造函数，在一些需要默认创建类实例的场景下（比如反序列化等）能够方便地使用，确保可以通过无参的方式构造出Shipping类的对象。
 @NoArgsConstructor
+// 使用lombok的@AllArgsConstructor注解，会为该类生成一个包含所有参数的构造函数，调用这个构造函数时可以一次性传入所有成员变量的值来创建Shipping类的对象，适用于需要完整初始化对象所有属性的情况。
 @AllArgsConstructor
 public class Shipping {
+    // 定义一个Integer类型的私有成员变量id，用于存储地址记录在系统中的唯一标识，通常对应数据库表中的主键字段，用于区分不同的地址记录。
     private Integer id;
 
+    // 定义一个Integer类型的私有成员变量userId，用于存储该地址所属用户的唯一标识，通过这个字段可以关联到具体的用户，表明该地址是哪个用户的收货地址。
     private Integer userId;
 
+    // 定义一个String类型的私有成员变量receiverName，用于存储收货人的姓名，方便在物流配送等场景中明确收件人信息。
     private String receiverName;
 
+    // 定义一个String类型的私有成员变量receiverPhone，用于存储收货人的固定电话号码，作为一种联系方式，方便快递员等相关人员与收件人沟通联系。
     private String receiverPhone;
 
+    // 定义一个String类型的私有成员变量receiverMobile，用于存储收货人的手机号码，在现代物流配送中，手机号码通常是更常用的联系方式，便于接收快递相关的通知等信息。
     private String receiverMobile;
 
+    // 定义一个String类型的私有成员变量receiverProvince，用于存储收货地址所在的省份信息，明确地址的大致地理位置范围。
     private String receiverProvince;
 
+    // 定义一个String类型的私有成员变量receiverCity，用于存储收货地址所在的城市信息，进一步细化地址的地理位置，方便物流准确配送。
     private String receiverCity;
 
+    // 定义一个String类型的私有成员变量receiverDistrict，用于存储收货地址所在的区（县）信息，更加精确地定位收货地址，有助于快递准确送达。
     private String receiverDistrict;
 
+    // 定义一个String类型的私有成员变量receiverAddress，用于存储详细的收货地址信息，如街道名称、门牌号等具体内容，确保快递能够准确送到收件人手中。
     private String receiverAddress;
 
+    // 定义一个String类型的私有成员变量receiverZip，用于存储收货地址对应的邮政编码，虽然在现在的物流配送中邮政编码的使用频率相对降低，但在一些情况下仍可能有辅助定位等作用。
     private String receiverZip;
 
+    // 使用Jackson的@JsonFormat注解来配置日期类型（Date）的成员变量createTime在序列化为JSON格式时的格式，指定shape为JsonFormat.Shape.STRING，表示将日期转换为字符串形式，
+    // pattern属性设置为"yyyy-MM-dd HH:mm:ss.SSS"，即按照年-月-日 时:分:秒.毫秒的格式进行序列化，这样在将Shipping对象转换为JSON数据时，createTime字段会以指定的格式呈现，方便与前端等进行日期数据的交互和展示。
     @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss.SSS")
     private Date createTime;
+    // 同样使用@JsonFormat注解来配置日期类型的成员变量updateTime在序列化为JSON格式时的格式，和createTime一样，将其转换为指定格式的字符串形式，便于在JSON数据中准确展示该日期信息，方便数据交互和查看更新时间等情况。
     @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss.SSS")
     private Date updateTime;
 }