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

@@ -1,12 +1,5 @@
-/***********************************************************
- * @Description : 考试题目表
- * @author      : 梁山广(Laing Shan Guang)
- * @date        : 2019/5/14 07:46
- * @email       : liangshanguang2@gmail.com
- ***********************************************************/
 package lsgwr.exam.entity;
 
-
 import com.fasterxml.jackson.annotation.JsonFormat;
 import lombok.Data;
 import org.hibernate.annotations.DynamicUpdate;
@@ -15,25 +8,70 @@ import javax.persistence.Entity;
 import javax.persistence.Id;
 import java.util.Date;
 
+/**
+ * Question实体类，用于表示考试题目信息
+ * 该类使用了Lombok的@Data注解自动生成getter和setter方法，
+ * 以及Hibernate的@Entity注解表明这是一个JPA实体类
+ *  @DynamicUpdate注解用于在更新实体时只更新发生变化的字段
+ */
 @Data
 @Entity
 @DynamicUpdate
 public class Question {
+    /**
+     * 题目ID，主键
+     */
     @Id
     private String questionId;
+
+    /**
+     * 题目名称
+     */
     private String questionName;
+
+    /**
+     * 题目分数
+     */
     private Integer questionScore;
+
+    /**
+     * 创建题目的用户ID
+     */
     private String questionCreatorId;
+
+    /**
+     * 题目难度等级ID
+     */
     private Integer questionLevelId;
+
+    /**
+     * 题目类型ID
+     */
     private Integer questionTypeId;
+
+    /**
+     * 题目分类ID
+     */
     private Integer questionCategoryId;
+
+    /**
+     * 题目描述
+     */
     private String questionDescription;
+
+    /**
+     * 题目选项IDs
+     */
     private String questionOptionIds;
+
+    /**
+     * 题目答案选项IDs
+     */
     private String questionAnswerOptionIds;
+
     /**
      * 创建时间, 设计表时设置了自动插入当前时间，无需在Java代码中设置了
      */
-
     @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
     private Date createTime;
 

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

@@ -6,7 +6,11 @@
  ***********************************************************/
 package lsgwr.exam.entity;
 
-
+/**
+ * QuestionCategory类代表了一个实体，用于在数据库中存储问题类别信息。
+ * 这个类被标记为@Entity，意味着它是一个JPA实体，可以映射到数据库表。
+ * Lombok的@Data注解用于自动生成getter和setter方法，以及toString、equals和hashCode方法。
+ */
 import com.fasterxml.jackson.annotation.JsonProperty;
 import lombok.Data;
 
@@ -17,15 +21,26 @@ import javax.persistence.Id;
 @Data
 @Entity
 public class QuestionCategory {
-
+    /**
+     * 问题类别ID，是这个实体的主键。
+     * @Id注解指明了这个字段是实体的主键。
+     * @GeneratedValue注解表示这个字段的值是自动生成的。
+     * @JsonProperty注解用于序列化和反序列化时，指定JSON对象中的键名。
+     */
     @Id
     @GeneratedValue
     @JsonProperty("id")
     private Integer questionCategoryId;
-
+    /**
+     * 问题类别名称，用于描述这个类别的名字。
+     * @JsonProperty注解用于序列化和反序列化时，指定JSON对象中的键名。
+     */
     @JsonProperty("name")
     private String questionCategoryName;
-
+    /**
+     * 问题类别描述，用于提供这个类别的详细信息或说明。
+     * @JsonProperty注解用于序列化和反序列化时，指定JSON对象中的键名。
+     */
     @JsonProperty("description")
     private String questionCategoryDescription;
 }

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

@@ -20,11 +20,11 @@ public class QuestionLevel {
     @Id
     @GeneratedValue
     @JsonProperty("id")
-    private Integer questionLevelId;
+    private Integer questionLevelId;//题目难度等级ID
 
     @JsonProperty("name")
-    private String questionLevelName;
+    private String questionLevelName;//题目难度等级名称
 
     @JsonProperty("description")
-    private String questionLevelDescription;
+    private String questionLevelDescription;//题目难度等级描述
 }

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

@@ -11,12 +11,19 @@ import lombok.Data;
 
 import javax.persistence.Entity;
 import javax.persistence.Id;
-
+/**
+ * 表示考试题目选项的实体类，包括选项的标识符、内容和描述。
+ * 该类使用 @Entity 注解标记，表示这是一个 JPA 实体类，用于对象关系映射（ORM）与数据库交互。
+ * 使用 Lombok 库的 @Data 注解自动生成 getter、setter、构造方法以及 equals、hash 和 toString 方法，减少样板代码。
+ */
 @Data
 @Entity
 public class QuestionOption {
+    /**
+     * 题目选项的唯一标识符，使用 @Id 注解标记，表示该字段是实体的主键。
+     */
     @Id
     private String questionOptionId;
-    private String questionOptionContent;
-    private String questionOptionDescription;
+    private String questionOptionContent;// 选项内容，描述选项的文本或信息
+    private String questionOptionDescription;// 选项描述，对选项的详细解释或注释
 }

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

@@ -13,18 +13,25 @@ import lombok.Data;
 import javax.persistence.Entity;
 import javax.persistence.GeneratedValue;
 import javax.persistence.Id;
-
+/**
+ * QuestionType类代表了一个实体，用于在数据库中存储问题类型的信息。
+ * 它包括问题类型的ID、名称和描述。
+ */
 @Data
 @Entity
 public class QuestionType {
+    /**
+     * 问题类型的唯一标识符。
+     * 通过@JsonProperty注解，该字段在序列化和反序列化时将映射为"id"。
+     */
     @Id
     @GeneratedValue
     @JsonProperty("id")
     private Integer questionTypeId;
-
+    /// 问题类型的名称。
     @JsonProperty("name")
     private String questionTypeName;
-
+    //问题类型的描述。
     @JsonProperty("description")
     private String questionTypeDescription;
 }

backend/src/main/java/lsgwr/exam/enums/QuestionEnum.java

@@ -18,12 +18,12 @@ public enum QuestionEnum {
     CHECK(2, "多选题"),
     JUDGE(3, "判断题");
 
-
+    //构造函数，用于创建一个新的题目类型实例
     QuestionEnum(Integer id, String role) {
         this.id = id;
         this.role = role;
     }
 
-    private Integer id;
-    private String role;
+    private Integer id;// 角色id
+    private String role;// 角色名称
 }

backend/src/main/java/lsgwr/exam/repository/QuestionCategoryRepository.java

@@ -10,4 +10,6 @@ import lsgwr.exam.entity.QuestionCategory;
 import org.springframework.data.jpa.repository.JpaRepository;
 
 public interface QuestionCategoryRepository extends JpaRepository<QuestionCategory, Integer> {
+    // 该接口继承了JpaRepository，用于处理QuestionCategory实体的数据库操作
+    // Integer类型作为实体的主键类型
 }

backend/src/main/java/lsgwr/exam/repository/QuestionLevelRepository.java

@@ -1,13 +1,14 @@
-/***********************************************************
- * @Description : 
- * @author      : 梁山广(Laing Shan Guang)
- * @date        : 2019-05-14 08:26
- * @email       : liangshanguang2@gmail.com
- ***********************************************************/
+/**
+ * 问题级别数据访问层接口
+ * 继承自JpaRepository，用于对QuestionLevel实体进行数据库操作
+ * 该接口没有定义额外的方法，直接继承了JpaRepository提供的标准CRUD方法
+ */
 package lsgwr.exam.repository;
 
 import lsgwr.exam.entity.QuestionLevel;
 import org.springframework.data.jpa.repository.JpaRepository;
 
 public interface QuestionLevelRepository extends JpaRepository<QuestionLevel, Integer> {
+    // 该接口继承了JpaRepository，用于处理QuestionLevel实体的数据库操作
+    // Integer类型参数表示实体的主键类型
 }

backend/src/main/java/lsgwr/exam/repository/QuestionOptionRepository.java

@@ -1,13 +1,9 @@
-/***********************************************************
- * @Description : 
- * @author      : 梁山广(Laing Shan Guang)
- * @date        : 2019-05-14 08:27
- * @email       : liangshanguang2@gmail.com
- ***********************************************************/
 package lsgwr.exam.repository;
 
 import lsgwr.exam.entity.QuestionOption;
 import org.springframework.data.jpa.repository.JpaRepository;
 
 public interface QuestionOptionRepository extends JpaRepository<QuestionOption, String> {
-}
+    // 该接口继承了JpaRepository，用于处理QuestionOption实体的数据库操作
+    // 没有定义额外的方法，意味着它利用JpaRepository提供的标准CRUD操作
+}

backend/src/main/java/lsgwr/exam/repository/QuestionRepository.java

@@ -1,19 +1,28 @@
-/***********************************************************
- * @Description : 
- * @author      : 梁山广(Laing Shan Guang)
- * @date        : 2019-05-14 08:25
- * @email       : liangshanguang2@gmail.com
- ***********************************************************/
 package lsgwr.exam.repository;
 
 import lsgwr.exam.entity.Question;
 import org.springframework.data.jpa.repository.JpaRepository;
 import org.springframework.data.jpa.repository.Query;
-
 import java.util.List;
 
+/**
+ * Question实体的仓库接口，用于定义对Question实体进行数据库操作的方法
+ */
 public interface QuestionRepository extends JpaRepository<Question, String> {
+
+    /**
+     * 根据问题类型ID查找问题
+     *
+     * @param id 问题类型ID
+     * @return 匹配的问题类型ID的所有问题列表
+     */
     List<Question> findByQuestionTypeId(Integer id);
+
+    /**
+     * 查询所有问题，并按照更新时间降序排序
+     *
+     * @return 所有问题列表，按更新时间降序排列
+     */
     @Query("select q from Question q order by q.updateTime desc")
     List<Question> findAll();
 }

backend/src/main/java/lsgwr/exam/repository/QuestionTypeRepository.java

@@ -1,13 +1,9 @@
-/***********************************************************
- * @Description : 
- * @author      : 梁山广(Laing Shan Guang)
- * @date        : 2019-05-14 08:28
- * @email       : liangshanguang2@gmail.com
- ***********************************************************/
 package lsgwr.exam.repository;
 
 import lsgwr.exam.entity.QuestionType;
 import org.springframework.data.jpa.repository.JpaRepository;
 
 public interface QuestionTypeRepository extends JpaRepository<QuestionType, Integer> {
-}
+    // 该接口继承了JpaRepository，用于处理QuestionType实体的数据库操作
+    // Integer类型作为实体的主键类型
+}

backend/src/main/java/lsgwr/exam/vo/QuestionCreateSimplifyVo.java

@@ -1,9 +1,3 @@
-/***********************************************************
- * @Description : 问题创建的实体类,简化了下
- * @author      : 梁山广(Laing Shan Guang)
- * @date        : 2019-06-02 13:26
- * @email       : liangshanguang2@gmail.com
- ***********************************************************/
 package lsgwr.exam.vo;
 
 import com.fasterxml.jackson.annotation.JsonProperty;
@@ -11,6 +5,9 @@ import lombok.Data;
 
 import java.util.List;
 
+/**
+ * 简化版题目创建VO类，用于处理题目创建时的部分信息
+ */
 @Data
 public class QuestionCreateSimplifyVo {
     /**
@@ -19,6 +16,9 @@ public class QuestionCreateSimplifyVo {
     @JsonProperty("name")
     private String questionName;
 
+    /**
+     * 题目描述
+     */
     @JsonProperty("desc")
     private String questionDescription;
 

backend/src/main/java/lsgwr/exam/vo/QuestionCreateVo.java

@@ -1,9 +1,3 @@
-/***********************************************************
- * @Description : 问题创建的实体类
- * @author      : 梁山广(Laing Shan Guang)
- * @date        : 2019-06-02 13:26
- * @email       : liangshanguang2@gmail.com
- ***********************************************************/
 package lsgwr.exam.vo;
 
 import com.fasterxml.jackson.annotation.JsonProperty;
@@ -11,6 +5,9 @@ import lombok.Data;
 
 import java.util.List;
 
+/**
+ * 用于创建问题的视图对象，包含了问题的基本信息及其选项
+ */
 @Data
 public class QuestionCreateVo {
     /**
@@ -19,6 +16,9 @@ public class QuestionCreateVo {
     @JsonProperty("name")
     private String questionName;
 
+    /**
+     * 题目描述
+     */
     @JsonProperty("desc")
     private String questionDescription;
 

backend/src/main/java/lsgwr/exam/vo/QuestionDetailVo.java

@@ -1,9 +1,3 @@
-/***********************************************************
- * @Description : 问题详情的实体类
- * @author      : 梁山广(Laing Shan Guang)
- * @date        : 2019-10-20 09:51
- * @email       : liangshanguang2@gmail.com
- ***********************************************************/
 package lsgwr.exam.vo;
 
 import lsgwr.exam.entity.QuestionOption;
@@ -12,6 +6,9 @@ import lombok.Data;
 import java.util.ArrayList;
 import java.util.List;
 
+/**
+ * 问题详情视图对象，用于展示问题的详细信息
+ */
 @Data
 public class QuestionDetailVo {
     /**
@@ -28,14 +25,17 @@ public class QuestionDetailVo {
      * 考试描述
      */
     private String description;
+
     /**
      * 问题的类型
      */
     private String type;
+
     /**
      * 问题的选项
      */
     private List<QuestionOption> options;
+
     /**
      * 问题的答案,选项的id组成的数组
      */

backend/src/main/java/lsgwr/exam/vo/QuestionOptionCreateVo.java

@@ -1,25 +1,29 @@
-/***********************************************************
- * @Description : 问题选项的外层对象
- * @author      : 梁山广(Laing Shan Guang)
- * @date        : 2019-06-02 20:23
- * @email       : liangshanguang2@gmail.com
- ***********************************************************/
 package lsgwr.exam.vo;
 
 import com.fasterxml.jackson.annotation.JsonProperty;
 import lombok.Data;
 
+/**
+ * 问题选项的创建视图模型类
+ * 用于处理问题选项的创建请求
+ */
 @Data
 public class QuestionOptionCreateVo {
 
     /**
      * 问题的内容
+     * 这里使用@JsonProperty注解来指定JSON字段名
+     * 这是因为在JSON与Java对象进行序列化和反序列化时
+     * 可以将JSON中的"content"字段映射到Java对象中的"questionOptionContent"属性
      */
     @JsonProperty("content")
     private String questionOptionContent;
 
     /**
-     * 当前的选项是否是问题大答案
+     * 当前的选项是否是问题的答案
+     * 默认值为false
+     * 同样使用@JsonProperty注解来指定JSON字段名
+     * 这样可以将JSON中的"answer"字段映射到Java对象中的"answer"属性
      */
     @JsonProperty("answer")
     private Boolean answer = false;

backend/src/main/java/lsgwr/exam/vo/QuestionOptionVo.java

@@ -1,25 +1,45 @@
-/***********************************************************
- * @Description : 问题选项的自定义实体类
- * @author      : 梁山广(Laing Shan Guang)
- * @date        : 2019-06-01 09:45
- * @email       : liangshanguang2@gmail.com
- ***********************************************************/
+/**
+ * QuestionOptionVo类用于表示考试题目中的选项信息
+ * 它包含了选项的标识、内容、是否为正确答案以及选项的描述
+ * 该类使用Lombok的@Data注解，自动生成getter和setter方法，简化代码
+ * 使用Jackson的@JsonProperty注解，以便在序列化和反序列化JSON时映射到特定的字段
+ */
 package lsgwr.exam.vo;
 
 import com.fasterxml.jackson.annotation.JsonProperty;
 import lombok.Data;
 
+/**
+ * 表示考试题目选项的值对象
+ */
 @Data
 public class QuestionOptionVo {
+    /**
+     * 选项的唯一标识符
+     * 使用@JsonProperty注解指定JSON字段名
+     */
     @JsonProperty("id")
     private String questionOptionId;
 
+    /**
+     * 选项的内容
+     * 使用@JsonProperty注解指定JSON字段名
+     */
     @JsonProperty("content")
     private String questionOptionContent;
 
+    /**
+     * 标识该选项是否为正确答案
+     * 默认值为false
+     * 使用@JsonProperty注解指定JSON字段名
+     */
     @JsonProperty("answer")
     private Boolean answer = false;
 
+    /**
+     * 对选项的描述，用于提供额外的信息
+     * 使用@JsonProperty注解指定JSON字段名
+     */
     @JsonProperty("description")
     private String questionOptionDescription;
 }

backend/src/main/java/lsgwr/exam/vo/QuestionPageVo.java

@@ -1,9 +1,3 @@
-/***********************************************************
- * @Description : 问题列表反馈给前端的对象
- * @author      : 梁山广(Laing Shan Guang)
- * @date        : 2019-05-28 22:09
- * @email       : liangshanguang2@gmail.com
- ***********************************************************/
 package lsgwr.exam.vo;
 
 import com.fasterxml.jackson.annotation.JsonProperty;
@@ -11,6 +5,9 @@ import lombok.Data;
 
 import java.util.List;
 
+/**
+ * 用于试题分页查询的视图对象
+ */
 @Data
 public class QuestionPageVo {
 

backend/src/main/java/lsgwr/exam/vo/QuestionSelectionVo.java

@@ -1,9 +1,7 @@
-/***********************************************************
- * @Description : 前端创建问题时的下拉列表选择
- * @author      : 梁山广(Laing Shan Guang)
- * @date        : 2019-06-03 07:35
- * @email       : liangshanguang2@gmail.com
- ***********************************************************/
+/**
+ * 问题选择视图对象
+ * 用于在前端展示问题选择界面时传递问题类型、问题类别和问题难度等级信息
+ */
 package lsgwr.exam.vo;
 
 import com.fasterxml.jackson.annotation.JsonProperty;
@@ -14,14 +12,30 @@ import lombok.Data;
 
 import java.util.List;
 
+/**
+ * 问题选择视图对象
+ * 包含问题类型、问题类别和问题难度等级的列表
+ */
 @Data
 public class QuestionSelectionVo {
+    /**
+     * 问题类型列表
+     * 用于展示可选择的问题类型
+     */
     @JsonProperty("types")
     private List<QuestionType> questionTypeList;
 
+    /**
+     * 问题类别列表
+     * 用于展示可选择的问题类别
+     */
     @JsonProperty("categories")
     private List<QuestionCategory> questionCategoryList;
 
+    /**
+     * 问题难度等级列表
+     * 用于展示可选择的问题难度等级
+     */
     @JsonProperty("levels")
     private List<QuestionLevel> questionLevelList;
 }

backend/src/main/java/lsgwr/exam/vo/QuestionVo.java

@@ -1,9 +1,3 @@
-/***********************************************************
- * @Description : 考试问题的对外封装类
- * @author      : 梁山广(Laing Shan Guang)
- * @date        : 2019-05-28 08:17
- * @email       : liangshanguang2@gmail.com
- ***********************************************************/
 package lsgwr.exam.vo;
 
 import com.fasterxml.jackson.annotation.JsonFormat;
@@ -13,14 +7,27 @@ import lombok.Data;
 import java.util.Date;
 import java.util.List;
 
+/**
+ * QuestionVo类代表了一个问题的值对象，用于在系统中传输和展示问题相关信息。
+ * 该类使用Lombok的@Data注解，自动生成getter和setter方法，简化代码并提高可读性。
+ */
 @Data
 public class QuestionVo {
+    /**
+     * 问题在数据库中的唯一标识符。
+     */
     @JsonProperty("id")
     private String questionId;
 
+    /**
+     * 问题的名称或标题。
+     */
     @JsonProperty("name")
     private String questionName;
 
+    /**
+     * 问题的分值，表示该问题在评估或考试中的重要性或权重。
+     */
     @JsonProperty("score")
     private Integer questionScore;
 
@@ -66,7 +73,9 @@ public class QuestionVo {
     @JsonProperty("categoryId")
     private int questionCategoryId;
 
-
+    /**
+     * 问题的描述信息，可能包含问题的背景、要求或其他详细说明。
+     */
     @JsonProperty("description")
     private String questionDescription;
 
@@ -76,7 +85,6 @@ public class QuestionVo {
     @JsonProperty("options")
     private List<QuestionOptionVo> questionOptionVoList;
 
-
     /**
      * 更新时间，设计表时设置了自动插入当前时间，无需在Java代码中设置了。
      * 同时@DynamicUpdate注解可以时间当数据库数据变化时自动更新，无需人工维护