Merge pull request '3' (#7) from cqq into develop

src/main/java/com/dao/YonghuDao.java

@@ -9,10 +9,10 @@ import com.baomidou.mybatisplus.plugins.pagination.Pagination;
 import org.apache.ibatis.annotations.Param;
 import com.entity.view.YonghuView;
 
-/**
- * 用户 Dao 接口
- *
- * @author 
+
+/*
+  * 用户 Dao 接口
+ * @author
  */
 public interface YonghuDao extends BaseMapper<YonghuEntity> {
 

src/main/java/com/entity/YonghuEntity.java

@@ -21,325 +21,332 @@ import com.baomidou.mybatisplus.enums.FieldFill;
 import com.baomidou.mybatisplus.enums.IdType;
 
 /**
- * 用户
+ * 用户实体类
+ * 数据库表映射对象，对应数据库中的yonghu表
  *
- * @author 
+ * @author
  * @email
  */
-@TableName("yonghu")
+@TableName("yonghu")  // 指定对应的数据库表名
 public class YonghuEntity<T> implements Serializable {
-    private static final long serialVersionUID = 1L;
+    private static final long serialVersionUID = 1L;  // 序列化版本UID
 
+    /**
+     * 无参构造函数
+     */
+    public YonghuEntity() {
 
-	public YonghuEntity() {
-
-	}
-
-	public YonghuEntity(T t) {
-		try {
-			BeanUtils.copyProperties(this, t);
-		} catch (IllegalAccessException | InvocationTargetException e) {
-			// TODO Auto-generated catch block
-			e.printStackTrace();
-		}
-	}
-
+    }
 
     /**
-     * 主键
+     * 带参构造函数
+     * 通过BeanUtils将传入对象的属性拷贝到当前对象
+     * @param t 源对象
      */
-    @TableId(type = IdType.AUTO)
-    @TableField(value = "id")
+    public YonghuEntity(T t) {
+        try {
+            BeanUtils.copyProperties(this, t);  // 使用BeanUtils进行属性拷贝
+        } catch (IllegalAccessException | InvocationTargetException e) {
+            // 打印异常堆栈
+            e.printStackTrace();
+        }
+    }
 
+    /**
+     * 主键ID
+     * 自增类型
+     */
+    @TableId(type = IdType.AUTO)  // 主键自增
+    @TableField(value = "id")  // 对应数据库字段名
     private Integer id;
 
-
     /**
-     * 账户
+     * 用户名/账户
+     * 用于登录系统的唯一标识
      */
-    @TableField(value = "username")
-
+    @TableField(value = "username")  // 对应数据库字段名
     private String username;
 
-
     /**
      * 密码
+     * 存储加密后的用户密码
      */
-    @TableField(value = "password")
-
+    @TableField(value = "password")  // 对应数据库字段名
     private String password;
 
-
     /**
-     * 用户姓名
+     * 用户真实姓名
      */
-    @TableField(value = "yonghu_name")
-
+    @TableField(value = "yonghu_name")  // 对应数据库字段名
     private String yonghuName;
 
-
     /**
-     * 头像
+     * 用户头像
+     * 存储头像图片路径
      */
-    @TableField(value = "yonghu_photo")
-
+    @TableField(value = "yonghu_photo")  // 对应数据库字段名
     private String yonghuPhoto;
 
-
     /**
      * 用户手机号
      */
-    @TableField(value = "yonghu_phone")
-
+    @TableField(value = "yonghu_phone")  // 对应数据库字段名
     private String yonghuPhone;
 
-
     /**
      * 用户身份证号
      */
-    @TableField(value = "yonghu_id_number")
-
+    @TableField(value = "yonghu_id_number")  // 对应数据库字段名
     private String yonghuIdNumber;
 
-
     /**
-     * 邮箱
+     * 用户邮箱
      */
-    @TableField(value = "yonghu_email")
-
+    @TableField(value = "yonghu_email")  // 对应数据库字段名
     private String yonghuEmail;
 
-
     /**
      * 性别
+     * 使用数字表示，对应字典表中的性别类型
      */
-    @TableField(value = "sex_types")
-
+    @TableField(value = "sex_types")  // 对应数据库字段名
     private Integer sexTypes;
 
-
     /**
-     * 余额
+     * 用户余额
      */
-    @TableField(value = "new_money")
-
+    @TableField(value = "new_money")  // 对应数据库字段名
     private Double newMoney;
 
-
     /**
-     * 假删
+     * 逻辑删除标志
+     * 1-未删除，2-已删除
      */
-    @TableField(value = "yonghu_delete")
-
+    @TableField(value = "yonghu_delete")  // 对应数据库字段名
     private Integer yonghuDelete;
 
-
     /**
      * 创建时间
+     * 自动填充，格式化为yyyy-MM-dd HH:mm:ss
      */
-    @JsonFormat(locale="zh", timezone="GMT+8", pattern="yyyy-MM-dd HH:mm:ss")
-	@DateTimeFormat
-    @TableField(value = "create_time",fill = FieldFill.INSERT)
-
+    @JsonFormat(locale="zh", timezone="GMT+8", pattern="yyyy-MM-dd HH:mm:ss")  // 日期格式化
+    @DateTimeFormat  // 日期格式
+    @TableField(value = "create_time",fill = FieldFill.INSERT)  // 插入时自动填充
     private Date createTime;
 
+    // ================ getter和setter方法 ================
 
     /**
-	 * 设置：主键
-	 */
+     * 获取主键ID
+     * @return id 主键ID
+     */
     public Integer getId() {
         return id;
     }
 
-
     /**
-	 * 获取：主键
-	 */
-
+     * 设置主键ID
+     * @param id 主键ID
+     */
     public void setId(Integer id) {
         this.id = id;
     }
+
     /**
-	 * 设置：账户
-	 */
+     * 获取用户名/账户
+     * @return username 用户名
+     */
     public String getUsername() {
         return username;
     }
 
-
     /**
-	 * 获取：账户
-	 */
-
+     * 设置用户名/账户
+     * @param username 用户名
+     */
     public void setUsername(String username) {
         this.username = username;
     }
+
     /**
-	 * 设置：密码
-	 */
+     * 获取密码
+     * @return password 密码
+     */
     public String getPassword() {
         return password;
     }
 
-
     /**
-	 * 获取：密码
-	 */
-
+     * 设置密码
+     * @param password 密码
+     */
     public void setPassword(String password) {
         this.password = password;
     }
+
     /**
-	 * 设置：用户姓名
-	 */
+     * 获取用户真实姓名
+     * @return yonghuName 用户姓名
+     */
     public String getYonghuName() {
         return yonghuName;
     }
 
-
     /**
-	 * 获取：用户姓名
-	 */
-
+     * 设置用户真实姓名
+     * @param yonghuName 用户姓名
+     */
     public void setYonghuName(String yonghuName) {
         this.yonghuName = yonghuName;
     }
+
     /**
-	 * 设置：头像
-	 */
+     * 获取用户头像路径
+     * @return yonghuPhoto 头像路径
+     */
     public String getYonghuPhoto() {
         return yonghuPhoto;
     }
 
-
     /**
-	 * 获取：头像
-	 */
-
+     * 设置用户头像路径
+     * @param yonghuPhoto 头像路径
+     */
     public void setYonghuPhoto(String yonghuPhoto) {
         this.yonghuPhoto = yonghuPhoto;
     }
+
     /**
-	 * 设置：用户手机号
-	 */
+     * 获取用户手机号
+     * @return yonghuPhone 手机号
+     */
     public String getYonghuPhone() {
         return yonghuPhone;
     }
 
-
     /**
-	 * 获取：用户手机号
-	 */
-
+     * 设置用户手机号
+     * @param yonghuPhone 手机号
+     */
     public void setYonghuPhone(String yonghuPhone) {
         this.yonghuPhone = yonghuPhone;
     }
+
     /**
-	 * 设置：用户身份证号
-	 */
+     * 获取用户身份证号
+     * @return yonghuIdNumber 身份证号
+     */
     public String getYonghuIdNumber() {
         return yonghuIdNumber;
     }
 
-
     /**
-	 * 获取：用户身份证号
-	 */
-
+     * 设置用户身份证号
+     * @param yonghuIdNumber 身份证号
+     */
     public void setYonghuIdNumber(String yonghuIdNumber) {
         this.yonghuIdNumber = yonghuIdNumber;
     }
+
     /**
-	 * 设置：邮箱
-	 */
+     * 获取用户邮箱
+     * @return yonghuEmail 邮箱地址
+     */
     public String getYonghuEmail() {
         return yonghuEmail;
     }
 
-
     /**
-	 * 获取：邮箱
-	 */
-
+     * 设置用户邮箱
+     * @param yonghuEmail 邮箱地址
+     */
     public void setYonghuEmail(String yonghuEmail) {
         this.yonghuEmail = yonghuEmail;
     }
+
     /**
-	 * 设置：性别
-	 */
+     * 获取性别类型
+     * @return sexTypes 性别类型编码
+     */
     public Integer getSexTypes() {
         return sexTypes;
     }
 
-
     /**
-	 * 获取：性别
-	 */
-
+     * 设置性别类型
+     * @param sexTypes 性别类型编码
+     */
     public void setSexTypes(Integer sexTypes) {
         this.sexTypes = sexTypes;
     }
+
     /**
-	 * 设置：余额
-	 */
+     * 获取用户余额
+     * @return newMoney 余额
+     */
     public Double getNewMoney() {
         return newMoney;
     }
 
-
     /**
-	 * 获取：余额
-	 */
-
+     * 设置用户余额
+     * @param newMoney 余额
+     */
     public void setNewMoney(Double newMoney) {
         this.newMoney = newMoney;
     }
+
     /**
-	 * 设置：假删
-	 */
+     * 获取逻辑删除标志
+     * @return yonghuDelete 删除状态(1-未删除，2-已删除)
+     */
     public Integer getYonghuDelete() {
         return yonghuDelete;
     }
 
-
     /**
-	 * 获取：假删
-	 */
-
+     * 设置逻辑删除标志
+     * @param yonghuDelete 删除状态(1-未删除，2-已删除)
+     */
     public void setYonghuDelete(Integer yonghuDelete) {
         this.yonghuDelete = yonghuDelete;
     }
+
     /**
-	 * 设置：创建时间
-	 */
+     * 获取创建时间
+     * @return createTime 创建时间
+     */
     public Date getCreateTime() {
         return createTime;
     }
 
-
     /**
-	 * 获取：创建时间
-	 */
-
+     * 设置创建时间
+     * @param createTime 创建时间
+     */
     public void setCreateTime(Date createTime) {
         this.createTime = createTime;
     }
 
+    /**
+     * 重写toString方法
+     * @return 对象字符串表示
+     */
     @Override
     public String toString() {
         return "Yonghu{" +
-            "id=" + id +
-            ", username=" + username +
-            ", password=" + password +
-            ", yonghuName=" + yonghuName +
-            ", yonghuPhoto=" + yonghuPhoto +
-            ", yonghuPhone=" + yonghuPhone +
-            ", yonghuIdNumber=" + yonghuIdNumber +
-            ", yonghuEmail=" + yonghuEmail +
-            ", sexTypes=" + sexTypes +
-            ", newMoney=" + newMoney +
-            ", yonghuDelete=" + yonghuDelete +
-            ", createTime=" + createTime +
-        "}";
+                "id=" + id +
+                ", username=" + username +
+                ", password=" + password +
+                ", yonghuName=" + yonghuName +
+                ", yonghuPhoto=" + yonghuPhoto +
+                ", yonghuPhone=" + yonghuPhone +
+                ", yonghuIdNumber=" + yonghuIdNumber +
+                ", yonghuEmail=" + yonghuEmail +
+                ", sexTypes=" + sexTypes +
+                ", newMoney=" + newMoney +
+                ", yonghuDelete=" + yonghuDelete +
+                ", createTime=" + createTime +
+                "}";
     }
-}
+}

src/main/java/com/entity/model/YonghuModel.java

@@ -1,10 +1,14 @@
 package com.entity.model;
 
+// 导入用户实体类
 import com.entity.YonghuEntity;
 
+// 导入MyBatis-Plus的表名注解
 import com.baomidou.mybatisplus.annotations.TableName;
+// 导入Jackson的日期格式化注解
 import com.fasterxml.jackson.annotation.JsonFormat;
 import java.util.Date;
+// 导入Spring的日期格式化注解
 import org.springframework.format.annotation.DateTimeFormat;
 import java.io.Serializable;
 
@@ -16,252 +20,239 @@ import java.io.Serializable;
  * 取自ModelAndView 的model名称
  */
 public class YonghuModel implements Serializable {
+    // 序列化版本号，用于保证序列化和反序列化的兼容性
     private static final long serialVersionUID = 1L;
 
-
-
-
     /**
      * 主键
      */
     private Integer id;
 
-
     /**
      * 账户
      */
     private String username;
 
-
     /**
      * 密码
      */
     private String password;
 
-
     /**
      * 用户姓名
      */
     private String yonghuName;
 
-
     /**
      * 头像
      */
     private String yonghuPhoto;
 
-
     /**
      * 用户手机号
      */
     private String yonghuPhone;
 
-
     /**
      * 用户身份证号
      */
     private String yonghuIdNumber;
 
-
     /**
      * 邮箱
      */
     private String yonghuEmail;
 
-
     /**
      * 性别
      */
     private Integer sexTypes;
 
-
     /**
      * 余额
      */
     private Double newMoney;
 
-
     /**
      * 假删
+     * 用一个整数来标记用户是否被逻辑删除，例如0表示未删除，1表示已删除
      */
     private Integer yonghuDelete;
 
-
     /**
      * 创建时间
      */
+    // 用于JSON序列化时，将日期格式化为指定的格式，这里指定为中国时区，格式为yyyy-MM-dd HH:mm:ss
     @JsonFormat(locale="zh", timezone="GMT+8", pattern="yyyy-MM-dd HH:mm:ss")
-	@DateTimeFormat
+    // 用于Spring MVC接收表单数据时，将字符串类型的日期转换为Date类型
+    @DateTimeFormat
     private Date createTime;
 
-
     /**
-	 * 获取：主键
-	 */
+     * 获取：主键
+     */
     public Integer getId() {
         return id;
     }
 
-
     /**
-	 * 设置：主键
-	 */
+     * 设置：主键
+     */
     public void setId(Integer id) {
         this.id = id;
     }
+
     /**
-	 * 获取：账户
-	 */
+     * 获取：账户
+     */
     public String getUsername() {
         return username;
     }
 
-
     /**
-	 * 设置：账户
-	 */
+     * 设置：账户
+     */
     public void setUsername(String username) {
         this.username = username;
     }
+
     /**
-	 * 获取：密码
-	 */
+     * 获取：密码
+     */
     public String getPassword() {
         return password;
     }
 
-
     /**
-	 * 设置：密码
-	 */
+     * 设置：密码
+     */
     public void setPassword(String password) {
         this.password = password;
     }
+
     /**
-	 * 获取：用户姓名
-	 */
+     * 获取：用户姓名
+     */
     public String getYonghuName() {
         return yonghuName;
     }
 
-
     /**
-	 * 设置：用户姓名
-	 */
+     * 设置：用户姓名
+     */
     public void setYonghuName(String yonghuName) {
         this.yonghuName = yonghuName;
     }
+
     /**
-	 * 获取：头像
-	 */
+     * 获取：头像
+     */
     public String getYonghuPhoto() {
         return yonghuPhoto;
     }
 
-
     /**
-	 * 设置：头像
-	 */
+     * 设置：头像
+     */
     public void setYonghuPhoto(String yonghuPhoto) {
         this.yonghuPhoto = yonghuPhoto;
     }
+
     /**
-	 * 获取：用户手机号
-	 */
+     * 获取：用户手机号
+     */
     public String getYonghuPhone() {
         return yonghuPhone;
     }
 
-
     /**
-	 * 设置：用户手机号
-	 */
+     * 设置：用户手机号
+     */
     public void setYonghuPhone(String yonghuPhone) {
         this.yonghuPhone = yonghuPhone;
     }
+
     /**
-	 * 获取：用户身份证号
-	 */
+     * 获取：用户身份证号
+     */
     public String getYonghuIdNumber() {
         return yonghuIdNumber;
     }
 
-
     /**
-	 * 设置：用户身份证号
-	 */
+     * 设置：用户身份证号
+     */
     public void setYonghuIdNumber(String yonghuIdNumber) {
         this.yonghuIdNumber = yonghuIdNumber;
     }
+
     /**
-	 * 获取：邮箱
-	 */
+     * 获取：邮箱
+     */
     public String getYonghuEmail() {
         return yonghuEmail;
     }
 
-
     /**
-	 * 设置：邮箱
-	 */
+     * 设置：邮箱
+     */
     public void setYonghuEmail(String yonghuEmail) {
         this.yonghuEmail = yonghuEmail;
     }
+
     /**
-	 * 获取：性别
-	 */
+     * 获取：性别
+     */
     public Integer getSexTypes() {
         return sexTypes;
     }
 
-
     /**
-	 * 设置：性别
-	 */
+     * 设置：性别
+     */
     public void setSexTypes(Integer sexTypes) {
         this.sexTypes = sexTypes;
     }
+
     /**
-	 * 获取：余额
-	 */
+     * 获取：余额
+     */
     public Double getNewMoney() {
         return newMoney;
     }
 
-
     /**
-	 * 设置：余额
-	 */
+     * 设置：余额
+     */
     public void setNewMoney(Double newMoney) {
         this.newMoney = newMoney;
     }
+
     /**
-	 * 获取：假删
-	 */
+     * 获取：假删
+     */
     public Integer getYonghuDelete() {
         return yonghuDelete;
     }
 
-
     /**
-	 * 设置：假删
-	 */
+     * 设置：假删
+     */
     public void setYonghuDelete(Integer yonghuDelete) {
         this.yonghuDelete = yonghuDelete;
     }
+
     /**
-	 * 获取：创建时间
-	 */
+     * 获取：创建时间
+     */
     public Date getCreateTime() {
         return createTime;
     }
 
-
     /**
-	 * 设置：创建时间
-	 */
+     * 设置：创建时间
+     */
     public void setCreateTime(Date createTime) {
         this.createTime = createTime;
     }
-
-    }
+}

src/main/java/com/entity/view/YonghuView.java

@@ -9,6 +9,7 @@ import com.fasterxml.jackson.annotation.JsonFormat;
 import java.io.Serializable;
 import java.util.Date;
 
+
 /**
  * 用户
  * 后端返回视图实体辅助类
@@ -18,9 +19,10 @@ import java.util.Date;
 public class YonghuView extends YonghuEntity implements Serializable {
     private static final long serialVersionUID = 1L;
 
-		/**
-		* 性别的值
-		*/
+
+	/**
+	 * 性别的值
+	 */
 		private String sexValue;
 
 
@@ -40,15 +42,17 @@ public class YonghuView extends YonghuEntity implements Serializable {
 
 
 
-			/**
-			* 获取： 性别的值
-			*/
+
+	/**
+	 * 获取： 性别的值
+	 */
 			public String getSexValue() {
 				return sexValue;
 			}
-			/**
-			* 设置： 性别的值
-			*/
+
+	/**
+	 * 设置： 性别的值
+	 */
 			public void setSexValue(String sexValue) {
 				this.sexValue = sexValue;
 			}

src/main/java/com/service/YonghuService.java

@@ -6,14 +6,16 @@ import com.entity.YonghuEntity;
 import java.util.Map;
 import javax.servlet.http.HttpServletRequest;
 
+
 /**
  * 用户 服务类
  */
 public interface YonghuService extends IService<YonghuEntity> {
 
+
     /**
-    * @param params 查询参数
-    * @return 带分页的查询出来的数据
-    */
+     * @param params 查询参数
+     * @return 带分页的查询出来的数据
+     */
      PageUtils queryPage(Map<String, Object> params);
 }