Merge remote-tracking branch 'origin/后台运营yy' into 后台运营yy

tamguo-crawler/src/main/java/com/tamguo/dao/BookMapper.java

@@ -1,8 +1,12 @@
 package com.tamguo.dao;
 
 import com.tamguo.config.dao.SuperMapper;
+// 引入具体的实体类BookEntity，表明该Mapper接口是针对BookEntity这个实体进行数据库操作相关的定义。
 import com.tamguo.model.BookEntity;
 
+// BookMapper接口继承自SuperMapper<BookEntity>，SuperMapper是一个通用的Mapper父接口，用于定义一些公共的方法或者规范，方便复用代码和统一接口结构。
+// 这里通过继承指定了该接口是针对BookEntity实体的Mapper，意味着它可以使用SuperMapper中定义的通用方法，并可以根据BookEntity的特点来扩展特定的数据库操作方法。
+// 该接口主要用于定义与BookEntity实体对应的数据库操作方法，例如常见的增删改查等操作，具体的方法实现通常由MyBatis-Plus等相关框架根据接口定义自动生成或者由开发人员手动编写对应的XML映射文件等方式来完成。
 public interface BookMapper extends SuperMapper<BookEntity> {
 
 }

tamguo-crawler/src/main/java/com/tamguo/dao/ChapterMapper.java

@@ -1,10 +1,17 @@
 package com.tamguo.dao;
 
 import org.apache.ibatis.annotations.Param;
+// 引入通用的Mapper父接口SuperMapper，它为具体的Mapper接口提供了一些通用的方法和规范，便于代码复用以及统一接口结构，此处针对ChapterEntity实体进行扩展。
 import com.tamguo.config.dao.SuperMapper;
+// 引入具体的实体类ChapterEntity，表明该Mapper接口主要用于操作与之对应的数据库表，进行数据的增删改查等相关操作。
 import com.tamguo.model.ChapterEntity;
 
-public interface ChapterMapper extends SuperMapper<ChapterEntity>{
+// ChapterMapper接口继承自SuperMapper<ChapterEntity>，意味着它可以继承SuperMapper中定义的通用数据库操作方法，
+// 同时也可以根据ChapterEntity实体的业务需求来扩展特定的、只适用于该实体的数据库操作方法，用于与数据库中对应的章节（Chapter）相关的数据表进行交互。
+public interface ChapterMapper extends SuperMapper<ChapterEntity> {
 
+	// 自定义的数据库查询方法，用于查询满足特定条件的记录数量。
+	// 该方法接收一个名为"uid"的参数（通过@Param注解进行参数命名绑定，以便在对应的SQL语句中能准确引用这个参数），参数类型为字符串，用于表示用户的唯一标识（具体含义取决于业务逻辑）。
+	// 返回值类型为Integer，即返回满足条件的记录数量（可能是某个用户相关的章节记录数量等，具体取决于数据库表结构和业务需求对应的查询逻辑）。
 	Integer queryCount(@Param(value="uid")String uid);
 }

tamguo-crawler/src/main/java/com/tamguo/dao/CourseMapper.java

@@ -1,9 +1,12 @@
 package com.tamguo.dao;
 
 import com.tamguo.config.dao.SuperMapper;
+// 引入代表课程（Course）相关的实体类CourseEntity，表明这个Mapper接口主要是针对课程实体的数据在数据库层面进行操作而定义的。
 import com.tamguo.model.CourseEntity;
 
-public interface CourseMapper extends SuperMapper<CourseEntity>{
+// CourseMapper接口继承自SuperMapper<CourseEntity>，SuperMapper是一个通用的Mapper父接口，用于提供一些公共的数据库操作方法和规范，方便复用代码以及统一接口结构。
+// 这里通过继承指定了CourseMapper是针对CourseEntity实体的Mapper，意味着它既可以使用SuperMapper中已有的通用方法，也能够后续根据课程实体相关的业务需求，扩展特定的数据库操作方法，比如课程信息的新增、查询、更新、删除等与数据库交互的操作，这些操作的具体实现通常由MyBatis-Plus等相关框架依据接口定义来生成或者由开发人员手动编写对应的SQL映射来完成。
+public interface CourseMapper extends SuperMapper<CourseEntity> {
 
 
 }

tamguo-crawler/src/main/java/com/tamguo/dao/CrawlerBookMapper.java

@@ -1,8 +1,11 @@
 package com.tamguo.dao;
 
 import com.tamguo.config.dao.SuperMapper;
+// 引入代表爬虫获取的书籍（CrawlerBook）相关的实体类CrawlerBookEntity，这表明该Mapper接口主要用于操作数据库中与通过爬虫获取的书籍数据对应的表。
 import com.tamguo.model.CrawlerBookEntity;
 
+// CrawlerBookMapper接口继承自SuperMapper<CrawlerBookEntity>。SuperMapper作为一个通用的Mapper父接口，定义了一些通用的数据库操作方法以及规范，便于在不同实体对应的Mapper接口间实现代码复用，并保证接口结构的统一性。
+// 此处的CrawlerBookMapper通过继承关系，明确了是针对CrawlerBookEntity这个实体的Mapper接口，它既能利用SuperMapper中已有的通用操作逻辑（例如基础的增删改查方法等），又能依据爬虫书籍实体自身的业务特点（比如可能有独特的字段、关联关系等），后续扩展特定的、专门用于处理爬虫书籍数据的数据库操作方法。这些具体的数据库操作方法实现，通常会借助如MyBatis-Plus框架，按照该接口的定义来生成相应代码，或者由开发人员手动编写对应的SQL映射语句等方式来完成，进而实现与数据库中爬虫书籍相关数据表的交互操作，满足业务上对于爬虫获取书籍数据的处理需求。
 public interface CrawlerBookMapper extends SuperMapper<CrawlerBookEntity> {
 
 }

tamguo-crawler/src/main/java/com/tamguo/dao/CrawlerChapterMapper.java

@@ -1,8 +1,11 @@
 package com.tamguo.dao;
 
 import com.tamguo.config.dao.SuperMapper;
+// 引入代表爬虫获取的章节（CrawlerChapter）相关的实体类CrawlerChapterEntity，意味着该Mapper接口主要是用于操作数据库中与通过爬虫获取的章节数据对应的表。
 import com.tamguo.model.CrawlerChapterEntity;
 
-public interface CrawlerChapterMapper extends SuperMapper<CrawlerChapterEntity>{
+// CrawlerChapterMapper接口继承自SuperMapper<CrawlerChapterEntity>。其中，SuperMapper是一个通用的Mapper父接口，它旨在提供一些通用的数据库操作方法与规范，以此达成代码复用以及统一接口结构的目的。
+// 本接口通过继承SuperMapper<CrawlerChapterEntity>，明确了自身是针对CrawlerChapterEntity这个实体的Mapper接口。这样一来，它既能够使用SuperMapper中已经定义好的通用数据库操作方法（像常规的增、删、改、查等基础操作），又可以根据爬虫章节实体自身特有的业务需求（例如章节内容来源、特殊的关联关系等情况），后续去扩展那些专门用于处理爬虫章节数据的特定数据库操作方法。而这些数据库操作方法的具体实现，往往会借助如MyBatis-Plus这类框架，按照该接口所定义的内容来生成相应代码，或者由开发人员手动编写对应的SQL映射语句等方式来达成，进而实现与数据库里爬虫章节相关数据表进行交互，以满足业务中针对爬虫获取章节数据的处理要求。
+public interface CrawlerChapterMapper extends SuperMapper<CrawlerChapterEntity> {
 
 }

tamguo-crawler/src/main/java/com/tamguo/dao/CrawlerPaperMapper.java

@@ -4,14 +4,23 @@ import java.util.List;
 
 import org.apache.ibatis.annotations.Param;
 import org.apache.ibatis.annotations.Select;
-
+// 引入MyBatis-Plus的分页插件相关的Page类，用于实现分页查询功能，指定该分页操作针对的是CrawlerPaperEntity实体类型的数据。
 import com.baomidou.mybatisplus.plugins.Page;
 import com.tamguo.config.dao.SuperMapper;
+// 引入代表爬虫获取的试卷（CrawlerPaper）相关的实体类CrawlerPaperEntity，表明这个Mapper接口主要用于操作数据库中与通过爬虫获取的试卷数据对应的表。
 import com.tamguo.model.CrawlerPaperEntity;
 
-public interface CrawlerPaperMapper extends SuperMapper<CrawlerPaperEntity>{
+// CrawlerPaperMapper接口继承自SuperMapper<CrawlerPaperEntity>，SuperMapper是通用的Mapper父接口，提供了一些通用的数据库操作方法和规范，这里在此基础上扩展针对爬虫试卷实体的特定操作方法。
+public interface CrawlerPaperMapper extends SuperMapper<CrawlerPaperEntity> {
 
+	// 使用MyBatis的@Select注解来定义一个SQL查询语句，该语句将直接映射到对应的数据库查询操作，用于获取满足特定条件的CrawlerPaperEntity实体列表数据，实现分页查询功能。
+	// SQL语句的逻辑是：从名为"crawler_paper"的表（对应CrawlerPaperEntity实体的数据表）中选择所有记录（用"c.*"表示选择所有列），
+	// 筛选条件是该表中的"paper_id"字段的值存在于子查询的结果集中，子查询是从名为"tiku_paper"的表中选择"id"字段，筛选条件为"area_id"字段等于传入的参数#{areaId}所代表的值。
+	// 最后按照"id"和"queindex"字段升序排序（"order by id,queindex asc"），以此来获取按照特定顺序且符合区域条件的试卷数据。
 	@Select("SELECT c.* FROM crawler_paper c WHERE c.paper_id IN (SELECT p.id FROM tiku_paper p WHERE p.area_id = #{areaId}) order by id,queindex asc;")
-	List<CrawlerPaperEntity> selectPageByAreaId(Page<CrawlerPaperEntity> questionPage,@Param(value="areaId") String areaId);
+	// 定义一个方法selectPageByAreaId，用于执行上述SQL语句所定义的分页查询操作，返回一个包含CrawlerPaperEntity实体的列表。
+	// 该方法接收两个参数，一个是Page<CrawlerPaperEntity>类型的questionPage，表示分页相关的信息（如页码、每页记录数等），用于实现分页功能；
+	// 另一个是通过@Param注解命名为"areaId"的字符串类型参数，用于在SQL语句中作为条件进行数据筛选，代表区域的唯一标识（具体含义取决于业务逻辑）。
+	List<CrawlerPaperEntity> selectPageByAreaId(Page<CrawlerPaperEntity> questionPage, @Param(value="areaId") String areaId);
 
 }

tamguo-crawler/src/main/java/com/tamguo/dao/CrawlerQuestionMapper.java

@@ -2,12 +2,18 @@ package com.tamguo.dao;
 
 import java.util.List;
 
+// 引入MyBatis-Plus插件中用于分页相关操作的Pagination类，通过它可以传递分页相关的参数（如页码、每页记录数等），实现分页查询功能。
 import com.baomidou.mybatisplus.plugins.pagination.Pagination;
 import com.tamguo.config.dao.SuperMapper;
+// 引入代表爬虫获取的题目（CrawlerQuestion）相关的实体类CrawlerQuestionEntity，说明该Mapper接口主要用于操作数据库中与通过爬虫获取的题目数据对应的表。
 import com.tamguo.model.CrawlerQuestionEntity;
 
-public interface CrawlerQuestionMapper extends SuperMapper<CrawlerQuestionEntity>{
+// CrawlerQuestionMapper接口继承自SuperMapper<CrawlerQuestionEntity>，SuperMapper作为通用的Mapper父接口，定义了一些通用的数据库操作方法和规范，方便复用代码以及统一接口结构。
+// 这里的CrawlerQuestionMapper在继承的基础上，可利用通用方法并能根据爬虫题目实体的业务特点来扩展特定的数据库操作方法，用于与数据库中对应的题目数据表进行交互。
+public interface CrawlerQuestionMapper extends SuperMapper<CrawlerQuestionEntity> {
 
+	// 自定义的数据库查询方法，用于按照用户唯一标识（uid，具体含义根据业务逻辑确定）进行分页查询操作，返回一个包含CrawlerQuestionEntity实体的列表。
+	// 该方法接收一个Pagination类型的参数page，这个参数包含了分页相关的详细信息，例如当前页码、每页显示的记录数量等，用于控制分页查询的具体行为，以获取对应页面范围内的题目数据记录。
 	List<CrawlerQuestionEntity> queryPageOrderUid(Pagination page);
 
 }

tamguo-crawler/src/main/java/com/tamguo/dao/IQuestionOptionsMapper.java

@@ -1,10 +1,14 @@
 package com.tamguo.dao;
 
 import com.baomidou.mybatisplus.mapper.BaseMapper;
+// 引入代表题目选项（QuestionOptions）相关的实体类QuestionOptionsEntity，意味着该Mapper接口主要是用于操作数据库中与题目选项数据对应的表。
 import com.tamguo.model.QuestionOptionsEntity;
 
 /**
  * Created by TanGuo on 2019/3/30.
+ * 这是一个用于操作题目选项数据的Mapper接口，通过继承BaseMapper<QuestionOptionsEntity>，它能够利用MyBatis-Plus框架提供的通用数据库操作方法，
+ * 例如常见的增、删、改、查等基础操作都可以直接使用，无需再手动编写大量重复的SQL语句，方便快捷地实现与数据库中题目选项相关数据表的交互，
+ * 以满足业务上对于题目选项数据进行处理的需求。后续也可以根据题目选项实体的特定业务场景，在这个接口中扩展一些自定义的数据库操作方法。
  */
 public interface IQuestionOptionsMapper extends BaseMapper<QuestionOptionsEntity> {
 }

tamguo-crawler/src/main/java/com/tamguo/dao/PaperMapper.java

@@ -1,8 +1,11 @@
 package com.tamguo.dao;
 
 import com.tamguo.config.dao.SuperMapper;
+// 引入代表试卷（Paper）相关的实体类PaperEntity，表明这个Mapper接口主要用于操作数据库中与试卷数据对应的表，进行如试卷信息的查询、新增、修改、删除等数据库交互操作。
 import com.tamguo.model.PaperEntity;
 
+// PaperMapper接口继承自SuperMapper<PaperEntity>。SuperMapper是一个通用的Mapper父接口，其定义了一些通用的数据库操作方法与规范，方便实现代码复用以及统一接口结构。
+// 此处的PaperMapper通过继承关系，明确了是针对PaperEntity实体的Mapper接口。这意味着它既能运用SuperMapper中已有的通用操作逻辑（例如基础的增删改查方法等），又能依据试卷实体自身的业务特点（比如试卷包含的题目、所属学科等相关属性情况），后续去扩展那些专门用于处理试卷数据的特定数据库操作方法。这些具体的数据库操作方法实现，通常会借助如MyBatis-Plus框架，按照该接口的定义来生成相应代码，或者由开发人员手动编写对应的SQL映射语句等方式来完成，进而实现与数据库中试卷相关数据表的交互操作，满足业务上对于试卷数据处理的需求。
 public interface PaperMapper extends SuperMapper<PaperEntity> {
 
 }

tamguo-crawler/src/main/java/com/tamguo/dao/QuestionMapper.java

@@ -1,8 +1,11 @@
 package com.tamguo.dao;
 
 import com.tamguo.config.dao.SuperMapper;
+// 引入代表题目（Question）相关的实体类QuestionEntity，这表明该Mapper接口主要是用于操作数据库中与题目数据对应的表，实现和题目相关的数据访问操作，比如增删改查等。
 import com.tamguo.model.QuestionEntity;
 
-public interface QuestionMapper extends SuperMapper<QuestionEntity>{
+// QuestionMapper接口继承自SuperMapper<QuestionEntity>。SuperMapper是一个通用的Mapper父接口，它定义了一系列通用的数据库操作方法和规范，其目的在于方便代码复用以及让接口结构更加统一。
+// 本接口通过继承SuperMapper<QuestionEntity>，确定了自身是针对QuestionEntity这个实体的Mapper接口。如此一来，它既能使用SuperMapper里已有的通用数据库操作方法（像常规的新增记录、删除记录、修改记录以及查询记录这些基础操作），又可以依据题目实体自身特有的业务需求（例如题目所属的学科分类、难度级别等相关情况），后续去扩展那些专门用于处理题目数据的特定数据库操作方法。而这些数据库操作方法的具体实现，往往会借助如MyBatis-Plus之类的框架，按照该接口所定义的内容来生成相应代码，或者由开发人员手动编写对应的SQL映射语句等方式来达成，进而实现与数据库里题目相关数据表进行交互，以满足业务中针对题目数据处理的要求。
+public interface QuestionMapper extends SuperMapper<QuestionEntity> {
 
 }

tamguo-crawler/src/main/java/com/tamguo/dao/SubjectMapper.java

@@ -1,12 +1,18 @@
 package com.tamguo.dao;
 
 import org.apache.ibatis.annotations.Param;
-
+// 引入通用的Mapper父接口SuperMapper，它定义了一些公共的数据库操作方法和规范，便于复用代码以及统一接口结构，此处针对SubjectEntity实体进行扩展。
 import com.tamguo.config.dao.SuperMapper;
+// 引入代表学科（Subject）相关的实体类SubjectEntity，表明该Mapper接口主要用于操作数据库中与学科数据对应的表，进行如学科信息的查询、新增、修改、删除等数据库交互操作。
 import com.tamguo.model.SubjectEntity;
 
-public interface SubjectMapper extends SuperMapper<SubjectEntity>{
+// SubjectMapper接口继承自SuperMapper<SubjectEntity>，意味着它可以继承SuperMapper中定义的通用数据库操作方法，
+// 同时也可以根据SubjectEntity实体的业务需求来扩展特定的、只适用于该实体的数据库操作方法，用于与数据库中对应的学科数据表进行交互。
+public interface SubjectMapper extends SuperMapper<SubjectEntity> {
 
+	// 自定义的数据库查询方法，用于根据学科名称查找对应的学科实体信息。
+	// 该方法接收一个名为"name"的参数（通过@Param注解进行参数命名绑定，以便在对应的SQL语句中能准确引用这个参数），参数类型为字符串，代表要查找的学科的名称（具体含义取决于业务逻辑）。
+	// 返回值类型为SubjectEntity，即如果查询到符合条件的学科记录，则返回对应的学科实体对象，若未找到则可能返回null（具体取决于数据库查询结果以及相关的映射配置情况）。
 	SubjectEntity findByName(@Param(value="name")String name);
 
 }