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

@@ -1,5 +1,12 @@
+/***********************************************************
+ * @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;
@@ -8,70 +15,25 @@ 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,11 +6,7 @@
  ***********************************************************/
 package lsgwr.exam.entity;
 
-/**
- * QuestionCategory类代表了一个实体，用于在数据库中存储问题类别信息。
- * 这个类被标记为@Entity，意味着它是一个JPA实体，可以映射到数据库表。
- * Lombok的@Data注解用于自动生成getter和setter方法，以及toString、equals和hashCode方法。
- */
+
 import com.fasterxml.jackson.annotation.JsonProperty;
 import lombok.Data;
 
@@ -21,26 +17,15 @@ 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;//题目难度等级ID
+    private Integer questionLevelId;
 
     @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,19 +11,12 @@ 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,25 +13,18 @@ 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;// 角色id
-    private String role;// 角色名称
+    private Integer id;
+    private String role;
 }

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

@@ -10,6 +10,4 @@ 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,14 +1,13 @@
-/**
- * 问题级别数据访问层接口
- * 继承自JpaRepository，用于对QuestionLevel实体进行数据库操作
- * 该接口没有定义额外的方法，直接继承了JpaRepository提供的标准CRUD方法
- */
+/***********************************************************
+ * @Description : 
+ * @author      : 梁山广(Laing Shan Guang)
+ * @date        : 2019-05-14 08:26
+ * @email       : liangshanguang2@gmail.com
+ ***********************************************************/
 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,9 +1,13 @@
+/***********************************************************
+ * @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,28 +1,19 @@
+/***********************************************************
+ * @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,9 +1,13 @@
+/***********************************************************
+ * @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,3 +1,9 @@
+/***********************************************************
+ * @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;
@@ -5,9 +11,6 @@ import lombok.Data;
 
 import java.util.List;
 
-/**
- * 简化版题目创建VO类，用于处理题目创建时的部分信息
- */
 @Data
 public class QuestionCreateSimplifyVo {
     /**
@@ -16,9 +19,6 @@ public class QuestionCreateSimplifyVo {
     @JsonProperty("name")
     private String questionName;
 
-    /**
-     * 题目描述
-     */
     @JsonProperty("desc")
     private String questionDescription;
 

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

@@ -1,3 +1,9 @@
+/***********************************************************
+ * @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;
@@ -5,9 +11,6 @@ import lombok.Data;
 
 import java.util.List;
 
-/**
- * 用于创建问题的视图对象，包含了问题的基本信息及其选项
- */
 @Data
 public class QuestionCreateVo {
     /**
@@ -16,9 +19,6 @@ public class QuestionCreateVo {
     @JsonProperty("name")
     private String questionName;
 
-    /**
-     * 题目描述
-     */
     @JsonProperty("desc")
     private String questionDescription;
 

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

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

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

@@ -1,29 +1,25 @@
+/***********************************************************
+ * @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,45 +1,25 @@
-/**
- * QuestionOptionVo类用于表示考试题目中的选项信息
- * 它包含了选项的标识、内容、是否为正确答案以及选项的描述
- * 该类使用Lombok的@Data注解，自动生成getter和setter方法，简化代码
- * 使用Jackson的@JsonProperty注解，以便在序列化和反序列化JSON时映射到特定的字段
- */
+/***********************************************************
+ * @Description : 问题选项的自定义实体类
+ * @author      : 梁山广(Laing Shan Guang)
+ * @date        : 2019-06-01 09:45
+ * @email       : liangshanguang2@gmail.com
+ ***********************************************************/
 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,3 +1,9 @@
+/***********************************************************
+ * @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;
@@ -5,9 +11,6 @@ import lombok.Data;
 
 import java.util.List;
 
-/**
- * 用于试题分页查询的视图对象
- */
 @Data
 public class QuestionPageVo {
 

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

@@ -1,7 +1,9 @@
-/**
- * 问题选择视图对象
- * 用于在前端展示问题选择界面时传递问题类型、问题类别和问题难度等级信息
- */
+/***********************************************************
+ * @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;
@@ -12,30 +14,14 @@ 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,3 +1,9 @@
+/***********************************************************
+ * @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;
@@ -7,27 +13,14 @@ 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;
 
@@ -73,9 +66,7 @@ public class QuestionVo {
     @JsonProperty("categoryId")
     private int questionCategoryId;
 
-    /**
-     * 问题的描述信息，可能包含问题的背景、要求或其他详细说明。
-     */
+
     @JsonProperty("description")
     private String questionDescription;
 
@@ -85,6 +76,7 @@ public class QuestionVo {
     @JsonProperty("options")
     private List<QuestionOptionVo> questionOptionVoList;
 
+
     /**
      * 更新时间，设计表时设置了自动插入当前时间，无需在Java代码中设置了。
      * 同时@DynamicUpdate注解可以时间当数据库数据变化时自动更新，无需人工维护