Default Changelist

backend/src/main/java/lsgwr/exam/entity/Exam.java

@@ -4,51 +4,60 @@
  * @date        : 2019/5/14 07:42
  * @email       : liangshanguang2@gmail.com
  ***********************************************************/
-
+// 定义包名，用于组织类文件，避免命名冲突
 package lsgwr.exam.entity;
 
-
+// 导入Jackson库的JsonFormat注解，用于JSON序列化时自定义日期格式
 import com.fasterxml.jackson.annotation.JsonFormat;
+// 导入Lombok库的Data注解，用于自动生成getter、setter、equals、hashCode和toString方法
 import lombok.Data;
+// 导入Hibernate的DynamicUpdate注解，用于在实体更新时只更新发生变化的字段
 import org.hibernate.annotations.DynamicUpdate;
-
+// 导入JPA的Entity注解，用于声明该类是一个JPA实体类
 import javax.persistence.Entity;
+// 导入JPA的Id注解，用于声明该类中的某个字段作为主键
 import javax.persistence.Id;
+// 导入Java的Date类，用于表示日期和时间
 import java.util.Date;
 
 @Entity
 @Data
 @DynamicUpdate
 public class Exam {
+    // 使用JPA的@Id注解声明该字段为主键
     @Id
-    private String examId;
-    private String examName;
-    private String examAvatar;
-    private String examDescription;
-    private String examQuestionIds;
-    private String examQuestionIdsRadio;
-    private String examQuestionIdsCheck;
-    private String examQuestionIdsJudge;
-    private Integer examScore;
-    private Integer examScoreRadio;
-    private Integer examScoreCheck;
-    private Integer examScoreJudge;
-    private String examCreatorId;
-    private Integer examTimeLimit;
+    private String examId;// 考试ID，唯一标识一场考试
+    private String examName;// 考试名称
+    private String examAvatar; // 考试头像或图标
+    private String examDescription;// 考试描述或简介
+    private String examQuestionIds;// 存储所有问题ID的字符串，可能是逗号分隔的ID列表
+    private String examQuestionIdsRadio;// 存储所有单选题ID的字符串
+    private String examQuestionIdsCheck;// 存储所有多选题ID的字符串
+    private String examQuestionIdsJudge;// 存储所有判断题ID的字符串
+    private Integer examScore;// 考试总分
+    private Integer examScoreRadio;// 单选题总分
+    private Integer examScoreCheck;// 多选题总分
+    private Integer examScoreJudge;// 判断题总分
+    private String examCreatorId;// 创建者ID，标识谁创建了这场考试
+    private Integer examTimeLimit;// 考试时间限制，单位可能是分钟
+    // 考试开始时间，使用Jackson的@JsonFormat注解自定义日期格式
     @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
     private Date examStartDate;
+    // 考试结束时间
     @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
     private Date examEndDate;
     /**
-     * 创建时间, 设计表时设置了自动插入当前时间，无需在Java代码中设置了
+     * 创建时间，设计数据库表时设置了自动插入当前时间，因此在Java代码中无需手动设置。
+     * 使用Jackson的@JsonFormat注解自定义日期格式以便于前端展示。
      */
 
     @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
     private Date createTime;
 
     /**
-     * 更新时间，设计表时设置了自动插入当前时间，无需在Java代码中设置了。
-     * 同时@DynamicUpdate注解可以时间当数据库数据变化时自动更新，无需人工维护
+     * 更新时间，设计数据库表时也设置了自动插入当前时间（或更新为当前时间），在Java代码中无需手动维护。
+     * 同时，由于使用了Hibernate的@DynamicUpdate注解，当数据库中的实体数据发生变化时，该字段会自动更新为当前时间。
+     * 使用Jackson的@JsonFormat注解自定义日期格式以便于前端展示。
      */
     @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
     private Date updateTime;

backend/src/main/java/lsgwr/exam/entity/ExamRecord.java

@@ -7,42 +7,44 @@
 package lsgwr.exam.entity;
 
 
-import com.fasterxml.jackson.annotation.JsonFormat;
-import lombok.Data;
+import com.fasterxml.jackson.annotation.JsonFormat;// 引入Jackson库用于日期格式化的注解
+import lombok.Data;// 引入Lombok库用于简化Java实体类的编写，如自动生成getter和setter方法
 
-import javax.persistence.Entity;
+import javax.persistence.Entity;// 引入JPA注解，用于标识这是一个实体类，并映射到数据库中的一张表
+// 引入JPA注解，用于标识实体类的主键字段
 import javax.persistence.Id;
 import java.util.Date;
-
+// 使用@Data注解自动生成getter和setter方法，以及toString、equals和hashCode方法
 @Data
+// 使用@Entity注解标识这是一个JPA实体类
 @Entity
 public class ExamRecord {
     /**
-     * 主键
+     * 主键，用于唯一标识一条考试记录
      */
     @Id
     private String examRecordId;
     /**
-     * 参与的考试的id
+     * 关联的考试ID，用于标识考生参加的是哪一场考试
      */
     private String examId;
 
     /**
-     * 考生作答地每个题目的选项(题目和题目之间用_分隔，题目有多个选项地话用-分隔),用于查看考试详情
+     * 考生作答的每个题目的选项，题目之间用下划线_分隔，若题目有多个选项则用短横线-分隔。这个字段用于查看考试详情时展示考生作答情况。
      */
     private String answerOptionIds;
 
     /**
-     * 参与者，即user的id
+     * 参与考试的考生ID，即用户的ID
      */
     private String examJoinerId;
     /**
-     * 参加考试的日期
+     * 参加考试的日期和时间
      */
     @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
     private Date examJoinDate;
     /**
-     * 考试耗时(秒)
+     * 考试耗时，单位为秒
      */
     private Integer examTimeCost;
     /**
@@ -50,7 +52,7 @@ public class ExamRecord {
      */
     private Integer examJoinScore;
     /**
-     * 考试得分水平
+     * 考试得分水平，通常根据得分划分不同的等级，如优秀、良好、及格等（具体等级需另建表定义）
      */
     private Integer examResultLevel;
 }

backend/src/main/java/lsgwr/exam/entity/ExamRecordLevel.java

@@ -7,21 +7,22 @@
 package lsgwr.exam.entity;
 
 
-import lombok.Data;
-
-import javax.persistence.Entity;
-import javax.persistence.GeneratedValue;
-import javax.persistence.Id;
+import lombok.Data;// 引入Lombok库中的@Data注解，用于自动生成getter、setter、toString、equals和hashCode方法
 
+import javax.persistence.Entity;// 引入JPA（Java Persistence API）中的@Entity注解，标识这是一个实体类，与数据库中的表相对应
+import javax.persistence.GeneratedValue;// 引入JPA中的@GeneratedValue注解，用于指定主键的生成策略，这里未明确指定策略，将使用默认策略
+import javax.persistence.Id;// 引入JPA中的@Id注解，标识实体类的主键字段
+// 使用@Data注解自动生成getter、setter等方法
 @Data
+// 使用@Entity注解标识这是一个JPA实体类
 @Entity
 public class ExamRecordLevel {
-    // 考试记录等级ID
+    // 考试记录等级的ID，是主键，通过@Id注解标识，并通过@GeneratedValue注解指定主键生成策略
     @Id
     @GeneratedValue
     private Integer examRecordLevelId;
-    // 考试记录等级名称
+    // 考试记录等级的名称，用于标识等级，如“优秀”、“良好”等
     private String examRecordLevelName;
-    // 考试记录等级描述
+    // 考试记录等级的描述，用于对等级进行更详细的说明
     private String examRecordLevelDescription;
 }