commit：同步1.3版本

orange-demo-single-service-for-app/README.md

@@ -1,5 +1,7 @@
 ### 服务接口文档
 ---
+- Knife4j
+  - 服务启动后，Knife4j的文档入口地址 [http://localhost:8082/doc.html#/plus](http://localhost:8082/doc.html#/plus)
 - Postman
   - 无需启动服务，即可将当前工程的接口导出成Postman格式。在工程的common/common-tools/模块下，找到ExportApiApp文件，并执行main函数。
 

orange-demo-single-service-for-app/application/pom.xml

@@ -30,6 +30,11 @@
             <artifactId>application-common</artifactId>
             <version>1.0.0</version>
         </dependency>
+        <dependency>
+            <groupId>com.orange.demo</groupId>
+            <artifactId>common-swagger</artifactId>
+            <version>1.0.0</version>
+        </dependency>
 	</dependencies>
 
 	<build>

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/controller/AreaCodeController.java

@@ -1,5 +1,6 @@
 package com.orange.demo.app.controller;
 
+import io.swagger.annotations.Api;
 import cn.jimmyshi.beanquery.BeanQuery;
 import com.orange.demo.app.model.AreaCode;
 import com.orange.demo.app.service.AreaCodeService;
@@ -19,6 +20,7 @@ import java.util.*;
  * @author Jerry
  * @date 2020-09-24
  */
+@Api(tags = "行政区划数据访问接口")
 @RestController
 @RequestMapping("/admin/app/areaCode")
 public class AreaCodeController {

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/controller/CourseController.java

@@ -8,6 +8,7 @@ import com.orange.demo.common.core.upload.UploadResponseInfo;
 import com.orange.demo.common.core.upload.UploadStoreInfo;
 import com.github.pagehelper.page.PageMethod;
 import com.orange.demo.app.vo.*;
+import com.orange.demo.app.dto.*;
 import com.orange.demo.app.model.*;
 import com.orange.demo.app.service.*;
 import com.orange.demo.common.core.object.*;
@@ -17,6 +18,8 @@ import com.orange.demo.common.core.annotation.MyRequestBody;
 import com.orange.demo.common.core.validator.UpdateGroup;
 import com.orange.demo.common.core.cache.SessionCacheHelper;
 import com.orange.demo.config.ApplicationConfig;
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
@@ -32,6 +35,7 @@ import javax.validation.groups.Default;
  * @author Jerry
  * @date 2020-09-24
  */
+@Api(tags = "课程数据管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/app/course")
@@ -49,15 +53,24 @@ public class CourseController {
     /**
      * 新增课程数据数据。
      *
-     * @param course 新增对象。
+     * @param courseDto 新增对象。
      * @return 应答结果对象，包含新增对象主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {
+            "course.courseId",
+            "course.priceStart",
+            "course.priceEnd",
+            "course.classHourStart",
+            "course.classHourEnd",
+            "course.createTimeStart",
+            "course.createTimeEnd"})
     @PostMapping("/add")
-    public ResponseResult<Long> add(@MyRequestBody Course course) {
-        String errorMessage = MyCommonUtil.getModelValidationError(course);
+    public ResponseResult<Long> add(@MyRequestBody("course") CourseDto courseDto) {
+        String errorMessage = MyCommonUtil.getModelValidationError(courseDto);
         if (errorMessage != null) {
             return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
         }
+        Course course = MyModelUtil.copyTo(courseDto, Course.class);
         // 验证关联Id的数据合法性
         CallResult callResult = courseService.verifyRelatedData(course, null);
         if (!callResult.isSuccess()) {
@@ -71,16 +84,23 @@ public class CourseController {
     /**
      * 更新课程数据数据。
      *
-     * @param course 更新对象。
+     * @param courseDto 更新对象。
      * @return 应答结果对象。
      */
+    @ApiOperationSupport(ignoreParameters = {
+            "course.priceStart",
+            "course.priceEnd",
+            "course.classHourStart",
+            "course.classHourEnd",
+            "course.createTimeStart",
+            "course.createTimeEnd"})
     @PostMapping("/update")
-    public ResponseResult<Void> update(@MyRequestBody Course course) {
-        String errorMessage = MyCommonUtil.getModelValidationError(course, Default.class, UpdateGroup.class);
+    public ResponseResult<Void> update(@MyRequestBody("course") CourseDto courseDto) {
+        String errorMessage = MyCommonUtil.getModelValidationError(courseDto, Default.class, UpdateGroup.class);
         if (errorMessage != null) {
             return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
         }
-        // 验证关联Id的数据合法性
+        Course course = MyModelUtil.copyTo(courseDto, Course.class);
         Course originalCourse = courseService.getById(course.getCourseId());
         if (originalCourse == null) {
             // NOTE: 修改下面方括号中的话述
@@ -128,19 +148,20 @@ public class CourseController {
     /**
      * 列出符合过滤条件的课程数据列表。
      *
-     * @param courseFilter 过滤对象。
+     * @param courseDtoFilter 过滤对象。
      * @param orderParam 排序参数。
      * @param pageParam 分页参数。
      * @return 应答结果对象，包含查询结果集。
      */
     @PostMapping("/list")
     public ResponseResult<MyPageData<CourseVo>> list(
-            @MyRequestBody Course courseFilter,
+            @MyRequestBody("courseFilter") CourseDto courseDtoFilter,
             @MyRequestBody MyOrderParam orderParam,
             @MyRequestBody MyPageParam pageParam) {
         if (pageParam != null) {
             PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize());
         }
+        Course courseFilter = MyModelUtil.copyTo(courseDtoFilter, Course.class);
         String orderBy = MyOrderParam.buildOrderBy(orderParam, Course.class);
         List<Course> courseList = courseService.getCourseListWithRelation(courseFilter, orderBy);
         return ResponseResult.success(MyPageUtil.makeResponseData(courseList, Course.INSTANCE));
@@ -267,7 +288,7 @@ public class CourseController {
      */
     @GetMapping("/listDict")
     public ResponseResult<List<Map<String, Object>>> listDict(Course filter) {
-        List<Course> resultList = courseService.getListByFilter(filter, null);
+        List<Course> resultList = courseService.getListByFilter(filter);
         return ResponseResult.success(BeanQuery.select(
                 "courseId as id", "courseName as name").executeFrom(resultList));
     }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/controller/CourseTransStatsController.java

@@ -2,12 +2,14 @@ package com.orange.demo.app.controller;
 
 import com.github.pagehelper.page.PageMethod;
 import com.orange.demo.app.vo.*;
+import com.orange.demo.app.dto.*;
 import com.orange.demo.app.model.*;
 import com.orange.demo.app.service.*;
 import com.orange.demo.common.core.object.*;
 import com.orange.demo.common.core.util.*;
 import com.orange.demo.common.core.constant.*;
 import com.orange.demo.common.core.annotation.MyRequestBody;
+import io.swagger.annotations.Api;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
@@ -20,6 +22,7 @@ import java.util.*;
  * @author Jerry
  * @date 2020-09-24
  */
+@Api(tags = "课程统计管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/app/courseTransStats")
@@ -31,19 +34,20 @@ public class CourseTransStatsController {
     /**
      * 列出符合过滤条件的课程统计列表。
      *
-     * @param courseTransStatsFilter 过滤对象。
+     * @param courseTransStatsDtoFilter 过滤对象。
      * @param orderParam 排序参数。
      * @param pageParam 分页参数。
      * @return 应答结果对象，包含查询结果集。
      */
     @PostMapping("/list")
     public ResponseResult<MyPageData<CourseTransStatsVo>> list(
-            @MyRequestBody CourseTransStats courseTransStatsFilter,
+            @MyRequestBody("courseTransStatsFilter") CourseTransStatsDto courseTransStatsDtoFilter,
             @MyRequestBody MyOrderParam orderParam,
             @MyRequestBody MyPageParam pageParam) {
         if (pageParam != null) {
             PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize());
         }
+        CourseTransStats courseTransStatsFilter = MyModelUtil.copyTo(courseTransStatsDtoFilter, CourseTransStats.class);
         String orderBy = MyOrderParam.buildOrderBy(orderParam, CourseTransStats.class);
         List<CourseTransStats> courseTransStatsList = courseTransStatsService.getCourseTransStatsListWithRelation(courseTransStatsFilter, orderBy);
         return ResponseResult.success(MyPageUtil.makeResponseData(courseTransStatsList, CourseTransStats.INSTANCE));
@@ -52,7 +56,7 @@ public class CourseTransStatsController {
     /**
      * 分组列出符合过滤条件的课程统计列表。
      *
-     * @param courseTransStatsFilter 过滤对象。
+     * @param courseTransStatsDtoFilter 过滤对象。
      * @param groupParam 分组参数。
      * @param orderParam 排序参数。
      * @param pageParam 分页参数。
@@ -60,7 +64,7 @@ public class CourseTransStatsController {
      */
     @PostMapping("/listWithGroup")
     public ResponseResult<MyPageData<CourseTransStatsVo>> listWithGroup(
-            @MyRequestBody CourseTransStats courseTransStatsFilter,
+            @MyRequestBody("courseTransStatsFilter") CourseTransStatsDto courseTransStatsDtoFilter,
             @MyRequestBody(required = true) MyGroupParam groupParam,
             @MyRequestBody MyOrderParam orderParam,
             @MyRequestBody MyPageParam pageParam) {
@@ -73,9 +77,10 @@ public class CourseTransStatsController {
         if (pageParam != null) {
             PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize());
         }
+        CourseTransStats filter = MyModelUtil.copyTo(courseTransStatsDtoFilter, CourseTransStats.class);
         MyGroupCriteria criteria = groupParam.getGroupCriteria();
         List<CourseTransStats> resultList = courseTransStatsService.getGroupedCourseTransStatsListWithRelation(
-                courseTransStatsFilter, criteria.getGroupSelect(), criteria.getGroupBy(), orderBy);
+                filter, criteria.getGroupSelect(), criteria.getGroupBy(), orderBy);
         // 分页连同对象数据转换copy工作，下面的方法一并完成。
         return ResponseResult.success(MyPageUtil.makeResponseData(resultList, CourseTransStats.INSTANCE));
     }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/controller/GradeController.java

@@ -1,17 +1,22 @@
 package com.orange.demo.app.controller;
 
-import com.orange.demo.app.model.*;
-import com.orange.demo.app.service.*;
+import com.alibaba.fastjson.JSONObject;
+import cn.jimmyshi.beanquery.BeanQuery;
+import com.orange.demo.app.dto.GradeDto;
+import com.orange.demo.app.model.Grade;
+import com.orange.demo.app.service.GradeService;
 import com.orange.demo.common.core.constant.ErrorCodeEnum;
+import com.orange.demo.common.core.util.MyModelUtil;
 import com.orange.demo.common.core.util.MyCommonUtil;
 import com.orange.demo.common.core.object.ResponseResult;
 import com.orange.demo.common.core.annotation.MyRequestBody;
 import com.orange.demo.common.core.validator.UpdateGroup;
 
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
-import cn.jimmyshi.beanquery.BeanQuery;
 
 import javax.validation.groups.Default;
 import java.util.*;
@@ -22,6 +27,7 @@ import java.util.*;
  * @author Jerry
  * @date 2020-09-24
  */
+@Api(tags = "年级管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/app/grade")
@@ -33,15 +39,17 @@ public class GradeController {
     /**
      * 新增年级数据。
      *
-     * @param grade 新增对象。
+     * @param gradeDto 新增对象。
      * @return 应答结果对象，包含新增对象主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"grade.gradeId"})
     @PostMapping("/add")
-    public ResponseResult<Integer> add(@MyRequestBody Grade grade) {
-        String errorMessage = MyCommonUtil.getModelValidationError(grade);
+    public ResponseResult<Integer> add(@MyRequestBody("grade") GradeDto gradeDto) {
+        String errorMessage = MyCommonUtil.getModelValidationError(gradeDto);
         if (errorMessage != null) {
             return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
         }
+        Grade grade = MyModelUtil.copyTo(gradeDto, Grade.class);
         grade = gradeService.saveNew(grade);
         return ResponseResult.success(grade.getGradeId());
     }
@@ -49,15 +57,16 @@ public class GradeController {
     /**
      * 更新年级数据。
      *
-     * @param grade 更新对象。
+     * @param gradeDto 更新对象。
      * @return 应答结果对象。
      */
     @PostMapping("/update")
-    public ResponseResult<Void> update(@MyRequestBody Grade grade) {
-        String errorMessage = MyCommonUtil.getModelValidationError(grade, Default.class, UpdateGroup.class);
+    public ResponseResult<Void> update(@MyRequestBody("grade") GradeDto gradeDto) {
+        String errorMessage = MyCommonUtil.getModelValidationError(gradeDto, Default.class, UpdateGroup.class);
         if (errorMessage != null) {
             return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
         }
+        Grade grade = MyModelUtil.copyTo(gradeDto, Grade.class);
         Grade originalGrade = gradeService.getById(grade.getGradeId());
         if (originalGrade == null) {
             return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST);
@@ -86,18 +95,34 @@ public class GradeController {
     }
 
     /**
-     * 以字典形式返回全部年级数据集合。
-     * 白名单接口，登录用户均可访问。
+     * 白名单接口，登录用户均可访问。以字典形式返回全部年级数据集合。
+     * 所有数据全部取自于缓存，对于数据库中存在，但是缓存中不存在的数据，不会返回。
      *
      * @return 应答结果对象，包含字典形式的数据集合。
      */
     @GetMapping("/listDict")
     public ResponseResult<List<Map<String, Object>>> listDict() {
-        List<Grade> resultList = gradeService.getAllList();
+        List<Grade> resultList = gradeService.getAllListFromCache();
         return ResponseResult.success(BeanQuery.select(
                 "gradeId as id", "gradeName as name").executeFrom(resultList));
     }
 
+    /**
+     * 白名单接口，登录用户均可访问。以字典形式返回全部年级数据集合。
+     * fullResultList中的字典列表全部取自于数据库，而cachedResultList全部取自于缓存，前端负责比对。
+     *
+     * @return 应答结果对象，包含字典形式的数据集合。
+     */
+    @GetMapping("/listAll")
+    public ResponseResult<JSONObject> listAll() {
+        JSONObject jsonObject = new JSONObject();
+        jsonObject.put("fullResultList", BeanQuery.select(
+                "gradeId as id", "gradeName as name").executeFrom(gradeService.getAllList()));
+        jsonObject.put("cachedResultList", BeanQuery.select(
+                "gradeId as id", "gradeName as name").executeFrom(gradeService.getAllListFromCache()));
+        return ResponseResult.success(jsonObject);
+    }
+
     /**
      * 将当前字典表的数据重新加载到缓存中。
      * 由于缓存的数据更新，在add/update/delete等接口均有同步处理。因此该接口仅当同步过程中出现问题时，

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/controller/SchoolInfoController.java

@@ -3,6 +3,7 @@ package com.orange.demo.app.controller;
 import cn.jimmyshi.beanquery.BeanQuery;
 import com.github.pagehelper.page.PageMethod;
 import com.orange.demo.app.vo.*;
+import com.orange.demo.app.dto.*;
 import com.orange.demo.app.model.*;
 import com.orange.demo.app.service.*;
 import com.orange.demo.common.core.object.*;
@@ -10,6 +11,8 @@ import com.orange.demo.common.core.util.*;
 import com.orange.demo.common.core.constant.*;
 import com.orange.demo.common.core.annotation.MyRequestBody;
 import com.orange.demo.common.core.validator.UpdateGroup;
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
@@ -23,6 +26,7 @@ import javax.validation.groups.Default;
  * @author Jerry
  * @date 2020-09-24
  */
+@Api(tags = "校区数据管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/app/schoolInfo")
@@ -34,15 +38,17 @@ public class SchoolInfoController {
     /**
      * 新增校区数据数据。
      *
-     * @param schoolInfo 新增对象。
+     * @param schoolInfoDto 新增对象。
      * @return 应答结果对象，包含新增对象主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"schoolInfo.schoolId"})
     @PostMapping("/add")
-    public ResponseResult<Long> add(@MyRequestBody SchoolInfo schoolInfo) {
-        String errorMessage = MyCommonUtil.getModelValidationError(schoolInfo);
+    public ResponseResult<Long> add(@MyRequestBody("schoolInfo") SchoolInfoDto schoolInfoDto) {
+        String errorMessage = MyCommonUtil.getModelValidationError(schoolInfoDto);
         if (errorMessage != null) {
             return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
         }
+        SchoolInfo schoolInfo = MyModelUtil.copyTo(schoolInfoDto, SchoolInfo.class);
         // 验证关联Id的数据合法性
         CallResult callResult = schoolInfoService.verifyRelatedData(schoolInfo, null);
         if (!callResult.isSuccess()) {
@@ -56,16 +62,16 @@ public class SchoolInfoController {
     /**
      * 更新校区数据数据。
      *
-     * @param schoolInfo 更新对象。
+     * @param schoolInfoDto 更新对象。
      * @return 应答结果对象。
      */
     @PostMapping("/update")
-    public ResponseResult<Void> update(@MyRequestBody SchoolInfo schoolInfo) {
-        String errorMessage = MyCommonUtil.getModelValidationError(schoolInfo, Default.class, UpdateGroup.class);
+    public ResponseResult<Void> update(@MyRequestBody("schoolInfo") SchoolInfoDto schoolInfoDto) {
+        String errorMessage = MyCommonUtil.getModelValidationError(schoolInfoDto, Default.class, UpdateGroup.class);
         if (errorMessage != null) {
             return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
         }
-        // 验证关联Id的数据合法性
+        SchoolInfo schoolInfo = MyModelUtil.copyTo(schoolInfoDto, SchoolInfo.class);
         SchoolInfo originalSchoolInfo = schoolInfoService.getById(schoolInfo.getSchoolId());
         if (originalSchoolInfo == null) {
             // NOTE: 修改下面方括号中的话述
@@ -113,19 +119,20 @@ public class SchoolInfoController {
     /**
      * 列出符合过滤条件的校区数据列表。
      *
-     * @param schoolInfoFilter 过滤对象。
+     * @param schoolInfoDtoFilter 过滤对象。
      * @param orderParam 排序参数。
      * @param pageParam 分页参数。
      * @return 应答结果对象，包含查询结果集。
      */
     @PostMapping("/list")
     public ResponseResult<MyPageData<SchoolInfoVo>> list(
-            @MyRequestBody SchoolInfo schoolInfoFilter,
+            @MyRequestBody("schoolInfoFilter") SchoolInfoDto schoolInfoDtoFilter,
             @MyRequestBody MyOrderParam orderParam,
             @MyRequestBody MyPageParam pageParam) {
         if (pageParam != null) {
             PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize());
         }
+        SchoolInfo schoolInfoFilter = MyModelUtil.copyTo(schoolInfoDtoFilter, SchoolInfo.class);
         String orderBy = MyOrderParam.buildOrderBy(orderParam, SchoolInfo.class);
         List<SchoolInfo> schoolInfoList = schoolInfoService.getSchoolInfoListWithRelation(schoolInfoFilter, orderBy);
         return ResponseResult.success(MyPageUtil.makeResponseData(schoolInfoList, SchoolInfo.INSTANCE));
@@ -159,7 +166,7 @@ public class SchoolInfoController {
      */
     @GetMapping("/listDict")
     public ResponseResult<List<Map<String, Object>>> listDict(SchoolInfo filter) {
-        List<SchoolInfo> resultList = schoolInfoService.getListByFilter(filter, null);
+        List<SchoolInfo> resultList = schoolInfoService.getListByFilter(filter);
         return ResponseResult.success(BeanQuery.select(
                 "schoolId as id", "schoolName as name").executeFrom(resultList));
     }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/controller/StudentActionStatsController.java

@@ -2,12 +2,14 @@ package com.orange.demo.app.controller;
 
 import com.github.pagehelper.page.PageMethod;
 import com.orange.demo.app.vo.*;
+import com.orange.demo.app.dto.*;
 import com.orange.demo.app.model.*;
 import com.orange.demo.app.service.*;
 import com.orange.demo.common.core.object.*;
 import com.orange.demo.common.core.util.*;
 import com.orange.demo.common.core.constant.*;
 import com.orange.demo.common.core.annotation.MyRequestBody;
+import io.swagger.annotations.Api;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
@@ -20,6 +22,7 @@ import java.util.*;
  * @author Jerry
  * @date 2020-09-24
  */
+@Api(tags = "学生行为统计管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/app/studentActionStats")
@@ -31,19 +34,20 @@ public class StudentActionStatsController {
     /**
      * 列出符合过滤条件的学生行为统计列表。
      *
-     * @param studentActionStatsFilter 过滤对象。
+     * @param studentActionStatsDtoFilter 过滤对象。
      * @param orderParam 排序参数。
      * @param pageParam 分页参数。
      * @return 应答结果对象，包含查询结果集。
      */
     @PostMapping("/list")
     public ResponseResult<MyPageData<StudentActionStatsVo>> list(
-            @MyRequestBody StudentActionStats studentActionStatsFilter,
+            @MyRequestBody("studentActionStatsFilter") StudentActionStatsDto studentActionStatsDtoFilter,
             @MyRequestBody MyOrderParam orderParam,
             @MyRequestBody MyPageParam pageParam) {
         if (pageParam != null) {
             PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize());
         }
+        StudentActionStats studentActionStatsFilter = MyModelUtil.copyTo(studentActionStatsDtoFilter, StudentActionStats.class);
         String orderBy = MyOrderParam.buildOrderBy(orderParam, StudentActionStats.class);
         List<StudentActionStats> studentActionStatsList = studentActionStatsService.getStudentActionStatsListWithRelation(studentActionStatsFilter, orderBy);
         return ResponseResult.success(MyPageUtil.makeResponseData(studentActionStatsList, StudentActionStats.INSTANCE));
@@ -52,7 +56,7 @@ public class StudentActionStatsController {
     /**
      * 分组列出符合过滤条件的学生行为统计列表。
      *
-     * @param studentActionStatsFilter 过滤对象。
+     * @param studentActionStatsDtoFilter 过滤对象。
      * @param groupParam 分组参数。
      * @param orderParam 排序参数。
      * @param pageParam 分页参数。
@@ -60,7 +64,7 @@ public class StudentActionStatsController {
      */
     @PostMapping("/listWithGroup")
     public ResponseResult<MyPageData<StudentActionStatsVo>> listWithGroup(
-            @MyRequestBody StudentActionStats studentActionStatsFilter,
+            @MyRequestBody("studentActionStatsFilter") StudentActionStatsDto studentActionStatsDtoFilter,
             @MyRequestBody(required = true) MyGroupParam groupParam,
             @MyRequestBody MyOrderParam orderParam,
             @MyRequestBody MyPageParam pageParam) {
@@ -73,9 +77,10 @@ public class StudentActionStatsController {
         if (pageParam != null) {
             PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize());
         }
+        StudentActionStats filter = MyModelUtil.copyTo(studentActionStatsDtoFilter, StudentActionStats.class);
         MyGroupCriteria criteria = groupParam.getGroupCriteria();
         List<StudentActionStats> resultList = studentActionStatsService.getGroupedStudentActionStatsListWithRelation(
-                studentActionStatsFilter, criteria.getGroupSelect(), criteria.getGroupBy(), orderBy);
+                filter, criteria.getGroupSelect(), criteria.getGroupBy(), orderBy);
         // 分页连同对象数据转换copy工作，下面的方法一并完成。
         return ResponseResult.success(MyPageUtil.makeResponseData(resultList, StudentActionStats.INSTANCE));
     }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/controller/StudentActionTransController.java

@@ -2,6 +2,7 @@ package com.orange.demo.app.controller;
 
 import com.github.pagehelper.page.PageMethod;
 import com.orange.demo.app.vo.*;
+import com.orange.demo.app.dto.*;
 import com.orange.demo.app.model.*;
 import com.orange.demo.app.service.*;
 import com.orange.demo.common.core.object.*;
@@ -9,6 +10,8 @@ import com.orange.demo.common.core.util.*;
 import com.orange.demo.common.core.constant.*;
 import com.orange.demo.common.core.annotation.MyRequestBody;
 import com.orange.demo.common.core.validator.UpdateGroup;
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
@@ -22,6 +25,7 @@ import javax.validation.groups.Default;
  * @author Jerry
  * @date 2020-09-24
  */
+@Api(tags = "学生行为流水管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/app/studentActionTrans")
@@ -33,15 +37,20 @@ public class StudentActionTransController {
     /**
      * 新增学生行为流水数据。
      *
-     * @param studentActionTrans 新增对象。
+     * @param studentActionTransDto 新增对象。
      * @return 应答结果对象，包含新增对象主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {
+            "studentActionTrans.transId",
+            "studentActionTrans.createTimeStart",
+            "studentActionTrans.createTimeEnd"})
     @PostMapping("/add")
-    public ResponseResult<Long> add(@MyRequestBody StudentActionTrans studentActionTrans) {
-        String errorMessage = MyCommonUtil.getModelValidationError(studentActionTrans);
+    public ResponseResult<Long> add(@MyRequestBody("studentActionTrans") StudentActionTransDto studentActionTransDto) {
+        String errorMessage = MyCommonUtil.getModelValidationError(studentActionTransDto);
         if (errorMessage != null) {
             return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
         }
+        StudentActionTrans studentActionTrans = MyModelUtil.copyTo(studentActionTransDto, StudentActionTrans.class);
         // 验证关联Id的数据合法性
         CallResult callResult = studentActionTransService.verifyRelatedData(studentActionTrans, null);
         if (!callResult.isSuccess()) {
@@ -55,16 +64,19 @@ public class StudentActionTransController {
     /**
      * 更新学生行为流水数据。
      *
-     * @param studentActionTrans 更新对象。
+     * @param studentActionTransDto 更新对象。
      * @return 应答结果对象。
      */
+    @ApiOperationSupport(ignoreParameters = {
+            "studentActionTrans.createTimeStart",
+            "studentActionTrans.createTimeEnd"})
     @PostMapping("/update")
-    public ResponseResult<Void> update(@MyRequestBody StudentActionTrans studentActionTrans) {
-        String errorMessage = MyCommonUtil.getModelValidationError(studentActionTrans, Default.class, UpdateGroup.class);
+    public ResponseResult<Void> update(@MyRequestBody("studentActionTrans") StudentActionTransDto studentActionTransDto) {
+        String errorMessage = MyCommonUtil.getModelValidationError(studentActionTransDto, Default.class, UpdateGroup.class);
         if (errorMessage != null) {
             return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
         }
-        // 验证关联Id的数据合法性
+        StudentActionTrans studentActionTrans = MyModelUtil.copyTo(studentActionTransDto, StudentActionTrans.class);
         StudentActionTrans originalStudentActionTrans = studentActionTransService.getById(studentActionTrans.getTransId());
         if (originalStudentActionTrans == null) {
             // NOTE: 修改下面方括号中的话述
@@ -112,19 +124,20 @@ public class StudentActionTransController {
     /**
      * 列出符合过滤条件的学生行为流水列表。
      *
-     * @param studentActionTransFilter 过滤对象。
+     * @param studentActionTransDtoFilter 过滤对象。
      * @param orderParam 排序参数。
      * @param pageParam 分页参数。
      * @return 应答结果对象，包含查询结果集。
      */
     @PostMapping("/list")
     public ResponseResult<MyPageData<StudentActionTransVo>> list(
-            @MyRequestBody StudentActionTrans studentActionTransFilter,
+            @MyRequestBody("studentActionTransFilter") StudentActionTransDto studentActionTransDtoFilter,
             @MyRequestBody MyOrderParam orderParam,
             @MyRequestBody MyPageParam pageParam) {
         if (pageParam != null) {
             PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize());
         }
+        StudentActionTrans studentActionTransFilter = MyModelUtil.copyTo(studentActionTransDtoFilter, StudentActionTrans.class);
         String orderBy = MyOrderParam.buildOrderBy(orderParam, StudentActionTrans.class);
         List<StudentActionTrans> studentActionTransList = studentActionTransService.getStudentActionTransListWithRelation(studentActionTransFilter, orderBy);
         return ResponseResult.success(MyPageUtil.makeResponseData(studentActionTransList, StudentActionTrans.INSTANCE));

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/controller/StudentClassController.java

@@ -2,6 +2,7 @@ package com.orange.demo.app.controller;
 
 import com.github.pagehelper.page.PageMethod;
 import com.orange.demo.app.vo.*;
+import com.orange.demo.app.dto.*;
 import com.orange.demo.app.model.*;
 import com.orange.demo.app.service.*;
 import com.orange.demo.common.core.object.*;
@@ -9,6 +10,8 @@ import com.orange.demo.common.core.util.*;
 import com.orange.demo.common.core.constant.*;
 import com.orange.demo.common.core.annotation.MyRequestBody;
 import com.orange.demo.common.core.validator.UpdateGroup;
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
@@ -23,6 +26,7 @@ import java.util.stream.Collectors;
  * @author Jerry
  * @date 2020-09-24
  */
+@Api(tags = "班级数据管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/app/studentClass")
@@ -38,15 +42,17 @@ public class StudentClassController {
     /**
      * 新增班级数据数据。
      *
-     * @param studentClass 新增对象。
+     * @param studentClassDto 新增对象。
      * @return 应答结果对象，包含新增对象主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {"studentClass.classId"})
     @PostMapping("/add")
-    public ResponseResult<Long> add(@MyRequestBody StudentClass studentClass) {
-        String errorMessage = MyCommonUtil.getModelValidationError(studentClass);
+    public ResponseResult<Long> add(@MyRequestBody("studentClass") StudentClassDto studentClassDto) {
+        String errorMessage = MyCommonUtil.getModelValidationError(studentClassDto);
         if (errorMessage != null) {
             return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
         }
+        StudentClass studentClass = MyModelUtil.copyTo(studentClassDto, StudentClass.class);
         // 验证关联Id的数据合法性
         CallResult callResult = studentClassService.verifyRelatedData(studentClass, null);
         if (!callResult.isSuccess()) {
@@ -60,16 +66,16 @@ public class StudentClassController {
     /**
      * 更新班级数据数据。
      *
-     * @param studentClass 更新对象。
+     * @param studentClassDto 更新对象。
      * @return 应答结果对象。
      */
     @PostMapping("/update")
-    public ResponseResult<Void> update(@MyRequestBody StudentClass studentClass) {
-        String errorMessage = MyCommonUtil.getModelValidationError(studentClass, Default.class, UpdateGroup.class);
+    public ResponseResult<Void> update(@MyRequestBody("studentClass") StudentClassDto studentClassDto) {
+        String errorMessage = MyCommonUtil.getModelValidationError(studentClassDto, Default.class, UpdateGroup.class);
         if (errorMessage != null) {
             return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
         }
-        // 验证关联Id的数据合法性
+        StudentClass studentClass = MyModelUtil.copyTo(studentClassDto, StudentClass.class);
         StudentClass originalStudentClass = studentClassService.getById(studentClass.getClassId());
         if (originalStudentClass == null) {
             // NOTE: 修改下面方括号中的话述
@@ -117,19 +123,20 @@ public class StudentClassController {
     /**
      * 列出符合过滤条件的班级数据列表。
      *
-     * @param studentClassFilter 过滤对象。
+     * @param studentClassDtoFilter 过滤对象。
      * @param orderParam 排序参数。
      * @param pageParam 分页参数。
      * @return 应答结果对象，包含查询结果集。
      */
     @PostMapping("/list")
     public ResponseResult<MyPageData<StudentClassVo>> list(
-            @MyRequestBody StudentClass studentClassFilter,
+            @MyRequestBody("studentClassFilter") StudentClassDto studentClassDtoFilter,
             @MyRequestBody MyOrderParam orderParam,
             @MyRequestBody MyPageParam pageParam) {
         if (pageParam != null) {
             PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize());
         }
+        StudentClass studentClassFilter = MyModelUtil.copyTo(studentClassDtoFilter, StudentClass.class);
         String orderBy = MyOrderParam.buildOrderBy(orderParam, StudentClass.class);
         List<StudentClass> studentClassList = studentClassService.getStudentClassListWithRelation(studentClassFilter, orderBy);
         return ResponseResult.success(MyPageUtil.makeResponseData(studentClassList, StudentClass.INSTANCE));
@@ -158,7 +165,7 @@ public class StudentClassController {
      * 列出不与指定班级数据存在多对多关系的 [课程数据] 列表数据。通常用于查看添加新 [课程数据] 对象的候选列表。
      *
      * @param classId 主表关联字段。
-     * @param courseFilter [课程数据] 过滤对象。
+     * @param courseDtoFilter [课程数据] 过滤对象。
      * @param orderParam 排序参数。
      * @param pageParam 分页参数。
      * @return 应答结果对象，返回符合条件的数据列表。
@@ -166,7 +173,7 @@ public class StudentClassController {
     @PostMapping("/listNotInClassCourse")
     public ResponseResult<MyPageData<CourseVo>> listNotInClassCourse(
             @MyRequestBody Long classId,
-            @MyRequestBody Course courseFilter,
+            @MyRequestBody("courseFilter") CourseDto courseDtoFilter,
             @MyRequestBody MyOrderParam orderParam,
             @MyRequestBody MyPageParam pageParam) {
         ResponseResult<Void> verifyResult = this.doClassCourseVerify(classId);
@@ -176,9 +183,10 @@ public class StudentClassController {
         if (pageParam != null) {
             PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize());
         }
+        Course filter = MyModelUtil.copyTo(courseDtoFilter, Course.class);
         String orderBy = MyOrderParam.buildOrderBy(orderParam, Course.class);
         List<Course> courseList =
-                courseService.getNotInCourseListByClassId(classId, courseFilter, orderBy);
+                courseService.getNotInCourseListByClassId(classId, filter, orderBy);
         return ResponseResult.success(MyPageUtil.makeResponseData(courseList, Course.INSTANCE));
     }
 
@@ -186,7 +194,7 @@ public class StudentClassController {
      * 列出与指定班级数据存在多对多关系的 [课程数据] 列表数据。
      *
      * @param classId 主表关联字段。
-     * @param courseFilter [课程数据] 过滤对象。
+     * @param courseDtoFilter [课程数据] 过滤对象。
      * @param orderParam 排序参数。
      * @param pageParam 分页参数。
      * @return 应答结果对象，返回符合条件的数据列表。
@@ -194,7 +202,7 @@ public class StudentClassController {
     @PostMapping("/listClassCourse")
     public ResponseResult<MyPageData<CourseVo>> listClassCourse(
             @MyRequestBody Long classId,
-            @MyRequestBody Course courseFilter,
+            @MyRequestBody("courseFilter") CourseDto courseDtoFilter,
             @MyRequestBody MyOrderParam orderParam,
             @MyRequestBody MyPageParam pageParam) {
         ResponseResult<Void> verifyResult = this.doClassCourseVerify(classId);
@@ -204,9 +212,10 @@ public class StudentClassController {
         if (pageParam != null) {
             PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize());
         }
+        Course filter = MyModelUtil.copyTo(courseDtoFilter, Course.class);
         String orderBy = MyOrderParam.buildOrderBy(orderParam, Course.class);
         List<Course> courseList =
-                courseService.getCourseListByClassId(classId, courseFilter, orderBy);
+                courseService.getCourseListByClassId(classId, filter, orderBy);
         return ResponseResult.success(MyPageUtil.makeResponseData(courseList, Course.INSTANCE));
     }
 
@@ -224,28 +233,30 @@ public class StudentClassController {
      * 批量添加班级数据和 [课程数据] 对象的多对多关联关系数据。
      *
      * @param classId 主表主键Id。
-     * @param classCourseList 关联对象列表。
+     * @param classCourseDtoList 关联对象列表。
      * @return 应答结果对象。
      */
     @PostMapping("/addClassCourse")
     public ResponseResult<Void> addClassCourse(
             @MyRequestBody Long classId,
-            @MyRequestBody(elementType = ClassCourse.class) List<ClassCourse> classCourseList) {
-        if (MyCommonUtil.existBlankArgument(classId, classCourseList)) {
+            @MyRequestBody(value = "classCourseList", elementType = ClassCourseDto.class) List<ClassCourseDto> classCourseDtoList) {
+        if (MyCommonUtil.existBlankArgument(classId, classCourseDtoList)) {
             return ResponseResult.error(ErrorCodeEnum.ARGUMENT_NULL_EXIST);
         }
-        for (ClassCourse classCourse : classCourseList) {
+        for (ClassCourseDto classCourse : classCourseDtoList) {
             String errorMessage = MyCommonUtil.getModelValidationError(classCourse);
             if (errorMessage != null) {
                 return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
             }
         }
         Set<Long> courseIdSet =
-                classCourseList.stream().map(ClassCourse::getCourseId).collect(Collectors.toSet());
+                classCourseDtoList.stream().map(ClassCourseDto::getCourseId).collect(Collectors.toSet());
         if (!studentClassService.existId(classId)
                 || !courseService.existUniqueKeyList("courseId", courseIdSet)) {
             return ResponseResult.error(ErrorCodeEnum.INVALID_RELATED_RECORD_ID);
         }
+        List<ClassCourse> classCourseList =
+                MyModelUtil.copyCollectionTo(classCourseDtoList, ClassCourse.class);
         studentClassService.addClassCourseList(classCourseList, classId);
         return ResponseResult.success();
     }
@@ -253,15 +264,17 @@ public class StudentClassController {
     /**
      * 更新指定班级数据和指定 [课程数据] 的多对多关联数据。
      *
-     * @param classCourse 对多对中间表对象。
+     * @param classCourseDto 对多对中间表对象。
      * @return 应答结果对象。
      */
     @PostMapping("/updateClassCourse")
-    public ResponseResult<Void> updateClassCourse(@MyRequestBody ClassCourse classCourse) {
-        String errorMessage = MyCommonUtil.getModelValidationError(classCourse);
+    public ResponseResult<Void> updateClassCourse(
+            @MyRequestBody("classCourse") ClassCourseDto classCourseDto) {
+        String errorMessage = MyCommonUtil.getModelValidationError(classCourseDto);
         if (errorMessage != null) {
             return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
         }
+        ClassCourse classCourse = MyModelUtil.copyTo(classCourseDto, ClassCourse.class);
         if (!studentClassService.updateClassCourse(classCourse)) {
             return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST);
         }
@@ -312,7 +325,7 @@ public class StudentClassController {
      * 列出不与指定班级数据存在多对多关系的 [学生数据] 列表数据。通常用于查看添加新 [学生数据] 对象的候选列表。
      *
      * @param classId 主表关联字段。
-     * @param studentFilter [学生数据] 过滤对象。
+     * @param studentDtoFilter [学生数据] 过滤对象。
      * @param orderParam 排序参数。
      * @param pageParam 分页参数。
      * @return 应答结果对象，返回符合条件的数据列表。
@@ -320,7 +333,7 @@ public class StudentClassController {
     @PostMapping("/listNotInClassStudent")
     public ResponseResult<MyPageData<StudentVo>> listNotInClassStudent(
             @MyRequestBody Long classId,
-            @MyRequestBody Student studentFilter,
+            @MyRequestBody("studentFilter") StudentDto studentDtoFilter,
             @MyRequestBody MyOrderParam orderParam,
             @MyRequestBody MyPageParam pageParam) {
         ResponseResult<Void> verifyResult = this.doClassStudentVerify(classId);
@@ -330,9 +343,10 @@ public class StudentClassController {
         if (pageParam != null) {
             PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize());
         }
+        Student filter = MyModelUtil.copyTo(studentDtoFilter, Student.class);
         String orderBy = MyOrderParam.buildOrderBy(orderParam, Student.class);
         List<Student> studentList =
-                studentService.getNotInStudentListByClassId(classId, studentFilter, orderBy);
+                studentService.getNotInStudentListByClassId(classId, filter, orderBy);
         return ResponseResult.success(MyPageUtil.makeResponseData(studentList, Student.INSTANCE));
     }
 
@@ -340,7 +354,7 @@ public class StudentClassController {
      * 列出与指定班级数据存在多对多关系的 [学生数据] 列表数据。
      *
      * @param classId 主表关联字段。
-     * @param studentFilter [学生数据] 过滤对象。
+     * @param studentDtoFilter [学生数据] 过滤对象。
      * @param orderParam 排序参数。
      * @param pageParam 分页参数。
      * @return 应答结果对象，返回符合条件的数据列表。
@@ -348,7 +362,7 @@ public class StudentClassController {
     @PostMapping("/listClassStudent")
     public ResponseResult<MyPageData<StudentVo>> listClassStudent(
             @MyRequestBody Long classId,
-            @MyRequestBody Student studentFilter,
+            @MyRequestBody("studentFilter") StudentDto studentDtoFilter,
             @MyRequestBody MyOrderParam orderParam,
             @MyRequestBody MyPageParam pageParam) {
         ResponseResult<Void> verifyResult = this.doClassStudentVerify(classId);
@@ -358,9 +372,10 @@ public class StudentClassController {
         if (pageParam != null) {
             PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize());
         }
+        Student filter = MyModelUtil.copyTo(studentDtoFilter, Student.class);
         String orderBy = MyOrderParam.buildOrderBy(orderParam, Student.class);
         List<Student> studentList =
-                studentService.getStudentListByClassId(classId, studentFilter, orderBy);
+                studentService.getStudentListByClassId(classId, filter, orderBy);
         return ResponseResult.success(MyPageUtil.makeResponseData(studentList, Student.INSTANCE));
     }
 
@@ -378,28 +393,30 @@ public class StudentClassController {
      * 批量添加班级数据和 [学生数据] 对象的多对多关联关系数据。
      *
      * @param classId 主表主键Id。
-     * @param classStudentList 关联对象列表。
+     * @param classStudentDtoList 关联对象列表。
      * @return 应答结果对象。
      */
     @PostMapping("/addClassStudent")
     public ResponseResult<Void> addClassStudent(
             @MyRequestBody Long classId,
-            @MyRequestBody(elementType = ClassStudent.class) List<ClassStudent> classStudentList) {
-        if (MyCommonUtil.existBlankArgument(classId, classStudentList)) {
+            @MyRequestBody(value = "classStudentList", elementType = ClassStudentDto.class) List<ClassStudentDto> classStudentDtoList) {
+        if (MyCommonUtil.existBlankArgument(classId, classStudentDtoList)) {
             return ResponseResult.error(ErrorCodeEnum.ARGUMENT_NULL_EXIST);
         }
-        for (ClassStudent classStudent : classStudentList) {
+        for (ClassStudentDto classStudent : classStudentDtoList) {
             String errorMessage = MyCommonUtil.getModelValidationError(classStudent);
             if (errorMessage != null) {
                 return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
             }
         }
         Set<Long> studentIdSet =
-                classStudentList.stream().map(ClassStudent::getStudentId).collect(Collectors.toSet());
+                classStudentDtoList.stream().map(ClassStudentDto::getStudentId).collect(Collectors.toSet());
         if (!studentClassService.existId(classId)
                 || !studentService.existUniqueKeyList("studentId", studentIdSet)) {
             return ResponseResult.error(ErrorCodeEnum.INVALID_RELATED_RECORD_ID);
         }
+        List<ClassStudent> classStudentList =
+                MyModelUtil.copyCollectionTo(classStudentDtoList, ClassStudent.class);
         studentClassService.addClassStudentList(classStudentList, classId);
         return ResponseResult.success();
     }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/controller/StudentController.java

@@ -3,6 +3,7 @@ package com.orange.demo.app.controller;
 import cn.jimmyshi.beanquery.BeanQuery;
 import com.github.pagehelper.page.PageMethod;
 import com.orange.demo.app.vo.*;
+import com.orange.demo.app.dto.*;
 import com.orange.demo.app.model.*;
 import com.orange.demo.app.service.*;
 import com.orange.demo.common.core.object.*;
@@ -10,6 +11,8 @@ import com.orange.demo.common.core.util.*;
 import com.orange.demo.common.core.constant.*;
 import com.orange.demo.common.core.annotation.MyRequestBody;
 import com.orange.demo.common.core.validator.UpdateGroup;
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
@@ -23,6 +26,7 @@ import javax.validation.groups.Default;
  * @author Jerry
  * @date 2020-09-24
  */
+@Api(tags = "学生数据管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/app/student")
@@ -34,15 +38,23 @@ public class StudentController {
     /**
      * 新增学生数据数据。
      *
-     * @param student 新增对象。
+     * @param studentDto 新增对象。
      * @return 应答结果对象，包含新增对象主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {
+            "student.studentId",
+            "student.searchString",
+            "student.birthdayStart",
+            "student.birthdayEnd",
+            "student.registerTimeStart",
+            "student.registerTimeEnd"})
     @PostMapping("/add")
-    public ResponseResult<Long> add(@MyRequestBody Student student) {
-        String errorMessage = MyCommonUtil.getModelValidationError(student);
+    public ResponseResult<Long> add(@MyRequestBody("student") StudentDto studentDto) {
+        String errorMessage = MyCommonUtil.getModelValidationError(studentDto);
         if (errorMessage != null) {
             return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
         }
+        Student student = MyModelUtil.copyTo(studentDto, Student.class);
         // 验证关联Id的数据合法性
         CallResult callResult = studentService.verifyRelatedData(student, null);
         if (!callResult.isSuccess()) {
@@ -56,16 +68,22 @@ public class StudentController {
     /**
      * 更新学生数据数据。
      *
-     * @param student 更新对象。
+     * @param studentDto 更新对象。
      * @return 应答结果对象。
      */
+    @ApiOperationSupport(ignoreParameters = {
+            "student.searchString",
+            "student.birthdayStart",
+            "student.birthdayEnd",
+            "student.registerTimeStart",
+            "student.registerTimeEnd"})
     @PostMapping("/update")
-    public ResponseResult<Void> update(@MyRequestBody Student student) {
-        String errorMessage = MyCommonUtil.getModelValidationError(student, Default.class, UpdateGroup.class);
+    public ResponseResult<Void> update(@MyRequestBody("student") StudentDto studentDto) {
+        String errorMessage = MyCommonUtil.getModelValidationError(studentDto, Default.class, UpdateGroup.class);
         if (errorMessage != null) {
             return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
         }
-        // 验证关联Id的数据合法性
+        Student student = MyModelUtil.copyTo(studentDto, Student.class);
         Student originalStudent = studentService.getById(student.getStudentId());
         if (originalStudent == null) {
             // NOTE: 修改下面方括号中的话述
@@ -113,19 +131,20 @@ public class StudentController {
     /**
      * 列出符合过滤条件的学生数据列表。
      *
-     * @param studentFilter 过滤对象。
+     * @param studentDtoFilter 过滤对象。
      * @param orderParam 排序参数。
      * @param pageParam 分页参数。
      * @return 应答结果对象，包含查询结果集。
      */
     @PostMapping("/list")
     public ResponseResult<MyPageData<StudentVo>> list(
-            @MyRequestBody Student studentFilter,
+            @MyRequestBody("studentFilter") StudentDto studentDtoFilter,
             @MyRequestBody MyOrderParam orderParam,
             @MyRequestBody MyPageParam pageParam) {
         if (pageParam != null) {
             PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize());
         }
+        Student studentFilter = MyModelUtil.copyTo(studentDtoFilter, Student.class);
         String orderBy = MyOrderParam.buildOrderBy(orderParam, Student.class);
         List<Student> studentList = studentService.getStudentListWithRelation(studentFilter, orderBy);
         return ResponseResult.success(MyPageUtil.makeResponseData(studentList, Student.INSTANCE));
@@ -159,7 +178,7 @@ public class StudentController {
      */
     @GetMapping("/listDict")
     public ResponseResult<List<Map<String, Object>>> listDict(Student filter) {
-        List<Student> resultList = studentService.getListByFilter(filter, null);
+        List<Student> resultList = studentService.getListByFilter(filter);
         return ResponseResult.success(BeanQuery.select(
                 "studentId as id", "studentName as name").executeFrom(resultList));
     }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/dto/ClassCourseDto.java

@@ -0,0 +1,41 @@
+package com.orange.demo.app.dto;
+
+import com.orange.demo.common.core.validator.UpdateGroup;
+
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import javax.validation.constraints.*;
+
+/**
+ * ClassCourseDto对象。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@ApiModel("ClassCourseDto对象")
+@Data
+public class ClassCourseDto {
+
+    /**
+     * 班级Id。
+     */
+    @ApiModelProperty(value = "班级Id", required = true)
+    @NotNull(message = "数据验证失败，班级Id不能为空！", groups = {UpdateGroup.class})
+    private Long classId;
+
+    /**
+     * 课程Id。
+     */
+    @ApiModelProperty(value = "课程Id", required = true)
+    @NotNull(message = "数据验证失败，课程Id不能为空！", groups = {UpdateGroup.class})
+    private Long courseId;
+
+    /**
+     * 课程顺序(数值越小越靠前)。
+     */
+    @ApiModelProperty(value = "课程顺序(数值越小越靠前)", required = true)
+    @NotNull(message = "数据验证失败，课程顺序(数值越小越靠前)不能为空！", groups = {UpdateGroup.class})
+    private Integer courseOrder;
+}

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/dto/ClassStudentDto.java

@@ -0,0 +1,34 @@
+package com.orange.demo.app.dto;
+
+import com.orange.demo.common.core.validator.UpdateGroup;
+
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import javax.validation.constraints.*;
+
+/**
+ * ClassStudentDto对象。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@ApiModel("ClassStudentDto对象")
+@Data
+public class ClassStudentDto {
+
+    /**
+     * 班级Id。
+     */
+    @ApiModelProperty(value = "班级Id", required = true)
+    @NotNull(message = "数据验证失败，班级Id不能为空！", groups = {UpdateGroup.class})
+    private Long classId;
+
+    /**
+     * 学生Id。
+     */
+    @ApiModelProperty(value = "学生Id", required = true)
+    @NotNull(message = "数据验证失败，学生Id不能为空！", groups = {UpdateGroup.class})
+    private Long studentId;
+}

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/dto/CourseDto.java

@@ -0,0 +1,125 @@
+package com.orange.demo.app.dto;
+
+import com.orange.demo.common.core.validator.UpdateGroup;
+import com.orange.demo.common.core.validator.ConstDictRef;
+import com.orange.demo.app.model.constant.CourseDifficult;
+import com.orange.demo.application.common.constant.Subject;
+
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import javax.validation.constraints.*;
+
+import java.math.BigDecimal;
+
+/**
+ * CourseDto对象。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@ApiModel("CourseDto对象")
+@Data
+public class CourseDto {
+
+    /**
+     * 主键Id。
+     */
+    @ApiModelProperty(value = "主键Id", required = true)
+    @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
+    private Long courseId;
+
+    /**
+     * 课程名称。
+     */
+    @ApiModelProperty(value = "课程名称", required = true)
+    @NotBlank(message = "数据验证失败，课程名称不能为空！")
+    private String courseName;
+
+    /**
+     * 课程价格。
+     */
+    @ApiModelProperty(value = "课程价格", required = true)
+    @NotNull(message = "数据验证失败，课程价格不能为空！")
+    private BigDecimal price;
+
+    /**
+     * 课程描述。
+     */
+    @ApiModelProperty(value = "课程描述")
+    private String description;
+
+    /**
+     * 课程难度(0: 容易 1: 普通 2: 很难)。
+     */
+    @ApiModelProperty(value = "课程难度(0: 容易 1: 普通 2: 很难)", required = true)
+    @NotNull(message = "数据验证失败，课程难度不能为空！")
+    @ConstDictRef(constDictClass = CourseDifficult.class, message = "数据验证失败，课程难度为无效值！")
+    private Integer difficulty;
+
+    /**
+     * 年级Id。
+     */
+    @ApiModelProperty(value = "年级Id", required = true)
+    @NotNull(message = "数据验证失败，所属年级不能为空！")
+    private Integer gradeId;
+
+    /**
+     * 学科Id。
+     */
+    @ApiModelProperty(value = "学科Id", required = true)
+    @NotNull(message = "数据验证失败，所属学科不能为空！")
+    @ConstDictRef(constDictClass = Subject.class, message = "数据验证失败，所属学科为无效值！")
+    private Integer subjectId;
+
+    /**
+     * 课时数量。
+     */
+    @ApiModelProperty(value = "课时数量", required = true)
+    @NotNull(message = "数据验证失败，课时数量不能为空！")
+    private Integer classHour;
+
+    /**
+     * 多张课程图片地址。
+     */
+    @ApiModelProperty(value = "多张课程图片地址", required = true)
+    @NotBlank(message = "数据验证失败，课程图片不能为空！")
+    private String pictureUrl;
+
+    /**
+     * price 范围过滤起始值(>=)。
+     */
+    @ApiModelProperty(value = "price 范围过滤起始值(>=)")
+    private BigDecimal priceStart;
+
+    /**
+     * price 范围过滤结束值(<=)。
+     */
+    @ApiModelProperty(value = "price 范围过滤结束值(<=)")
+    private BigDecimal priceEnd;
+
+    /**
+     * classHour 范围过滤起始值(>=)。
+     */
+    @ApiModelProperty(value = "classHour 范围过滤起始值(>=)")
+    private Integer classHourStart;
+
+    /**
+     * classHour 范围过滤结束值(<=)。
+     */
+    @ApiModelProperty(value = "classHour 范围过滤结束值(<=)")
+    private Integer classHourEnd;
+
+    /**
+     * createTime 范围过滤起始值(>=)。
+     */
+    @ApiModelProperty(value = "createTime 范围过滤起始值(>=)")
+    private String createTimeStart;
+
+    /**
+     * createTime 范围过滤结束值(<=)。
+     */
+    @ApiModelProperty(value = "createTime 范围过滤结束值(<=)")
+    private String createTimeEnd;
+}

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/dto/CourseTransStatsDto.java

@@ -0,0 +1,105 @@
+package com.orange.demo.app.dto;
+
+import com.orange.demo.common.core.validator.UpdateGroup;
+import com.orange.demo.common.core.validator.ConstDictRef;
+import com.orange.demo.application.common.constant.Subject;
+
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import javax.validation.constraints.*;
+
+import java.util.Date;
+
+/**
+ * CourseTransStatsDto对象。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@ApiModel("CourseTransStatsDto对象")
+@Data
+public class CourseTransStatsDto {
+
+    /**
+     * 主键Id。
+     */
+    @ApiModelProperty(value = "主键Id", required = true)
+    @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
+    private Long statsId;
+
+    /**
+     * 统计日期。
+     */
+    @ApiModelProperty(value = "统计日期", required = true)
+    @NotNull(message = "数据验证失败，统计日期不能为空！")
+    private Date statsDate;
+
+    /**
+     * 科目Id。
+     */
+    @ApiModelProperty(value = "科目Id", required = true)
+    @NotNull(message = "数据验证失败，所属科目不能为空！")
+    @ConstDictRef(constDictClass = Subject.class, message = "数据验证失败，所属科目为无效值！")
+    private Integer subjectId;
+
+    /**
+     * 年级Id。
+     */
+    @ApiModelProperty(value = "年级Id", required = true)
+    @NotNull(message = "数据验证失败，所属年级不能为空！")
+    private Integer gradeId;
+
+    /**
+     * 年级名称。
+     */
+    @ApiModelProperty(value = "年级名称")
+    private String gradeName;
+
+    /**
+     * 课程Id。
+     */
+    @ApiModelProperty(value = "课程Id", required = true)
+    @NotNull(message = "数据验证失败，课程Id不能为空！")
+    private Long courseId;
+
+    /**
+     * 课程名称。
+     */
+    @ApiModelProperty(value = "课程名称")
+    private String courseName;
+
+    /**
+     * 学生上课次数。
+     */
+    @ApiModelProperty(value = "学生上课次数", required = true)
+    @NotNull(message = "数据验证失败，上课次数不能为空！")
+    private Integer studentAttendCount;
+
+    /**
+     * 学生献花数量。
+     */
+    @ApiModelProperty(value = "学生献花数量", required = true)
+    @NotNull(message = "数据验证失败，献花数量不能为空！")
+    private Integer studentFlowerAmount;
+
+    /**
+     * 学生献花次数。
+     */
+    @ApiModelProperty(value = "学生献花次数", required = true)
+    @NotNull(message = "数据验证失败，献花次数不能为空！")
+    private Integer studentFlowerCount;
+
+    /**
+     * statsDate 范围过滤起始值(>=)。
+     */
+    @ApiModelProperty(value = "statsDate 范围过滤起始值(>=)")
+    private String statsDateStart;
+
+    /**
+     * statsDate 范围过滤结束值(<=)。
+     */
+    @ApiModelProperty(value = "statsDate 范围过滤结束值(<=)")
+    private String statsDateEnd;
+}

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/dto/GradeDto.java

@@ -0,0 +1,34 @@
+package com.orange.demo.app.dto;
+
+import com.orange.demo.common.core.validator.UpdateGroup;
+
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import javax.validation.constraints.*;
+
+/**
+ * GradeDto对象。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@ApiModel("GradeDto对象")
+@Data
+public class GradeDto {
+
+    /**
+     * 主键Id。
+     */
+    @ApiModelProperty(value = "主键Id", required = true)
+    @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
+    private Integer gradeId;
+
+    /**
+     * 年级名称。
+     */
+    @ApiModelProperty(value = "年级名称", required = true)
+    @NotBlank(message = "数据验证失败，年级名称不能为空！")
+    private String gradeName;
+}

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/dto/SchoolInfoDto.java

@@ -0,0 +1,48 @@
+package com.orange.demo.app.dto;
+
+import com.orange.demo.common.core.validator.UpdateGroup;
+
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import javax.validation.constraints.*;
+
+/**
+ * SchoolInfoDto对象。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@ApiModel("SchoolInfoDto对象")
+@Data
+public class SchoolInfoDto {
+
+    /**
+     * 学校Id。
+     */
+    @ApiModelProperty(value = "学校Id", required = true)
+    @NotNull(message = "数据验证失败，学校Id不能为空！", groups = {UpdateGroup.class})
+    private Long schoolId;
+
+    /**
+     * 学校名称。
+     */
+    @ApiModelProperty(value = "学校名称", required = true)
+    @NotBlank(message = "数据验证失败，学校名称不能为空！")
+    private String schoolName;
+
+    /**
+     * 所在省Id。
+     */
+    @ApiModelProperty(value = "所在省Id", required = true)
+    @NotNull(message = "数据验证失败，所在省份不能为空！")
+    private Long provinceId;
+
+    /**
+     * 所在城市Id。
+     */
+    @ApiModelProperty(value = "所在城市Id", required = true)
+    @NotNull(message = "数据验证失败，所在城市不能为空！")
+    private Long cityId;
+}

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/dto/StudentActionStatsDto.java

@@ -0,0 +1,180 @@
+package com.orange.demo.app.dto;
+
+import com.orange.demo.common.core.validator.UpdateGroup;
+
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import javax.validation.constraints.*;
+
+import java.util.Date;
+
+/**
+ * StudentActionStatsDto对象。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@ApiModel("StudentActionStatsDto对象")
+@Data
+public class StudentActionStatsDto {
+
+    /**
+     * 主键Id。
+     */
+    @ApiModelProperty(value = "主键Id", required = true)
+    @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
+    private Long statsId;
+
+    /**
+     * 统计日期。
+     */
+    @ApiModelProperty(value = "统计日期", required = true)
+    @NotNull(message = "数据验证失败，统计日期不能为空！")
+    private Date statsDate;
+
+    /**
+     * 统计小时。
+     */
+    @ApiModelProperty(value = "统计小时")
+    private Date statsMonth;
+
+    /**
+     * 年级Id。
+     */
+    @ApiModelProperty(value = "年级Id", required = true)
+    @NotNull(message = "数据验证失败，所属年级不能为空！")
+    private Integer gradeId;
+
+    /**
+     * 学生所在省Id。
+     */
+    @ApiModelProperty(value = "学生所在省Id", required = true)
+    @NotNull(message = "数据验证失败，所在省份不能为空！")
+    private Long provinceId;
+
+    /**
+     * 学生所在城市Id。
+     */
+    @ApiModelProperty(value = "学生所在城市Id", required = true)
+    @NotNull(message = "数据验证失败，所在城市不能为空！", groups = {UpdateGroup.class})
+    private Long cityId;
+
+    /**
+     * 购课学币数量。
+     */
+    @ApiModelProperty(value = "购课学币数量", required = true)
+    @NotNull(message = "数据验证失败，购课学币数量不能为空！", groups = {UpdateGroup.class})
+    private Integer buyCourseAmount;
+
+    /**
+     * 购买课程次数。
+     */
+    @ApiModelProperty(value = "购买课程次数", required = true)
+    @NotNull(message = "数据验证失败，购买课程次数不能为空！", groups = {UpdateGroup.class})
+    private Integer buyCourseCount;
+
+    /**
+     * 购买视频学币数量。
+     */
+    @ApiModelProperty(value = "购买视频学币数量", required = true)
+    @NotNull(message = "数据验证失败，购买视频学币数量不能为空！", groups = {UpdateGroup.class})
+    private Integer buyVideoAmount;
+
+    /**
+     * 购买视频次数。
+     */
+    @ApiModelProperty(value = "购买视频次数", required = true)
+    @NotNull(message = "数据验证失败，购买视频次数不能为空！", groups = {UpdateGroup.class})
+    private Integer buyVideoCount;
+
+    /**
+     * 购买作业学币数量。
+     */
+    @ApiModelProperty(value = "购买作业学币数量", required = true)
+    @NotNull(message = "数据验证失败，购买作业学币数量不能为空！", groups = {UpdateGroup.class})
+    private Integer buyPaperAmount;
+
+    /**
+     * 购买作业次数。
+     */
+    @ApiModelProperty(value = "购买作业次数", required = true)
+    @NotNull(message = "数据验证失败，购买作业次数不能为空！", groups = {UpdateGroup.class})
+    private Integer buyPaperCount;
+
+    /**
+     * 购买献花数量。
+     */
+    @ApiModelProperty(value = "购买献花数量", required = true)
+    @NotNull(message = "数据验证失败，购买献花数量不能为空！", groups = {UpdateGroup.class})
+    private Integer buyFlowerAmount;
+
+    /**
+     * 购买献花次数。
+     */
+    @ApiModelProperty(value = "购买献花次数", required = true)
+    @NotNull(message = "数据验证失败，购买献花次数不能为空！", groups = {UpdateGroup.class})
+    private Integer buyFlowerCount;
+
+    /**
+     * 充值学币数量。
+     */
+    @ApiModelProperty(value = "充值学币数量", required = true)
+    @NotNull(message = "数据验证失败，充值学币数量不能为空！", groups = {UpdateGroup.class})
+    private Integer rechargeCoinAmount;
+
+    /**
+     * 充值学币次数。
+     */
+    @ApiModelProperty(value = "充值学币次数", required = true)
+    @NotNull(message = "数据验证失败，充值学币次数不能为空！", groups = {UpdateGroup.class})
+    private Integer rechargeCoinCount;
+
+    /**
+     * 线下课程上课次数。
+     */
+    @ApiModelProperty(value = "线下课程上课次数", required = true)
+    @NotNull(message = "数据验证失败，线下课程上课次数不能为空！")
+    private Integer doCourseCount;
+
+    /**
+     * 观看视频次数。
+     */
+    @ApiModelProperty(value = "观看视频次数", required = true)
+    @NotNull(message = "数据验证失败，观看视频次数不能为空！", groups = {UpdateGroup.class})
+    private Integer watchVideoCount;
+
+    /**
+     * 购买献花消费学币数量。
+     */
+    @ApiModelProperty(value = "购买献花消费学币数量", required = true)
+    @NotNull(message = "数据验证失败，购买献花消费学币数量不能为空！")
+    private Integer watchVideoTotalSecond;
+
+    /**
+     * 做题数量。
+     */
+    @ApiModelProperty(value = "做题数量", required = true)
+    @NotNull(message = "数据验证失败，做题数量不能为空！", groups = {UpdateGroup.class})
+    private Integer doExerciseCount;
+
+    /**
+     * 做题正确的数量。
+     */
+    @ApiModelProperty(value = "做题正确的数量", required = true)
+    @NotNull(message = "数据验证失败，做题正确的数量不能为空！", groups = {UpdateGroup.class})
+    private Integer doExerciseCorrectCount;
+
+    /**
+     * statsDate 范围过滤起始值(>=)。
+     */
+    @ApiModelProperty(value = "statsDate 范围过滤起始值(>=)")
+    private String statsDateStart;
+
+    /**
+     * statsDate 范围过滤结束值(<=)。
+     */
+    @ApiModelProperty(value = "statsDate 范围过滤结束值(<=)")
+    private String statsDateEnd;
+}

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/dto/StudentActionTransDto.java

@@ -0,0 +1,137 @@
+package com.orange.demo.app.dto;
+
+import com.orange.demo.common.core.validator.UpdateGroup;
+import com.orange.demo.common.core.validator.ConstDictRef;
+import com.orange.demo.application.common.constant.StudentActionType;
+import com.orange.demo.application.common.constant.DeviceType;
+
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import javax.validation.constraints.*;
+
+import java.util.Date;
+
+/**
+ * StudentActionTransDto对象。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@ApiModel("StudentActionTransDto对象")
+@Data
+public class StudentActionTransDto {
+
+    /**
+     * 主键Id。
+     */
+    @ApiModelProperty(value = "主键Id", required = true)
+    @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
+    private Long transId;
+
+    /**
+     * 学生Id。
+     */
+    @ApiModelProperty(value = "学生Id", required = true)
+    @NotNull(message = "数据验证失败，学生Id不能为空！")
+    private Long studentId;
+
+    /**
+     * 学生名称。
+     */
+    @ApiModelProperty(value = "学生名称", required = true)
+    @NotBlank(message = "数据验证失败，学生名称不能为空！")
+    private String studentName;
+
+    /**
+     * 学生校区。
+     */
+    @ApiModelProperty(value = "学生校区", required = true)
+    @NotNull(message = "数据验证失败，学生校区不能为空！")
+    private Long schoolId;
+
+    /**
+     * 年级Id。
+     */
+    @ApiModelProperty(value = "年级Id", required = true)
+    @NotNull(message = "数据验证失败，学生年级不能为空！")
+    private Integer gradeId;
+
+    /**
+     * 行为类型(0: 充值  1: 购课 2: 上课签到 3: 上课签退 4: 看视频课 5: 做作业 6: 刷题 7: 献花)。
+     */
+    @ApiModelProperty(value = "行为类型(0: 充值  1: 购课 2: 上课签到 3: 上课签退 4: 看视频课 5: 做作业 6: 刷题 7: 献花)", required = true)
+    @NotNull(message = "数据验证失败，行为类型不能为空！")
+    @ConstDictRef(constDictClass = StudentActionType.class, message = "数据验证失败，行为类型为无效值！")
+    private Integer actionType;
+
+    /**
+     * 设备类型(0: iOS 1: Android 2: PC)。
+     */
+    @ApiModelProperty(value = "设备类型(0: iOS 1: Android 2: PC)", required = true)
+    @NotNull(message = "数据验证失败，设备类型不能为空！")
+    @ConstDictRef(constDictClass = DeviceType.class, message = "数据验证失败，设备类型为无效值！")
+    private Integer deviceType;
+
+    /**
+     * 看视频秒数。
+     */
+    @ApiModelProperty(value = "看视频秒数")
+    private Integer watchVideoSeconds;
+
+    /**
+     * 购买献花数量。
+     */
+    @ApiModelProperty(value = "购买献花数量")
+    private Integer flowerCount;
+
+    /**
+     * 购买作业数量。
+     */
+    @ApiModelProperty(value = "购买作业数量")
+    private Integer paperCount;
+
+    /**
+     * 购买视频数量。
+     */
+    @ApiModelProperty(value = "购买视频数量")
+    private Integer videoCount;
+
+    /**
+     * 购买课程数量。
+     */
+    @ApiModelProperty(value = "购买课程数量")
+    private Integer courseCount;
+
+    /**
+     * 充值学币数量。
+     */
+    @ApiModelProperty(value = "充值学币数量")
+    private Integer coinCount;
+
+    /**
+     * 做题是否正确标记。
+     */
+    @ApiModelProperty(value = "做题是否正确标记")
+    private Integer exerciseCorrectFlag;
+
+    /**
+     * 发生时间。
+     */
+    @ApiModelProperty(value = "发生时间", required = true)
+    @NotNull(message = "数据验证失败，发生时间不能为空！")
+    private Date createTime;
+
+    /**
+     * createTime 范围过滤起始值(>=)。
+     */
+    @ApiModelProperty(value = "createTime 范围过滤起始值(>=)")
+    private String createTimeStart;
+
+    /**
+     * createTime 范围过滤结束值(<=)。
+     */
+    @ApiModelProperty(value = "createTime 范围过滤结束值(<=)")
+    private String createTimeEnd;
+}

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/dto/StudentClassDto.java

@@ -0,0 +1,65 @@
+package com.orange.demo.app.dto;
+
+import com.orange.demo.common.core.validator.UpdateGroup;
+import com.orange.demo.common.core.validator.ConstDictRef;
+import com.orange.demo.app.model.constant.ClassLevel;
+
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import javax.validation.constraints.*;
+
+/**
+ * StudentClassDto对象。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@ApiModel("StudentClassDto对象")
+@Data
+public class StudentClassDto {
+
+    /**
+     * 班级Id。
+     */
+    @ApiModelProperty(value = "班级Id", required = true)
+    @NotNull(message = "数据验证失败，班级Id不能为空！", groups = {UpdateGroup.class})
+    private Long classId;
+
+    /**
+     * 班级名称。
+     */
+    @ApiModelProperty(value = "班级名称", required = true)
+    @NotBlank(message = "数据验证失败，班级名称不能为空！")
+    private String className;
+
+    /**
+     * 学校Id。
+     */
+    @ApiModelProperty(value = "学校Id", required = true)
+    @NotNull(message = "数据验证失败，所属校区不能为空！")
+    private Long schoolId;
+
+    /**
+     * 学生班长Id。
+     */
+    @ApiModelProperty(value = "学生班长Id", required = true)
+    @NotNull(message = "数据验证失败，学生班长不能为空！")
+    private Long leaderId;
+
+    /**
+     * 已完成课时数量。
+     */
+    @ApiModelProperty(value = "已完成课时数量", required = true)
+    @NotNull(message = "数据验证失败，已完成课时不能为空！", groups = {UpdateGroup.class})
+    private Integer finishClassHour;
+
+    /**
+     * 班级级别(0: 初级班 1: 培优班 2: 冲刺提分班 3: 竞赛班)。
+     */
+    @ApiModelProperty(value = "班级级别(0: 初级班 1: 培优班 2: 冲刺提分班 3: 竞赛班)", required = true)
+    @NotNull(message = "数据验证失败，班级级别不能为空！")
+    @ConstDictRef(constDictClass = ClassLevel.class, message = "数据验证失败，班级级别为无效值！")
+    private Integer classLevel;
+}

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/dto/StudentDto.java

@@ -0,0 +1,157 @@
+package com.orange.demo.app.dto;
+
+import com.orange.demo.common.core.validator.UpdateGroup;
+import com.orange.demo.common.core.validator.ConstDictRef;
+import com.orange.demo.application.common.constant.Gender;
+import com.orange.demo.application.common.constant.ExpLevel;
+import com.orange.demo.application.common.constant.StudentStatus;
+
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import javax.validation.constraints.*;
+
+import java.util.Date;
+
+/**
+ * StudentDto对象。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@ApiModel("StudentDto对象")
+@Data
+public class StudentDto {
+
+    /**
+     * 学生Id。
+     */
+    @ApiModelProperty(value = "学生Id", required = true)
+    @NotNull(message = "数据验证失败，学生Id不能为空！", groups = {UpdateGroup.class})
+    private Long studentId;
+
+    /**
+     * 登录手机。
+     */
+    @ApiModelProperty(value = "登录手机", required = true)
+    @NotBlank(message = "数据验证失败，手机号码不能为空！")
+    private String loginMobile;
+
+    /**
+     * 学生姓名。
+     */
+    @ApiModelProperty(value = "学生姓名", required = true)
+    @NotBlank(message = "数据验证失败，学生姓名不能为空！")
+    private String studentName;
+
+    /**
+     * 所在省份Id。
+     */
+    @ApiModelProperty(value = "所在省份Id", required = true)
+    @NotNull(message = "数据验证失败，所在省份不能为空！")
+    private Long provinceId;
+
+    /**
+     * 所在城市Id。
+     */
+    @ApiModelProperty(value = "所在城市Id", required = true)
+    @NotNull(message = "数据验证失败，所在城市不能为空！")
+    private Long cityId;
+
+    /**
+     * 区县Id。
+     */
+    @ApiModelProperty(value = "区县Id", required = true)
+    @NotNull(message = "数据验证失败，所在区县不能为空！")
+    private Long districtId;
+
+    /**
+     * 学生性别 (0: 女生 1: 男生)。
+     */
+    @ApiModelProperty(value = "学生性别 (0: 女生 1: 男生)", required = true)
+    @NotNull(message = "数据验证失败，学生性别不能为空！")
+    @ConstDictRef(constDictClass = Gender.class, message = "数据验证失败，学生性别为无效值！")
+    private Integer gender;
+
+    /**
+     * 生日。
+     */
+    @ApiModelProperty(value = "生日", required = true)
+    @NotNull(message = "数据验证失败，出生日期不能为空！")
+    private Date birthday;
+
+    /**
+     * 经验等级 (0: 初级 1: 中级 2: 高级 3: 资深)。
+     */
+    @ApiModelProperty(value = "经验等级 (0: 初级 1: 中级 2: 高级 3: 资深)", required = true)
+    @NotNull(message = "数据验证失败，经验等级不能为空！")
+    @ConstDictRef(constDictClass = ExpLevel.class, message = "数据验证失败，经验等级为无效值！")
+    private Integer experienceLevel;
+
+    /**
+     * 总共充值学币数量。
+     */
+    @ApiModelProperty(value = "总共充值学币数量", required = true)
+    @NotNull(message = "数据验证失败，充值学币不能为空！", groups = {UpdateGroup.class})
+    private Integer totalCoin;
+
+    /**
+     * 可用学币数量。
+     */
+    @ApiModelProperty(value = "可用学币数量", required = true)
+    @NotNull(message = "数据验证失败，剩余学币不能为空！", groups = {UpdateGroup.class})
+    private Integer leftCoin;
+
+    /**
+     * 年级Id。
+     */
+    @ApiModelProperty(value = "年级Id", required = true)
+    @NotNull(message = "数据验证失败，年级不能为空！")
+    private Integer gradeId;
+
+    /**
+     * 校区Id。
+     */
+    @ApiModelProperty(value = "校区Id", required = true)
+    @NotNull(message = "数据验证失败，所属校区不能为空！")
+    private Long schoolId;
+
+    /**
+     * 学生状态 (0: 正常 1: 锁定 2: 注销)。
+     */
+    @ApiModelProperty(value = "学生状态 (0: 正常 1: 锁定 2: 注销)", required = true)
+    @NotNull(message = "数据验证失败，学生状态不能为空！", groups = {UpdateGroup.class})
+    @ConstDictRef(constDictClass = StudentStatus.class, message = "数据验证失败，学生状态为无效值！")
+    private Integer status;
+
+    /**
+     * birthday 范围过滤起始值(>=)。
+     */
+    @ApiModelProperty(value = "birthday 范围过滤起始值(>=)")
+    private String birthdayStart;
+
+    /**
+     * birthday 范围过滤结束值(<=)。
+     */
+    @ApiModelProperty(value = "birthday 范围过滤结束值(<=)")
+    private String birthdayEnd;
+
+    /**
+     * registerTime 范围过滤起始值(>=)。
+     */
+    @ApiModelProperty(value = "registerTime 范围过滤起始值(>=)")
+    private String registerTimeStart;
+
+    /**
+     * registerTime 范围过滤结束值(<=)。
+     */
+    @ApiModelProperty(value = "registerTime 范围过滤结束值(<=)")
+    private String registerTimeEnd;
+
+    /**
+     * login_mobile / student_name LIKE搜索字符串。
+     */
+    @ApiModelProperty(value = "LIKE模糊搜索字符串")
+    private String searchString;
+}

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/model/ClassCourse.java

@@ -1,9 +1,7 @@
 package com.orange.demo.app.model;
 
-import com.orange.demo.common.core.validator.UpdateGroup;
 import lombok.Data;
 import javax.persistence.*;
-import javax.validation.constraints.*;
 
 /**
  * ClassCourse实体对象。
@@ -18,7 +16,6 @@ public class ClassCourse {
     /**
      * 班级Id。
      */
-    @NotNull(message = "数据验证失败，班级Id不能为空！", groups = {UpdateGroup.class})
     @Id
     @Column(name = "class_id")
     private Long classId;
@@ -26,7 +23,6 @@ public class ClassCourse {
     /**
      * 课程Id。
      */
-    @NotNull(message = "数据验证失败，课程Id不能为空！", groups = {UpdateGroup.class})
     @Id
     @Column(name = "course_id")
     private Long courseId;
@@ -34,7 +30,6 @@ public class ClassCourse {
     /**
      * 课程顺序(数值越小越靠前)。
      */
-    @NotNull(message = "数据验证失败，课程顺序(数值越小越靠前)不能为空！", groups = {UpdateGroup.class})
     @Column(name = "course_order")
     private Integer courseOrder;
 }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/model/ClassStudent.java

@@ -1,9 +1,7 @@
 package com.orange.demo.app.model;
 
-import com.orange.demo.common.core.validator.UpdateGroup;
 import lombok.Data;
 import javax.persistence.*;
-import javax.validation.constraints.*;
 
 /**
  * ClassStudent实体对象。
@@ -18,7 +16,6 @@ public class ClassStudent {
     /**
      * 班级Id。
      */
-    @NotNull(message = "数据验证失败，班级Id不能为空！", groups = {UpdateGroup.class})
     @Id
     @Column(name = "class_id")
     private Long classId;
@@ -26,7 +23,6 @@ public class ClassStudent {
     /**
      * 学生Id。
      */
-    @NotNull(message = "数据验证失败，学生Id不能为空！", groups = {UpdateGroup.class})
     @Id
     @Column(name = "student_id")
     private Long studentId;

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/model/Course.java

@@ -7,14 +7,11 @@ import com.orange.demo.common.core.annotation.UploadFlagColumn;
 import com.orange.demo.common.core.annotation.RelationDict;
 import com.orange.demo.common.core.annotation.RelationConstDict;
 import com.orange.demo.common.core.base.mapper.BaseModelMapper;
-import com.orange.demo.common.core.validator.UpdateGroup;
-import com.orange.demo.common.core.validator.ConstDictRef;
 import com.orange.demo.app.vo.CourseVo;
 import lombok.Data;
 import org.mapstruct.*;
 import org.mapstruct.factory.Mappers;
 import javax.persistence.*;
-import javax.validation.constraints.*;
 
 import java.math.BigDecimal;
 import java.util.Date;
@@ -33,7 +30,6 @@ public class Course {
     /**
      * 主键Id。
      */
-    @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
     @Id
     @Column(name = "course_id")
     private Long courseId;
@@ -41,14 +37,12 @@ public class Course {
     /**
      * 课程名称。
      */
-    @NotBlank(message = "数据验证失败，课程名称不能为空！")
     @Column(name = "course_name")
     private String courseName;
 
     /**
      * 课程价格。
      */
-    @NotNull(message = "数据验证失败，课程价格不能为空！")
     private BigDecimal price;
 
     /**
@@ -59,29 +53,23 @@ public class Course {
     /**
      * 课程难度(0: 容易 1: 普通 2: 很难)。
      */
-    @NotNull(message = "数据验证失败，课程难度不能为空！")
-    @ConstDictRef(constDictClass = CourseDifficult.class, message = "数据验证失败，课程难度为无效值！")
     private Integer difficulty;
 
     /**
      * 年级Id。
      */
-    @NotNull(message = "数据验证失败，所属年级不能为空！")
     @Column(name = "grade_id")
     private Integer gradeId;
 
     /**
      * 学科Id。
      */
-    @NotNull(message = "数据验证失败，所属学科不能为空！")
-    @ConstDictRef(constDictClass = Subject.class, message = "数据验证失败，所属学科为无效值！")
     @Column(name = "subject_id")
     private Integer subjectId;
 
     /**
      * 课时数量。
      */
-    @NotNull(message = "数据验证失败，课时数量不能为空！")
     @Column(name = "class_hour")
     private Integer classHour;
 
@@ -89,7 +77,6 @@ public class Course {
      * 多张课程图片地址。
      */
     @UploadFlagColumn(storeType = UploadStoreTypeEnum.LOCAL_SYSTEM)
-    @NotBlank(message = "数据验证失败，课程图片不能为空！")
     @Column(name = "picture_url")
     private String pictureUrl;
 

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/model/CourseTransStats.java

@@ -4,14 +4,11 @@ import com.orange.demo.application.common.constant.Subject;
 import com.orange.demo.common.core.annotation.RelationDict;
 import com.orange.demo.common.core.annotation.RelationConstDict;
 import com.orange.demo.common.core.base.mapper.BaseModelMapper;
-import com.orange.demo.common.core.validator.UpdateGroup;
-import com.orange.demo.common.core.validator.ConstDictRef;
 import com.orange.demo.app.vo.CourseTransStatsVo;
 import lombok.Data;
 import org.mapstruct.*;
 import org.mapstruct.factory.Mappers;
 import javax.persistence.*;
-import javax.validation.constraints.*;
 
 import java.util.Date;
 import java.util.Map;
@@ -29,7 +26,6 @@ public class CourseTransStats {
     /**
      * 主键Id。
      */
-    @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
     @Id
     @GeneratedValue(strategy = GenerationType.IDENTITY)
     @Column(name = "stats_id")
@@ -38,22 +34,18 @@ public class CourseTransStats {
     /**
      * 统计日期。
      */
-    @NotNull(message = "数据验证失败，统计日期不能为空！")
     @Column(name = "stats_date")
     private Date statsDate;
 
     /**
      * 科目Id。
      */
-    @NotNull(message = "数据验证失败，所属科目不能为空！")
-    @ConstDictRef(constDictClass = Subject.class, message = "数据验证失败，所属科目为无效值！")
     @Column(name = "subject_id")
     private Integer subjectId;
 
     /**
      * 年级Id。
      */
-    @NotNull(message = "数据验证失败，所属年级不能为空！")
     @Column(name = "grade_id")
     private Integer gradeId;
 
@@ -66,7 +58,6 @@ public class CourseTransStats {
     /**
      * 课程Id。
      */
-    @NotNull(message = "数据验证失败，课程Id不能为空！")
     @Column(name = "course_id")
     private Long courseId;
 
@@ -79,21 +70,18 @@ public class CourseTransStats {
     /**
      * 学生上课次数。
      */
-    @NotNull(message = "数据验证失败，上课次数不能为空！")
     @Column(name = "student_attend_count")
     private Integer studentAttendCount;
 
     /**
      * 学生献花数量。
      */
-    @NotNull(message = "数据验证失败，献花数量不能为空！")
     @Column(name = "student_flower_amount")
     private Integer studentFlowerAmount;
 
     /**
      * 学生献花次数。
      */
-    @NotNull(message = "数据验证失败，献花次数不能为空！")
     @Column(name = "student_flower_count")
     private Integer studentFlowerCount;
 

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/model/Grade.java

@@ -2,10 +2,8 @@ package com.orange.demo.app.model;
 
 import com.alibaba.fastjson.annotation.JSONField;
 import com.orange.demo.common.core.annotation.DeletedFlagColumn;
-import com.orange.demo.common.core.validator.UpdateGroup;
 import lombok.Data;
 import javax.persistence.*;
-import javax.validation.constraints.*;
 
 /**
  * Grade实体对象。
@@ -20,7 +18,6 @@ public class Grade {
     /**
      * 主键Id。
      */
-    @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
     @Id
     @GeneratedValue(strategy = GenerationType.IDENTITY)
     @Column(name = "grade_id")
@@ -29,7 +26,6 @@ public class Grade {
     /**
      * 年级名称。
      */
-    @NotBlank(message = "数据验证失败，年级名称不能为空！")
     @Column(name = "grade_name")
     private String gradeName;
 

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/model/MaterialEdition.java

@@ -1,9 +1,7 @@
 package com.orange.demo.app.model;
 
-import com.orange.demo.common.core.validator.UpdateGroup;
 import lombok.Data;
 import javax.persistence.*;
-import javax.validation.constraints.*;
 
 /**
  * MaterialEdition实体对象。
@@ -18,7 +16,6 @@ public class MaterialEdition {
     /**
      * 主键Id。
      */
-    @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
     @Id
     @GeneratedValue(strategy = GenerationType.IDENTITY)
     @Column(name = "edition_id")
@@ -27,13 +24,11 @@ public class MaterialEdition {
     /**
      * 教材版本名称。
      */
-    @NotBlank(message = "数据验证失败，教材版本名称不能为空！")
     @Column(name = "edition_name")
     private String editionName;
 
     /**
      * 是否正在使用（0：不是，1：是）。
      */
-    @NotNull(message = "数据验证失败，是否正在使用（0：不是，1：是）不能为空！")
     private Integer status;
 }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/model/SchoolInfo.java

@@ -2,13 +2,11 @@ package com.orange.demo.app.model;
 
 import com.orange.demo.common.core.annotation.RelationDict;
 import com.orange.demo.common.core.base.mapper.BaseModelMapper;
-import com.orange.demo.common.core.validator.UpdateGroup;
 import com.orange.demo.app.vo.SchoolInfoVo;
 import lombok.Data;
 import org.mapstruct.*;
 import org.mapstruct.factory.Mappers;
 import javax.persistence.*;
-import javax.validation.constraints.*;
 
 import java.util.Map;
 
@@ -25,7 +23,6 @@ public class SchoolInfo {
     /**
      * 学校Id。
      */
-    @NotNull(message = "数据验证失败，学校Id不能为空！", groups = {UpdateGroup.class})
     @Id
     @Column(name = "school_id")
     private Long schoolId;
@@ -33,21 +30,18 @@ public class SchoolInfo {
     /**
      * 学校名称。
      */
-    @NotBlank(message = "数据验证失败，学校名称不能为空！")
     @Column(name = "school_name")
     private String schoolName;
 
     /**
      * 所在省Id。
      */
-    @NotNull(message = "数据验证失败，所在省份不能为空！")
     @Column(name = "province_id")
     private Long provinceId;
 
     /**
      * 所在城市Id。
      */
-    @NotNull(message = "数据验证失败，所在城市不能为空！")
     @Column(name = "city_id")
     private Long cityId;
 

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/model/Student.java

@@ -3,17 +3,15 @@ package com.orange.demo.app.model;
 import com.orange.demo.application.common.constant.Gender;
 import com.orange.demo.application.common.constant.ExpLevel;
 import com.orange.demo.application.common.constant.StudentStatus;
+import com.orange.demo.common.core.util.MyCommonUtil;
 import com.orange.demo.common.core.annotation.RelationDict;
 import com.orange.demo.common.core.annotation.RelationConstDict;
 import com.orange.demo.common.core.base.mapper.BaseModelMapper;
-import com.orange.demo.common.core.validator.UpdateGroup;
-import com.orange.demo.common.core.validator.ConstDictRef;
 import com.orange.demo.app.vo.StudentVo;
 import lombok.Data;
 import org.mapstruct.*;
 import org.mapstruct.factory.Mappers;
 import javax.persistence.*;
-import javax.validation.constraints.*;
 
 import java.util.Date;
 import java.util.Map;
@@ -31,7 +29,6 @@ public class Student {
     /**
      * 学生Id。
      */
-    @NotNull(message = "数据验证失败，学生Id不能为空！", groups = {UpdateGroup.class})
     @Id
     @Column(name = "student_id")
     private Long studentId;
@@ -39,84 +36,70 @@ public class Student {
     /**
      * 登录手机。
      */
-    @NotBlank(message = "数据验证失败，手机号码不能为空！")
     @Column(name = "login_mobile")
     private String loginMobile;
 
     /**
      * 学生姓名。
      */
-    @NotBlank(message = "数据验证失败，学生姓名不能为空！")
     @Column(name = "student_name")
     private String studentName;
 
     /**
      * 所在省份Id。
      */
-    @NotNull(message = "数据验证失败，所在省份不能为空！")
     @Column(name = "province_id")
     private Long provinceId;
 
     /**
      * 所在城市Id。
      */
-    @NotNull(message = "数据验证失败，所在城市不能为空！")
     @Column(name = "city_id")
     private Long cityId;
 
     /**
      * 区县Id。
      */
-    @NotNull(message = "数据验证失败，所在区县不能为空！")
     @Column(name = "district_id")
     private Long districtId;
 
     /**
      * 学生性别 (0: 女生 1: 男生)。
      */
-    @NotNull(message = "数据验证失败，学生性别不能为空！")
-    @ConstDictRef(constDictClass = Gender.class, message = "数据验证失败，学生性别为无效值！")
     private Integer gender;
 
     /**
      * 生日。
      */
-    @NotNull(message = "数据验证失败，出生日期不能为空！")
     private Date birthday;
 
     /**
      * 经验等级 (0: 初级 1: 中级 2: 高级 3: 资深)。
      */
-    @NotNull(message = "数据验证失败，经验等级不能为空！")
-    @ConstDictRef(constDictClass = ExpLevel.class, message = "数据验证失败，经验等级为无效值！")
     @Column(name = "experience_level")
     private Integer experienceLevel;
 
     /**
      * 总共充值学币数量。
      */
-    @NotNull(message = "数据验证失败，充值学币不能为空！", groups = {UpdateGroup.class})
     @Column(name = "total_coin")
     private Integer totalCoin;
 
     /**
      * 可用学币数量。
      */
-    @NotNull(message = "数据验证失败，剩余学币不能为空！", groups = {UpdateGroup.class})
     @Column(name = "left_coin")
     private Integer leftCoin;
 
     /**
      * 年级Id。
      */
-    @NotNull(message = "数据验证失败，年级不能为空！")
     @Column(name = "grade_id")
     private Integer gradeId;
 
     /**
      * 校区Id。
      */
-    @NotNull(message = "数据验证失败，所属校区不能为空！")
     @Column(name = "school_id")
     private Long schoolId;
 
@@ -129,8 +112,6 @@ public class Student {
     /**
      * 学生状态 (0: 正常 1: 锁定 2: 注销)。
      */
-    @NotNull(message = "数据验证失败，学生状态不能为空！", groups = {UpdateGroup.class})
-    @ConstDictRef(constDictClass = StudentStatus.class, message = "数据验证失败，学生状态为无效值！")
     private Integer status;
 
     /**
@@ -163,6 +144,10 @@ public class Student {
     @Transient
     private String searchString;
 
+    public void setSearchString(String searchString) {
+        this.searchString = MyCommonUtil.replaceSqlWildcard(searchString);
+    }
+
     @RelationDict(
             masterIdField = "provinceId",
             slaveServiceName = "areaCodeService",

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/model/StudentActionStats.java

@@ -2,13 +2,11 @@ package com.orange.demo.app.model;
 
 import com.orange.demo.common.core.annotation.RelationDict;
 import com.orange.demo.common.core.base.mapper.BaseModelMapper;
-import com.orange.demo.common.core.validator.UpdateGroup;
 import com.orange.demo.app.vo.StudentActionStatsVo;
 import lombok.Data;
 import org.mapstruct.*;
 import org.mapstruct.factory.Mappers;
 import javax.persistence.*;
-import javax.validation.constraints.*;
 
 import java.util.Date;
 import java.util.Map;
@@ -26,7 +24,6 @@ public class StudentActionStats {
     /**
      * 主键Id。
      */
-    @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
     @Id
     @Column(name = "stats_id")
     private Long statsId;
@@ -34,7 +31,6 @@ public class StudentActionStats {
     /**
      * 统计日期。
      */
-    @NotNull(message = "数据验证失败，统计日期不能为空！")
     @Column(name = "stats_date")
     private Date statsDate;
 
@@ -47,126 +43,108 @@ public class StudentActionStats {
     /**
      * 年级Id。
      */
-    @NotNull(message = "数据验证失败，所属年级不能为空！")
     @Column(name = "grade_id")
     private Integer gradeId;
 
     /**
      * 学生所在省Id。
      */
-    @NotNull(message = "数据验证失败，所在省份不能为空！")
     @Column(name = "province_id")
     private Long provinceId;
 
     /**
      * 学生所在城市Id。
      */
-    @NotNull(message = "数据验证失败，所在城市不能为空！", groups = {UpdateGroup.class})
     @Column(name = "city_id")
     private Long cityId;
 
     /**
      * 购课学币数量。
      */
-    @NotNull(message = "数据验证失败，购课学币数量不能为空！", groups = {UpdateGroup.class})
     @Column(name = "buy_course_amount")
     private Integer buyCourseAmount;
 
     /**
      * 购买课程次数。
      */
-    @NotNull(message = "数据验证失败，购买课程次数不能为空！", groups = {UpdateGroup.class})
     @Column(name = "buy_course_count")
     private Integer buyCourseCount;
 
     /**
      * 购买视频学币数量。
      */
-    @NotNull(message = "数据验证失败，购买视频学币数量不能为空！", groups = {UpdateGroup.class})
     @Column(name = "buy_video_amount")
     private Integer buyVideoAmount;
 
     /**
      * 购买视频次数。
      */
-    @NotNull(message = "数据验证失败，购买视频次数不能为空！", groups = {UpdateGroup.class})
     @Column(name = "buy_video_count")
     private Integer buyVideoCount;
 
     /**
      * 购买作业学币数量。
      */
-    @NotNull(message = "数据验证失败，购买作业学币数量不能为空！", groups = {UpdateGroup.class})
     @Column(name = "buy_paper_amount")
     private Integer buyPaperAmount;
 
     /**
      * 购买作业次数。
      */
-    @NotNull(message = "数据验证失败，购买作业次数不能为空！", groups = {UpdateGroup.class})
     @Column(name = "buy_paper_count")
     private Integer buyPaperCount;
 
     /**
      * 购买献花数量。
      */
-    @NotNull(message = "数据验证失败，购买献花数量不能为空！", groups = {UpdateGroup.class})
     @Column(name = "buy_flower_amount")
     private Integer buyFlowerAmount;
 
     /**
      * 购买献花次数。
      */
-    @NotNull(message = "数据验证失败，购买献花次数不能为空！", groups = {UpdateGroup.class})
     @Column(name = "buy_flower_count")
     private Integer buyFlowerCount;
 
     /**
      * 充值学币数量。
      */
-    @NotNull(message = "数据验证失败，充值学币数量不能为空！", groups = {UpdateGroup.class})
     @Column(name = "recharge_coin_amount")
     private Integer rechargeCoinAmount;
 
     /**
      * 充值学币次数。
      */
-    @NotNull(message = "数据验证失败，充值学币次数不能为空！", groups = {UpdateGroup.class})
     @Column(name = "recharge_coin_count")
     private Integer rechargeCoinCount;
 
     /**
      * 线下课程上课次数。
      */
-    @NotNull(message = "数据验证失败，线下课程上课次数不能为空！")
     @Column(name = "do_course_count")
     private Integer doCourseCount;
 
     /**
      * 观看视频次数。
      */
-    @NotNull(message = "数据验证失败，观看视频次数不能为空！", groups = {UpdateGroup.class})
     @Column(name = "watch_video_count")
     private Integer watchVideoCount;
 
     /**
      * 购买献花消费学币数量。
      */
-    @NotNull(message = "数据验证失败，购买献花消费学币数量不能为空！")
     @Column(name = "watch_video_total_second")
     private Integer watchVideoTotalSecond;
 
     /**
      * 做题数量。
      */
-    @NotNull(message = "数据验证失败，做题数量不能为空！", groups = {UpdateGroup.class})
     @Column(name = "do_exercise_count")
     private Integer doExerciseCount;
 
     /**
      * 做题正确的数量。
      */
-    @NotNull(message = "数据验证失败，做题正确的数量不能为空！", groups = {UpdateGroup.class})
     @Column(name = "do_exercise_correct_count")
     private Integer doExerciseCorrectCount;
 

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/model/StudentActionTrans.java

@@ -5,14 +5,11 @@ import com.orange.demo.application.common.constant.DeviceType;
 import com.orange.demo.common.core.annotation.RelationDict;
 import com.orange.demo.common.core.annotation.RelationConstDict;
 import com.orange.demo.common.core.base.mapper.BaseModelMapper;
-import com.orange.demo.common.core.validator.UpdateGroup;
-import com.orange.demo.common.core.validator.ConstDictRef;
 import com.orange.demo.app.vo.StudentActionTransVo;
 import lombok.Data;
 import org.mapstruct.*;
 import org.mapstruct.factory.Mappers;
 import javax.persistence.*;
-import javax.validation.constraints.*;
 
 import java.util.Date;
 import java.util.Map;
@@ -30,7 +27,6 @@ public class StudentActionTrans {
     /**
      * 主键Id。
      */
-    @NotNull(message = "数据验证失败，主键Id不能为空！", groups = {UpdateGroup.class})
     @Id
     @Column(name = "trans_id")
     private Long transId;
@@ -38,44 +34,36 @@ public class StudentActionTrans {
     /**
      * 学生Id。
      */
-    @NotNull(message = "数据验证失败，学生Id不能为空！")
     @Column(name = "student_id")
     private Long studentId;
 
     /**
      * 学生名称。
      */
-    @NotBlank(message = "数据验证失败，学生名称不能为空！")
     @Column(name = "student_name")
     private String studentName;
 
     /**
      * 学生校区。
      */
-    @NotNull(message = "数据验证失败，学生校区不能为空！")
     @Column(name = "school_id")
     private Long schoolId;
 
     /**
      * 年级Id。
      */
-    @NotNull(message = "数据验证失败，学生年级不能为空！")
     @Column(name = "grade_id")
     private Integer gradeId;
 
     /**
      * 行为类型(0: 充值  1: 购课 2: 上课签到 3: 上课签退 4: 看视频课 5: 做作业 6: 刷题 7: 献花)。
      */
-    @NotNull(message = "数据验证失败，行为类型不能为空！")
-    @ConstDictRef(constDictClass = StudentActionType.class, message = "数据验证失败，行为类型为无效值！")
     @Column(name = "action_type")
     private Integer actionType;
 
     /**
      * 设备类型(0: iOS 1: Android 2: PC)。
      */
-    @NotNull(message = "数据验证失败，设备类型不能为空！")
-    @ConstDictRef(constDictClass = DeviceType.class, message = "数据验证失败，设备类型为无效值！")
     @Column(name = "device_type")
     private Integer deviceType;
 
@@ -124,7 +112,6 @@ public class StudentActionTrans {
     /**
      * 发生时间。
      */
-    @NotNull(message = "数据验证失败，发生时间不能为空！")
     @Column(name = "create_time")
     private Date createTime;
 

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/model/StudentClass.java

@@ -6,14 +6,11 @@ import com.orange.demo.common.core.annotation.RelationDict;
 import com.orange.demo.common.core.annotation.RelationConstDict;
 import com.orange.demo.common.core.base.mapper.BaseModelMapper;
 import com.orange.demo.common.core.annotation.DeletedFlagColumn;
-import com.orange.demo.common.core.validator.UpdateGroup;
-import com.orange.demo.common.core.validator.ConstDictRef;
 import com.orange.demo.app.vo.StudentClassVo;
 import lombok.Data;
 import org.mapstruct.*;
 import org.mapstruct.factory.Mappers;
 import javax.persistence.*;
-import javax.validation.constraints.*;
 
 import java.util.Date;
 import java.util.Map;
@@ -31,7 +28,6 @@ public class StudentClass {
     /**
      * 班级Id。
      */
-    @NotNull(message = "数据验证失败，班级Id不能为空！", groups = {UpdateGroup.class})
     @Id
     @Column(name = "class_id")
     private Long classId;
@@ -39,36 +35,30 @@ public class StudentClass {
     /**
      * 班级名称。
      */
-    @NotBlank(message = "数据验证失败，班级名称不能为空！")
     @Column(name = "class_name")
     private String className;
 
     /**
      * 学校Id。
      */
-    @NotNull(message = "数据验证失败，所属校区不能为空！")
     @Column(name = "school_id")
     private Long schoolId;
 
     /**
      * 学生班长Id。
      */
-    @NotNull(message = "数据验证失败，学生班长不能为空！")
     @Column(name = "leader_id")
     private Long leaderId;
 
     /**
      * 已完成课时数量。
      */
-    @NotNull(message = "数据验证失败，已完成课时不能为空！", groups = {UpdateGroup.class})
     @Column(name = "finish_class_hour")
     private Integer finishClassHour;
 
     /**
      * 班级级别(0: 初级班 1: 培优班 2: 冲刺提分班 3: 竞赛班)。
      */
-    @NotNull(message = "数据验证失败，班级级别不能为空！")
-    @ConstDictRef(constDictClass = ClassLevel.class, message = "数据验证失败，班级级别为无效值！")
     @Column(name = "class_level")
     private Integer classLevel;
 

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/service/AreaCodeService.java

@@ -1,49 +1,17 @@
 package com.orange.demo.app.service;
 
-import com.orange.demo.app.dao.AreaCodeMapper;
+import com.orange.demo.common.core.base.service.IBaseDictService;
 import com.orange.demo.app.model.AreaCode;
-import com.orange.demo.common.core.cache.MapTreeDictionaryCache;
-import com.orange.demo.common.core.base.service.BaseDictService;
-import com.orange.demo.common.core.base.dao.BaseDaoMapper;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.stereotype.Service;
-import tk.mybatis.mapper.entity.Example;
 
 import java.util.Collection;
-import java.util.List;
 
 /**
- * 行政区划的Service类。
+ * 行政区划的Service接口。
  *
  * @author Jerry
  * @date 2020-09-24
  */
-@Service
-public class AreaCodeService extends BaseDictService<AreaCode, Long> {
-
-    @Autowired
-    private AreaCodeMapper areaCodeMapper;
-
-    public AreaCodeService() {
-        super();
-        this.dictionaryCache = MapTreeDictionaryCache.create(AreaCode::getAreaId, AreaCode::getParentId);
-    }
-
-    @Override
-    protected BaseDaoMapper<AreaCode> mapper() {
-        return areaCodeMapper;
-    }
-
-    /**
-     * 加载数据库数据到内存缓存。
-     */
-    @Override
-    public void loadCachedData() {
-        Example e = new Example(AreaCode.class);
-        e.orderBy("areaLevel");
-        List<AreaCode> areaCodeList = areaCodeMapper.selectByExample(e);
-        dictionaryCache.putAll(areaCodeList);
-    }
+public interface AreaCodeService extends IBaseDictService<AreaCode, Long> {
 
     /**
      * 根据上级行政区划Id，获取其下级行政区划列表。
@@ -51,7 +19,5 @@ public class AreaCodeService extends BaseDictService<AreaCode, Long> {
      * @param parentId 上级行政区划Id。
      * @return 下级行政区划列表。
      */
-    public Collection<AreaCode> getListByParentId(Long parentId) {
-        return ((MapTreeDictionaryCache<Long, AreaCode>) dictionaryCache).getListByParentId(parentId);
-    }
+    Collection<AreaCode> getListByParentId(Long parentId);
 }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/service/CourseService.java

@@ -1,47 +1,18 @@
 package com.orange.demo.app.service;
 
-import com.orange.demo.app.dao.*;
 import com.orange.demo.app.model.*;
-import com.orange.demo.common.core.base.dao.BaseDaoMapper;
-import com.orange.demo.common.core.object.TokenData;
-import com.orange.demo.common.core.object.MyWhereCriteria;
-import com.orange.demo.common.core.object.MyRelationParam;
 import com.orange.demo.common.core.object.CallResult;
-import com.orange.demo.common.core.base.service.BaseService;
-import com.orange.demo.common.sequence.wrapper.IdGeneratorWrapper;
-import org.springframework.transaction.annotation.Transactional;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.stereotype.Service;
+import com.orange.demo.common.core.base.service.IBaseService;
 
 import java.util.*;
 
 /**
- * 课程数据数据操作服务类。
+ * 课程数据数据操作服务接口。
  *
  * @author Jerry
  * @date 2020-09-24
  */
-@Service
-public class CourseService extends BaseService<Course, Long> {
-
-    @Autowired
-    private CourseMapper courseMapper;
-    @Autowired
-    private ClassCourseMapper classCourseMapper;
-    @Autowired
-    private GradeService gradeService;
-    @Autowired
-    private IdGeneratorWrapper idGenerator;
-
-    /**
-     * 返回当前Service的主表Mapper对象。
-     *
-     * @return 主表Mapper对象。
-     */
-    @Override
-    protected BaseDaoMapper<Course> mapper() {
-        return courseMapper;
-    }
+public interface CourseService extends IBaseService<Course, Long> {
 
     /**
      * 保存新增对象。
@@ -49,17 +20,7 @@ public class CourseService extends BaseService<Course, Long> {
      * @param course 新增对象。
      * @return 返回新增对象。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public Course saveNew(Course course) {
-        course.setCourseId(idGenerator.nextLongId());
-        TokenData tokenData = TokenData.takeFromRequest();
-        course.setCreateUserId(tokenData.getUserId());
-        Date now = new Date();
-        course.setCreateTime(now);
-        course.setUpdateTime(now);
-        courseMapper.insert(course);
-        return course;
-    }
+    Course saveNew(Course course);
 
     /**
      * 更新数据对象。
@@ -68,14 +29,7 @@ public class CourseService extends BaseService<Course, Long> {
      * @param originalCourse 原有数据对象。
      * @return 成功返回true，否则false。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public boolean update(Course course, Course originalCourse) {
-        course.setCreateUserId(originalCourse.getCreateUserId());
-        course.setCreateTime(originalCourse.getCreateTime());
-        course.setUpdateTime(new Date());
-        // 这里重点提示，在执行主表数据更新之前，如果有哪些字段不支持修改操作，请用原有数据对象字段替换当前数据字段。
-        return courseMapper.updateByPrimaryKey(course) == 1;
-    }
+    boolean update(Course course, Course originalCourse);
 
     /**
      * 删除指定数据。
@@ -83,19 +37,7 @@ public class CourseService extends BaseService<Course, Long> {
      * @param courseId 主键Id。
      * @return 成功返回true，否则false。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public boolean remove(Long courseId) {
-        // 这里先删除主数据
-        if (courseMapper.deleteByPrimaryKey(courseId) == 0) {
-            return false;
-        }
-        // 这里可继续删除关联数据。
-        // 开始删除多对多父表的关联
-        ClassCourse classCourse = new ClassCourse();
-        classCourse.setCourseId(courseId);
-        classCourseMapper.delete(classCourse);
-        return true;
-    }
+    boolean remove(Long courseId);
 
     /**
      * 获取单表查询结果。由于没有关联数据查询，因此在仅仅获取单表数据的场景下，效率更高。
@@ -105,24 +47,18 @@ public class CourseService extends BaseService<Course, Long> {
      * @param orderBy 排序参数。
      * @return 查询结果集。
      */
-    public List<Course> getCourseList(Course filter, String orderBy) {
-        return courseMapper.getCourseList(filter, orderBy);
-    }
+    List<Course> getCourseList(Course filter, String orderBy);
 
     /**
      * 获取主表的查询结果，以及主表关联的字典数据和一对一从表数据，以及一对一从表的字典数据。
+     * 该查询会涉及到一对一从表的关联过滤，或一对多从表的嵌套关联过滤，因此性能不如单表过滤。
      * 如果仅仅需要获取主表数据，请移步(getCourseList)，以便获取更好的查询性能。
      *
      * @param filter 主表过滤对象。
      * @param orderBy 排序参数。
      * @return 查询结果集。
      */
-    public List<Course> getCourseListWithRelation(Course filter, String orderBy) {
-        List<Course> resultList = courseMapper.getCourseList(filter, orderBy);
-        Map<String, List<MyWhereCriteria>> criteriaMap = buildAggregationAdditionalWhereCriteria();
-        this.buildRelationForDataList(resultList, MyRelationParam.normal(), criteriaMap);
-        return resultList;
-    }
+    List<Course> getCourseListWithRelation(Course filter, String orderBy);
 
     /**
      * 在多对多关系中，当前Service的数据表为从表，返回不与指定主表主键Id存在对多对关系的列表。
@@ -132,13 +68,8 @@ public class CourseService extends BaseService<Course, Long> {
      * @param orderBy 排序参数。
      * @return 查询结果集。
      */
-    public List<Course> getNotInCourseListByClassId(
-            Long classId, Course filter, String orderBy) {
-        List<Course> resultList =
-                courseMapper.getNotInCourseListByClassId(classId, filter, orderBy);
-        this.buildRelationForDataList(resultList, MyRelationParam.dictOnly(), null);
-        return resultList;
-    }
+    List<Course> getNotInCourseListByClassId(
+            Long classId, Course filter, String orderBy);
 
     /**
      * 在多对多关系中，当前Service的数据表为从表，返回与指定主表主键Id存在对多对关系的列表。
@@ -148,13 +79,8 @@ public class CourseService extends BaseService<Course, Long> {
      * @param orderBy 排序参数。
      * @return 查询结果集。
      */
-    public List<Course> getCourseListByClassId(
-            Long classId, Course filter, String orderBy) {
-        List<Course> resultList =
-                courseMapper.getCourseListByClassId(classId, filter, orderBy);
-        this.buildRelationForDataList(resultList, MyRelationParam.dictOnly(), null);
-        return resultList;
-    }
+    List<Course> getCourseListByClassId(
+            Long classId, Course filter, String orderBy);
 
     /**
      * 根据最新对象和原有对象的数据对比，判断关联的字典数据和多对一主表数据是否都是合法数据。
@@ -163,13 +89,5 @@ public class CourseService extends BaseService<Course, Long> {
      * @param originalCourse 原有数据对象。
      * @return 数据全部正确返回true，否则false。
      */
-    public CallResult verifyRelatedData(Course course, Course originalCourse) {
-        String errorMessageFormat = "数据验证失败，关联的%s并不存在，请刷新后重试！";
-        //这里是基于字典的验证。
-        if (this.needToVerify(course, originalCourse, Course::getGradeId)
-                && !gradeService.existId(course.getGradeId())) {
-            return CallResult.error(String.format(errorMessageFormat, "所属年级"));
-        }
-        return CallResult.ok();
-    }
+    CallResult verifyRelatedData(Course course, Course originalCourse);
 }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/service/CourseTransStatsService.java

@@ -1,39 +1,17 @@
 package com.orange.demo.app.service;
 
-import com.orange.demo.app.dao.*;
 import com.orange.demo.app.model.*;
-import com.orange.demo.common.core.base.dao.BaseDaoMapper;
-import com.orange.demo.common.core.object.MyWhereCriteria;
-import com.orange.demo.common.core.object.MyRelationParam;
-import com.orange.demo.common.core.base.service.BaseService;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.stereotype.Service;
+import com.orange.demo.common.core.base.service.IBaseService;
 
 import java.util.*;
 
 /**
- * 课程统计数据操作服务类。
+ * 课程统计数据操作服务接口。
  *
  * @author Jerry
  * @date 2020-09-24
  */
-@Service
-public class CourseTransStatsService extends BaseService<CourseTransStats, Long> {
-
-    @Autowired
-    private CourseTransStatsMapper courseTransStatsMapper;
-    @Autowired
-    private GradeService gradeService;
-
-    /**
-     * 返回当前Service的主表Mapper对象。
-     *
-     * @return 主表Mapper对象。
-     */
-    @Override
-    protected BaseDaoMapper<CourseTransStats> mapper() {
-        return courseTransStatsMapper;
-    }
+public interface CourseTransStatsService extends IBaseService<CourseTransStats, Long> {
 
     /**
      * 获取单表查询结果。由于没有关联数据查询，因此在仅仅获取单表数据的场景下，效率更高。
@@ -43,24 +21,18 @@ public class CourseTransStatsService extends BaseService<CourseTransStats, Long>
      * @param orderBy 排序参数。
      * @return 查询结果集。
      */
-    public List<CourseTransStats> getCourseTransStatsList(CourseTransStats filter, String orderBy) {
-        return courseTransStatsMapper.getCourseTransStatsList(filter, orderBy);
-    }
+    List<CourseTransStats> getCourseTransStatsList(CourseTransStats filter, String orderBy);
 
     /**
      * 获取主表的查询结果，以及主表关联的字典数据和一对一从表数据，以及一对一从表的字典数据。
+     * 该查询会涉及到一对一从表的关联过滤，或一对多从表的嵌套关联过滤，因此性能不如单表过滤。
      * 如果仅仅需要获取主表数据，请移步(getCourseTransStatsList)，以便获取更好的查询性能。
      *
      * @param filter 主表过滤对象。
      * @param orderBy 排序参数。
      * @return 查询结果集。
      */
-    public List<CourseTransStats> getCourseTransStatsListWithRelation(CourseTransStats filter, String orderBy) {
-        List<CourseTransStats> resultList = courseTransStatsMapper.getCourseTransStatsList(filter, orderBy);
-        Map<String, List<MyWhereCriteria>> criteriaMap = buildAggregationAdditionalWhereCriteria();
-        this.buildRelationForDataList(resultList, MyRelationParam.normal(), criteriaMap);
-        return resultList;
-    }
+    List<CourseTransStats> getCourseTransStatsListWithRelation(CourseTransStats filter, String orderBy);
 
     /**
      * 获取分组过滤后的数据查询结果，以及关联的字典数据和一对一从表数据，以及一对一从表的字典数据。
@@ -71,13 +43,6 @@ public class CourseTransStatsService extends BaseService<CourseTransStats, Long>
      * @param orderBy     排序字符串，ORDER BY从句的参数。
      * @return 分组过滤结果集。
      */
-    public List<CourseTransStats> getGroupedCourseTransStatsListWithRelation(
-            CourseTransStats filter, String groupSelect, String groupBy, String orderBy) {
-        List<CourseTransStats> resultList =
-                courseTransStatsMapper.getGroupedCourseTransStatsList(filter, groupSelect, groupBy, orderBy);
-        // NOTE: 这里只是包含了关联数据，聚合计算数据没有包含。
-        // 主要原因是，由于聚合字段通常被视为普通字段使用，不会在group by的从句中出现，语义上也不会在此关联。
-        this.buildRelationForDataList(resultList, MyRelationParam.normal(), null);
-        return resultList;
-    }
+    List<CourseTransStats> getGroupedCourseTransStatsListWithRelation(
+            CourseTransStats filter, String groupSelect, String groupBy, String orderBy);
 }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/service/GradeService.java

@@ -1,88 +1,13 @@
 package com.orange.demo.app.service;
 
-import com.orange.demo.common.core.base.service.BaseDictService;
-import com.orange.demo.common.core.base.dao.BaseDaoMapper;
-import com.orange.demo.common.core.cache.MapDictionaryCache;
-import com.orange.demo.common.core.constant.GlobalDeletedFlag;
-import com.orange.demo.app.dao.GradeMapper;
+import com.orange.demo.common.core.base.service.IBaseDictService;
 import com.orange.demo.app.model.Grade;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.stereotype.Service;
-import org.springframework.transaction.annotation.Transactional;
 
 /**
- * 年级数据操作服务类。
+ * 年级字典数据操作服务接口。
  *
  * @author Jerry
  * @date 2020-09-24
  */
-@Service
-public class GradeService extends BaseDictService<Grade, Integer> {
-
-    @Autowired
-    private GradeMapper gradeMapper;
-
-    public GradeService() {
-        super();
-        this.dictionaryCache = MapDictionaryCache.create(Grade::getGradeId);
-    }
-
-    /**
-     * 返回当前Service的主表Mapper对象。
-     *
-     * @return 主表Mapper对象。
-     */
-    @Override
-    protected BaseDaoMapper<Grade> mapper() {
-        return gradeMapper;
-    }
-
-    /**
-     * 保存新增对象。
-     *
-     * @param grade 新增对象。
-     * @return 返回新增对象。
-     */
-    @Transactional(rollbackFor = Exception.class)
-    public Grade saveNew(Grade grade) {
-        grade.setStatus(GlobalDeletedFlag.NORMAL);
-        gradeMapper.insert(grade);
-        dictionaryCache.put(grade.getGradeId(), grade);
-        return grade;
-    }
-
-    /**
-     * 更新数据对象。
-     *
-     * @param grade         更新的对象。
-     * @param originalGrade 原有数据对象。
-     * @return 成功返回true，否则false。
-     */
-    @Transactional(rollbackFor = Exception.class)
-    public boolean update(Grade grade, Grade originalGrade) {
-        grade.setStatus(GlobalDeletedFlag.NORMAL);
-        if (gradeMapper.updateByPrimaryKey(grade) != 1) {
-            return false;
-        }
-        dictionaryCache.put(grade.getGradeId(), grade);
-        return true;
-    }
-
-    /**
-     * 删除指定数据。
-     *
-     * @param gradeId 主键Id。
-     * @return 成功返回true，否则false。
-     */
-    @Transactional(rollbackFor = Exception.class)
-    public boolean remove(Integer gradeId) {
-        Grade deletedObject = new Grade();
-        deletedObject.setGradeId(gradeId);
-        deletedObject.setStatus(GlobalDeletedFlag.DELETED);
-        if (gradeMapper.updateByPrimaryKeySelective(deletedObject) != 1) {
-            return false;
-        }
-        dictionaryCache.invalidate(gradeId);
-        return true;
-    }
+public interface GradeService extends IBaseDictService<Grade, Integer> {
 }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/service/SchoolInfoService.java

@@ -1,44 +1,18 @@
 package com.orange.demo.app.service;
 
-import com.orange.demo.app.dao.*;
 import com.orange.demo.app.model.*;
-import com.orange.demo.common.core.base.dao.BaseDaoMapper;
-import com.orange.demo.common.core.object.MyWhereCriteria;
-import com.orange.demo.common.core.object.MyRelationParam;
 import com.orange.demo.common.core.object.CallResult;
-import com.orange.demo.common.core.base.service.BaseService;
-import com.orange.demo.common.sequence.wrapper.IdGeneratorWrapper;
-import org.springframework.transaction.annotation.Transactional;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.stereotype.Service;
+import com.orange.demo.common.core.base.service.IBaseService;
 
 import java.util.*;
 
 /**
- * 校区数据数据操作服务类。
+ * 校区数据数据操作服务接口。
  *
  * @author Jerry
  * @date 2020-09-24
  */
-@Service
-public class SchoolInfoService extends BaseService<SchoolInfo, Long> {
-
-    @Autowired
-    private SchoolInfoMapper schoolInfoMapper;
-    @Autowired
-    private AreaCodeService areaCodeService;
-    @Autowired
-    private IdGeneratorWrapper idGenerator;
-
-    /**
-     * 返回当前Service的主表Mapper对象。
-     *
-     * @return 主表Mapper对象。
-     */
-    @Override
-    protected BaseDaoMapper<SchoolInfo> mapper() {
-        return schoolInfoMapper;
-    }
+public interface SchoolInfoService extends IBaseService<SchoolInfo, Long> {
 
     /**
      * 保存新增对象。
@@ -46,12 +20,7 @@ public class SchoolInfoService extends BaseService<SchoolInfo, Long> {
      * @param schoolInfo 新增对象。
      * @return 返回新增对象。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public SchoolInfo saveNew(SchoolInfo schoolInfo) {
-        schoolInfo.setSchoolId(idGenerator.nextLongId());
-        schoolInfoMapper.insert(schoolInfo);
-        return schoolInfo;
-    }
+    SchoolInfo saveNew(SchoolInfo schoolInfo);
 
     /**
      * 更新数据对象。
@@ -60,11 +29,7 @@ public class SchoolInfoService extends BaseService<SchoolInfo, Long> {
      * @param originalSchoolInfo 原有数据对象。
      * @return 成功返回true，否则false。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public boolean update(SchoolInfo schoolInfo, SchoolInfo originalSchoolInfo) {
-        // 这里重点提示，在执行主表数据更新之前，如果有哪些字段不支持修改操作，请用原有数据对象字段替换当前数据字段。
-        return schoolInfoMapper.updateByPrimaryKey(schoolInfo) == 1;
-    }
+    boolean update(SchoolInfo schoolInfo, SchoolInfo originalSchoolInfo);
 
     /**
      * 删除指定数据。
@@ -72,10 +37,7 @@ public class SchoolInfoService extends BaseService<SchoolInfo, Long> {
      * @param schoolId 主键Id。
      * @return 成功返回true，否则false。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public boolean remove(Long schoolId) {
-        return schoolInfoMapper.deleteByPrimaryKey(schoolId) != 0;
-    }
+    boolean remove(Long schoolId);
 
     /**
      * 获取单表查询结果。由于没有关联数据查询，因此在仅仅获取单表数据的场景下，效率更高。
@@ -85,24 +47,18 @@ public class SchoolInfoService extends BaseService<SchoolInfo, Long> {
      * @param orderBy 排序参数。
      * @return 查询结果集。
      */
-    public List<SchoolInfo> getSchoolInfoList(SchoolInfo filter, String orderBy) {
-        return schoolInfoMapper.getSchoolInfoList(filter, orderBy);
-    }
+    List<SchoolInfo> getSchoolInfoList(SchoolInfo filter, String orderBy);
 
     /**
      * 获取主表的查询结果，以及主表关联的字典数据和一对一从表数据，以及一对一从表的字典数据。
+     * 该查询会涉及到一对一从表的关联过滤，或一对多从表的嵌套关联过滤，因此性能不如单表过滤。
      * 如果仅仅需要获取主表数据，请移步(getSchoolInfoList)，以便获取更好的查询性能。
      *
      * @param filter 主表过滤对象。
      * @param orderBy 排序参数。
      * @return 查询结果集。
      */
-    public List<SchoolInfo> getSchoolInfoListWithRelation(SchoolInfo filter, String orderBy) {
-        List<SchoolInfo> resultList = schoolInfoMapper.getSchoolInfoList(filter, orderBy);
-        Map<String, List<MyWhereCriteria>> criteriaMap = buildAggregationAdditionalWhereCriteria();
-        this.buildRelationForDataList(resultList, MyRelationParam.normal(), criteriaMap);
-        return resultList;
-    }
+    List<SchoolInfo> getSchoolInfoListWithRelation(SchoolInfo filter, String orderBy);
 
     /**
      * 根据最新对象和原有对象的数据对比，判断关联的字典数据和多对一主表数据是否都是合法数据。
@@ -111,18 +67,5 @@ public class SchoolInfoService extends BaseService<SchoolInfo, Long> {
      * @param originalSchoolInfo 原有数据对象。
      * @return 数据全部正确返回true，否则false。
      */
-    public CallResult verifyRelatedData(SchoolInfo schoolInfo, SchoolInfo originalSchoolInfo) {
-        String errorMessageFormat = "数据验证失败，关联的%s并不存在，请刷新后重试！";
-        //这里是基于字典的验证。
-        if (this.needToVerify(schoolInfo, originalSchoolInfo, SchoolInfo::getProvinceId)
-                && !areaCodeService.existId(schoolInfo.getProvinceId())) {
-            return CallResult.error(String.format(errorMessageFormat, "所在省份"));
-        }
-        //这里是基于字典的验证。
-        if (this.needToVerify(schoolInfo, originalSchoolInfo, SchoolInfo::getCityId)
-                && !areaCodeService.existId(schoolInfo.getCityId())) {
-            return CallResult.error(String.format(errorMessageFormat, "所在城市"));
-        }
-        return CallResult.ok();
-    }
+    CallResult verifyRelatedData(SchoolInfo schoolInfo, SchoolInfo originalSchoolInfo);
 }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/service/StudentActionStatsService.java

@@ -1,41 +1,17 @@
 package com.orange.demo.app.service;
 
-import com.orange.demo.app.dao.*;
 import com.orange.demo.app.model.*;
-import com.orange.demo.common.core.base.dao.BaseDaoMapper;
-import com.orange.demo.common.core.object.MyWhereCriteria;
-import com.orange.demo.common.core.object.MyRelationParam;
-import com.orange.demo.common.core.base.service.BaseService;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.stereotype.Service;
+import com.orange.demo.common.core.base.service.IBaseService;
 
 import java.util.*;
 
 /**
- * 学生行为统计数据操作服务类。
+ * 学生行为统计数据操作服务接口。
  *
  * @author Jerry
  * @date 2020-09-24
  */
-@Service
-public class StudentActionStatsService extends BaseService<StudentActionStats, Long> {
-
-    @Autowired
-    private StudentActionStatsMapper studentActionStatsMapper;
-    @Autowired
-    private GradeService gradeService;
-    @Autowired
-    private AreaCodeService areaCodeService;
-
-    /**
-     * 返回当前Service的主表Mapper对象。
-     *
-     * @return 主表Mapper对象。
-     */
-    @Override
-    protected BaseDaoMapper<StudentActionStats> mapper() {
-        return studentActionStatsMapper;
-    }
+public interface StudentActionStatsService extends IBaseService<StudentActionStats, Long> {
 
     /**
      * 获取单表查询结果。由于没有关联数据查询，因此在仅仅获取单表数据的场景下，效率更高。
@@ -45,24 +21,18 @@ public class StudentActionStatsService extends BaseService<StudentActionStats, L
      * @param orderBy 排序参数。
      * @return 查询结果集。
      */
-    public List<StudentActionStats> getStudentActionStatsList(StudentActionStats filter, String orderBy) {
-        return studentActionStatsMapper.getStudentActionStatsList(filter, orderBy);
-    }
+    List<StudentActionStats> getStudentActionStatsList(StudentActionStats filter, String orderBy);
 
     /**
      * 获取主表的查询结果，以及主表关联的字典数据和一对一从表数据，以及一对一从表的字典数据。
+     * 该查询会涉及到一对一从表的关联过滤，或一对多从表的嵌套关联过滤，因此性能不如单表过滤。
      * 如果仅仅需要获取主表数据，请移步(getStudentActionStatsList)，以便获取更好的查询性能。
      *
      * @param filter 主表过滤对象。
      * @param orderBy 排序参数。
      * @return 查询结果集。
      */
-    public List<StudentActionStats> getStudentActionStatsListWithRelation(StudentActionStats filter, String orderBy) {
-        List<StudentActionStats> resultList = studentActionStatsMapper.getStudentActionStatsList(filter, orderBy);
-        Map<String, List<MyWhereCriteria>> criteriaMap = buildAggregationAdditionalWhereCriteria();
-        this.buildRelationForDataList(resultList, MyRelationParam.normal(), criteriaMap);
-        return resultList;
-    }
+    List<StudentActionStats> getStudentActionStatsListWithRelation(StudentActionStats filter, String orderBy);
 
     /**
      * 获取分组过滤后的数据查询结果，以及关联的字典数据和一对一从表数据，以及一对一从表的字典数据。
@@ -73,13 +43,6 @@ public class StudentActionStatsService extends BaseService<StudentActionStats, L
      * @param orderBy     排序字符串，ORDER BY从句的参数。
      * @return 分组过滤结果集。
      */
-    public List<StudentActionStats> getGroupedStudentActionStatsListWithRelation(
-            StudentActionStats filter, String groupSelect, String groupBy, String orderBy) {
-        List<StudentActionStats> resultList =
-                studentActionStatsMapper.getGroupedStudentActionStatsList(filter, groupSelect, groupBy, orderBy);
-        // NOTE: 这里只是包含了关联数据，聚合计算数据没有包含。
-        // 主要原因是，由于聚合字段通常被视为普通字段使用，不会在group by的从句中出现，语义上也不会在此关联。
-        this.buildRelationForDataList(resultList, MyRelationParam.normal(), null);
-        return resultList;
-    }
+    List<StudentActionStats> getGroupedStudentActionStatsListWithRelation(
+            StudentActionStats filter, String groupSelect, String groupBy, String orderBy);
 }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/service/StudentActionTransService.java

@@ -1,46 +1,18 @@
 package com.orange.demo.app.service;
 
-import com.orange.demo.app.dao.*;
 import com.orange.demo.app.model.*;
-import com.orange.demo.common.core.base.dao.BaseDaoMapper;
-import com.orange.demo.common.core.object.MyWhereCriteria;
-import com.orange.demo.common.core.object.MyRelationParam;
 import com.orange.demo.common.core.object.CallResult;
-import com.orange.demo.common.core.base.service.BaseService;
-import com.orange.demo.common.sequence.wrapper.IdGeneratorWrapper;
-import org.springframework.transaction.annotation.Transactional;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.stereotype.Service;
+import com.orange.demo.common.core.base.service.IBaseService;
 
 import java.util.*;
 
 /**
- * 学生行为流水数据操作服务类。
+ * 学生行为流水数据操作服务接口。
  *
  * @author Jerry
  * @date 2020-09-24
  */
-@Service
-public class StudentActionTransService extends BaseService<StudentActionTrans, Long> {
-
-    @Autowired
-    private StudentActionTransMapper studentActionTransMapper;
-    @Autowired
-    private SchoolInfoService schoolInfoService;
-    @Autowired
-    private GradeService gradeService;
-    @Autowired
-    private IdGeneratorWrapper idGenerator;
-
-    /**
-     * 返回当前Service的主表Mapper对象。
-     *
-     * @return 主表Mapper对象。
-     */
-    @Override
-    protected BaseDaoMapper<StudentActionTrans> mapper() {
-        return studentActionTransMapper;
-    }
+public interface StudentActionTransService extends IBaseService<StudentActionTrans, Long> {
 
     /**
      * 保存新增对象。
@@ -48,12 +20,7 @@ public class StudentActionTransService extends BaseService<StudentActionTrans, L
      * @param studentActionTrans 新增对象。
      * @return 返回新增对象。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public StudentActionTrans saveNew(StudentActionTrans studentActionTrans) {
-        studentActionTrans.setTransId(idGenerator.nextLongId());
-        studentActionTransMapper.insert(studentActionTrans);
-        return studentActionTrans;
-    }
+    StudentActionTrans saveNew(StudentActionTrans studentActionTrans);
 
     /**
      * 更新数据对象。
@@ -62,11 +29,7 @@ public class StudentActionTransService extends BaseService<StudentActionTrans, L
      * @param originalStudentActionTrans 原有数据对象。
      * @return 成功返回true，否则false。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public boolean update(StudentActionTrans studentActionTrans, StudentActionTrans originalStudentActionTrans) {
-        // 这里重点提示，在执行主表数据更新之前，如果有哪些字段不支持修改操作，请用原有数据对象字段替换当前数据字段。
-        return studentActionTransMapper.updateByPrimaryKey(studentActionTrans) == 1;
-    }
+    boolean update(StudentActionTrans studentActionTrans, StudentActionTrans originalStudentActionTrans);
 
     /**
      * 删除指定数据。
@@ -74,10 +37,7 @@ public class StudentActionTransService extends BaseService<StudentActionTrans, L
      * @param transId 主键Id。
      * @return 成功返回true，否则false。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public boolean remove(Long transId) {
-        return studentActionTransMapper.deleteByPrimaryKey(transId) != 0;
-    }
+    boolean remove(Long transId);
 
     /**
      * 获取单表查询结果。由于没有关联数据查询，因此在仅仅获取单表数据的场景下，效率更高。
@@ -87,24 +47,18 @@ public class StudentActionTransService extends BaseService<StudentActionTrans, L
      * @param orderBy 排序参数。
      * @return 查询结果集。
      */
-    public List<StudentActionTrans> getStudentActionTransList(StudentActionTrans filter, String orderBy) {
-        return studentActionTransMapper.getStudentActionTransList(filter, orderBy);
-    }
+    List<StudentActionTrans> getStudentActionTransList(StudentActionTrans filter, String orderBy);
 
     /**
      * 获取主表的查询结果，以及主表关联的字典数据和一对一从表数据，以及一对一从表的字典数据。
+     * 该查询会涉及到一对一从表的关联过滤，或一对多从表的嵌套关联过滤，因此性能不如单表过滤。
      * 如果仅仅需要获取主表数据，请移步(getStudentActionTransList)，以便获取更好的查询性能。
      *
      * @param filter 主表过滤对象。
      * @param orderBy 排序参数。
      * @return 查询结果集。
      */
-    public List<StudentActionTrans> getStudentActionTransListWithRelation(StudentActionTrans filter, String orderBy) {
-        List<StudentActionTrans> resultList = studentActionTransMapper.getStudentActionTransList(filter, orderBy);
-        Map<String, List<MyWhereCriteria>> criteriaMap = buildAggregationAdditionalWhereCriteria();
-        this.buildRelationForDataList(resultList, MyRelationParam.normal(), criteriaMap);
-        return resultList;
-    }
+    List<StudentActionTrans> getStudentActionTransListWithRelation(StudentActionTrans filter, String orderBy);
 
     /**
      * 根据最新对象和原有对象的数据对比，判断关联的字典数据和多对一主表数据是否都是合法数据。
@@ -113,18 +67,5 @@ public class StudentActionTransService extends BaseService<StudentActionTrans, L
      * @param originalStudentActionTrans 原有数据对象。
      * @return 数据全部正确返回true，否则false。
      */
-    public CallResult verifyRelatedData(StudentActionTrans studentActionTrans, StudentActionTrans originalStudentActionTrans) {
-        String errorMessageFormat = "数据验证失败，关联的%s并不存在，请刷新后重试！";
-        //这里是基于字典的验证。
-        if (this.needToVerify(studentActionTrans, originalStudentActionTrans, StudentActionTrans::getSchoolId)
-                && !schoolInfoService.existId(studentActionTrans.getSchoolId())) {
-            return CallResult.error(String.format(errorMessageFormat, "学生校区"));
-        }
-        //这里是基于字典的验证。
-        if (this.needToVerify(studentActionTrans, originalStudentActionTrans, StudentActionTrans::getGradeId)
-                && !gradeService.existId(studentActionTrans.getGradeId())) {
-            return CallResult.error(String.format(errorMessageFormat, "学生年级"));
-        }
-        return CallResult.ok();
-    }
+    CallResult verifyRelatedData(StudentActionTrans studentActionTrans, StudentActionTrans originalStudentActionTrans);
 }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/service/StudentClassService.java

@@ -1,53 +1,18 @@
 package com.orange.demo.app.service;
 
-import com.orange.demo.app.dao.*;
 import com.orange.demo.app.model.*;
-import com.orange.demo.common.core.base.dao.BaseDaoMapper;
-import com.orange.demo.common.core.constant.GlobalDeletedFlag;
-import com.orange.demo.common.core.object.TokenData;
-import com.orange.demo.common.core.object.MyWhereCriteria;
-import com.orange.demo.common.core.object.MyRelationParam;
 import com.orange.demo.common.core.object.CallResult;
-import com.orange.demo.common.core.base.service.BaseService;
-import com.orange.demo.common.sequence.wrapper.IdGeneratorWrapper;
-import org.springframework.transaction.annotation.Transactional;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.stereotype.Service;
-import tk.mybatis.mapper.entity.Example;
+import com.orange.demo.common.core.base.service.IBaseService;
 
 import java.util.*;
 
 /**
- * 班级数据数据操作服务类。
+ * 班级数据数据操作服务接口。
  *
  * @author Jerry
  * @date 2020-09-24
  */
-@Service
-public class StudentClassService extends BaseService<StudentClass, Long> {
-
-    @Autowired
-    private StudentClassMapper studentClassMapper;
-    @Autowired
-    private ClassCourseMapper classCourseMapper;
-    @Autowired
-    private ClassStudentMapper classStudentMapper;
-    @Autowired
-    private SchoolInfoService schoolInfoService;
-    @Autowired
-    private StudentService studentService;
-    @Autowired
-    private IdGeneratorWrapper idGenerator;
-
-    /**
-     * 返回当前Service的主表Mapper对象。
-     *
-     * @return 主表Mapper对象。
-     */
-    @Override
-    protected BaseDaoMapper<StudentClass> mapper() {
-        return studentClassMapper;
-    }
+public interface StudentClassService extends IBaseService<StudentClass, Long> {
 
     /**
      * 保存新增对象。
@@ -55,19 +20,7 @@ public class StudentClassService extends BaseService<StudentClass, Long> {
      * @param studentClass 新增对象。
      * @return 返回新增对象。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public StudentClass saveNew(StudentClass studentClass) {
-        studentClass.setClassId(idGenerator.nextLongId());
-        TokenData tokenData = TokenData.takeFromRequest();
-        studentClass.setCreateUserId(tokenData.getUserId());
-        studentClass.setCreateTime(new Date());
-        studentClass.setStatus(GlobalDeletedFlag.NORMAL);
-        if (studentClass.getFinishClassHour() == null) {
-            studentClass.setFinishClassHour(0);
-        }
-        studentClassMapper.insert(studentClass);
-        return studentClass;
-    }
+    StudentClass saveNew(StudentClass studentClass);
 
     /**
      * 更新数据对象。
@@ -76,14 +29,7 @@ public class StudentClassService extends BaseService<StudentClass, Long> {
      * @param originalStudentClass 原有数据对象。
      * @return 成功返回true，否则false。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public boolean update(StudentClass studentClass, StudentClass originalStudentClass) {
-        studentClass.setCreateUserId(originalStudentClass.getCreateUserId());
-        studentClass.setCreateTime(originalStudentClass.getCreateTime());
-        studentClass.setStatus(GlobalDeletedFlag.NORMAL);
-        // 这里重点提示，在执行主表数据更新之前，如果有哪些字段不支持修改操作，请用原有数据对象字段替换当前数据字段。
-        return studentClassMapper.updateByPrimaryKey(studentClass) == 1;
-    }
+    boolean update(StudentClass studentClass, StudentClass originalStudentClass);
 
     /**
      * 删除指定数据。
@@ -91,27 +37,7 @@ public class StudentClassService extends BaseService<StudentClass, Long> {
      * @param classId 主键Id。
      * @return 成功返回true，否则false。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public boolean remove(Long classId) {
-        Example studentClassExample = new Example(StudentClass.class);
-        Example.Criteria c = studentClassExample.createCriteria();
-        c.andEqualTo(super.idFieldName, classId);
-        c.andEqualTo(super.deletedFlagFieldName, GlobalDeletedFlag.NORMAL);
-        // 这里先删除主数据
-        StudentClass deletedObject = new StudentClass();
-        deletedObject.setStatus(GlobalDeletedFlag.DELETED);
-        if (studentClassMapper.updateByExampleSelective(deletedObject, studentClassExample) == 0) {
-            return false;
-        }
-        // 开始删除多对多子表的关联
-        ClassCourse classCourse = new ClassCourse();
-        classCourse.setClassId(classId);
-        classCourseMapper.delete(classCourse);
-        ClassStudent classStudent = new ClassStudent();
-        classStudent.setClassId(classId);
-        classStudentMapper.delete(classStudent);
-        return true;
-    }
+    boolean remove(Long classId);
 
     /**
      * 获取单表查询结果。由于没有关联数据查询，因此在仅仅获取单表数据的场景下，效率更高。
@@ -121,24 +47,18 @@ public class StudentClassService extends BaseService<StudentClass, Long> {
      * @param orderBy 排序参数。
      * @return 查询结果集。
      */
-    public List<StudentClass> getStudentClassList(StudentClass filter, String orderBy) {
-        return studentClassMapper.getStudentClassList(filter, orderBy);
-    }
+    List<StudentClass> getStudentClassList(StudentClass filter, String orderBy);
 
     /**
      * 获取主表的查询结果，以及主表关联的字典数据和一对一从表数据，以及一对一从表的字典数据。
+     * 该查询会涉及到一对一从表的关联过滤，或一对多从表的嵌套关联过滤，因此性能不如单表过滤。
      * 如果仅仅需要获取主表数据，请移步(getStudentClassList)，以便获取更好的查询性能。
      *
      * @param filter 主表过滤对象。
      * @param orderBy 排序参数。
      * @return 查询结果集。
      */
-    public List<StudentClass> getStudentClassListWithRelation(StudentClass filter, String orderBy) {
-        List<StudentClass> resultList = studentClassMapper.getStudentClassList(filter, orderBy);
-        Map<String, List<MyWhereCriteria>> criteriaMap = buildAggregationAdditionalWhereCriteria();
-        this.buildRelationForDataList(resultList, MyRelationParam.normal(), criteriaMap);
-        return resultList;
-    }
+    List<StudentClass> getStudentClassListWithRelation(StudentClass filter, String orderBy);
 
     /**
      * 批量添加多对多关联关系。
@@ -146,16 +66,7 @@ public class StudentClassService extends BaseService<StudentClass, Long> {
      * @param classCourseList 多对多关联表对象集合。
      * @param classId 主表Id。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public void addClassCourseList(List<ClassCourse> classCourseList, Long classId) {
-        for (ClassCourse classCourse : classCourseList) {
-            classCourse.setClassId(classId);
-            if (classCourse.getCourseOrder() == null) {
-                classCourse.setCourseOrder(0);
-            }
-        }
-        classCourseMapper.insertList(classCourseList);
-    }
+    void addClassCourseList(List<ClassCourse> classCourseList, Long classId);
 
     /**
      * 更新中间表数据。
@@ -163,14 +74,7 @@ public class StudentClassService extends BaseService<StudentClass, Long> {
      * @param classCourse 中间表对象。
      * @return 更新成功与否。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public boolean updateClassCourse(ClassCourse classCourse) {
-        Example e = new Example(ClassCourse.class);
-        e.createCriteria()
-                .andEqualTo("classId", classCourse.getClassId())
-                .andEqualTo("courseId", classCourse.getCourseId());
-        return classCourseMapper.updateByExample(classCourse, e) > 0;
-    }
+    boolean updateClassCourse(ClassCourse classCourse);
 
     /**
      * 获取中间表数据。
@@ -179,13 +83,7 @@ public class StudentClassService extends BaseService<StudentClass, Long> {
      * @param courseId 从表Id。
      * @return 中间表对象。
      */
-    public ClassCourse getClassCourse(Long classId, Long courseId) {
-        Example e = new Example(ClassCourse.class);
-        e.createCriteria()
-                .andEqualTo("classId", classId)
-                .andEqualTo("courseId", courseId);
-        return classCourseMapper.selectOneByExample(e);
-    }
+    ClassCourse getClassCourse(Long classId, Long courseId);
 
     /**
      * 移除单条多对多关系。
@@ -194,13 +92,7 @@ public class StudentClassService extends BaseService<StudentClass, Long> {
      * @param courseId 从表Id。
      * @return 成功返回true，否则false。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public boolean removeClassCourse(Long classId, Long courseId) {
-        ClassCourse classCourse = new ClassCourse();
-        classCourse.setClassId(classId);
-        classCourse.setCourseId(courseId);
-        return classCourseMapper.delete(classCourse) > 0;
-    }
+    boolean removeClassCourse(Long classId, Long courseId);
 
     /**
      * 批量添加多对多关联关系。
@@ -208,13 +100,7 @@ public class StudentClassService extends BaseService<StudentClass, Long> {
      * @param classStudentList 多对多关联表对象集合。
      * @param classId 主表Id。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public void addClassStudentList(List<ClassStudent> classStudentList, Long classId) {
-        for (ClassStudent classStudent : classStudentList) {
-            classStudent.setClassId(classId);
-        }
-        classStudentMapper.insertList(classStudentList);
-    }
+    void addClassStudentList(List<ClassStudent> classStudentList, Long classId);
 
     /**
      * 移除单条多对多关系。
@@ -223,13 +109,7 @@ public class StudentClassService extends BaseService<StudentClass, Long> {
      * @param studentId 从表Id。
      * @return 成功返回true，否则false。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public boolean removeClassStudent(Long classId, Long studentId) {
-        ClassStudent classStudent = new ClassStudent();
-        classStudent.setClassId(classId);
-        classStudent.setStudentId(studentId);
-        return classStudentMapper.delete(classStudent) > 0;
-    }
+    boolean removeClassStudent(Long classId, Long studentId);
 
     /**
      * 根据最新对象和原有对象的数据对比，判断关联的字典数据和多对一主表数据是否都是合法数据。
@@ -238,18 +118,5 @@ public class StudentClassService extends BaseService<StudentClass, Long> {
      * @param originalStudentClass 原有数据对象。
      * @return 数据全部正确返回true，否则false。
      */
-    public CallResult verifyRelatedData(StudentClass studentClass, StudentClass originalStudentClass) {
-        String errorMessageFormat = "数据验证失败，关联的%s并不存在，请刷新后重试！";
-        //这里是基于字典的验证。
-        if (this.needToVerify(studentClass, originalStudentClass, StudentClass::getSchoolId)
-                && !schoolInfoService.existId(studentClass.getSchoolId())) {
-            return CallResult.error(String.format(errorMessageFormat, "所属校区"));
-        }
-        //这里是基于字典的验证。
-        if (this.needToVerify(studentClass, originalStudentClass, StudentClass::getLeaderId)
-                && !studentService.existId(studentClass.getLeaderId())) {
-            return CallResult.error(String.format(errorMessageFormat, "学生班长"));
-        }
-        return CallResult.ok();
-    }
+    CallResult verifyRelatedData(StudentClass studentClass, StudentClass originalStudentClass);
 }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/service/StudentService.java

@@ -1,51 +1,18 @@
 package com.orange.demo.app.service;
 
-import com.orange.demo.application.common.constant.StudentStatus;
-import com.orange.demo.app.dao.*;
 import com.orange.demo.app.model.*;
-import com.orange.demo.common.core.base.dao.BaseDaoMapper;
-import com.orange.demo.common.core.object.MyWhereCriteria;
-import com.orange.demo.common.core.object.MyRelationParam;
 import com.orange.demo.common.core.object.CallResult;
-import com.orange.demo.common.core.base.service.BaseService;
-import com.orange.demo.common.sequence.wrapper.IdGeneratorWrapper;
-import org.springframework.transaction.annotation.Transactional;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.stereotype.Service;
+import com.orange.demo.common.core.base.service.IBaseService;
 
 import java.util.*;
 
 /**
- * 学生数据数据操作服务类。
+ * 学生数据数据操作服务接口。
  *
  * @author Jerry
  * @date 2020-09-24
  */
-@Service
-public class StudentService extends BaseService<Student, Long> {
-
-    @Autowired
-    private StudentMapper studentMapper;
-    @Autowired
-    private ClassStudentMapper classStudentMapper;
-    @Autowired
-    private AreaCodeService areaCodeService;
-    @Autowired
-    private GradeService gradeService;
-    @Autowired
-    private SchoolInfoService schoolInfoService;
-    @Autowired
-    private IdGeneratorWrapper idGenerator;
-
-    /**
-     * 返回当前Service的主表Mapper对象。
-     *
-     * @return 主表Mapper对象。
-     */
-    @Override
-    protected BaseDaoMapper<Student> mapper() {
-        return studentMapper;
-    }
+public interface StudentService extends IBaseService<Student, Long> {
 
     /**
      * 保存新增对象。
@@ -53,22 +20,7 @@ public class StudentService extends BaseService<Student, Long> {
      * @param student 新增对象。
      * @return 返回新增对象。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public Student saveNew(Student student) {
-        student.setStudentId(idGenerator.nextLongId());
-        student.setRegisterTime(new Date());
-        if (student.getTotalCoin() == null) {
-            student.setTotalCoin(0);
-        }
-        if (student.getLeftCoin() == null) {
-            student.setLeftCoin(0);
-        }
-        if (student.getStatus() == null) {
-            student.setStatus(StudentStatus.NORMAL);
-        }
-        studentMapper.insert(student);
-        return student;
-    }
+    Student saveNew(Student student);
 
     /**
      * 更新数据对象。
@@ -77,12 +29,7 @@ public class StudentService extends BaseService<Student, Long> {
      * @param originalStudent 原有数据对象。
      * @return 成功返回true，否则false。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public boolean update(Student student, Student originalStudent) {
-        student.setRegisterTime(originalStudent.getRegisterTime());
-        // 这里重点提示，在执行主表数据更新之前，如果有哪些字段不支持修改操作，请用原有数据对象字段替换当前数据字段。
-        return studentMapper.updateByPrimaryKey(student) == 1;
-    }
+    boolean update(Student student, Student originalStudent);
 
     /**
      * 删除指定数据。
@@ -90,19 +37,7 @@ public class StudentService extends BaseService<Student, Long> {
      * @param studentId 主键Id。
      * @return 成功返回true，否则false。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public boolean remove(Long studentId) {
-        // 这里先删除主数据
-        if (studentMapper.deleteByPrimaryKey(studentId) == 0) {
-            return false;
-        }
-        // 这里可继续删除关联数据。
-        // 开始删除多对多父表的关联
-        ClassStudent classStudent = new ClassStudent();
-        classStudent.setStudentId(studentId);
-        classStudentMapper.delete(classStudent);
-        return true;
-    }
+    boolean remove(Long studentId);
 
     /**
      * 获取单表查询结果。由于没有关联数据查询，因此在仅仅获取单表数据的场景下，效率更高。
@@ -112,24 +47,18 @@ public class StudentService extends BaseService<Student, Long> {
      * @param orderBy 排序参数。
      * @return 查询结果集。
      */
-    public List<Student> getStudentList(Student filter, String orderBy) {
-        return studentMapper.getStudentList(filter, orderBy);
-    }
+    List<Student> getStudentList(Student filter, String orderBy);
 
     /**
      * 获取主表的查询结果，以及主表关联的字典数据和一对一从表数据，以及一对一从表的字典数据。
+     * 该查询会涉及到一对一从表的关联过滤，或一对多从表的嵌套关联过滤，因此性能不如单表过滤。
      * 如果仅仅需要获取主表数据，请移步(getStudentList)，以便获取更好的查询性能。
      *
      * @param filter 主表过滤对象。
      * @param orderBy 排序参数。
      * @return 查询结果集。
      */
-    public List<Student> getStudentListWithRelation(Student filter, String orderBy) {
-        List<Student> resultList = studentMapper.getStudentList(filter, orderBy);
-        Map<String, List<MyWhereCriteria>> criteriaMap = buildAggregationAdditionalWhereCriteria();
-        this.buildRelationForDataList(resultList, MyRelationParam.normal(), criteriaMap);
-        return resultList;
-    }
+    List<Student> getStudentListWithRelation(Student filter, String orderBy);
 
     /**
      * 在多对多关系中，当前Service的数据表为从表，返回不与指定主表主键Id存在对多对关系的列表。
@@ -139,13 +68,8 @@ public class StudentService extends BaseService<Student, Long> {
      * @param orderBy 排序参数。
      * @return 查询结果集。
      */
-    public List<Student> getNotInStudentListByClassId(
-            Long classId, Student filter, String orderBy) {
-        List<Student> resultList =
-                studentMapper.getNotInStudentListByClassId(classId, filter, orderBy);
-        this.buildRelationForDataList(resultList, MyRelationParam.dictOnly(), null);
-        return resultList;
-    }
+    List<Student> getNotInStudentListByClassId(
+            Long classId, Student filter, String orderBy);
 
     /**
      * 在多对多关系中，当前Service的数据表为从表，返回与指定主表主键Id存在对多对关系的列表。
@@ -155,13 +79,8 @@ public class StudentService extends BaseService<Student, Long> {
      * @param orderBy 排序参数。
      * @return 查询结果集。
      */
-    public List<Student> getStudentListByClassId(
-            Long classId, Student filter, String orderBy) {
-        List<Student> resultList =
-                studentMapper.getStudentListByClassId(classId, filter, orderBy);
-        this.buildRelationForDataList(resultList, MyRelationParam.dictOnly(), null);
-        return resultList;
-    }
+    List<Student> getStudentListByClassId(
+            Long classId, Student filter, String orderBy);
 
     /**
      * 根据最新对象和原有对象的数据对比，判断关联的字典数据和多对一主表数据是否都是合法数据。
@@ -170,33 +89,5 @@ public class StudentService extends BaseService<Student, Long> {
      * @param originalStudent 原有数据对象。
      * @return 数据全部正确返回true，否则false。
      */
-    public CallResult verifyRelatedData(Student student, Student originalStudent) {
-        String errorMessageFormat = "数据验证失败，关联的%s并不存在，请刷新后重试！";
-        //这里是基于字典的验证。
-        if (this.needToVerify(student, originalStudent, Student::getProvinceId)
-                && !areaCodeService.existId(student.getProvinceId())) {
-            return CallResult.error(String.format(errorMessageFormat, "所在省份"));
-        }
-        //这里是基于字典的验证。
-        if (this.needToVerify(student, originalStudent, Student::getCityId)
-                && !areaCodeService.existId(student.getCityId())) {
-            return CallResult.error(String.format(errorMessageFormat, "所在城市"));
-        }
-        //这里是基于字典的验证。
-        if (this.needToVerify(student, originalStudent, Student::getDistrictId)
-                && !areaCodeService.existId(student.getDistrictId())) {
-            return CallResult.error(String.format(errorMessageFormat, "所在区县"));
-        }
-        //这里是基于字典的验证。
-        if (this.needToVerify(student, originalStudent, Student::getGradeId)
-                && !gradeService.existId(student.getGradeId())) {
-            return CallResult.error(String.format(errorMessageFormat, "年级"));
-        }
-        //这里是基于字典的验证。
-        if (this.needToVerify(student, originalStudent, Student::getSchoolId)
-                && !schoolInfoService.existId(student.getSchoolId())) {
-            return CallResult.error(String.format(errorMessageFormat, "所属校区"));
-        }
-        return CallResult.ok();
-    }
+    CallResult verifyRelatedData(Student student, Student originalStudent);
 }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/service/impl/AreaCodeServiceImpl.java

@@ -0,0 +1,59 @@
+package com.orange.demo.app.service.impl;
+
+import com.orange.demo.app.service.AreaCodeService;
+import com.orange.demo.app.dao.AreaCodeMapper;
+import com.orange.demo.app.model.AreaCode;
+import com.orange.demo.common.core.cache.MapTreeDictionaryCache;
+import com.orange.demo.common.core.base.service.BaseDictService;
+import com.orange.demo.common.core.base.dao.BaseDaoMapper;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Service;
+import tk.mybatis.mapper.entity.Example;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * 行政区划的Service类。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@Service("areaCodeService")
+public class AreaCodeServiceImpl extends BaseDictService<AreaCode, Long> implements AreaCodeService {
+
+    @Autowired
+    private AreaCodeMapper areaCodeMapper;
+
+    public AreaCodeServiceImpl() {
+        super();
+        this.dictionaryCache = MapTreeDictionaryCache.create(AreaCode::getAreaId, AreaCode::getParentId);
+    }
+
+    @Override
+    protected BaseDaoMapper<AreaCode> mapper() {
+        return areaCodeMapper;
+    }
+
+    /**
+     * 加载数据库数据到内存缓存。
+     */
+    @Override
+    public void loadCachedData() {
+        Example e = new Example(AreaCode.class);
+        e.orderBy("areaLevel");
+        List<AreaCode> areaCodeList = areaCodeMapper.selectByExample(e);
+        dictionaryCache.putAll(areaCodeList);
+    }
+
+    /**
+     * 根据上级行政区划Id，获取其下级行政区划列表。
+     *
+     * @param parentId 上级行政区划Id。
+     * @return 下级行政区划列表。
+     */
+    @Override
+    public Collection<AreaCode> getListByParentId(Long parentId) {
+        return ((MapTreeDictionaryCache<Long, AreaCode>) dictionaryCache).getListByParentId(parentId);
+    }
+}

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/service/impl/CourseServiceImpl.java

@@ -0,0 +1,182 @@
+package com.orange.demo.app.service.impl;
+
+import com.orange.demo.app.service.*;
+import com.orange.demo.app.dao.*;
+import com.orange.demo.app.model.*;
+import com.orange.demo.common.core.base.dao.BaseDaoMapper;
+import com.orange.demo.common.core.object.TokenData;
+import com.orange.demo.common.core.object.MyRelationParam;
+import com.orange.demo.common.core.object.CallResult;
+import com.orange.demo.common.core.base.service.BaseService;
+import com.orange.demo.common.sequence.wrapper.IdGeneratorWrapper;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Service;
+
+import java.util.*;
+
+/**
+ * 课程数据数据操作服务类。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@Service("courseService")
+public class CourseServiceImpl extends BaseService<Course, Long> implements CourseService {
+
+    @Autowired
+    private CourseMapper courseMapper;
+    @Autowired
+    private ClassCourseMapper classCourseMapper;
+    @Autowired
+    private GradeService gradeService;
+    @Autowired
+    private IdGeneratorWrapper idGenerator;
+
+    /**
+     * 返回当前Service的主表Mapper对象。
+     *
+     * @return 主表Mapper对象。
+     */
+    @Override
+    protected BaseDaoMapper<Course> mapper() {
+        return courseMapper;
+    }
+
+    /**
+     * 保存新增对象。
+     *
+     * @param course 新增对象。
+     * @return 返回新增对象。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public Course saveNew(Course course) {
+        course.setCourseId(idGenerator.nextLongId());
+        TokenData tokenData = TokenData.takeFromRequest();
+        course.setCreateUserId(tokenData.getUserId());
+        Date now = new Date();
+        course.setCreateTime(now);
+        course.setUpdateTime(now);
+        courseMapper.insert(course);
+        return course;
+    }
+
+    /**
+     * 更新数据对象。
+     *
+     * @param course         更新的对象。
+     * @param originalCourse 原有数据对象。
+     * @return 成功返回true，否则false。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public boolean update(Course course, Course originalCourse) {
+        course.setCreateUserId(originalCourse.getCreateUserId());
+        course.setCreateTime(originalCourse.getCreateTime());
+        course.setUpdateTime(new Date());
+        // 这里重点提示，在执行主表数据更新之前，如果有哪些字段不支持修改操作，请用原有数据对象字段替换当前数据字段。
+        return courseMapper.updateByPrimaryKey(course) == 1;
+    }
+
+    /**
+     * 删除指定数据。
+     *
+     * @param courseId 主键Id。
+     * @return 成功返回true，否则false。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public boolean remove(Long courseId) {
+        // 这里先删除主数据
+        if (!this.removeById(courseId)) {
+            return false;
+        }
+        // 开始删除多对多父表的关联
+        ClassCourse classCourse = new ClassCourse();
+        classCourse.setCourseId(courseId);
+        classCourseMapper.delete(classCourse);
+        return true;
+    }
+
+    /**
+     * 获取单表查询结果。由于没有关联数据查询，因此在仅仅获取单表数据的场景下，效率更高。
+     * 如果需要同时获取关联数据，请移步(getCourseListWithRelation)方法。
+     *
+     * @param filter  过滤对象。
+     * @param orderBy 排序参数。
+     * @return 查询结果集。
+     */
+    @Override
+    public List<Course> getCourseList(Course filter, String orderBy) {
+        return courseMapper.getCourseList(filter, orderBy);
+    }
+
+    /**
+     * 获取主表的查询结果，以及主表关联的字典数据和一对一从表数据，以及一对一从表的字典数据。
+     * 该查询会涉及到一对一从表的关联过滤，或一对多从表的嵌套关联过滤，因此性能不如单表过滤。
+     * 如果仅仅需要获取主表数据，请移步(getCourseList)，以便获取更好的查询性能。
+     *
+     * @param filter 主表过滤对象。
+     * @param orderBy 排序参数。
+     * @return 查询结果集。
+     */
+    @Override
+    public List<Course> getCourseListWithRelation(Course filter, String orderBy) {
+        List<Course> resultList = courseMapper.getCourseList(filter, orderBy);
+        this.buildRelationForDataList(resultList, MyRelationParam.normal());
+        return resultList;
+    }
+
+    /**
+     * 在多对多关系中，当前Service的数据表为从表，返回不与指定主表主键Id存在对多对关系的列表。
+     *
+     * @param classId 主表主键Id。
+     * @param filter 从表的过滤对象。
+     * @param orderBy 排序参数。
+     * @return 查询结果集。
+     */
+    @Override
+    public List<Course> getNotInCourseListByClassId(
+            Long classId, Course filter, String orderBy) {
+        List<Course> resultList =
+                courseMapper.getNotInCourseListByClassId(classId, filter, orderBy);
+        this.buildRelationForDataList(resultList, MyRelationParam.dictOnly());
+        return resultList;
+    }
+
+    /**
+     * 在多对多关系中，当前Service的数据表为从表，返回与指定主表主键Id存在对多对关系的列表。
+     *
+     * @param classId 主表主键Id。
+     * @param filter 从表的过滤对象。
+     * @param orderBy 排序参数。
+     * @return 查询结果集。
+     */
+    @Override
+    public List<Course> getCourseListByClassId(
+            Long classId, Course filter, String orderBy) {
+        List<Course> resultList =
+                courseMapper.getCourseListByClassId(classId, filter, orderBy);
+        this.buildRelationForDataList(resultList, MyRelationParam.dictOnly());
+        return resultList;
+    }
+
+    /**
+     * 根据最新对象和原有对象的数据对比，判断关联的字典数据和多对一主表数据是否都是合法数据。
+     *
+     * @param course 最新数据对象。
+     * @param originalCourse 原有数据对象。
+     * @return 数据全部正确返回true，否则false。
+     */
+    @Override
+    public CallResult verifyRelatedData(Course course, Course originalCourse) {
+        String errorMessageFormat = "数据验证失败，关联的%s并不存在，请刷新后重试！";
+        //这里是基于字典的验证。
+        if (this.needToVerify(course, originalCourse, Course::getGradeId)
+                && !gradeService.existId(course.getGradeId())) {
+            return CallResult.error(String.format(errorMessageFormat, "所属年级"));
+        }
+        return CallResult.ok();
+    }
+}

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/service/impl/CourseTransStatsServiceImpl.java

@@ -0,0 +1,86 @@
+package com.orange.demo.app.service.impl;
+
+import com.orange.demo.app.service.*;
+import com.orange.demo.app.dao.*;
+import com.orange.demo.app.model.*;
+import com.orange.demo.common.core.base.dao.BaseDaoMapper;
+import com.orange.demo.common.core.object.MyRelationParam;
+import com.orange.demo.common.core.base.service.BaseService;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Service;
+
+import java.util.*;
+
+/**
+ * 课程统计数据操作服务类。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@Service("courseTransStatsService")
+public class CourseTransStatsServiceImpl extends BaseService<CourseTransStats, Long> implements CourseTransStatsService {
+
+    @Autowired
+    private CourseTransStatsMapper courseTransStatsMapper;
+    @Autowired
+    private GradeService gradeService;
+
+    /**
+     * 返回当前Service的主表Mapper对象。
+     *
+     * @return 主表Mapper对象。
+     */
+    @Override
+    protected BaseDaoMapper<CourseTransStats> mapper() {
+        return courseTransStatsMapper;
+    }
+
+    /**
+     * 获取单表查询结果。由于没有关联数据查询，因此在仅仅获取单表数据的场景下，效率更高。
+     * 如果需要同时获取关联数据，请移步(getCourseTransStatsListWithRelation)方法。
+     *
+     * @param filter  过滤对象。
+     * @param orderBy 排序参数。
+     * @return 查询结果集。
+     */
+    @Override
+    public List<CourseTransStats> getCourseTransStatsList(CourseTransStats filter, String orderBy) {
+        return courseTransStatsMapper.getCourseTransStatsList(filter, orderBy);
+    }
+
+    /**
+     * 获取主表的查询结果，以及主表关联的字典数据和一对一从表数据，以及一对一从表的字典数据。
+     * 该查询会涉及到一对一从表的关联过滤，或一对多从表的嵌套关联过滤，因此性能不如单表过滤。
+     * 如果仅仅需要获取主表数据，请移步(getCourseTransStatsList)，以便获取更好的查询性能。
+     *
+     * @param filter 主表过滤对象。
+     * @param orderBy 排序参数。
+     * @return 查询结果集。
+     */
+    @Override
+    public List<CourseTransStats> getCourseTransStatsListWithRelation(CourseTransStats filter, String orderBy) {
+        List<CourseTransStats> resultList = courseTransStatsMapper.getCourseTransStatsList(filter, orderBy);
+        this.buildRelationForDataList(resultList, MyRelationParam.normal());
+        return resultList;
+    }
+
+    /**
+     * 获取分组过滤后的数据查询结果，以及关联的字典数据和一对一从表数据，以及一对一从表的字典数据。
+     *
+     * @param filter      过滤对象。
+     * @param groupSelect 分组显示列表参数。位于SQL语句SELECT的后面。
+     * @param groupBy     分组参数。位于SQL语句的GROUP BY后面。
+     * @param orderBy     排序字符串，ORDER BY从句的参数。
+     * @return 分组过滤结果集。
+     */
+    @Override
+    public List<CourseTransStats> getGroupedCourseTransStatsListWithRelation(
+            CourseTransStats filter, String groupSelect, String groupBy, String orderBy) {
+        List<CourseTransStats> resultList =
+                courseTransStatsMapper.getGroupedCourseTransStatsList(filter, groupSelect, groupBy, orderBy);
+        // NOTE: 这里只是包含了关联数据，聚合计算数据没有包含。
+        // 主要原因是，由于聚合字段通常被视为普通字段使用，不会在group by的从句中出现，语义上也不会在此关联。
+        this.buildRelationForDataList(resultList, MyRelationParam.normal());
+        return resultList;
+    }
+}

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/service/impl/GradeServiceImpl.java

@@ -0,0 +1,38 @@
+package com.orange.demo.app.service.impl;
+
+import com.orange.demo.common.core.base.service.BaseDictService;
+import com.orange.demo.common.core.base.dao.BaseDaoMapper;
+import com.orange.demo.common.core.cache.MapDictionaryCache;
+import com.orange.demo.app.service.GradeService;
+import com.orange.demo.app.dao.GradeMapper;
+import com.orange.demo.app.model.Grade;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Service;
+
+/**
+ * 年级字典数据操作服务类。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@Service("gradeService")
+public class GradeServiceImpl extends BaseDictService<Grade, Integer> implements GradeService {
+
+    @Autowired
+    private GradeMapper gradeMapper;
+
+    public GradeServiceImpl() {
+        super();
+        this.dictionaryCache = MapDictionaryCache.create(Grade::getGradeId);
+    }
+
+    /**
+     * 返回当前Service的主表Mapper对象。
+     *
+     * @return 主表Mapper对象。
+     */
+    @Override
+    protected BaseDaoMapper<Grade> mapper() {
+        return gradeMapper;
+    }
+}

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/service/impl/SchoolInfoServiceImpl.java

@@ -0,0 +1,135 @@
+package com.orange.demo.app.service.impl;
+
+import com.orange.demo.app.service.*;
+import com.orange.demo.app.dao.*;
+import com.orange.demo.app.model.*;
+import com.orange.demo.common.core.base.dao.BaseDaoMapper;
+import com.orange.demo.common.core.object.MyRelationParam;
+import com.orange.demo.common.core.object.CallResult;
+import com.orange.demo.common.core.base.service.BaseService;
+import com.orange.demo.common.sequence.wrapper.IdGeneratorWrapper;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Service;
+
+import java.util.*;
+
+/**
+ * 校区数据数据操作服务类。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@Service("schoolInfoService")
+public class SchoolInfoServiceImpl extends BaseService<SchoolInfo, Long> implements SchoolInfoService {
+
+    @Autowired
+    private SchoolInfoMapper schoolInfoMapper;
+    @Autowired
+    private AreaCodeService areaCodeService;
+    @Autowired
+    private IdGeneratorWrapper idGenerator;
+
+    /**
+     * 返回当前Service的主表Mapper对象。
+     *
+     * @return 主表Mapper对象。
+     */
+    @Override
+    protected BaseDaoMapper<SchoolInfo> mapper() {
+        return schoolInfoMapper;
+    }
+
+    /**
+     * 保存新增对象。
+     *
+     * @param schoolInfo 新增对象。
+     * @return 返回新增对象。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public SchoolInfo saveNew(SchoolInfo schoolInfo) {
+        schoolInfo.setSchoolId(idGenerator.nextLongId());
+        schoolInfoMapper.insert(schoolInfo);
+        return schoolInfo;
+    }
+
+    /**
+     * 更新数据对象。
+     *
+     * @param schoolInfo         更新的对象。
+     * @param originalSchoolInfo 原有数据对象。
+     * @return 成功返回true，否则false。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public boolean update(SchoolInfo schoolInfo, SchoolInfo originalSchoolInfo) {
+        // 这里重点提示，在执行主表数据更新之前，如果有哪些字段不支持修改操作，请用原有数据对象字段替换当前数据字段。
+        return schoolInfoMapper.updateByPrimaryKey(schoolInfo) == 1;
+    }
+
+    /**
+     * 删除指定数据。
+     *
+     * @param schoolId 主键Id。
+     * @return 成功返回true，否则false。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public boolean remove(Long schoolId) {
+        // 这里先删除主数据
+        return this.removeById(schoolId);
+    }
+
+    /**
+     * 获取单表查询结果。由于没有关联数据查询，因此在仅仅获取单表数据的场景下，效率更高。
+     * 如果需要同时获取关联数据，请移步(getSchoolInfoListWithRelation)方法。
+     *
+     * @param filter  过滤对象。
+     * @param orderBy 排序参数。
+     * @return 查询结果集。
+     */
+    @Override
+    public List<SchoolInfo> getSchoolInfoList(SchoolInfo filter, String orderBy) {
+        return schoolInfoMapper.getSchoolInfoList(filter, orderBy);
+    }
+
+    /**
+     * 获取主表的查询结果，以及主表关联的字典数据和一对一从表数据，以及一对一从表的字典数据。
+     * 该查询会涉及到一对一从表的关联过滤，或一对多从表的嵌套关联过滤，因此性能不如单表过滤。
+     * 如果仅仅需要获取主表数据，请移步(getSchoolInfoList)，以便获取更好的查询性能。
+     *
+     * @param filter 主表过滤对象。
+     * @param orderBy 排序参数。
+     * @return 查询结果集。
+     */
+    @Override
+    public List<SchoolInfo> getSchoolInfoListWithRelation(SchoolInfo filter, String orderBy) {
+        List<SchoolInfo> resultList = schoolInfoMapper.getSchoolInfoList(filter, orderBy);
+        this.buildRelationForDataList(resultList, MyRelationParam.normal());
+        return resultList;
+    }
+
+    /**
+     * 根据最新对象和原有对象的数据对比，判断关联的字典数据和多对一主表数据是否都是合法数据。
+     *
+     * @param schoolInfo 最新数据对象。
+     * @param originalSchoolInfo 原有数据对象。
+     * @return 数据全部正确返回true，否则false。
+     */
+    @Override
+    public CallResult verifyRelatedData(SchoolInfo schoolInfo, SchoolInfo originalSchoolInfo) {
+        String errorMessageFormat = "数据验证失败，关联的%s并不存在，请刷新后重试！";
+        //这里是基于字典的验证。
+        if (this.needToVerify(schoolInfo, originalSchoolInfo, SchoolInfo::getProvinceId)
+                && !areaCodeService.existId(schoolInfo.getProvinceId())) {
+            return CallResult.error(String.format(errorMessageFormat, "所在省份"));
+        }
+        //这里是基于字典的验证。
+        if (this.needToVerify(schoolInfo, originalSchoolInfo, SchoolInfo::getCityId)
+                && !areaCodeService.existId(schoolInfo.getCityId())) {
+            return CallResult.error(String.format(errorMessageFormat, "所在城市"));
+        }
+        return CallResult.ok();
+    }
+}

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/service/impl/StudentActionStatsServiceImpl.java

@@ -0,0 +1,89 @@
+package com.orange.demo.app.service.impl;
+
+import com.orange.demo.app.service.*;
+import com.orange.demo.app.dao.*;
+import com.orange.demo.app.model.*;
+import com.orange.demo.common.core.base.dao.BaseDaoMapper;
+import com.orange.demo.common.core.object.MyRelationParam;
+import com.orange.demo.common.core.base.service.BaseService;
+import com.orange.demo.common.core.util.MyModelUtil;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Service;
+
+import java.util.*;
+
+/**
+ * 学生行为统计数据操作服务类。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@Service("studentActionStatsService")
+public class StudentActionStatsServiceImpl extends BaseService<StudentActionStats, Long> implements StudentActionStatsService {
+
+    @Autowired
+    private StudentActionStatsMapper studentActionStatsMapper;
+    @Autowired
+    private GradeService gradeService;
+    @Autowired
+    private AreaCodeService areaCodeService;
+
+    /**
+     * 返回当前Service的主表Mapper对象。
+     *
+     * @return 主表Mapper对象。
+     */
+    @Override
+    protected BaseDaoMapper<StudentActionStats> mapper() {
+        return studentActionStatsMapper;
+    }
+
+    /**
+     * 获取单表查询结果。由于没有关联数据查询，因此在仅仅获取单表数据的场景下，效率更高。
+     * 如果需要同时获取关联数据，请移步(getStudentActionStatsListWithRelation)方法。
+     *
+     * @param filter  过滤对象。
+     * @param orderBy 排序参数。
+     * @return 查询结果集。
+     */
+    @Override
+    public List<StudentActionStats> getStudentActionStatsList(StudentActionStats filter, String orderBy) {
+        return studentActionStatsMapper.getStudentActionStatsList(filter, orderBy);
+    }
+
+    /**
+     * 获取主表的查询结果，以及主表关联的字典数据和一对一从表数据，以及一对一从表的字典数据。
+     * 该查询会涉及到一对一从表的关联过滤，或一对多从表的嵌套关联过滤，因此性能不如单表过滤。
+     * 如果仅仅需要获取主表数据，请移步(getStudentActionStatsList)，以便获取更好的查询性能。
+     *
+     * @param filter 主表过滤对象。
+     * @param orderBy 排序参数。
+     * @return 查询结果集。
+     */
+    @Override
+    public List<StudentActionStats> getStudentActionStatsListWithRelation(StudentActionStats filter, String orderBy) {
+        List<StudentActionStats> resultList = studentActionStatsMapper.getStudentActionStatsList(filter, orderBy);
+        this.buildRelationForDataList(resultList, MyRelationParam.normal());
+        return resultList;
+    }
+
+    /**
+     * 获取分组过滤后的数据查询结果，以及关联的字典数据和一对一从表数据，以及一对一从表的字典数据。
+     *
+     * @param filter      过滤对象。
+     * @param groupSelect 分组显示列表参数。位于SQL语句SELECT的后面。
+     * @param groupBy     分组参数。位于SQL语句的GROUP BY后面。
+     * @param orderBy     排序字符串，ORDER BY从句的参数。
+     * @return 分组过滤结果集。
+     */
+    @Override
+    public List<StudentActionStats> getGroupedStudentActionStatsListWithRelation(
+            StudentActionStats filter, String groupSelect, String groupBy, String orderBy) {
+        List<StudentActionStats> resultList =
+                studentActionStatsMapper.getGroupedStudentActionStatsList(filter, groupSelect, groupBy, orderBy);
+        // NOTE: 这里只是包含了关联数据，聚合计算数据没有包含。
+        // 主要原因是，由于聚合字段通常被视为普通字段使用，不会在group by的从句中出现，语义上也不会在此关联。
+        this.buildRelationForDataList(resultList, MyRelationParam.normal());
+        return resultList;
+    }
+}

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/service/impl/StudentActionTransServiceImpl.java

@@ -0,0 +1,137 @@
+package com.orange.demo.app.service.impl;
+
+import com.orange.demo.app.service.*;
+import com.orange.demo.app.dao.*;
+import com.orange.demo.app.model.*;
+import com.orange.demo.common.core.base.dao.BaseDaoMapper;
+import com.orange.demo.common.core.object.MyRelationParam;
+import com.orange.demo.common.core.object.CallResult;
+import com.orange.demo.common.core.base.service.BaseService;
+import com.orange.demo.common.sequence.wrapper.IdGeneratorWrapper;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Service;
+
+import java.util.*;
+
+/**
+ * 学生行为流水数据操作服务类。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@Service("studentActionTransService")
+public class StudentActionTransServiceImpl extends BaseService<StudentActionTrans, Long> implements StudentActionTransService {
+
+    @Autowired
+    private StudentActionTransMapper studentActionTransMapper;
+    @Autowired
+    private SchoolInfoService schoolInfoService;
+    @Autowired
+    private GradeService gradeService;
+    @Autowired
+    private IdGeneratorWrapper idGenerator;
+
+    /**
+     * 返回当前Service的主表Mapper对象。
+     *
+     * @return 主表Mapper对象。
+     */
+    @Override
+    protected BaseDaoMapper<StudentActionTrans> mapper() {
+        return studentActionTransMapper;
+    }
+
+    /**
+     * 保存新增对象。
+     *
+     * @param studentActionTrans 新增对象。
+     * @return 返回新增对象。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public StudentActionTrans saveNew(StudentActionTrans studentActionTrans) {
+        studentActionTrans.setTransId(idGenerator.nextLongId());
+        studentActionTransMapper.insert(studentActionTrans);
+        return studentActionTrans;
+    }
+
+    /**
+     * 更新数据对象。
+     *
+     * @param studentActionTrans         更新的对象。
+     * @param originalStudentActionTrans 原有数据对象。
+     * @return 成功返回true，否则false。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public boolean update(StudentActionTrans studentActionTrans, StudentActionTrans originalStudentActionTrans) {
+        // 这里重点提示，在执行主表数据更新之前，如果有哪些字段不支持修改操作，请用原有数据对象字段替换当前数据字段。
+        return studentActionTransMapper.updateByPrimaryKey(studentActionTrans) == 1;
+    }
+
+    /**
+     * 删除指定数据。
+     *
+     * @param transId 主键Id。
+     * @return 成功返回true，否则false。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public boolean remove(Long transId) {
+        // 这里先删除主数据
+        return this.removeById(transId);
+    }
+
+    /**
+     * 获取单表查询结果。由于没有关联数据查询，因此在仅仅获取单表数据的场景下，效率更高。
+     * 如果需要同时获取关联数据，请移步(getStudentActionTransListWithRelation)方法。
+     *
+     * @param filter  过滤对象。
+     * @param orderBy 排序参数。
+     * @return 查询结果集。
+     */
+    @Override
+    public List<StudentActionTrans> getStudentActionTransList(StudentActionTrans filter, String orderBy) {
+        return studentActionTransMapper.getStudentActionTransList(filter, orderBy);
+    }
+
+    /**
+     * 获取主表的查询结果，以及主表关联的字典数据和一对一从表数据，以及一对一从表的字典数据。
+     * 该查询会涉及到一对一从表的关联过滤，或一对多从表的嵌套关联过滤，因此性能不如单表过滤。
+     * 如果仅仅需要获取主表数据，请移步(getStudentActionTransList)，以便获取更好的查询性能。
+     *
+     * @param filter 主表过滤对象。
+     * @param orderBy 排序参数。
+     * @return 查询结果集。
+     */
+    @Override
+    public List<StudentActionTrans> getStudentActionTransListWithRelation(StudentActionTrans filter, String orderBy) {
+        List<StudentActionTrans> resultList = studentActionTransMapper.getStudentActionTransList(filter, orderBy);
+        this.buildRelationForDataList(resultList, MyRelationParam.normal());
+        return resultList;
+    }
+
+    /**
+     * 根据最新对象和原有对象的数据对比，判断关联的字典数据和多对一主表数据是否都是合法数据。
+     *
+     * @param studentActionTrans 最新数据对象。
+     * @param originalStudentActionTrans 原有数据对象。
+     * @return 数据全部正确返回true，否则false。
+     */
+    @Override
+    public CallResult verifyRelatedData(StudentActionTrans studentActionTrans, StudentActionTrans originalStudentActionTrans) {
+        String errorMessageFormat = "数据验证失败，关联的%s并不存在，请刷新后重试！";
+        //这里是基于字典的验证。
+        if (this.needToVerify(studentActionTrans, originalStudentActionTrans, StudentActionTrans::getSchoolId)
+                && !schoolInfoService.existId(studentActionTrans.getSchoolId())) {
+            return CallResult.error(String.format(errorMessageFormat, "学生校区"));
+        }
+        //这里是基于字典的验证。
+        if (this.needToVerify(studentActionTrans, originalStudentActionTrans, StudentActionTrans::getGradeId)
+                && !gradeService.existId(studentActionTrans.getGradeId())) {
+            return CallResult.error(String.format(errorMessageFormat, "学生年级"));
+        }
+        return CallResult.ok();
+    }
+}

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/service/impl/StudentClassServiceImpl.java

@@ -0,0 +1,258 @@
+package com.orange.demo.app.service.impl;
+
+import com.orange.demo.app.service.*;
+import com.orange.demo.app.dao.*;
+import com.orange.demo.app.model.*;
+import com.orange.demo.common.core.base.dao.BaseDaoMapper;
+import com.orange.demo.common.core.constant.GlobalDeletedFlag;
+import com.orange.demo.common.core.object.TokenData;
+import com.orange.demo.common.core.object.MyRelationParam;
+import com.orange.demo.common.core.object.CallResult;
+import com.orange.demo.common.core.base.service.BaseService;
+import com.orange.demo.common.core.util.MyModelUtil;
+import com.orange.demo.common.sequence.wrapper.IdGeneratorWrapper;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Service;
+import tk.mybatis.mapper.entity.Example;
+
+import java.util.*;
+
+/**
+ * 班级数据数据操作服务类。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@Service("studentClassService")
+public class StudentClassServiceImpl extends BaseService<StudentClass, Long> implements StudentClassService {
+
+    @Autowired
+    private StudentClassMapper studentClassMapper;
+    @Autowired
+    private ClassCourseMapper classCourseMapper;
+    @Autowired
+    private ClassStudentMapper classStudentMapper;
+    @Autowired
+    private SchoolInfoService schoolInfoService;
+    @Autowired
+    private StudentService studentService;
+    @Autowired
+    private IdGeneratorWrapper idGenerator;
+
+    /**
+     * 返回当前Service的主表Mapper对象。
+     *
+     * @return 主表Mapper对象。
+     */
+    @Override
+    protected BaseDaoMapper<StudentClass> mapper() {
+        return studentClassMapper;
+    }
+
+    /**
+     * 保存新增对象。
+     *
+     * @param studentClass 新增对象。
+     * @return 返回新增对象。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public StudentClass saveNew(StudentClass studentClass) {
+        studentClass.setClassId(idGenerator.nextLongId());
+        TokenData tokenData = TokenData.takeFromRequest();
+        studentClass.setCreateUserId(tokenData.getUserId());
+        studentClass.setCreateTime(new Date());
+        studentClass.setStatus(GlobalDeletedFlag.NORMAL);
+        MyModelUtil.setDefaultValue(studentClass, "finishClassHour", 0);
+        studentClassMapper.insert(studentClass);
+        return studentClass;
+    }
+
+    /**
+     * 更新数据对象。
+     *
+     * @param studentClass         更新的对象。
+     * @param originalStudentClass 原有数据对象。
+     * @return 成功返回true，否则false。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public boolean update(StudentClass studentClass, StudentClass originalStudentClass) {
+        studentClass.setCreateUserId(originalStudentClass.getCreateUserId());
+        studentClass.setCreateTime(originalStudentClass.getCreateTime());
+        studentClass.setStatus(GlobalDeletedFlag.NORMAL);
+        // 这里重点提示，在执行主表数据更新之前，如果有哪些字段不支持修改操作，请用原有数据对象字段替换当前数据字段。
+        return studentClassMapper.updateByPrimaryKey(studentClass) == 1;
+    }
+
+    /**
+     * 删除指定数据。
+     *
+     * @param classId 主键Id。
+     * @return 成功返回true，否则false。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public boolean remove(Long classId) {
+        // 这里先删除主数据
+        if (!this.removeById(classId)) {
+            return false;
+        }
+        // 开始删除多对多子表的关联
+        ClassCourse classCourse = new ClassCourse();
+        classCourse.setClassId(classId);
+        classCourseMapper.delete(classCourse);
+        ClassStudent classStudent = new ClassStudent();
+        classStudent.setClassId(classId);
+        classStudentMapper.delete(classStudent);
+        return true;
+    }
+
+    /**
+     * 获取单表查询结果。由于没有关联数据查询，因此在仅仅获取单表数据的场景下，效率更高。
+     * 如果需要同时获取关联数据，请移步(getStudentClassListWithRelation)方法。
+     *
+     * @param filter  过滤对象。
+     * @param orderBy 排序参数。
+     * @return 查询结果集。
+     */
+    @Override
+    public List<StudentClass> getStudentClassList(StudentClass filter, String orderBy) {
+        return studentClassMapper.getStudentClassList(filter, orderBy);
+    }
+
+    /**
+     * 获取主表的查询结果，以及主表关联的字典数据和一对一从表数据，以及一对一从表的字典数据。
+     * 该查询会涉及到一对一从表的关联过滤，或一对多从表的嵌套关联过滤，因此性能不如单表过滤。
+     * 如果仅仅需要获取主表数据，请移步(getStudentClassList)，以便获取更好的查询性能。
+     *
+     * @param filter 主表过滤对象。
+     * @param orderBy 排序参数。
+     * @return 查询结果集。
+     */
+    @Override
+    public List<StudentClass> getStudentClassListWithRelation(StudentClass filter, String orderBy) {
+        List<StudentClass> resultList = studentClassMapper.getStudentClassList(filter, orderBy);
+        this.buildRelationForDataList(resultList, MyRelationParam.normal());
+        return resultList;
+    }
+
+    /**
+     * 批量添加多对多关联关系。
+     *
+     * @param classCourseList 多对多关联表对象集合。
+     * @param classId 主表Id。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public void addClassCourseList(List<ClassCourse> classCourseList, Long classId) {
+        for (ClassCourse classCourse : classCourseList) {
+            classCourse.setClassId(classId);
+            MyModelUtil.setDefaultValue(classCourse, "courseOrder", 0);
+        }
+        classCourseMapper.insertList(classCourseList);
+    }
+
+    /**
+     * 更新中间表数据。
+     *
+     * @param classCourse 中间表对象。
+     * @return 更新成功与否。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public boolean updateClassCourse(ClassCourse classCourse) {
+        Example e = new Example(ClassCourse.class);
+        e.createCriteria()
+                .andEqualTo("classId", classCourse.getClassId())
+                .andEqualTo("courseId", classCourse.getCourseId());
+        return classCourseMapper.updateByExample(classCourse, e) > 0;
+    }
+
+    /**
+     * 获取中间表数据。
+     *
+     * @param classId 主表Id。
+     * @param courseId 从表Id。
+     * @return 中间表对象。
+     */
+    @Override
+    public ClassCourse getClassCourse(Long classId, Long courseId) {
+        Example e = new Example(ClassCourse.class);
+        e.createCriteria()
+                .andEqualTo("classId", classId)
+                .andEqualTo("courseId", courseId);
+        return classCourseMapper.selectOneByExample(e);
+    }
+
+    /**
+     * 移除单条多对多关系。
+     *
+     * @param classId 主表Id。
+     * @param courseId 从表Id。
+     * @return 成功返回true，否则false。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public boolean removeClassCourse(Long classId, Long courseId) {
+        ClassCourse filter = new ClassCourse();
+        filter.setClassId(classId);
+        filter.setCourseId(courseId);
+        return classCourseMapper.delete(filter) > 0;
+    }
+
+    /**
+     * 批量添加多对多关联关系。
+     *
+     * @param classStudentList 多对多关联表对象集合。
+     * @param classId 主表Id。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public void addClassStudentList(List<ClassStudent> classStudentList, Long classId) {
+        for (ClassStudent classStudent : classStudentList) {
+            classStudent.setClassId(classId);
+        }
+        classStudentMapper.insertList(classStudentList);
+    }
+
+    /**
+     * 移除单条多对多关系。
+     *
+     * @param classId 主表Id。
+     * @param studentId 从表Id。
+     * @return 成功返回true，否则false。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public boolean removeClassStudent(Long classId, Long studentId) {
+        ClassStudent filter = new ClassStudent();
+        filter.setClassId(classId);
+        filter.setStudentId(studentId);
+        return classStudentMapper.delete(filter) > 0;
+    }
+
+    /**
+     * 根据最新对象和原有对象的数据对比，判断关联的字典数据和多对一主表数据是否都是合法数据。
+     *
+     * @param studentClass 最新数据对象。
+     * @param originalStudentClass 原有数据对象。
+     * @return 数据全部正确返回true，否则false。
+     */
+    @Override
+    public CallResult verifyRelatedData(StudentClass studentClass, StudentClass originalStudentClass) {
+        String errorMessageFormat = "数据验证失败，关联的%s并不存在，请刷新后重试！";
+        //这里是基于字典的验证。
+        if (this.needToVerify(studentClass, originalStudentClass, StudentClass::getSchoolId)
+                && !schoolInfoService.existId(studentClass.getSchoolId())) {
+            return CallResult.error(String.format(errorMessageFormat, "所属校区"));
+        }
+        //这里是基于字典的验证。
+        if (this.needToVerify(studentClass, originalStudentClass, StudentClass::getLeaderId)
+                && !studentService.existId(studentClass.getLeaderId())) {
+            return CallResult.error(String.format(errorMessageFormat, "学生班长"));
+        }
+        return CallResult.ok();
+    }
+}

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/service/impl/StudentServiceImpl.java

@@ -0,0 +1,204 @@
+package com.orange.demo.app.service.impl;
+
+import com.orange.demo.application.common.constant.StudentStatus;
+import com.orange.demo.app.service.*;
+import com.orange.demo.app.dao.*;
+import com.orange.demo.app.model.*;
+import com.orange.demo.common.core.base.dao.BaseDaoMapper;
+import com.orange.demo.common.core.object.MyRelationParam;
+import com.orange.demo.common.core.object.CallResult;
+import com.orange.demo.common.core.base.service.BaseService;
+import com.orange.demo.common.core.util.MyModelUtil;
+import com.orange.demo.common.sequence.wrapper.IdGeneratorWrapper;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Service;
+
+import java.util.*;
+
+/**
+ * 学生数据数据操作服务类。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@Service("studentService")
+public class StudentServiceImpl extends BaseService<Student, Long> implements StudentService {
+
+    @Autowired
+    private StudentMapper studentMapper;
+    @Autowired
+    private ClassStudentMapper classStudentMapper;
+    @Autowired
+    private AreaCodeService areaCodeService;
+    @Autowired
+    private GradeService gradeService;
+    @Autowired
+    private SchoolInfoService schoolInfoService;
+    @Autowired
+    private IdGeneratorWrapper idGenerator;
+
+    /**
+     * 返回当前Service的主表Mapper对象。
+     *
+     * @return 主表Mapper对象。
+     */
+    @Override
+    protected BaseDaoMapper<Student> mapper() {
+        return studentMapper;
+    }
+
+    /**
+     * 保存新增对象。
+     *
+     * @param student 新增对象。
+     * @return 返回新增对象。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public Student saveNew(Student student) {
+        student.setStudentId(idGenerator.nextLongId());
+        student.setRegisterTime(new Date());
+        MyModelUtil.setDefaultValue(student, "totalCoin", 0);
+        MyModelUtil.setDefaultValue(student, "leftCoin", 0);
+        MyModelUtil.setDefaultValue(student, "status", StudentStatus.NORMAL);
+        studentMapper.insert(student);
+        return student;
+    }
+
+    /**
+     * 更新数据对象。
+     *
+     * @param student         更新的对象。
+     * @param originalStudent 原有数据对象。
+     * @return 成功返回true，否则false。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public boolean update(Student student, Student originalStudent) {
+        student.setRegisterTime(originalStudent.getRegisterTime());
+        // 这里重点提示，在执行主表数据更新之前，如果有哪些字段不支持修改操作，请用原有数据对象字段替换当前数据字段。
+        return studentMapper.updateByPrimaryKey(student) == 1;
+    }
+
+    /**
+     * 删除指定数据。
+     *
+     * @param studentId 主键Id。
+     * @return 成功返回true，否则false。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public boolean remove(Long studentId) {
+        // 这里先删除主数据
+        if (!this.removeById(studentId)) {
+            return false;
+        }
+        // 开始删除多对多父表的关联
+        ClassStudent classStudent = new ClassStudent();
+        classStudent.setStudentId(studentId);
+        classStudentMapper.delete(classStudent);
+        return true;
+    }
+
+    /**
+     * 获取单表查询结果。由于没有关联数据查询，因此在仅仅获取单表数据的场景下，效率更高。
+     * 如果需要同时获取关联数据，请移步(getStudentListWithRelation)方法。
+     *
+     * @param filter  过滤对象。
+     * @param orderBy 排序参数。
+     * @return 查询结果集。
+     */
+    @Override
+    public List<Student> getStudentList(Student filter, String orderBy) {
+        return studentMapper.getStudentList(filter, orderBy);
+    }
+
+    /**
+     * 获取主表的查询结果，以及主表关联的字典数据和一对一从表数据，以及一对一从表的字典数据。
+     * 该查询会涉及到一对一从表的关联过滤，或一对多从表的嵌套关联过滤，因此性能不如单表过滤。
+     * 如果仅仅需要获取主表数据，请移步(getStudentList)，以便获取更好的查询性能。
+     *
+     * @param filter 主表过滤对象。
+     * @param orderBy 排序参数。
+     * @return 查询结果集。
+     */
+    @Override
+    public List<Student> getStudentListWithRelation(Student filter, String orderBy) {
+        List<Student> resultList = studentMapper.getStudentList(filter, orderBy);
+        this.buildRelationForDataList(resultList, MyRelationParam.normal());
+        return resultList;
+    }
+
+    /**
+     * 在多对多关系中，当前Service的数据表为从表，返回不与指定主表主键Id存在对多对关系的列表。
+     *
+     * @param classId 主表主键Id。
+     * @param filter 从表的过滤对象。
+     * @param orderBy 排序参数。
+     * @return 查询结果集。
+     */
+    @Override
+    public List<Student> getNotInStudentListByClassId(
+            Long classId, Student filter, String orderBy) {
+        List<Student> resultList =
+                studentMapper.getNotInStudentListByClassId(classId, filter, orderBy);
+        this.buildRelationForDataList(resultList, MyRelationParam.dictOnly());
+        return resultList;
+    }
+
+    /**
+     * 在多对多关系中，当前Service的数据表为从表，返回与指定主表主键Id存在对多对关系的列表。
+     *
+     * @param classId 主表主键Id。
+     * @param filter 从表的过滤对象。
+     * @param orderBy 排序参数。
+     * @return 查询结果集。
+     */
+    @Override
+    public List<Student> getStudentListByClassId(
+            Long classId, Student filter, String orderBy) {
+        List<Student> resultList =
+                studentMapper.getStudentListByClassId(classId, filter, orderBy);
+        this.buildRelationForDataList(resultList, MyRelationParam.dictOnly());
+        return resultList;
+    }
+
+    /**
+     * 根据最新对象和原有对象的数据对比，判断关联的字典数据和多对一主表数据是否都是合法数据。
+     *
+     * @param student 最新数据对象。
+     * @param originalStudent 原有数据对象。
+     * @return 数据全部正确返回true，否则false。
+     */
+    @Override
+    public CallResult verifyRelatedData(Student student, Student originalStudent) {
+        String errorMessageFormat = "数据验证失败，关联的%s并不存在，请刷新后重试！";
+        //这里是基于字典的验证。
+        if (this.needToVerify(student, originalStudent, Student::getProvinceId)
+                && !areaCodeService.existId(student.getProvinceId())) {
+            return CallResult.error(String.format(errorMessageFormat, "所在省份"));
+        }
+        //这里是基于字典的验证。
+        if (this.needToVerify(student, originalStudent, Student::getCityId)
+                && !areaCodeService.existId(student.getCityId())) {
+            return CallResult.error(String.format(errorMessageFormat, "所在城市"));
+        }
+        //这里是基于字典的验证。
+        if (this.needToVerify(student, originalStudent, Student::getDistrictId)
+                && !areaCodeService.existId(student.getDistrictId())) {
+            return CallResult.error(String.format(errorMessageFormat, "所在区县"));
+        }
+        //这里是基于字典的验证。
+        if (this.needToVerify(student, originalStudent, Student::getGradeId)
+                && !gradeService.existId(student.getGradeId())) {
+            return CallResult.error(String.format(errorMessageFormat, "年级"));
+        }
+        //这里是基于字典的验证。
+        if (this.needToVerify(student, originalStudent, Student::getSchoolId)
+                && !schoolInfoService.existId(student.getSchoolId())) {
+            return CallResult.error(String.format(errorMessageFormat, "所属校区"));
+        }
+        return CallResult.ok();
+    }
+}

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/vo/AreaCodeVo.java

@@ -1,5 +1,7 @@
 package com.orange.demo.app.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 /**
@@ -8,26 +10,31 @@ import lombok.Data;
  * @author Jerry
  * @date 2020-09-24
  */
+@ApiModel("行政区划实体对象")
 @Data
 public class AreaCodeVo {
 
     /**
      * 行政区划主键Id
      */
+    @ApiModelProperty(value = "行政区划主键Id", required = true)
     private Long areaId;
 
     /**
      * 行政区划名称
      */
+    @ApiModelProperty(value = "行政区划名称")
     private String areaName;
 
     /**
      * 行政区划级别 (1: 省级别 2: 市级别 3: 区级别)
      */
+    @ApiModelProperty(value = "行政区划级别")
     private Integer areaLevel;
 
     /**
      * 父级行政区划Id
      */
+    @ApiModelProperty(value = "父级行政区划Id")
     private Long parentId;
 }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/vo/ClassCourseVo.java

@@ -1,5 +1,7 @@
 package com.orange.demo.app.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 /**
@@ -8,21 +10,25 @@ import lombok.Data;
  * @author Jerry
  * @date 2020-09-24
  */
+@ApiModel("ClassCourseVO实体对象")
 @Data
 public class ClassCourseVo {
 
     /**
      * 班级Id。
      */
+    @ApiModelProperty(value = "班级Id")
     private Long classId;
 
     /**
      * 课程Id。
      */
+    @ApiModelProperty(value = "课程Id")
     private Long courseId;
 
     /**
      * 课程顺序(数值越小越靠前)。
      */
+    @ApiModelProperty(value = "课程顺序(数值越小越靠前)")
     private Integer courseOrder;
 }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/vo/ClassStudentVo.java

@@ -1,5 +1,7 @@
 package com.orange.demo.app.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 /**
@@ -8,16 +10,19 @@ import lombok.Data;
  * @author Jerry
  * @date 2020-09-24
  */
+@ApiModel("ClassStudentVO实体对象")
 @Data
 public class ClassStudentVo {
 
     /**
      * 班级Id。
      */
+    @ApiModelProperty(value = "班级Id")
     private Long classId;
 
     /**
      * 学生Id。
      */
+    @ApiModelProperty(value = "学生Id")
     private Long studentId;
 }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/vo/CourseTransStatsVo.java

@@ -1,5 +1,7 @@
 package com.orange.demo.app.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Date;
@@ -11,66 +13,79 @@ import java.util.Map;
  * @author Jerry
  * @date 2020-09-24
  */
+@ApiModel("CourseTransStatsVO实体对象")
 @Data
 public class CourseTransStatsVo {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     private Long statsId;
 
     /**
      * 统计日期。
      */
+    @ApiModelProperty(value = "统计日期")
     private Date statsDate;
 
     /**
      * 科目Id。
      */
+    @ApiModelProperty(value = "科目Id")
     private Integer subjectId;
 
     /**
      * 年级Id。
      */
+    @ApiModelProperty(value = "年级Id")
     private Integer gradeId;
 
     /**
      * 年级名称。
      */
+    @ApiModelProperty(value = "年级名称")
     private String gradeName;
 
     /**
      * 课程Id。
      */
+    @ApiModelProperty(value = "课程Id")
     private Long courseId;
 
     /**
      * 课程名称。
      */
+    @ApiModelProperty(value = "课程名称")
     private String courseName;
 
     /**
      * 学生上课次数。
      */
+    @ApiModelProperty(value = "学生上课次数")
     private Integer studentAttendCount;
 
     /**
      * 学生献花数量。
      */
+    @ApiModelProperty(value = "学生献花数量")
     private Integer studentFlowerAmount;
 
     /**
      * 学生献花次数。
      */
+    @ApiModelProperty(value = "学生献花次数")
     private Integer studentFlowerCount;
 
     /**
      * gradeId 字典关联数据。
      */
+    @ApiModelProperty(value = "gradeId 字典关联数据")
     private Map<String, Object> gradeIdDictMap;
 
     /**
      * subjectId 常量字典关联数据。
      */
+    @ApiModelProperty(value = "subjectId 常量字典关联数据")
     private Map<String, Object> subjectIdDictMap;
 }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/vo/CourseVo.java

@@ -1,5 +1,7 @@
 package com.orange.demo.app.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.math.BigDecimal;
@@ -12,86 +14,103 @@ import java.util.Map;
  * @author Jerry
  * @date 2020-09-24
  */
+@ApiModel("CourseVO实体对象")
 @Data
 public class CourseVo {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     private Long courseId;
 
     /**
      * 课程名称。
      */
+    @ApiModelProperty(value = "课程名称")
     private String courseName;
 
     /**
      * 课程价格。
      */
+    @ApiModelProperty(value = "课程价格")
     private BigDecimal price;
 
     /**
      * 课程描述。
      */
+    @ApiModelProperty(value = "课程描述")
     private String description;
 
     /**
      * 课程难度(0: 容易 1: 普通 2: 很难)。
      */
+    @ApiModelProperty(value = "课程难度(0: 容易 1: 普通 2: 很难)")
     private Integer difficulty;
 
     /**
      * 年级Id。
      */
+    @ApiModelProperty(value = "年级Id")
     private Integer gradeId;
 
     /**
      * 学科Id。
      */
+    @ApiModelProperty(value = "学科Id")
     private Integer subjectId;
 
     /**
      * 课时数量。
      */
+    @ApiModelProperty(value = "课时数量")
     private Integer classHour;
 
     /**
      * 多张课程图片地址。
      */
+    @ApiModelProperty(value = "多张课程图片地址")
     private String pictureUrl;
 
     /**
      * 创建用户Id。
      */
+    @ApiModelProperty(value = "创建用户Id")
     private Long createUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 最后修改时间。
      */
+    @ApiModelProperty(value = "最后修改时间")
     private Date updateTime;
 
     /**
      * courseId 的多对多关联表数据对象，数据对应类型为ClassCourseVo。
      */
+    @ApiModelProperty(value = "courseId 的多对多关联表数据对象，数据对应类型为ClassCourseVo")
     private Map<String, Object> classCourse;
 
     /**
      * gradeId 字典关联数据。
      */
+    @ApiModelProperty(value = "gradeId 字典关联数据")
     private Map<String, Object> gradeIdDictMap;
 
     /**
      * difficulty 常量字典关联数据。
      */
+    @ApiModelProperty(value = "difficulty 常量字典关联数据")
     private Map<String, Object> difficultyDictMap;
 
     /**
      * subjectId 常量字典关联数据。
      */
+    @ApiModelProperty(value = "subjectId 常量字典关联数据")
     private Map<String, Object> subjectIdDictMap;
 }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/vo/GradeVo.java

@@ -1,5 +1,7 @@
 package com.orange.demo.app.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 /**
@@ -8,16 +10,19 @@ import lombok.Data;
  * @author Jerry
  * @date 2020-09-24
  */
+@ApiModel("GradeVO实体对象")
 @Data
 public class GradeVo {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     private Integer gradeId;
 
     /**
      * 年级名称。
      */
+    @ApiModelProperty(value = "年级名称")
     private String gradeName;
 }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/vo/SchoolInfoVo.java

@@ -1,5 +1,7 @@
 package com.orange.demo.app.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Map;
@@ -10,36 +12,43 @@ import java.util.Map;
  * @author Jerry
  * @date 2020-09-24
  */
+@ApiModel("SchoolInfoVO实体对象")
 @Data
 public class SchoolInfoVo {
 
     /**
      * 学校Id。
      */
+    @ApiModelProperty(value = "学校Id")
     private Long schoolId;
 
     /**
      * 学校名称。
      */
+    @ApiModelProperty(value = "学校名称")
     private String schoolName;
 
     /**
      * 所在省Id。
      */
+    @ApiModelProperty(value = "所在省Id")
     private Long provinceId;
 
     /**
      * 所在城市Id。
      */
+    @ApiModelProperty(value = "所在城市Id")
     private Long cityId;
 
     /**
      * provinceId 字典关联数据。
      */
+    @ApiModelProperty(value = "provinceId 字典关联数据")
     private Map<String, Object> provinceIdDictMap;
 
     /**
      * cityId 字典关联数据。
      */
+    @ApiModelProperty(value = "cityId 字典关联数据")
     private Map<String, Object> cityIdDictMap;
 }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/vo/StudentActionStatsVo.java

@@ -1,5 +1,7 @@
 package com.orange.demo.app.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Date;
@@ -11,126 +13,151 @@ import java.util.Map;
  * @author Jerry
  * @date 2020-09-24
  */
+@ApiModel("StudentActionStatsVO实体对象")
 @Data
 public class StudentActionStatsVo {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     private Long statsId;
 
     /**
      * 统计日期。
      */
+    @ApiModelProperty(value = "统计日期")
     private Date statsDate;
 
     /**
      * 统计小时。
      */
+    @ApiModelProperty(value = "统计小时")
     private Date statsMonth;
 
     /**
      * 年级Id。
      */
+    @ApiModelProperty(value = "年级Id")
     private Integer gradeId;
 
     /**
      * 学生所在省Id。
      */
+    @ApiModelProperty(value = "学生所在省Id")
     private Long provinceId;
 
     /**
      * 学生所在城市Id。
      */
+    @ApiModelProperty(value = "学生所在城市Id")
     private Long cityId;
 
     /**
      * 购课学币数量。
      */
+    @ApiModelProperty(value = "购课学币数量")
     private Integer buyCourseAmount;
 
     /**
      * 购买课程次数。
      */
+    @ApiModelProperty(value = "购买课程次数")
     private Integer buyCourseCount;
 
     /**
      * 购买视频学币数量。
      */
+    @ApiModelProperty(value = "购买视频学币数量")
     private Integer buyVideoAmount;
 
     /**
      * 购买视频次数。
      */
+    @ApiModelProperty(value = "购买视频次数")
     private Integer buyVideoCount;
 
     /**
      * 购买作业学币数量。
      */
+    @ApiModelProperty(value = "购买作业学币数量")
     private Integer buyPaperAmount;
 
     /**
      * 购买作业次数。
      */
+    @ApiModelProperty(value = "购买作业次数")
     private Integer buyPaperCount;
 
     /**
      * 购买献花数量。
      */
+    @ApiModelProperty(value = "购买献花数量")
     private Integer buyFlowerAmount;
 
     /**
      * 购买献花次数。
      */
+    @ApiModelProperty(value = "购买献花次数")
     private Integer buyFlowerCount;
 
     /**
      * 充值学币数量。
      */
+    @ApiModelProperty(value = "充值学币数量")
     private Integer rechargeCoinAmount;
 
     /**
      * 充值学币次数。
      */
+    @ApiModelProperty(value = "充值学币次数")
     private Integer rechargeCoinCount;
 
     /**
      * 线下课程上课次数。
      */
+    @ApiModelProperty(value = "线下课程上课次数")
     private Integer doCourseCount;
 
     /**
      * 观看视频次数。
      */
+    @ApiModelProperty(value = "观看视频次数")
     private Integer watchVideoCount;
 
     /**
      * 购买献花消费学币数量。
      */
+    @ApiModelProperty(value = "购买献花消费学币数量")
     private Integer watchVideoTotalSecond;
 
     /**
      * 做题数量。
      */
+    @ApiModelProperty(value = "做题数量")
     private Integer doExerciseCount;
 
     /**
      * 做题正确的数量。
      */
+    @ApiModelProperty(value = "做题正确的数量")
     private Integer doExerciseCorrectCount;
 
     /**
      * gradeId 字典关联数据。
      */
+    @ApiModelProperty(value = "gradeId 字典关联数据")
     private Map<String, Object> gradeIdDictMap;
 
     /**
      * provinceId 字典关联数据。
      */
+    @ApiModelProperty(value = "provinceId 字典关联数据")
     private Map<String, Object> provinceIdDictMap;
 
     /**
      * cityId 字典关联数据。
      */
+    @ApiModelProperty(value = "cityId 字典关联数据")
     private Map<String, Object> cityIdDictMap;
 }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/vo/StudentActionTransVo.java

@@ -1,5 +1,7 @@
 package com.orange.demo.app.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Date;
@@ -11,101 +13,121 @@ import java.util.Map;
  * @author Jerry
  * @date 2020-09-24
  */
+@ApiModel("StudentActionTransVO实体对象")
 @Data
 public class StudentActionTransVo {
 
     /**
      * 主键Id。
      */
+    @ApiModelProperty(value = "主键Id")
     private Long transId;
 
     /**
      * 学生Id。
      */
+    @ApiModelProperty(value = "学生Id")
     private Long studentId;
 
     /**
      * 学生名称。
      */
+    @ApiModelProperty(value = "学生名称")
     private String studentName;
 
     /**
      * 学生校区。
      */
+    @ApiModelProperty(value = "学生校区")
     private Long schoolId;
 
     /**
      * 年级Id。
      */
+    @ApiModelProperty(value = "年级Id")
     private Integer gradeId;
 
     /**
      * 行为类型(0: 充值  1: 购课 2: 上课签到 3: 上课签退 4: 看视频课 5: 做作业 6: 刷题 7: 献花)。
      */
+    @ApiModelProperty(value = "行为类型(0: 充值  1: 购课 2: 上课签到 3: 上课签退 4: 看视频课 5: 做作业 6: 刷题 7: 献花)")
     private Integer actionType;
 
     /**
      * 设备类型(0: iOS 1: Android 2: PC)。
      */
+    @ApiModelProperty(value = "设备类型(0: iOS 1: Android 2: PC)")
     private Integer deviceType;
 
     /**
      * 看视频秒数。
      */
+    @ApiModelProperty(value = "看视频秒数")
     private Integer watchVideoSeconds;
 
     /**
      * 购买献花数量。
      */
+    @ApiModelProperty(value = "购买献花数量")
     private Integer flowerCount;
 
     /**
      * 购买作业数量。
      */
+    @ApiModelProperty(value = "购买作业数量")
     private Integer paperCount;
 
     /**
      * 购买视频数量。
      */
+    @ApiModelProperty(value = "购买视频数量")
     private Integer videoCount;
 
     /**
      * 购买课程数量。
      */
+    @ApiModelProperty(value = "购买课程数量")
     private Integer courseCount;
 
     /**
      * 充值学币数量。
      */
+    @ApiModelProperty(value = "充值学币数量")
     private Integer coinCount;
 
     /**
      * 做题是否正确标记。
      */
+    @ApiModelProperty(value = "做题是否正确标记")
     private Integer exerciseCorrectFlag;
 
     /**
      * 发生时间。
      */
+    @ApiModelProperty(value = "发生时间")
     private Date createTime;
 
     /**
      * schoolId 字典关联数据。
      */
+    @ApiModelProperty(value = "schoolId 字典关联数据")
     private Map<String, Object> schoolIdDictMap;
 
     /**
      * gradeId 字典关联数据。
      */
+    @ApiModelProperty(value = "gradeId 字典关联数据")
     private Map<String, Object> gradeIdDictMap;
 
     /**
      * actionType 常量字典关联数据。
      */
+    @ApiModelProperty(value = "actionType 常量字典关联数据")
     private Map<String, Object> actionTypeDictMap;
 
     /**
      * deviceType 常量字典关联数据。
      */
+    @ApiModelProperty(value = "deviceType 常量字典关联数据")
     private Map<String, Object> deviceTypeDictMap;
 }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/vo/StudentClassVo.java

@@ -1,5 +1,7 @@
 package com.orange.demo.app.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Date;
@@ -11,61 +13,73 @@ import java.util.Map;
  * @author Jerry
  * @date 2020-09-24
  */
+@ApiModel("StudentClassVO实体对象")
 @Data
 public class StudentClassVo {
 
     /**
      * 班级Id。
      */
+    @ApiModelProperty(value = "班级Id")
     private Long classId;
 
     /**
      * 班级名称。
      */
+    @ApiModelProperty(value = "班级名称")
     private String className;
 
     /**
      * 学校Id。
      */
+    @ApiModelProperty(value = "学校Id")
     private Long schoolId;
 
     /**
      * 学生班长Id。
      */
+    @ApiModelProperty(value = "学生班长Id")
     private Long leaderId;
 
     /**
      * 已完成课时数量。
      */
+    @ApiModelProperty(value = "已完成课时数量")
     private Integer finishClassHour;
 
     /**
      * 班级级别(0: 初级班 1: 培优班 2: 冲刺提分班 3: 竞赛班)。
      */
+    @ApiModelProperty(value = "班级级别(0: 初级班 1: 培优班 2: 冲刺提分班 3: 竞赛班)")
     private Integer classLevel;
 
     /**
      * 创建用户。
      */
+    @ApiModelProperty(value = "创建用户")
     private Long createUserId;
 
     /**
      * 班级创建时间。
      */
+    @ApiModelProperty(value = "班级创建时间")
     private Date createTime;
 
     /**
      * schoolId 字典关联数据。
      */
+    @ApiModelProperty(value = "schoolId 字典关联数据")
     private Map<String, Object> schoolIdDictMap;
 
     /**
      * leaderId 字典关联数据。
      */
+    @ApiModelProperty(value = "leaderId 字典关联数据")
     private Map<String, Object> leaderIdDictMap;
 
     /**
      * classLevel 常量字典关联数据。
      */
+    @ApiModelProperty(value = "classLevel 常量字典关联数据")
     private Map<String, Object> classLevelDictMap;
 }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/app/vo/StudentVo.java

@@ -1,5 +1,7 @@
 package com.orange.demo.app.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Date;
@@ -11,121 +13,145 @@ import java.util.Map;
  * @author Jerry
  * @date 2020-09-24
  */
+@ApiModel("StudentVO实体对象")
 @Data
 public class StudentVo {
 
     /**
      * 学生Id。
      */
+    @ApiModelProperty(value = "学生Id")
     private Long studentId;
 
     /**
      * 登录手机。
      */
+    @ApiModelProperty(value = "登录手机")
     private String loginMobile;
 
     /**
      * 学生姓名。
      */
+    @ApiModelProperty(value = "学生姓名")
     private String studentName;
 
     /**
      * 所在省份Id。
      */
+    @ApiModelProperty(value = "所在省份Id")
     private Long provinceId;
 
     /**
      * 所在城市Id。
      */
+    @ApiModelProperty(value = "所在城市Id")
     private Long cityId;
 
     /**
      * 区县Id。
      */
+    @ApiModelProperty(value = "区县Id")
     private Long districtId;
 
     /**
      * 学生性别 (0: 女生 1: 男生)。
      */
+    @ApiModelProperty(value = "学生性别 (0: 女生 1: 男生)")
     private Integer gender;
 
     /**
      * 生日。
      */
+    @ApiModelProperty(value = "生日")
     private Date birthday;
 
     /**
      * 经验等级 (0: 初级 1: 中级 2: 高级 3: 资深)。
      */
+    @ApiModelProperty(value = "经验等级 (0: 初级 1: 中级 2: 高级 3: 资深)")
     private Integer experienceLevel;
 
     /**
      * 总共充值学币数量。
      */
+    @ApiModelProperty(value = "总共充值学币数量")
     private Integer totalCoin;
 
     /**
      * 可用学币数量。
      */
+    @ApiModelProperty(value = "可用学币数量")
     private Integer leftCoin;
 
     /**
      * 年级Id。
      */
+    @ApiModelProperty(value = "年级Id")
     private Integer gradeId;
 
     /**
      * 校区Id。
      */
+    @ApiModelProperty(value = "校区Id")
     private Long schoolId;
 
     /**
      * 注册时间。
      */
+    @ApiModelProperty(value = "注册时间")
     private Date registerTime;
 
     /**
      * 学生状态 (0: 正常 1: 锁定 2: 注销)。
      */
+    @ApiModelProperty(value = "学生状态 (0: 正常 1: 锁定 2: 注销)")
     private Integer status;
 
     /**
      * provinceId 字典关联数据。
      */
+    @ApiModelProperty(value = "provinceId 字典关联数据")
     private Map<String, Object> provinceIdDictMap;
 
     /**
      * cityId 字典关联数据。
      */
+    @ApiModelProperty(value = "cityId 字典关联数据")
     private Map<String, Object> cityIdDictMap;
 
     /**
      * districtId 字典关联数据。
      */
+    @ApiModelProperty(value = "districtId 字典关联数据")
     private Map<String, Object> districtIdDictMap;
 
     /**
      * gradeId 字典关联数据。
      */
+    @ApiModelProperty(value = "gradeId 字典关联数据")
     private Map<String, Object> gradeIdDictMap;
 
     /**
      * schoolId 字典关联数据。
      */
+    @ApiModelProperty(value = "schoolId 字典关联数据")
     private Map<String, Object> schoolIdDictMap;
 
     /**
      * gender 常量字典关联数据。
      */
+    @ApiModelProperty(value = "gender 常量字典关联数据")
     private Map<String, Object> genderDictMap;
 
     /**
      * experienceLevel 常量字典关联数据。
      */
+    @ApiModelProperty(value = "experienceLevel 常量字典关联数据")
     private Map<String, Object> experienceLevelDictMap;
 
     /**
      * status 常量字典关联数据。
      */
+    @ApiModelProperty(value = "status 常量字典关联数据")
     private Map<String, Object> statusDictMap;
 }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/upms/controller/LoginController.java

@@ -1,6 +1,10 @@
 package com.orange.demo.upms.controller;
 
 import com.alibaba.fastjson.JSONObject;
+import com.github.xiaoymin.knife4j.annotations.ApiSupport;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiImplicitParam;
+import io.swagger.annotations.ApiImplicitParams;
 import lombok.extern.slf4j.Slf4j;
 import com.orange.demo.config.ApplicationConfig;
 import com.orange.demo.upms.service.*;
@@ -29,6 +33,8 @@ import java.util.*;
  * @author Jerry
  * @date 2020-09-24
  */
+@ApiSupport(order = 1)
+@Api(tags = "用户登录接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/login")
@@ -50,6 +56,12 @@ public class LoginController {
      * @param password  密码。
      * @return 应答结果对象，其中包括JWT的Token数据，以及菜单列表。
      */
+    @ApiImplicitParams({
+            // 这里包含密码密文，仅用于方便开发期间的接口测试，集成测试和发布阶段，需要将当前注解去掉。
+            // 如果您重新生成了公钥和私钥，请替换password的缺省值。
+            @ApiImplicitParam(name = "loginName", defaultValue = "admin"),
+            @ApiImplicitParam(name = "password", defaultValue = "IP3ccke3GhH45iGHB5qP9p7iZw6xUyj28Ju10rnBiPKOI35sc%2BjI7%2FdsjOkHWMfUwGYGfz8ik31HC2Ruk%2Fhkd9f6RPULTHj7VpFdNdde2P9M4mQQnFBAiPM7VT9iW3RyCtPlJexQ3nAiA09OqG%2F0sIf1kcyveSrulxembARDbDo%3D")
+    })
     @NoAuthInterface
     @PostMapping("/doLogin")
     public ResponseResult<JSONObject> doLogin(

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/upms/controller/SysUserController.java

@@ -2,6 +2,7 @@ package com.orange.demo.upms.controller;
 
 import com.github.pagehelper.page.PageMethod;
 import com.orange.demo.upms.vo.*;
+import com.orange.demo.upms.dto.*;
 import com.orange.demo.upms.model.*;
 import com.orange.demo.upms.service.*;
 import com.orange.demo.common.core.object.*;
@@ -11,6 +12,8 @@ import com.orange.demo.common.core.annotation.MyRequestBody;
 import com.orange.demo.common.core.validator.AddGroup;
 import com.orange.demo.common.core.validator.UpdateGroup;
 import com.orange.demo.config.ApplicationConfig;
+import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
+import io.swagger.annotations.Api;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.security.crypto.password.PasswordEncoder;
 import org.springframework.beans.factory.annotation.Autowired;
@@ -25,6 +28,7 @@ import javax.validation.groups.Default;
  * @author Jerry
  * @date 2020-09-24
  */
+@Api(tags = "用户管理管理接口")
 @Slf4j
 @RestController
 @RequestMapping("/admin/upms/sysUser")
@@ -40,15 +44,20 @@ public class SysUserController {
     /**
      * 新增用户操作。
      *
-     * @param sysUser 新增用户对象。
+     * @param sysUserDto 新增用户对象。
      * @return 应答结果对象，包含新增用户的主键Id。
      */
+    @ApiOperationSupport(ignoreParameters = {
+            "sysUser.userId",
+            "sysUser.createTimeStart",
+            "sysUser.createTimeEnd"})
     @PostMapping("/add")
-    public ResponseResult<Long> add(@MyRequestBody SysUser sysUser) {
-        String errorMessage = MyCommonUtil.getModelValidationError(sysUser, Default.class, AddGroup.class);
+    public ResponseResult<Long> add(@MyRequestBody("sysUser") SysUserDto sysUserDto) {
+        String errorMessage = MyCommonUtil.getModelValidationError(sysUserDto, Default.class, AddGroup.class);
         if (errorMessage != null) {
             return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
         }
+        SysUser sysUser = MyModelUtil.copyTo(sysUserDto, SysUser.class);
         CallResult result = sysUserService.verifyRelatedData(sysUser, null);
         if (!result.isSuccess()) {
             return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, result.getErrorMessage());
@@ -60,19 +69,23 @@ public class SysUserController {
     /**
      * 更新用户操作。
      *
-     * @param sysUser 更新用户对象。
+     * @param sysUserDto 更新用户对象。
      * @return 应答结果对象。
      */
+    @ApiOperationSupport(ignoreParameters = {
+            "sysUser.createTimeStart",
+            "sysUser.createTimeEnd"})
     @PostMapping("/update")
-    public ResponseResult<Void> update(@MyRequestBody SysUser sysUser) {
-        String errorMessage = MyCommonUtil.getModelValidationError(sysUser, Default.class, UpdateGroup.class);
+    public ResponseResult<Void> update(@MyRequestBody("sysUser") SysUserDto sysUserDto) {
+        String errorMessage = MyCommonUtil.getModelValidationError(sysUserDto, Default.class, UpdateGroup.class);
         if (errorMessage != null) {
             return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
         }
-        SysUser originalUser = sysUserService.getById(sysUser.getUserId());
+        SysUser originalUser = sysUserService.getById(sysUserDto.getUserId());
         if (originalUser == null) {
             return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST);
         }
+        SysUser sysUser = MyModelUtil.copyTo(sysUserDto, SysUser.class);
         CallResult result = sysUserService.verifyRelatedData(sysUser, originalUser);
         if (!result.isSuccess()) {
             return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, result.getErrorMessage());
@@ -129,19 +142,20 @@ public class SysUserController {
     /**
      * 列出符合过滤条件的用户管理列表。
      *
-     * @param sysUserFilter 过滤对象。
+     * @param sysUserDtoFilter 过滤对象。
      * @param orderParam 排序参数。
      * @param pageParam 分页参数。
      * @return 应答结果对象，包含查询结果集。
      */
     @PostMapping("/list")
     public ResponseResult<MyPageData<SysUserVo>> list(
-            @MyRequestBody SysUser sysUserFilter,
+            @MyRequestBody("sysUserFilter") SysUserDto sysUserDtoFilter,
             @MyRequestBody MyOrderParam orderParam,
             @MyRequestBody MyPageParam pageParam) {
         if (pageParam != null) {
             PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize());
         }
+        SysUser sysUserFilter = MyModelUtil.copyTo(sysUserDtoFilter, SysUser.class);
         String orderBy = MyOrderParam.buildOrderBy(orderParam, SysUser.class);
         List<SysUser> sysUserList = sysUserService.getSysUserListWithRelation(sysUserFilter, orderBy);
         return ResponseResult.success(MyPageUtil.makeResponseData(sysUserList, SysUser.INSTANCE));

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/upms/dao/mapper/SysUserMapper.xml

@@ -11,7 +11,7 @@
         <result column="user_status" jdbcType="INTEGER" property="userStatus"/>
         <result column="deleted_flag" jdbcType="INTEGER" property="deletedFlag"/>
         <result column="create_user_id" jdbcType="BIGINT" property="createUserId"/>
-        <result column="create_username" jdbcType="VARCHAR" property="createUsername"/>
+        <result column="update_user_id" jdbcType="BIGINT" property="updateUserId"/>
         <result column="create_time" jdbcType="TIMESTAMP" property="createTime"/>
         <result column="update_time" jdbcType="TIMESTAMP" property="updateTime"/>
     </resultMap>

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/upms/dto/SysUserDto.java

@@ -0,0 +1,86 @@
+package com.orange.demo.upms.dto;
+
+import com.orange.demo.common.core.validator.AddGroup;
+import com.orange.demo.common.core.validator.UpdateGroup;
+import com.orange.demo.common.core.validator.ConstDictRef;
+import com.orange.demo.upms.model.constant.SysUserType;
+import com.orange.demo.upms.model.constant.SysUserStatus;
+
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import javax.validation.constraints.*;
+
+/**
+ * SysUserDto对象。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@ApiModel("SysUserDto对象")
+@Data
+public class SysUserDto {
+
+    /**
+     * 用户Id。
+     */
+    @ApiModelProperty(value = "用户Id", required = true)
+    @NotNull(message = "数据验证失败，用户Id不能为空！", groups = {UpdateGroup.class})
+    private Long userId;
+
+    /**
+     * 登录用户名。
+     */
+    @ApiModelProperty(value = "登录用户名", required = true)
+    @NotBlank(message = "数据验证失败，登录用户名不能为空！")
+    private String loginName;
+
+    /**
+     * 用户密码。
+     */
+    @ApiModelProperty(value = "用户密码", required = true)
+    @NotBlank(message = "数据验证失败，用户密码不能为空！", groups = {AddGroup.class})
+    private String password;
+
+    /**
+     * 用户显示名称。
+     */
+    @ApiModelProperty(value = "用户显示名称", required = true)
+    @NotBlank(message = "数据验证失败，用户显示名称不能为空！")
+    private String showName;
+
+    /**
+     * 用户类型(0: 管理员 1: 系统管理用户 2: 系统业务用户)。
+     */
+    @ApiModelProperty(value = "用户类型(0: 管理员 1: 系统管理用户 2: 系统业务用户)", required = true)
+    @NotNull(message = "数据验证失败，用户类型(0: 管理员 1: 系统管理用户 2: 系统业务用户)不能为空！")
+    @ConstDictRef(constDictClass = SysUserType.class, message = "数据验证失败，用户类型(0: 管理员 1: 系统管理用户 2: 系统业务用户)为无效值！")
+    private Integer userType;
+
+    /**
+     * 用户头像的Url。
+     */
+    @ApiModelProperty(value = "用户头像的Url")
+    private String headImageUrl;
+
+    /**
+     * 用户状态(0: 正常 1: 锁定)。
+     */
+    @ApiModelProperty(value = "用户状态(0: 正常 1: 锁定)", required = true)
+    @NotNull(message = "数据验证失败，用户状态(0: 正常 1: 锁定)不能为空！")
+    @ConstDictRef(constDictClass = SysUserStatus.class, message = "数据验证失败，用户状态(0: 正常 1: 锁定)为无效值！")
+    private Integer userStatus;
+
+    /**
+     * createTime 范围过滤起始值(>=)。
+     */
+    @ApiModelProperty(value = "createTime 范围过滤起始值(>=)")
+    private String createTimeStart;
+
+    /**
+     * createTime 范围过滤结束值(<=)。
+     */
+    @ApiModelProperty(value = "createTime 范围过滤结束值(<=)")
+    private String createTimeEnd;
+}

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/upms/model/SysUser.java

@@ -6,15 +6,11 @@ import com.orange.demo.upms.model.constant.SysUserStatus;
 import com.orange.demo.common.core.annotation.RelationConstDict;
 import com.orange.demo.common.core.base.mapper.BaseModelMapper;
 import com.orange.demo.common.core.annotation.DeletedFlagColumn;
-import com.orange.demo.common.core.validator.AddGroup;
-import com.orange.demo.common.core.validator.UpdateGroup;
-import com.orange.demo.common.core.validator.ConstDictRef;
 import com.orange.demo.upms.vo.SysUserVo;
 import lombok.Data;
 import org.mapstruct.*;
 import org.mapstruct.factory.Mappers;
 import javax.persistence.*;
-import javax.validation.constraints.*;
 
 import java.util.Date;
 import java.util.Map;
@@ -32,7 +28,6 @@ public class SysUser {
     /**
      * 用户Id。
      */
-    @NotNull(message = "数据验证失败，用户Id不能为空！", groups = {UpdateGroup.class})
     @Id
     @Column(name = "user_id")
     private Long userId;
@@ -40,28 +35,23 @@ public class SysUser {
     /**
      * 登录用户名。
      */
-    @NotBlank(message = "数据验证失败，登录用户名不能为空！")
     @Column(name = "login_name")
     private String loginName;
 
     /**
      * 用户密码。
      */
-    @NotBlank(message = "数据验证失败，用户密码不能为空！", groups = {AddGroup.class})
     private String password;
 
     /**
      * 用户显示名称。
      */
-    @NotBlank(message = "数据验证失败，用户显示名称不能为空！")
     @Column(name = "show_name")
     private String showName;
 
     /**
      * 用户类型(0: 管理员 1: 系统管理用户 2: 系统业务用户)。
      */
-    @NotNull(message = "数据验证失败，用户类型(0: 管理员 1: 系统管理用户 2: 系统业务用户)不能为空！")
-    @ConstDictRef(constDictClass = SysUserType.class, message = "数据验证失败，用户类型(0: 管理员 1: 系统管理用户 2: 系统业务用户)为无效值！")
     @Column(name = "user_type")
     private Integer userType;
 
@@ -74,8 +64,6 @@ public class SysUser {
     /**
      * 用户状态(0: 正常 1: 锁定)。
      */
-    @NotNull(message = "数据验证失败，用户状态(0: 正常 1: 锁定)不能为空！")
-    @ConstDictRef(constDictClass = SysUserStatus.class, message = "数据验证失败，用户状态(0: 正常 1: 锁定)为无效值！")
     @Column(name = "user_status")
     private Integer userStatus;
 
@@ -94,10 +82,10 @@ public class SysUser {
     private Long createUserId;
 
     /**
-     * 创建用户名。
+     * 更新者Id。
      */
-    @Column(name = "create_username")
-    private String createUsername;
+    @Column(name = "update_user_id")
+    private Long updateUserId;
 
     /**
      * 创建时间。

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/upms/service/SysUserService.java

@@ -1,50 +1,18 @@
 package com.orange.demo.upms.service;
 
-import com.alibaba.fastjson.JSONObject;
-import com.orange.demo.upms.dao.*;
 import com.orange.demo.upms.model.*;
-import com.orange.demo.upms.model.constant.SysUserStatus;
-import com.orange.demo.common.core.base.dao.BaseDaoMapper;
-import com.orange.demo.common.core.constant.GlobalDeletedFlag;
-import com.orange.demo.common.core.object.TokenData;
-import com.orange.demo.common.core.object.MyWhereCriteria;
-import com.orange.demo.common.core.object.MyRelationParam;
 import com.orange.demo.common.core.object.CallResult;
-import com.orange.demo.common.core.base.service.BaseService;
-import com.orange.demo.common.sequence.wrapper.IdGeneratorWrapper;
-import org.springframework.transaction.annotation.Transactional;
-import org.springframework.security.crypto.password.PasswordEncoder;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.stereotype.Service;
-import tk.mybatis.mapper.entity.Example;
+import com.orange.demo.common.core.base.service.IBaseService;
 
 import java.util.*;
 
 /**
- * 用户管理数据操作服务类。
+ * 用户管理数据操作服务接口。
  *
  * @author Jerry
  * @date 2020-09-24
  */
-@Service
-public class SysUserService extends BaseService<SysUser, Long> {
-
-    @Autowired
-    private SysUserMapper sysUserMapper;
-    @Autowired
-    private IdGeneratorWrapper idGenerator;
-    @Autowired
-    private PasswordEncoder passwordEncoder;
-
-    /**
-     * 返回当前Service的主表Mapper对象。
-     *
-     * @return 主表Mapper对象。
-     */
-    @Override
-    protected BaseDaoMapper<SysUser> mapper() {
-        return sysUserMapper;
-    }
+public interface SysUserService extends IBaseService<SysUser, Long> {
 
     /**
      * 获取指定登录名的用户对象。
@@ -52,13 +20,7 @@ public class SysUserService extends BaseService<SysUser, Long> {
      * @param loginName 指定登录用户名。
      * @return 用户对象。
      */
-    public SysUser getSysUserByLoginName(String loginName) {
-        Example e = new Example(SysUser.class);
-        Example.Criteria c = e.createCriteria();
-        c.andEqualTo("loginName", loginName);
-        c.andEqualTo("deletedFlag", GlobalDeletedFlag.NORMAL);
-        return sysUserMapper.selectOneByExample(e);
-    }
+    SysUser getSysUserByLoginName(String loginName);
 
     /**
      * 保存新增的用户对象。
@@ -66,21 +28,7 @@ public class SysUserService extends BaseService<SysUser, Long> {
      * @param user 新增的用户对象。
      * @return 新增后的用户对象。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public SysUser saveNew(SysUser user) {
-        user.setUserId(idGenerator.nextLongId());
-        user.setPassword(passwordEncoder.encode(user.getPassword()));
-        user.setUserStatus(SysUserStatus.STATUS_NORMAL);
-        user.setDeletedFlag(GlobalDeletedFlag.NORMAL);
-        TokenData tokenData = TokenData.takeFromRequest();
-        user.setCreateUserId(tokenData.getUserId());
-        user.setCreateUsername(tokenData.getShowName());
-        Date now = new Date();
-        user.setCreateTime(now);
-        user.setUpdateTime(now);
-        sysUserMapper.insert(user);
-        return user;
-    }
+    SysUser saveNew(SysUser user);
 
     /**
      * 更新用户对象。
@@ -89,16 +37,7 @@ public class SysUserService extends BaseService<SysUser, Long> {
      * @param originalUser 原有的用户对象。
      * @return 更新成功返回true，否则false。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public boolean update(SysUser user, SysUser originalUser) {
-        user.setLoginName(originalUser.getLoginName());
-        user.setPassword(originalUser.getPassword());
-        user.setCreateUserId(originalUser.getCreateUserId());
-        user.setCreateUsername(originalUser.getCreateUsername());
-        user.setCreateTime(originalUser.getCreateTime());
-        user.setUpdateTime(new Date());
-        return sysUserMapper.updateByPrimaryKeySelective(user) == 1;
-    }
+    boolean update(SysUser user, SysUser originalUser);
 
     /**
      * 修改用户密码。
@@ -106,16 +45,7 @@ public class SysUserService extends BaseService<SysUser, Long> {
      * @param newPass 新密码。
      * @return 成功返回true，否则false。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public boolean changePassword(Long userId, String newPass) {
-        Example e = new Example(SysUser.class);
-        e.createCriteria()
-                .andEqualTo(super.idFieldName, userId)
-                .andEqualTo(super.deletedFlagFieldName, GlobalDeletedFlag.NORMAL);
-        SysUser updatedUser = new SysUser();
-        updatedUser.setPassword(passwordEncoder.encode(newPass));
-        return sysUserMapper.updateByExampleSelective(updatedUser, e) == 1;
-    }
+    boolean changePassword(Long userId, String newPass);
 
     /**
      * 删除指定数据。
@@ -123,17 +53,7 @@ public class SysUserService extends BaseService<SysUser, Long> {
      * @param userId 主键Id。
      * @return 成功返回true，否则false。
      */
-    @Transactional(rollbackFor = Exception.class)
-    public boolean remove(Long userId) {
-        Example sysUserExample = new Example(SysUser.class);
-        Example.Criteria c = sysUserExample.createCriteria();
-        c.andEqualTo(super.idFieldName, userId);
-        c.andEqualTo(super.deletedFlagFieldName, GlobalDeletedFlag.NORMAL);
-        // 这里先删除主数据
-        SysUser deletedObject = new SysUser();
-        deletedObject.setDeletedFlag(GlobalDeletedFlag.DELETED);
-        return sysUserMapper.updateByExampleSelective(deletedObject, sysUserExample) != 0;
-    }
+    boolean remove(Long userId);
 
     /**
      * 获取单表查询结果。由于没有关联数据查询，因此在仅仅获取单表数据的场景下，效率更高。
@@ -143,24 +63,18 @@ public class SysUserService extends BaseService<SysUser, Long> {
      * @param orderBy 排序参数。
      * @return 查询结果集。
      */
-    public List<SysUser> getSysUserList(SysUser filter, String orderBy) {
-        return sysUserMapper.getSysUserList(filter, orderBy);
-    }
+    List<SysUser> getSysUserList(SysUser filter, String orderBy);
 
     /**
      * 获取主表的查询结果，以及主表关联的字典数据和一对一从表数据，以及一对一从表的字典数据。
+     * 该查询会涉及到一对一从表的关联过滤，或一对多从表的嵌套关联过滤，因此性能不如单表过滤。
      * 如果仅仅需要获取主表数据，请移步(getSysUserList)，以便获取更好的查询性能。
      *
      * @param filter 主表过滤对象。
      * @param orderBy 排序参数。
      * @return 查询结果集。
      */
-    public List<SysUser> getSysUserListWithRelation(SysUser filter, String orderBy) {
-        List<SysUser> resultList = sysUserMapper.getSysUserList(filter, orderBy);
-        Map<String, List<MyWhereCriteria>> criteriaMap = buildAggregationAdditionalWhereCriteria();
-        this.buildRelationForDataList(resultList, MyRelationParam.normal(), criteriaMap);
-        return resultList;
-    }
+    List<SysUser> getSysUserListWithRelation(SysUser filter, String orderBy);
 
     /**
      * 验证用户对象关联的数据是否都合法。
@@ -169,8 +83,5 @@ public class SysUserService extends BaseService<SysUser, Long> {
      * @param originalSysUser 原有对象。
      * @return 验证结果。
      */
-    public CallResult verifyRelatedData(SysUser sysUser, SysUser originalSysUser) {
-        JSONObject jsonObject = new JSONObject();
-        return CallResult.ok(jsonObject);
-    }
+    CallResult verifyRelatedData(SysUser sysUser, SysUser originalSysUser);
 }

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/upms/service/impl/SysUserServiceImpl.java

@@ -0,0 +1,171 @@
+package com.orange.demo.upms.service.impl;
+
+import com.alibaba.fastjson.JSONObject;
+import com.orange.demo.upms.service.*;
+import com.orange.demo.upms.dao.*;
+import com.orange.demo.upms.model.*;
+import com.orange.demo.upms.model.constant.SysUserStatus;
+import com.orange.demo.common.core.base.dao.BaseDaoMapper;
+import com.orange.demo.common.core.constant.GlobalDeletedFlag;
+import com.orange.demo.common.core.object.MyRelationParam;
+import com.orange.demo.common.core.object.CallResult;
+import com.orange.demo.common.core.base.service.BaseService;
+import com.orange.demo.common.core.util.MyModelUtil;
+import com.orange.demo.common.sequence.wrapper.IdGeneratorWrapper;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.security.crypto.password.PasswordEncoder;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Service;
+import tk.mybatis.mapper.entity.Example;
+
+import java.util.*;
+
+/**
+ * 用户管理数据操作服务类。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@Service("sysUserService")
+public class SysUserServiceImpl extends BaseService<SysUser, Long> implements SysUserService {
+
+    @Autowired
+    private SysUserMapper sysUserMapper;
+    @Autowired
+    private IdGeneratorWrapper idGenerator;
+    @Autowired
+    private PasswordEncoder passwordEncoder;
+
+    /**
+     * 返回当前Service的主表Mapper对象。
+     *
+     * @return 主表Mapper对象。
+     */
+    @Override
+    protected BaseDaoMapper<SysUser> mapper() {
+        return sysUserMapper;
+    }
+
+    /**
+     * 获取指定登录名的用户对象。
+     *
+     * @param loginName 指定登录用户名。
+     * @return 用户对象。
+     */
+    @Override
+    public SysUser getSysUserByLoginName(String loginName) {
+        Example e = new Example(SysUser.class);
+        Example.Criteria c = e.createCriteria();
+        c.andEqualTo("loginName", loginName);
+        c.andEqualTo("deletedFlag", GlobalDeletedFlag.NORMAL);
+        return sysUserMapper.selectOneByExample(e);
+    }
+
+    /**
+     * 保存新增的用户对象。
+     *
+     * @param user 新增的用户对象。
+     * @return 新增后的用户对象。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public SysUser saveNew(SysUser user) {
+        user.setUserId(idGenerator.nextLongId());
+        user.setPassword(passwordEncoder.encode(user.getPassword()));
+        user.setUserStatus(SysUserStatus.STATUS_NORMAL);
+        user.setDeletedFlag(GlobalDeletedFlag.NORMAL);
+        MyModelUtil.fillCommonsForInsert(user);
+        sysUserMapper.insert(user);
+        return user;
+    }
+
+    /**
+     * 更新用户对象。
+     *
+     * @param user         更新的用户对象。
+     * @param originalUser 原有的用户对象。
+     * @return 更新成功返回true，否则false。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public boolean update(SysUser user, SysUser originalUser) {
+        user.setLoginName(originalUser.getLoginName());
+        user.setPassword(originalUser.getPassword());
+        MyModelUtil.fillCommonsForUpdate(user, originalUser);
+        user.setDeletedFlag(GlobalDeletedFlag.NORMAL);
+        return sysUserMapper.updateByPrimaryKey(user) == 1;
+    }
+
+    /**
+     * 修改用户密码。
+     * @param userId  用户主键Id。
+     * @param newPass 新密码。
+     * @return 成功返回true，否则false。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public boolean changePassword(Long userId, String newPass) {
+        Example e = new Example(SysUser.class);
+        e.createCriteria()
+                .andEqualTo(super.idFieldName, userId)
+                .andEqualTo(super.deletedFlagFieldName, GlobalDeletedFlag.NORMAL);
+        SysUser updatedUser = new SysUser();
+        updatedUser.setPassword(passwordEncoder.encode(newPass));
+        return sysUserMapper.updateByExampleSelective(updatedUser, e) == 1;
+    }
+
+    /**
+     * 删除指定数据。
+     *
+     * @param userId 主键Id。
+     * @return 成功返回true，否则false。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public boolean remove(Long userId) {
+        // 这里先删除主数据
+        return this.removeById(userId);
+    }
+
+    /**
+     * 获取单表查询结果。由于没有关联数据查询，因此在仅仅获取单表数据的场景下，效率更高。
+     * 如果需要同时获取关联数据，请移步(getSysUserListWithRelation)方法。
+     *
+     * @param filter  过滤对象。
+     * @param orderBy 排序参数。
+     * @return 查询结果集。
+     */
+    @Override
+    public List<SysUser> getSysUserList(SysUser filter, String orderBy) {
+        return sysUserMapper.getSysUserList(filter, orderBy);
+    }
+
+    /**
+     * 获取主表的查询结果，以及主表关联的字典数据和一对一从表数据，以及一对一从表的字典数据。
+     * 该查询会涉及到一对一从表的关联过滤，或一对多从表的嵌套关联过滤，因此性能不如单表过滤。
+     * 如果仅仅需要获取主表数据，请移步(getSysUserList)，以便获取更好的查询性能。
+     *
+     * @param filter 主表过滤对象。
+     * @param orderBy 排序参数。
+     * @return 查询结果集。
+     */
+    @Override
+    public List<SysUser> getSysUserListWithRelation(SysUser filter, String orderBy) {
+        List<SysUser> resultList = sysUserMapper.getSysUserList(filter, orderBy);
+        this.buildRelationForDataList(resultList, MyRelationParam.normal());
+        return resultList;
+    }
+
+    /**
+     * 验证用户对象关联的数据是否都合法。
+     *
+     * @param sysUser         当前操作的对象。
+     * @param originalSysUser 原有对象。
+     * @return 验证结果。
+     */
+    @Override
+    public CallResult verifyRelatedData(SysUser sysUser, SysUser originalSysUser) {
+        JSONObject jsonObject = new JSONObject();
+        return CallResult.ok(jsonObject);
+    }
+}

orange-demo-single-service-for-app/application/src/main/java/com/orange/demo/upms/vo/SysUserVo.java

@@ -1,5 +1,7 @@
 package com.orange.demo.upms.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
 import java.util.Date;
@@ -11,71 +13,85 @@ import java.util.Map;
  * @author Jerry
  * @date 2020-09-24
  */
+@ApiModel("SysUserVO实体对象")
 @Data
 public class SysUserVo {
 
     /**
      * 用户Id。
      */
+    @ApiModelProperty(value = "用户Id")
     private Long userId;
 
     /**
      * 登录用户名。
      */
+    @ApiModelProperty(value = "登录用户名")
     private String loginName;
 
     /**
      * 用户密码。
      */
+    @ApiModelProperty(value = "用户密码")
     private String password;
 
     /**
      * 用户显示名称。
      */
+    @ApiModelProperty(value = "用户显示名称")
     private String showName;
 
     /**
      * 用户类型(0: 管理员 1: 系统管理用户 2: 系统业务用户)。
      */
+    @ApiModelProperty(value = "用户类型(0: 管理员 1: 系统管理用户 2: 系统业务用户)")
     private Integer userType;
 
     /**
      * 用户头像的Url。
      */
+    @ApiModelProperty(value = "用户头像的Url")
     private String headImageUrl;
 
     /**
      * 用户状态(0: 正常 1: 锁定)。
      */
+    @ApiModelProperty(value = "用户状态(0: 正常 1: 锁定)")
     private Integer userStatus;
 
     /**
      * 创建用户Id。
      */
+    @ApiModelProperty(value = "创建用户Id")
     private Long createUserId;
 
     /**
-     * 创建用户名。
+     * 更新者Id。
      */
-    private String createUsername;
+    @ApiModelProperty(value = "更新者Id")
+    private Long updateUserId;
 
     /**
      * 创建时间。
      */
+    @ApiModelProperty(value = "创建时间")
     private Date createTime;
 
     /**
      * 更新时间。
      */
+    @ApiModelProperty(value = "更新时间")
     private Date updateTime;
 
     /**
      * userType 常量字典关联数据。
      */
+    @ApiModelProperty(value = "userType 常量字典关联数据")
     private Map<String, Object> userTypeDictMap;
 
     /**
      * userStatus 常量字典关联数据。
      */
+    @ApiModelProperty(value = "userStatus 常量字典关联数据")
     private Map<String, Object> userStatusDictMap;
 }

orange-demo-single-service-for-app/application/src/main/resources/application.yml

@@ -56,6 +56,15 @@ pagehelper:
   supportMethodsArguments: false
   params: count=countSql
 
+swagger:
+  # 当enabled为false的时候，则可禁用swagger。
+  enabled: true
+  # 工程的基础包名。
+  basePackage: com.orange.demo
+  title: 橙单单体服务工程
+  description: 橙单单体服务工程详情
+  version: 1.0
+
 # 暴露监控端点
 management:
   endpoints:

orange-demo-single-service-for-app/application/src/main/resources/log4j2.xml

@@ -53,6 +53,9 @@
         <root level="${OUTPUT_LOG_LEVEL}">
             <AppenderRef ref="console"/>
         </root>
+        <Logger name="springfox.documentation" additivity="false" level="error">
+            <AppenderRef ref="console"/>
+        </Logger>
         <Logger name="com.orange.demo" additivity="false" level="info">
             <AppenderRef ref="console"/>
             <AppenderRef ref="file_log"/>

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/advice/MyExceptionHandler.java

@@ -2,7 +2,6 @@ package com.orange.demo.common.core.advice;
 
 import com.orange.demo.common.core.exception.*;
 import com.orange.demo.common.core.constant.ErrorCodeEnum;
-import com.orange.demo.common.core.exception.RedisCacheAccessException;
 import com.orange.demo.common.core.object.ResponseResult;
 import com.orange.demo.common.core.util.ContextUtil;
 import lombok.extern.slf4j.Slf4j;

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/annotation/RelationDict.java

@@ -1,5 +1,7 @@
 package com.orange.demo.common.core.annotation;
 
+import com.orange.demo.common.core.object.DummyClass;
+
 import java.lang.annotation.*;
 
 /**
@@ -43,10 +45,18 @@ public @interface RelationDict {
 
     /**
      * 被关联的本地Service对象名称。
+     * 该参数的优先级高于 slaveService()，如果定义了该值，会优先使用加载service的bean对象。
      *
      * @return 被关联的本地Service对象名称。
      */
-    String slaveServiceName();
+    String slaveServiceName() default "";
+
+    /**
+     * 被关联的本地Service对象CLass类型。
+     *
+     * @return 被关联的本地Service对象CLass类型。
+     */
+    Class<?> slaveServiceClass() default DummyClass.class;
 
     /**
      * 在同一个实体对象中，如果有一对一关联和字典关联，都是基于相同的主表字段，并关联到

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/annotation/RelationManyToManyAggregation.java

@@ -1,5 +1,7 @@
 package com.orange.demo.common.core.annotation;
 
+import com.orange.demo.common.core.object.DummyClass;
+
 import java.lang.annotation.*;
 
 /**
@@ -22,10 +24,18 @@ public @interface RelationManyToManyAggregation {
 
     /**
      * 被关联的本地Service对象名称。
+     * 该参数的优先级高于 slaveService()，如果定义了该值，会优先使用加载service的bean对象。
      *
      * @return 被关联的本地Service对象名称。
      */
-    String slaveServiceName();
+    String slaveServiceName() default "";
+
+    /**
+     * 被关联的本地Service对象CLass类型。
+     *
+     * @return 被关联的本地Service对象CLass类型。
+     */
+    Class<?> slaveServiceClass() default DummyClass.class;
 
     /**
      * 多对多从表Model对象的Class对象。

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/annotation/RelationOneToMany.java

@@ -0,0 +1,53 @@
+package com.orange.demo.common.core.annotation;
+
+import com.orange.demo.common.core.object.DummyClass;
+
+import java.lang.annotation.*;
+
+/**
+ * 标识Model之间的一对多关联关系。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@Target({ElementType.FIELD, ElementType.METHOD})
+@Retention(RetentionPolicy.RUNTIME)
+@Documented
+public @interface RelationOneToMany {
+
+    /**
+     * 当前对象的关联Id字段名称。
+     *
+     * @return 当前对象的关联Id字段名称。
+     */
+    String masterIdField();
+
+    /**
+     * 被关联Model对象的Class对象。
+     *
+     * @return 被关联Model对象的Class对象。
+     */
+    Class<?> slaveModelClass();
+
+    /**
+     * 被关联Model对象的关联Id字段名称。
+     *
+     * @return 被关联Model对象的关联Id字段名称。
+     */
+    String slaveIdField();
+
+    /**
+     * 被关联的本地Service对象名称。
+     * 该参数的优先级高于 slaveService()，如果定义了该值，会优先使用加载service的bean对象。
+     *
+     * @return 被关联的本地Service对象名称。
+     */
+    String slaveServiceName() default "";
+
+    /**
+     * 被关联的本地Service对象CLass类型。
+     *
+     * @return 被关联的本地Service对象CLass类型。
+     */
+    Class<?> slaveServiceClass() default DummyClass.class;
+}

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/annotation/RelationOneToManyAggregation.java

@@ -1,5 +1,7 @@
 package com.orange.demo.common.core.annotation;
 
+import com.orange.demo.common.core.object.DummyClass;
+
 import java.lang.annotation.*;
 
 /**
@@ -22,10 +24,18 @@ public @interface RelationOneToManyAggregation {
 
     /**
      * 被关联的本地Service对象名称。
+     * 该参数的优先级高于 slaveService()，如果定义了该值，会优先使用加载service的bean对象。
      *
      * @return 被关联的本地Service对象名称。
      */
-    String slaveServiceName();
+    String slaveServiceName() default "";
+
+    /**
+     * 被关联的本地Service对象CLass类型。
+     *
+     * @return 被关联的本地Service对象CLass类型。
+     */
+    Class<?> slaveServiceClass() default DummyClass.class;
 
     /**
      * 被关联Model对象的Class对象。

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/annotation/RelationOneToOne.java

@@ -1,5 +1,7 @@
 package com.orange.demo.common.core.annotation;
 
+import com.orange.demo.common.core.object.DummyClass;
+
 import java.lang.annotation.*;
 
 /**
@@ -36,10 +38,18 @@ public @interface RelationOneToOne {
 
     /**
      * 被关联的本地Service对象名称。
+     * 该参数的优先级高于 slaveService()，如果定义了该值，会优先使用加载service的bean对象。
      *
      * @return 被关联的本地Service对象名称。
      */
-    String slaveServiceName();
+    String slaveServiceName() default "";
+
+    /**
+     * 被关联的本地Service对象CLass类型。
+     *
+     * @return 被关联的本地Service对象CLass类型。
+     */
+    Class<?> slaveServiceClass() default DummyClass.class;
 
     /**
      * 在一对一关联时，是否加载从表的字典关联。

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/aop/DictCacheSyncAop.java

@@ -0,0 +1,62 @@
+package com.orange.demo.common.core.aop;
+
+import com.orange.demo.common.core.base.service.BaseDictService;
+import lombok.extern.slf4j.Slf4j;
+import org.aspectj.lang.ProceedingJoinPoint;
+import org.aspectj.lang.annotation.Around;
+import org.aspectj.lang.annotation.Aspect;
+import org.aspectj.lang.annotation.Pointcut;
+import org.springframework.core.Ordered;
+import org.springframework.core.annotation.Order;
+import org.springframework.stereotype.Component;
+
+/**
+ * 字典缓存同步的AOP。该AOP的优先级必须比事务切面的优先级高，因此会在事务外执行该切面的代码。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@Aspect
+@Component
+@Order(Ordered.LOWEST_PRECEDENCE - 1)
+@Slf4j
+public class DictCacheSyncAop {
+
+    /**
+     * BaseDictService 字典服务父类中的字典数据增删改的方法。
+     */
+    @Pointcut("execution(public * com.orange.demo..BaseDictService.saveNew (..)) " +
+            "|| execution(public * com.orange.demo..BaseDictService.update (..)) " +
+            "|| execution(public * com.orange.demo..BaseDictService.remove (..))" )
+    public void baseDictServicePointCut() {
+        // 空注释，避免sonar警告
+    }
+
+    @SuppressWarnings("unchecked")
+    @Around("baseDictServicePointCut()")
+    public Object around(ProceedingJoinPoint joinPoint) throws Throwable {
+        String methodName = joinPoint.getSignature().getName();
+        Object arg = joinPoint.getArgs()[0];
+        if ("saveNew".equals(methodName)) {
+            Object data = joinPoint.proceed();
+            BaseDictService<Object, Object> service =
+                    (BaseDictService<Object, Object>) joinPoint.getTarget();
+            // 这里参数必须使用saveNew方法的返回对象，因为里面包含实际主键值。
+            service.putDictionaryCache(data);
+            return data;
+        } else if ("update".equals(methodName)) {
+            Object data = joinPoint.proceed();
+            BaseDictService<Object, Object> service =
+                    (BaseDictService<Object, Object>) joinPoint.getTarget();
+            // update的方法返回的是boolean，因此这里的参数需要使用第一个参数即可。
+            service.putDictionaryCache(arg);
+            return data;
+        } else {
+            // remove
+            BaseDictService<Object, Object> service =
+                    (BaseDictService<Object, Object>) joinPoint.getTarget();
+            service.removeDictionaryCache(arg);
+            return joinPoint.proceed();
+        }
+    }
+}

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/base/mapper/BaseModelMapper.java

@@ -86,7 +86,7 @@ public interface BaseModelMapper<D, M> {
      * @return 转换后的bean对象。
      */
     default <T> T mapToBean(Map<String, Object> map, Class<T> beanClazz) {
-        return BeanUtil.mapToBean(map, beanClazz, true);
+        return BeanUtil.toBeanIgnoreError(map, beanClazz);
     }
 
     /**
@@ -102,7 +102,7 @@ public interface BaseModelMapper<D, M> {
             return new LinkedList<>();
         }
         return mapList.stream()
-                .map(m -> BeanUtil.mapToBean(m, beanClazz, true))
+                .map(m -> BeanUtil.toBeanIgnoreError(m, beanClazz))
                 .collect(Collectors.toList());
     }
 

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/base/service/BaseDictService.java

@@ -1,13 +1,15 @@
 package com.orange.demo.common.core.base.service;
 
-import com.orange.demo.common.core.cache.DictionaryCache;
+import cn.hutool.core.util.ReflectUtil;
 import com.orange.demo.common.core.constant.GlobalDeletedFlag;
+import com.orange.demo.common.core.exception.MyRuntimeException;
+import com.orange.demo.common.core.cache.DictionaryCache;
 import lombok.extern.slf4j.Slf4j;
 import org.apache.commons.collections4.CollectionUtils;
+import org.springframework.transaction.annotation.Transactional;
 import tk.mybatis.mapper.entity.Example;
 
-import java.util.Set;
-import java.util.List;
+import java.util.*;
 
 /**
  * 带有缓存功能的字典Service基类，需要留意的是，由于缓存基于Key/Value方式存储，
@@ -19,7 +21,7 @@ import java.util.List;
  * @date 2020-09-24
  */
 @Slf4j
-public abstract class BaseDictService<M, K> extends BaseService<M, K> {
+public abstract class BaseDictService<M, K> extends BaseService<M, K> implements IBaseDictService<M, K> {
 
     /**
      * 缓存池对象。
@@ -38,6 +40,7 @@ public abstract class BaseDictService<M, K> extends BaseService<M, K> {
      *
      * @return true表示启动即可加载数据，false需要手动调用loadCachedData进行加载。
      */
+    @Override
     public boolean loadOnStartup() {
         return true;
     }
@@ -45,6 +48,7 @@ public abstract class BaseDictService<M, K> extends BaseService<M, K> {
     /**
      * 在系统启动时，加载全部数据到内存，缓存的key只能为映射表的主键。
      */
+    @Override
     public void loadCachedData() {
         if (loadOnStartup()) {
             reloadCachedData(false);
@@ -56,6 +60,7 @@ public abstract class BaseDictService<M, K> extends BaseService<M, K> {
      *
      * @param force true则强制刷新，如果false，当缓存中存在数据时不刷新。
      */
+    @Override
     public void reloadCachedData(boolean force) {
         // 在非强制刷新情况下。
         // 先行判断缓存中是否存在数据，如果有就不加载了。
@@ -67,14 +72,76 @@ public abstract class BaseDictService<M, K> extends BaseService<M, K> {
     }
 
     /**
-     * 直接从缓存池中获取主键Id关联的数据。
+     * 保存新增对象。
+     *
+     * @param data 新增对象。
+     * @return 返回新增对象。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public M saveNew(M data) {
+        if (deletedFlagFieldName != null) {
+            try {
+                setDeletedFlagMethod.invoke(data, GlobalDeletedFlag.NORMAL);
+            } catch (Exception e) {
+                log.error("Failed to call reflection [setDeletedFlagMethod] in BaseDictService.saveNew.", e);
+                throw new MyRuntimeException(e);
+            }
+        }
+        mapper().insert(data);
+        return data;
+    }
+
+    /**
+     * 更新数据对象。
+     *
+     * @param data         更新的对象。
+     * @param originalData 原有数据对象。
+     * @return 成功返回true，否则false。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public boolean update(M data, M originalData) {
+        if (deletedFlagFieldName != null) {
+            try {
+                setDeletedFlagMethod.invoke(data, GlobalDeletedFlag.NORMAL);
+            } catch (Exception e) {
+                log.error("Failed to call reflection [setDeletedFlagMethod] in BaseDictService.update.", e);
+                throw new MyRuntimeException(e);
+            }
+        }
+        return mapper().updateByPrimaryKey(data) == 1;
+    }
+
+    /**
+     * 删除指定数据。
+     *
+     * @param id 主键Id。
+     * @return 成功返回true，否则false。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public boolean remove(K id) {
+        return this.removeById(id);
+    }
+
+    /**
+     * 直接从缓存池中获取主键Id关联的数据。如果缓存中不存在，再从数据库中取出并回写到缓存。
      *
      * @param id 主键Id。
      * @return 主键关联的数据，不存在返回null。
      */
     @Override
     public M getById(K id) {
-        return dictionaryCache.get(id);
+        M data = dictionaryCache.get(id);
+        if (data != null) {
+            return data;
+        }
+        data = super.getById(id);
+        if (data != null) {
+            this.dictionaryCache.put(id, data);
+        }
+        return data;
     }
 
     /**
@@ -83,19 +150,54 @@ public abstract class BaseDictService<M, K> extends BaseService<M, K> {
      * @return 返回所有数据。
      */
     @Override
-    public List<M> getAllList() {
+    public List<M> getAllListFromCache() {
         return dictionaryCache.getAll();
     }
 
     /**
      * 直接从缓存池中返回符合主键 in (idValues) 条件的所有数据。
+     * 对于缓存中不存在的数据，从数据库中获取并回写入缓存。
      *
      * @param idValues 主键值列表。
      * @return 检索后的数据列表。
      */
+    @SuppressWarnings("unchecked")
     @Override
     public List<M> getInList(Set<K> idValues) {
-        return dictionaryCache.getInList(idValues);
+        List<M> resultList = dictionaryCache.getInList(idValues);
+        if (resultList.size() == idValues.size()) {
+            return resultList;
+        }
+        Set<K> cachedIdList = new HashSet<>();
+        for (M data : resultList) {
+            try {
+                cachedIdList.add((K) getIdFieldMethod.invoke(data));
+            } catch (Exception e) {
+                log.error("Failed to call reflection method in BaseDictService.getInList.", e);
+                throw new MyRuntimeException(e);
+            }
+        }
+        // 找到未缓存的数据，然后从数据库读取后缓存。
+        Set<K> uncachedIdList = new HashSet<>();
+        for (K id : idValues) {
+            if (!cachedIdList.contains(id)) {
+                uncachedIdList.add(id);
+            }
+        }
+        List<M> uncachedResultList = super.getInList(uncachedIdList);
+        if (CollectionUtils.isNotEmpty(uncachedResultList)) {
+            for (M data : uncachedResultList) {
+                try {
+                    K id = (K) getIdFieldMethod.invoke(data);
+                    this.dictionaryCache.put(id, data);
+                } catch (Exception e) {
+                    log.error("Failed to call reflection method in BaseDictService.getInList.", e);
+                    throw new MyRuntimeException(e);
+                }
+            }
+            resultList.addAll(uncachedResultList);
+        }
+        return resultList;
     }
 
     /**
@@ -105,13 +207,13 @@ public abstract class BaseDictService<M, K> extends BaseService<M, K> {
      * @param inFilterValues 参与(In-list)过滤的Java字段值集合。
      * @return 检索后的数据列表。
      */
-    @Override
     @SuppressWarnings("unchecked")
+    @Override
     public <T> List<M> getInList(String inFilterField, Set<T> inFilterValues) {
         if (inFilterField.equals(this.idFieldName)) {
             return this.getInList((Set<K>) inFilterValues);
         }
-        return this.getInList(inFilterField, inFilterValues, (String) null);
+        return this.getInList(inFilterField, inFilterValues);
     }
 
     /**
@@ -121,28 +223,48 @@ public abstract class BaseDictService<M, K> extends BaseService<M, K> {
      * @param inFilterValues 数据值集合。
      * @return 全部存在返回true，否则false。
      */
-    @Override
     @SuppressWarnings("unchecked")
+    @Override
     public <T> boolean existUniqueKeyList(String inFilterField, Set<T> inFilterValues) {
         if (CollectionUtils.isEmpty(inFilterValues)) {
             return true;
         }
         if (inFilterField.equals(this.idFieldName)) {
-            List<M> dataList = dictionaryCache.getInList((Set<K>) inFilterValues);
+            List<M> dataList = this.getInList((Set<K>) inFilterValues);
             return dataList.size() == inFilterValues.size();
         }
         Example e = this.makeDefaultInListExample(inFilterField, inFilterValues, null);
-        if (deletedFlagFieldName != null) {
-            e.and().andEqualTo(deletedFlagFieldName, GlobalDeletedFlag.NORMAL);
-        }
         return mapper().selectCountByExample(e) == inFilterValues.size();
     }
 
+    /**
+     * 存入缓存。
+     *
+     * @param data 新增或更新数据。
+     */
+    @SuppressWarnings("unchecked")
+    @Override
+    public void putDictionaryCache(M data) {
+        K key = (K) ReflectUtil.getFieldValue(data, idFieldName);
+        this.dictionaryCache.put(key, data);
+    }
+
+    /**
+     * 根据字典主键将数据从缓存中删除。
+     *
+     * @param id 字典主键。
+     */
+    @Override
+    public void removeDictionaryCache(K id) {
+        this.dictionaryCache.invalidate(id);
+    }
+
     /**
      * 获取缓存中的数据数量。
      *
      * @return 缓存中的数据总量。
      */
+    @Override
     public int getCachedCount() {
         return dictionaryCache.getCount();
     }

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/base/service/BaseService.java

@@ -13,6 +13,7 @@ import lombok.extern.slf4j.Slf4j;
 import org.apache.commons.collections4.CollectionUtils;
 import org.apache.commons.collections4.MapUtils;
 import org.apache.commons.lang3.StringUtils;
+import org.springframework.transaction.annotation.Transactional;
 import tk.mybatis.mapper.entity.Example;
 import cn.hutool.core.util.ReflectUtil;
 
@@ -38,16 +39,19 @@ import static java.util.stream.Collectors.*;
  * @date 2020-09-24
  */
 @Slf4j
-public abstract class BaseService<M, K> {
-
+public abstract class BaseService<M, K> implements IBaseService<M, K> {
     /**
      * 当前Service关联的主Model实体对象的Class。
      */
-    protected Class<M> modelClass;
+    protected final Class<M> modelClass;
+    /**
+     * 当前Service关联的主Model实体对象主键字段的Class。
+     */
+    protected final Class<K> idFieldClass;
     /**
      * 当前Service关联的主Model实体对象的实际表名称。
      */
-    protected String tableName;
+    protected final String tableName;
     /**
      * 当前Service关联的主Model对象主键字段名称。
      */
@@ -73,41 +77,45 @@ public abstract class BaseService<M, K> {
      */
     protected String updateTimeColumnName;
     /**
-     * 当前Service关联的主Model对象主键字段反射对象。
+     * 当前Service关联的主Model对象主键字段赋值方法的反射对象。
      */
-    protected Field idField;
+    protected Method setIdFieldMethod;
     /**
-     * 当前Service关联的主Model对象逻辑删除字段反射对象。
+     * 当前Service关联的主Model对象主键字段访问方法的反射对象。
      */
-    protected Field deletedFlagField;
+    protected Method getIdFieldMethod;
     /**
-     * 当前Service关联的主Model对象逻辑字段赋值方法的反射对象。
+     * 当前Service关联的主Model对象逻辑删除字段赋值方法的反射对象。
      */
-    private Method setDeletedFlagMethod;
+    protected Method setDeletedFlagMethod;
     /**
      * 当前Service关联的主Model对象的所有字典关联的结构列表，该字段在系统启动阶段一次性预加载，提升运行时效率。
      */
-    private List<RelationStruct> relationDictStructList = new LinkedList<>();
+    private final List<RelationStruct> relationDictStructList = new LinkedList<>();
     /**
      * 当前Service关联的主Model对象的所有常量字典关联的结构列表，该字段在系统启动阶段一次性预加载，提升运行时效率。
      */
-    private List<RelationStruct> relationConstDictStructList = new LinkedList<>();
+    private final List<RelationStruct> relationConstDictStructList = new LinkedList<>();
     /**
      * 当前Service关联的主Model对象的所有一对一关联的结构列表，该字段在系统启动阶段一次性预加载，提升运行时效率。
      */
-    private List<RelationStruct> relationOneToOneStructList = new LinkedList<>();
+    private final List<RelationStruct> relationOneToOneStructList = new LinkedList<>();
+    /**
+     * 当前Service关联的主Model对象的所有一对多关联的结构列表，该字段在系统启动阶段一次性预加载，提升运行时效率。
+     */
+    private final List<RelationStruct> relationOneToManyStructList = new LinkedList<>();
     /**
      * 当前Service关联的主Model对象的所有多对多关联的结构列表，该字段在系统启动阶段一次性预加载，提升运行时效率。
      */
-    private List<RelationStruct> relationManyToManyStructList = new LinkedList<>();
+    private final List<RelationStruct> relationManyToManyStructList = new LinkedList<>();
     /**
      * 当前Service关联的主Model对象的所有一对多聚合关联的结构列表，该字段在系统启动阶段一次性预加载，提升运行时效率。
      */
-    private List<RelationStruct> relationOneToManyAggrStructList = new LinkedList<>();
+    private final List<RelationStruct> relationOneToManyAggrStructList = new LinkedList<>();
     /**
      * 当前Service关联的主Model对象的所有多对多聚合关联的结构列表，该字段在系统启动阶段一次性预加载，提升运行时效率。
      */
-    private List<RelationStruct> relationManyToManyAggrStructList = new LinkedList<>();
+    private final List<RelationStruct> relationManyToManyAggrStructList = new LinkedList<>();
 
     private static final String GROUPED_KEY = "groupedKey";
     private static final String AGGREGATED_VALUE = "aggregatedValue";
@@ -119,6 +127,7 @@ public abstract class BaseService<M, K> {
     @SuppressWarnings("unchecked")
     public BaseService() {
         modelClass = (Class<M>) ((ParameterizedType) getClass().getGenericSuperclass()).getActualTypeArguments()[0];
+        idFieldClass = (Class<K>) ((ParameterizedType) getClass().getGenericSuperclass()).getActualTypeArguments()[1];
         this.tableName = modelClass.getAnnotation(Table.class).name();
         Field[] fields = ReflectUtil.getFields(modelClass);
         for (Field field : fields) {
@@ -129,9 +138,12 @@ public abstract class BaseService<M, K> {
     private void initializeField(Field field) {
         if (idFieldName == null && null != field.getAnnotation(Id.class)) {
             idFieldName = field.getName();
-            idField = field;
             Column c = field.getAnnotation(Column.class);
             idColumnName = c == null ? idFieldName : c.name();
+            setIdFieldMethod = ReflectUtil.getMethod(
+                    modelClass, "set" + StringUtils.capitalize(idFieldName), idFieldClass);
+            getIdFieldMethod = ReflectUtil.getMethod(
+                    modelClass, "get" + StringUtils.capitalize(idFieldName));
         }
         if (updateTimeFieldName == null && null != field.getAnnotation(JobUpdateTimeColumn.class)) {
             updateTimeFieldName = field.getName();
@@ -142,7 +154,6 @@ public abstract class BaseService<M, K> {
             deletedFlagFieldName = field.getName();
             Column c = field.getAnnotation(Column.class);
             deletedFlagColumnName = c == null ? deletedFlagFieldName : c.name();
-            deletedFlagField = field;
             setDeletedFlagMethod = ReflectUtil.getMethod(
                     modelClass, "set" + StringUtils.capitalize(deletedFlagFieldName), Integer.class);
         }
@@ -155,6 +166,29 @@ public abstract class BaseService<M, K> {
      */
     protected abstract BaseDaoMapper<M> mapper();
 
+    /**
+     * 基于主键Id删除数据。如果包含逻辑删除字段，则进行逻辑删除。
+     *
+     * @param id 主键Id值。
+     * @return true删除成功，false数据不存在。
+     */
+    @Transactional(rollbackFor = Exception.class)
+    @Override
+    public boolean removeById(K id) {
+        if (this.deletedFlagFieldName == null) {
+            return mapper().deleteByPrimaryKey(id) == 1;
+        }
+        try {
+            M data = modelClass.newInstance();
+            setDeletedFlagMethod.invoke(data, GlobalDeletedFlag.DELETED);
+            setIdFieldMethod.invoke(data, id);
+            return mapper().updateByPrimaryKeySelective(data) == 1;
+        } catch (Exception ex) {
+            log.error("Failed to call reflection method in BaseService.removeById.", ex);
+            throw new MyRuntimeException(ex);
+        }
+    }
+
     /**
      * 判断指定字段的数据是否存在，且仅仅存在一条记录。
      * 如果是基于主键的过滤，会直接调用existId过滤函数，提升性能。在有缓存的场景下，也可以利用缓存。
@@ -164,6 +198,7 @@ public abstract class BaseService<M, K> {
      * @return 存在且仅存在一条返回true，否则false。
      */
     @SuppressWarnings("unchecked")
+    @Override
     public boolean existOne(String fieldName, Object fieldValue) {
         if (fieldName.equals(this.idFieldName)) {
             return this.existId((K) fieldValue);
@@ -179,6 +214,7 @@ public abstract class BaseService<M, K> {
      * @param id 主键Id。
      * @return 存在返回true，否则false。
      */
+    @Override
     public boolean existId(K id) {
         return getById(id) != null;
     }
@@ -189,6 +225,7 @@ public abstract class BaseService<M, K> {
      * @param id 主键Id。
      * @return 主键关联的数据，不存在返回null。
      */
+    @Override
     public M getById(K id) {
         if (deletedFlagFieldName == null) {
             return mapper().selectByPrimaryKey(id);
@@ -200,6 +237,27 @@ public abstract class BaseService<M, K> {
         return mapper().selectOneByExample(e);
     }
 
+    /**
+     * 返回符合 filterField = filterValue 条件的一条数据。
+     *
+     * @param filterField 过滤的Java字段。
+     * @param filterValue 过滤的Java字段值。
+     * @return 查询后的数据对象。
+     */
+    @SuppressWarnings("unchecked")
+    @Override
+    public M getOne(String filterField, Object filterValue) {
+        if (filterField.equals(idFieldName)) {
+            return this.getById((K) filterValue);
+        }
+        Example e = new Example(modelClass);
+        Example.Criteria c = e.createCriteria().andEqualTo(filterField, filterValue);
+        if (deletedFlagFieldName != null) {
+            c.andEqualTo(deletedFlagFieldName, GlobalDeletedFlag.NORMAL);
+        }
+        return mapper().selectOneByExample(e);
+    }
+
     /**
      * 获取主表的查询结果，以及主表关联的字典数据和一对一从表数据，以及一对一从表的字典数据。
      *
@@ -207,9 +265,10 @@ public abstract class BaseService<M, K> {
      * @param relationParam  实体对象数据组装的参数构建器。
      * @return 查询结果对象。
      */
+    @Override
     public M getByIdWithRelation(K id, MyRelationParam relationParam) {
         M dataObject = this.getById(id);
-        this.buildRelationForData(dataObject, relationParam, buildAggregationAdditionalWhereCriteria());
+        this.buildRelationForData(dataObject, relationParam);
         return dataObject;
     }
 
@@ -218,6 +277,7 @@ public abstract class BaseService<M, K> {
      *
      * @return 返回所有数据。
      */
+    @Override
     public List<M> getAllList() {
         if (deletedFlagFieldName == null) {
             return mapper().selectAll();
@@ -227,24 +287,13 @@ public abstract class BaseService<M, K> {
         return mapper().selectByExample(e);
     }
 
-    /**
-     * 获取所有主数据，及其关联数据。
-     *
-     * @param relationParam  实体对象数据组装的参数构建器。
-     * @return 返回所有主数据，及其关联数据。
-     */
-    public List<M> getAllListWithRelation(MyRelationParam relationParam) {
-        List<M> resultList = getAllList();
-        this.buildRelationForDataList(resultList, relationParam, null);
-        return resultList;
-    }
-
     /**
      * 获取排序后所有数据。
      *
      * @param orderByProperties 需要排序的字段属性，这里使用Java对象中的属性名，而不是数据库字段名。
      * @return 返回排序后所有数据。
      */
+    @Override
     public List<M> getAllListByOrder(String... orderByProperties) {
         Example e = new Example(modelClass);
         for (String orderByProperty : orderByProperties) {
@@ -262,6 +311,7 @@ public abstract class BaseService<M, K> {
      * @param idSet  待校验的主键集合。
      * @return 全部存在返回true，否则false。
      */
+    @Override
     public boolean existAllPrimaryKeys(Set<K> idSet) {
         if (CollectionUtils.isEmpty(idSet)) {
             return true;
@@ -276,51 +326,24 @@ public abstract class BaseService<M, K> {
      * @param inFilterValues 数据值列表。
      * @return 全部存在返回true，否则false。
      */
+    @Override
     public <T> boolean existUniqueKeyList(String inFilterField, Set<T> inFilterValues) {
         if (CollectionUtils.isEmpty(inFilterValues)) {
             return true;
         }
         Example e = this.makeDefaultInListExample(inFilterField, inFilterValues, null);
-        if (deletedFlagFieldName != null) {
-            e.and().andEqualTo(deletedFlagFieldName, GlobalDeletedFlag.NORMAL);
-        }
         return mapper().selectCountByExample(e) == inFilterValues.size();
     }
 
-    /**
-     * 获取所有数据的指定字段的数据列表。
-     *
-     * @param getterFunc 指定字段的getter方法。
-     * @param <T>        指定字段的类型。
-     * @return 指定字段的列表。
-     */
-    public <T> List<T> getAllListWithField(Function<M, T> getterFunc) {
-        List<M> allList = this.getAllList();
-        // 即使没有符合filter条件的item存在，也会返回空列表对象，而不是null。
-        return allList.stream().filter(x -> getterFunc.apply(x) != null).map(getterFunc).collect(toList());
-    }
-
     /**
      * 返回符合主键 in (idValues) 条件的所有数据。
      *
      * @param idValues 主键值集合。
      * @return 检索后的数据列表。
      */
+    @Override
     public List<M> getInList(Set<K> idValues) {
-        return this.getInList(idFieldName, idValues, (String) null);
-    }
-
-    /**
-     * 通过getIdFunc函数，获取主对象列表masterList中的主键列表。在基于该Id列表作为主键查询的in list条件，获取数据。
-     *
-     * @param masterList 主对象列表，通过应用getIdFunc函数，获取查询条件中的主键in list条件。
-     * @param getIdFunc  获取主对象中符合查询条件主键的id值。
-     * @return 检索后的数据列表。
-     */
-    public <T> List<M> getInList(List<T> masterList, Function<T, K> getIdFunc) {
-        // 即使没有符合filter条件的item存在，也会返回空列表对象，而不是null。
-        return this.getInList(masterList.stream()
-                .filter(x -> getIdFunc.apply(x) != null).map(getIdFunc).collect(toSet()));
+        return this.getInList(idFieldName, idValues, null);
     }
 
     /**
@@ -330,8 +353,9 @@ public abstract class BaseService<M, K> {
      * @param inFilterValues 参与(In-list)过滤的Java字段值集合。
      * @return 检索后的数据列表。
      */
+    @Override
     public <T> List<M> getInList(String inFilterField, Set<T> inFilterValues) {
-        return this.getInList(inFilterField, inFilterValues, (String) null);
+        return this.getInList(inFilterField, inFilterValues, null);
     }
 
     /**
@@ -342,39 +366,22 @@ public abstract class BaseService<M, K> {
      * @param orderBy        排序字段。
      * @return 检索后的数据列表。
      */
+    @Override
     public <T> List<M> getInList(String inFilterField, Set<T> inFilterValues, String orderBy) {
         if (CollectionUtils.isEmpty(inFilterValues)) {
             return new LinkedList<>();
         }
         Example e = this.makeDefaultInListExample(inFilterField, inFilterValues, orderBy);
-        if (deletedFlagFieldName != null) {
-            e.and().andEqualTo(deletedFlagFieldName, GlobalDeletedFlag.NORMAL);
-        }
         return mapper().selectByExample(e);
     }
 
-    /**
-     * 基于对象集合(masterList)，并通过masterIdFunction函数对象获取property字段的数据列表，
-     * inFilterField in (inFilterValues)的所有数据。
-     *
-     * @param inFilterField    参与(In-list)过滤的Java字段。
-     * @param masterList       主对象数据集合。
-     * @param masterIdFunction 获取主对象中，property字段数值的函数对象。
-     * @param <T>              主对象类型。
-     * @return 检索后的数据列表。
-     */
-    public <T> List<M> getInList(String inFilterField, Collection<T> masterList, Function<T, K> masterIdFunction) {
-        // 即使没有符合filter条件的item存在，也会返回空列表对象，而不是null。
-        return this.getInList(inFilterField, masterList.stream()
-                .filter(x -> masterIdFunction.apply(x) != null).map(masterIdFunction).collect(toSet()));
-    }
-
     /**
      * 用参数对象作为过滤条件，获取数据数量。
      *
      * @param filter 该方法基于mybatis 通用mapper，过滤对象中，只有被赋值的字段，才会成为where中的条件。
      * @return 返回过滤后的数据数量。
      */
+    @Override
     public int getCountByFilter(M filter) {
         if (deletedFlagFieldName == null) {
             return mapper().selectCount(filter);
@@ -383,7 +390,7 @@ public abstract class BaseService<M, K> {
             setDeletedFlagMethod.invoke(filter, GlobalDeletedFlag.NORMAL);
             return mapper().selectCount(filter);
         } catch (Exception e) {
-            log.error("Failed to call reflection code of BaseService.getCountByFilter.", e);
+            log.error("Failed to call reflection [setDeletedFlagMethod] in BaseService.getCountByFilter.", e);
             throw new MyRuntimeException(e);
         }
     }
@@ -394,6 +401,7 @@ public abstract class BaseService<M, K> {
      * @param filter 该方法基于mybatis 通用mapper，过滤对象中，只有被赋值的字段，才会成为where中的条件。
      * @return 存在返回true，否则false。
      */
+    @Override
     public boolean existByFilter(M filter) {
         return this.getCountByFilter(filter) > 0;
     }
@@ -404,7 +412,8 @@ public abstract class BaseService<M, K> {
      * @param filter 该方法基于mybatis的通用mapper。如果参数为null，则返回全部数据。
      * @return 返回过滤后的数据。
      */
-    private List<M> getListByFilter(M filter) {
+    @Override
+    public List<M> getListByFilter(M filter) {
         if (filter == null) {
             return this.getAllList();
         }
@@ -420,33 +429,6 @@ public abstract class BaseService<M, K> {
         }
     }
 
-    /**
-     * 用参数对象作为过滤条件，获取查询结果。
-     *
-     * @param filter  该方法基于mybatis的通用mapper。如果参数为null，则返回全部数据。
-     * @param orderBy SQL中ORDER BY从句。
-     * @return 返回过滤后的数据。
-     */
-    public List<M> getListByFilter(M filter, String orderBy) {
-        if (StringUtils.isBlank(orderBy)) {
-            return this.getListByFilter(filter);
-        }
-        Example e = new Example(modelClass);
-        if (StringUtils.isNotBlank(orderBy)) {
-            e.setOrderByClause(orderBy);
-        }
-        if (filter != null) {
-            Example.Criteria c = e.createCriteria();
-            Field[] fields = ReflectUtil.getFields(modelClass);
-            for (Field field : fields) {
-                if (field.getAnnotation(Transient.class) == null) {
-                    assembleCriteriaByFilter(filter, field, c);
-                }
-            }
-        }
-        return mapper().selectByExample(e);
-    }
-
     private void assembleCriteriaByFilter(M filter, Field field, Example.Criteria c) {
         int modifiers = field.getModifiers();
         // transient类型的字段不能作为查询条件
@@ -470,21 +452,6 @@ public abstract class BaseService<M, K> {
         }
     }
 
-    /**
-     * 用参数对象作为过滤条件，获取查询结果。同时组装实体对象中基于RelationXXXX注解关联的数据。
-     *
-     * @param filter         该方法基于mybatis的通用mapper。如果参数为null，则返回全部数据。
-     * @param orderBy        SQL中ORDER BY从句。
-     * @param relationParam  实体对象数据组装的参数构建器。
-     * @return 返回过滤后的数据。
-     */
-    public List<M> getListWithRelationByFilter(M filter, String orderBy, MyRelationParam relationParam) {
-        List<M> resultList = this.getListByFilter(filter, orderBy);
-        Map<String, List<MyWhereCriteria>> criteriaMap = buildAggregationAdditionalWhereCriteria();
-        this.buildRelationForDataList(resultList, relationParam, criteriaMap);
-        return resultList;
-    }
-
     /**
      * 获取父主键Id下的所有子数据列表。
      *
@@ -492,6 +459,7 @@ public abstract class BaseService<M, K> {
      * @param parentId          父主键的值。
      * @return 父主键Id下的所有子数据列表。
      */
+    @Override
     public List<M> getListByParentId(String parentIdFieldName, K parentId) {
         Example e = new Example(modelClass);
         Example.Criteria c = e.createCriteria();
@@ -516,6 +484,7 @@ public abstract class BaseService<M, K> {
      * @param groupBy      SQL常量形式分组字段列表，逗号分隔。
      * @return 聚合计算后的数据结果集。
      */
+    @Override
     public List<Map<String, Object>> getGroupedListByCondition(
             String selectFields, String whereClause, String groupBy) {
         return mapper().getGroupedListByCondition(tableName, selectFields, whereClause, groupBy);
@@ -525,12 +494,15 @@ public abstract class BaseService<M, K> {
      * 根据指定的显示字段列表、过滤条件字符串和排序字符串，返回查询结果。(基本是内部框架使用，不建议外部接口直接使用)。
      *
      * @param selectList  选择的Java字段列表。如果为空表示返回全部字段。
+     * @param filter      过滤对象。
      * @param whereClause SQL常量形式的条件从句。
      * @param orderBy     SQL常量形式排序字段列表，逗号分隔。
      * @return 查询结果。
      */
-    public List<M> getListByCondition(List<String> selectList, String whereClause, String orderBy) {
+    @Override
+    public List<M> getListByCondition(List<String> selectList, M filter, String whereClause, String orderBy) {
         Example e = new Example(modelClass);
+        Example.Criteria c = null;
         if (CollectionUtils.isNotEmpty(selectList)) {
             String[] selectFields = new String[selectList.size()];
             selectList.toArray(selectFields);
@@ -539,8 +511,20 @@ public abstract class BaseService<M, K> {
         if (StringUtils.isNotBlank(orderBy)) {
             e.setOrderByClause(orderBy);
         }
+        if (filter != null) {
+            c = e.createCriteria();
+            Field[] fields = ReflectUtil.getFields(modelClass);
+            for (Field field : fields) {
+                if (field.getAnnotation(Transient.class) == null) {
+                    this.assembleCriteriaByFilter(filter, field, c);
+                }
+            }
+        }
         if (StringUtils.isNotBlank(whereClause)) {
-            e.createCriteria().andCondition(whereClause);
+            if (c == null) {
+                c = e.createCriteria();
+            }
+            c.andCondition(whereClause);
         }
         return mapper().selectByExample(e);
     }
@@ -551,6 +535,7 @@ public abstract class BaseService<M, K> {
      * @param whereClause SQL常量形式的条件从句。
      * @return 返回过滤后的数据数量。
      */
+    @Override
     public Integer getCountByCondition(String whereClause) {
         return mapper().getCountByCondition(this.tableName, whereClause);
     }
@@ -561,10 +546,9 @@ public abstract class BaseService<M, K> {
      *
      * @param resultList      主表实体对象列表。数据集成将直接作用于该对象列表。
      * @param relationParam   实体对象数据组装的参数构建器。
-     * @param criteriaListMap 仅仅用于一对多和多对多聚合计算的附加过滤条件。如果没有可以为NULL。
      */
-    public void buildRelationForDataList(
-            List<M> resultList, MyRelationParam relationParam, Map<String, List<MyWhereCriteria>> criteriaListMap) {
+    @Override
+    public void buildRelationForDataList(List<M> resultList, MyRelationParam relationParam) {
         if (relationParam == null || CollectionUtils.isEmpty(resultList)) {
             return;
         }
@@ -583,9 +567,9 @@ public abstract class BaseService<M, K> {
         // 组装本地聚合计算关联数据
         if (relationParam.isBuildRelationAggregation()) {
             // 处理多对多场景下，根据主表的结果，进行从表聚合数据的计算。
-            this.buildManyToManyAggregationForDataList(resultList, criteriaListMap);
+            this.buildManyToManyAggregationForDataList(resultList, buildAggregationAdditionalWhereCriteria());
             // 处理多一多场景下，根据主表的结果，进行从表聚合数据的计算。
-            this.buildOneToManyAggregationForDataList(resultList, criteriaListMap);
+            this.buildOneToManyAggregationForDataList(resultList, buildAggregationAdditionalWhereCriteria());
         }
     }
 
@@ -595,11 +579,10 @@ public abstract class BaseService<M, K> {
      *
      * @param dataObject      主表实体对象。数据集成将直接作用于该对象。
      * @param relationParam   实体对象数据组装的参数构建器。
-     * @param criteriaListMap 仅仅用于一对多和多对多聚合计算的附加过滤条件。如果没有可以为NULL。
      * @param <T>             实体对象类型。
      */
-    public <T extends M> void buildRelationForData(
-            T dataObject, MyRelationParam relationParam, Map<String, List<MyWhereCriteria>> criteriaListMap) {
+    @Override
+    public <T extends M> void buildRelationForData(T dataObject, MyRelationParam relationParam) {
         if (dataObject == null || relationParam == null) {
             return;
         }
@@ -617,12 +600,12 @@ public abstract class BaseService<M, K> {
         // 组装本地聚合计算关联数据
         if (relationParam.isBuildRelationAggregation()) {
             // 开始处理多对多场景。
-            buildManyToManyAggregationForData(dataObject, criteriaListMap);
+            buildManyToManyAggregationForData(dataObject, buildAggregationAdditionalWhereCriteria());
             // 构建一对多场景
-            buildOneToManyAggregationForData(dataObject, criteriaListMap);
+            buildOneToManyAggregationForData(dataObject, buildAggregationAdditionalWhereCriteria());
         }
         if (relationParam.isBuildRelationManyToMany()) {
-            this.buildManyToManyRelation(dataObject);
+            this.buildRelationManyToMany(dataObject);
         }
     }
 
@@ -631,7 +614,7 @@ public abstract class BaseService<M, K> {
      *
      * @param dataObject 关联后的主表数据对象。
      */
-    private <T extends M> void buildManyToManyRelation(T dataObject) {
+    private <T extends M> void buildRelationManyToMany(T dataObject) {
         if (dataObject == null || CollectionUtils.isEmpty(this.relationManyToManyStructList)) {
             return;
         }
@@ -650,8 +633,7 @@ public abstract class BaseService<M, K> {
      * @param resultList 主表数据列表。
      */
     private void buildConstDictForDataList(List<M> resultList) {
-        if (CollectionUtils.isEmpty(this.relationConstDictStructList)
-                || CollectionUtils.isEmpty(resultList)) {
+        if (CollectionUtils.isEmpty(this.relationConstDictStructList) || CollectionUtils.isEmpty(resultList)) {
             return;
         }
         for (RelationStruct relationStruct : this.relationConstDictStructList) {
@@ -701,8 +683,7 @@ public abstract class BaseService<M, K> {
      *                         不为空，则直接从已经完成一对一数据关联的从表对象中获取数据，减少一次数据库交互。
      */
     private void buildDictForDataList(List<M> resultList, boolean hasBuiltOneToOne) {
-        if (CollectionUtils.isEmpty(this.relationDictStructList)
-                || CollectionUtils.isEmpty(resultList)) {
+        if (CollectionUtils.isEmpty(this.relationDictStructList) || CollectionUtils.isEmpty(resultList)) {
             return;
         }
         for (RelationStruct relationStruct : this.relationDictStructList) {
@@ -745,7 +726,7 @@ public abstract class BaseService<M, K> {
             } else {
                 Object id = ReflectUtil.getFieldValue(dataObject, relationStruct.masterIdField);
                 if (id != null) {
-                    relationObject = relationStruct.service.getById(id);
+                    relationObject = relationStruct.service.getOne(relationStruct.relationDict.slaveIdField(), id);
                 }
             }
             MyModelUtil.makeDictRelation(
@@ -757,11 +738,10 @@ public abstract class BaseService<M, K> {
      * 为实体对象参数列表数据集成本地一对一关联数据。
      *
      * @param resultList 实体对象数据列表。
-     * @param withDict   关联从表数据后，是否把从表的字典数据也一起关联了。。
+     * @param withDict   关联从表数据后，是否把从表的字典数据也一起关联了。
      */
     private void buildOneToOneForDataList(List<M> resultList, boolean withDict) {
-        if (CollectionUtils.isEmpty(this.relationOneToOneStructList)
-                || CollectionUtils.isEmpty(resultList)) {
+        if (CollectionUtils.isEmpty(this.relationOneToOneStructList) || CollectionUtils.isEmpty(resultList)) {
             return;
         }
         for (RelationStruct relationStruct : this.relationOneToOneStructList) {
@@ -795,7 +775,7 @@ public abstract class BaseService<M, K> {
      * 为实体对象数据集成本地一对一关联数据。
      *
      * @param dataObject 实体对象。
-     * @param withDict   关联从表数据后，是否把从表的字典数据也一起关联了。。
+     * @param withDict   关联从表数据后，是否把从表的字典数据也一起关联了。
      */
     private void buildOneToOneForData(M dataObject, boolean withDict) {
         if (dataObject == null || CollectionUtils.isEmpty(this.relationOneToOneStructList)) {
@@ -805,7 +785,7 @@ public abstract class BaseService<M, K> {
             Object id = ReflectUtil.getFieldValue(dataObject, relationStruct.masterIdField);
             if (id != null) {
                 BaseService<Object, Object> relationService = relationStruct.service;
-                Object relationObject = relationService.getById(id);
+                Object relationObject = relationService.getOne(relationStruct.relationOneToOne.slaveIdField(), id);
                 ReflectUtil.setFieldValue(dataObject, relationStruct.relationField, relationObject);
                 // 仅仅当需要加载从表字典关联时，才去加载。
                 if (withDict && relationStruct.relationOneToOne.loadSlaveDict() && relationObject != null) {
@@ -821,6 +801,53 @@ public abstract class BaseService<M, K> {
         }
     }
 
+    /**
+     * 为实体对象参数列表数据集成本地一对多关联数据。
+     *
+     * @param resultList 实体对象数据列表。
+     */
+    private void buildOneToManyForDataList(List<M> resultList) {
+        if (CollectionUtils.isEmpty(this.relationOneToManyStructList) || CollectionUtils.isEmpty(resultList)) {
+            return;
+        }
+        for (RelationStruct relationStruct : this.relationOneToManyStructList) {
+            Set<Object> masterIdSet = resultList.stream()
+                    .map(obj -> ReflectUtil.getFieldValue(obj, relationStruct.masterIdField))
+                    .filter(Objects::nonNull)
+                    .collect(toSet());
+            // 从主表集合中，抽取主表关联字段的集合，再以in list形式去从表中查询。
+            if (CollectionUtils.isNotEmpty(masterIdSet)) {
+                BaseService<Object, Object> relationService = relationStruct.service;
+                List<Object> relationList =
+                        relationService.getInList(relationStruct.relationOneToMany.slaveIdField(), masterIdSet);
+                MyModelUtil.makeOneToManyRelation(
+                        modelClass, resultList, relationList, relationStruct.relationField.getName());
+            }
+        }
+    }
+
+    /**
+     * 为实体对象数据集成本地一对多关联数据。
+     *
+     * @param dataObject 实体对象。
+     */
+    private void buildOneToManyForData(M dataObject) {
+        if (dataObject == null || CollectionUtils.isEmpty(this.relationOneToManyStructList)) {
+            return;
+        }
+        for (RelationStruct relationStruct : this.relationOneToManyStructList) {
+            Object id = ReflectUtil.getFieldValue(dataObject, relationStruct.masterIdField);
+            if (id != null) {
+                BaseService<Object, Object> relationService = relationStruct.service;
+                Set<Object> masterIdSet = new HashSet<>(1);
+                masterIdSet.add(id);
+                List<Object> relationObject = relationService.getInList(
+                        relationStruct.relationOneToMany.slaveIdField(), masterIdSet);
+                ReflectUtil.setFieldValue(dataObject, relationStruct.relationField, relationObject);
+            }
+        }
+    }
+
     /**
      * 根据实体对象参数列表和过滤条件，集成本地多对多关联聚合计算数据。
      *
@@ -829,8 +856,7 @@ public abstract class BaseService<M, K> {
      */
     private void buildManyToManyAggregationForDataList(
             List<M> resultList, Map<String, List<MyWhereCriteria>> criteriaListMap) {
-        if (CollectionUtils.isEmpty(this.relationManyToManyAggrStructList)
-                || CollectionUtils.isEmpty(resultList)) {
+        if (CollectionUtils.isEmpty(this.relationManyToManyAggrStructList) || CollectionUtils.isEmpty(resultList)) {
             return;
         }
         if (criteriaListMap == null) {
@@ -944,8 +970,7 @@ public abstract class BaseService<M, K> {
     private void buildOneToManyAggregationForDataList(
             List<M> resultList, Map<String, List<MyWhereCriteria>> criteriaListMap) {
         // 处理多一多场景下，根据主表的结果，进行从表聚合数据的计算。
-        if (CollectionUtils.isEmpty(this.relationOneToManyAggrStructList)
-                || CollectionUtils.isEmpty(resultList)) {
+        if (CollectionUtils.isEmpty(this.relationOneToManyAggrStructList) || CollectionUtils.isEmpty(resultList)) {
             return;
         }
         if (criteriaListMap == null) {
@@ -1038,6 +1063,7 @@ public abstract class BaseService<M, K> {
     /**
      * 仅仅在spring boot 启动后的监听器事件中调用，缓存所有service的关联关系，加速后续的数据绑定效率。
      */
+    @Override
     public void loadRelationStruct() {
         Field[] fields = ReflectUtil.getFields(modelClass);
         for (Field f : fields) {
@@ -1104,10 +1130,15 @@ public abstract class BaseService<M, K> {
             inFilterValueSet = new HashSet<>(inFilterValues.size());
             inFilterValueSet.addAll(inFilterValues);
         }
-        e.createCriteria().andIn(inFilterField, inFilterValueSet);
+        Example.Criteria c = e.createCriteria();
+        c.andIn(inFilterField, inFilterValueSet);
+        if (deletedFlagFieldName != null) {
+            c.andEqualTo(deletedFlagFieldName, GlobalDeletedFlag.NORMAL);
+        }
         return e;
     }
 
+    @SuppressWarnings("unchecked")
     private void initializeRelationStruct(Field f) {
         RelationOneToOne relationOneToOne = f.getAnnotation(RelationOneToOne.class);
         if (relationOneToOne != null) {
@@ -1115,11 +1146,32 @@ public abstract class BaseService<M, K> {
             relationStruct.relationField = f;
             relationStruct.masterIdField = ReflectUtil.getField(modelClass, relationOneToOne.masterIdField());
             relationStruct.relationOneToOne = relationOneToOne;
-            relationStruct.service = ApplicationContextHolder.getBean(
-                    StringUtils.uncapitalize(relationOneToOne.slaveServiceName()));
+            if (StringUtils.isNotBlank(relationOneToOne.slaveServiceName())) {
+                relationStruct.service = ApplicationContextHolder.getBean(
+                        StringUtils.uncapitalize(relationOneToOne.slaveServiceName()));
+            } else {
+                relationStruct.service = (BaseService<Object, Object>)
+                        ApplicationContextHolder.getBean(relationOneToOne.slaveServiceClass());
+            }
             relationOneToOneStructList.add(relationStruct);
             return;
         }
+        RelationOneToMany relationOneToMany = f.getAnnotation(RelationOneToMany.class);
+        if (relationOneToMany != null) {
+            RelationStruct relationStruct = new RelationStruct();
+            relationStruct.relationField = f;
+            relationStruct.masterIdField = ReflectUtil.getField(modelClass, relationOneToMany.masterIdField());
+            relationStruct.relationOneToMany = relationOneToMany;
+            if (StringUtils.isNotBlank(relationOneToMany.slaveServiceName())) {
+                relationStruct.service = ApplicationContextHolder.getBean(
+                        StringUtils.uncapitalize(relationOneToMany.slaveServiceName()));
+            } else {
+                relationStruct.service = (BaseService<Object, Object>)
+                        ApplicationContextHolder.getBean(relationOneToMany.slaveServiceClass());
+            }
+            relationOneToManyStructList.add(relationStruct);
+            return;
+        }
         RelationManyToMany relationManyToMany = f.getAnnotation(RelationManyToMany.class);
         if (relationManyToMany != null) {
             RelationStruct relationStruct = new RelationStruct();
@@ -1132,6 +1184,7 @@ public abstract class BaseService<M, K> {
         }
     }
 
+    @SuppressWarnings("unchecked")
     private void initializeRelationAggregationStruct(Field f) {
         RelationOneToManyAggregation relationOneToManyAggregation = f.getAnnotation(RelationOneToManyAggregation.class);
         if (relationOneToManyAggregation != null) {
@@ -1139,8 +1192,13 @@ public abstract class BaseService<M, K> {
             relationStruct.relationField = f;
             relationStruct.masterIdField = ReflectUtil.getField(modelClass, relationOneToManyAggregation.masterIdField());
             relationStruct.relationOneToManyAggregation = relationOneToManyAggregation;
-            relationStruct.service = ApplicationContextHolder.getBean(
-                    StringUtils.uncapitalize(relationOneToManyAggregation.slaveServiceName()));
+            if (StringUtils.isNotBlank(relationOneToManyAggregation.slaveServiceName())) {
+                relationStruct.service = ApplicationContextHolder.getBean(
+                        StringUtils.uncapitalize(relationOneToManyAggregation.slaveServiceName()));
+            } else {
+                relationStruct.service = (BaseService<Object, Object>)
+                        ApplicationContextHolder.getBean(relationOneToManyAggregation.slaveServiceClass());
+            }
             relationOneToManyAggrStructList.add(relationStruct);
             return;
         }
@@ -1150,8 +1208,13 @@ public abstract class BaseService<M, K> {
             relationStruct.relationField = f;
             relationStruct.masterIdField = ReflectUtil.getField(modelClass, relationManyToManyAggregation.masterIdField());
             relationStruct.relationManyToManyAggregation = relationManyToManyAggregation;
-            relationStruct.service = ApplicationContextHolder.getBean(
-                    StringUtils.uncapitalize(relationManyToManyAggregation.slaveServiceName()));
+            if (StringUtils.isNotBlank(relationManyToManyAggregation.slaveServiceName())) {
+                relationStruct.service = ApplicationContextHolder.getBean(
+                        StringUtils.uncapitalize(relationManyToManyAggregation.slaveServiceName()));
+            } else {
+                relationStruct.service = (BaseService<Object, Object>)
+                        ApplicationContextHolder.getBean(relationManyToManyAggregation.slaveServiceClass());
+            }
             relationManyToManyAggrStructList.add(relationStruct);
         }
     }
@@ -1178,8 +1241,13 @@ public abstract class BaseService<M, K> {
                 relationStruct.equalOneToOneRelationField =
                         ReflectUtil.getField(modelClass, relationDict.equalOneToOneRelationField());
             }
-            relationStruct.service = ApplicationContextHolder.getBean(
-                    StringUtils.uncapitalize(relationDict.slaveServiceName()));
+            if (StringUtils.isNotBlank(relationDict.slaveServiceName())) {
+                relationStruct.service = ApplicationContextHolder.getBean(
+                        StringUtils.uncapitalize(relationDict.slaveServiceName()));
+            } else {
+                relationStruct.service = (BaseService<Object, Object>)
+                        ApplicationContextHolder.getBean(relationDict.slaveServiceClass());
+            }
             relationDictStructList.add(relationStruct);
         }
     }
@@ -1379,6 +1447,7 @@ public abstract class BaseService<M, K> {
         private Map<Object, String> dictMap;
         private RelationDict relationDict;
         private RelationOneToOne relationOneToOne;
+        private RelationOneToMany relationOneToMany;
         private RelationManyToMany relationManyToMany;
         private RelationOneToManyAggregation relationOneToManyAggregation;
         private RelationManyToManyAggregation relationManyToManyAggregation;

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/base/service/IBaseDictService.java

@@ -0,0 +1,86 @@
+package com.orange.demo.common.core.base.service;
+
+import java.util.List;
+
+/**
+ * 带有缓存功能的字典Service接口。
+ *
+ * @param <M> Model实体对象的类型。
+ * @param <K> Model对象主键的类型。
+ * @author Jerry
+ * @date 2020-09-24
+ */
+public interface IBaseDictService<M, K> extends IBaseService<M, K> {
+
+    /**
+     * 是否在服务启动的时候加载。子类可以重载该方法，并在需要的时候手工调用loadCachedData加载数据。
+     *
+     * @return true表示启动即可加载数据，false需要手动调用loadCachedData进行加载。
+     */
+    boolean loadOnStartup();
+
+    /**
+     * 在系统启动时，加载全部数据到内存，缓存的key只能为映射表的主键。
+     */
+    void loadCachedData();
+
+    /**
+     * 重新加载数据库中所有当前表数据到系统内存。
+     *
+     * @param force true则强制刷新，如果false，当缓存中存在数据时不刷新。
+     */
+    void reloadCachedData(boolean force);
+
+    /**
+     * 保存新增对象。
+     *
+     * @param data 新增对象。
+     * @return 返回新增对象。
+     */
+    M saveNew(M data);
+
+    /**
+     * 更新数据对象。
+     *
+     * @param data         更新的对象。
+     * @param originalData 原有数据对象。
+     * @return 成功返回true，否则false。
+     */
+    boolean update(M data, M originalData);
+
+    /**
+     * 删除指定数据。
+     *
+     * @param id 主键Id。
+     * @return 成功返回true，否则false。
+     */
+    boolean remove(K id);
+
+    /**
+     * 直接从缓存池中获取所有数据。
+     *
+     * @return 返回所有数据。
+     */
+    List<M> getAllListFromCache();
+
+    /**
+     * 存入缓存。
+     *
+     * @param data 新增或更新数据。
+     */
+    void putDictionaryCache(M data);
+
+    /**
+     * 根据字典主键将数据从缓存中删除。
+     *
+     * @param id 字典主键。
+     */
+    void removeDictionaryCache(K id);
+
+    /**
+     * 获取缓存中的数据数量。
+     *
+     * @return 缓存中的数据总量。
+     */
+    int getCachedCount();
+}

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/base/service/IBaseService.java

@@ -0,0 +1,217 @@
+package com.orange.demo.common.core.base.service;
+
+import com.orange.demo.common.core.object.MyRelationParam;
+
+import java.util.*;
+
+/**
+ * 所有Service的接口。
+ *
+ * @param <M> Model对象的类型。
+ * @param <K> Model对象主键的类型。
+ * @author Jerry
+ * @date 2020-09-24
+ */
+public interface IBaseService<M, K> {
+
+    /**
+     * 基于主键Id删除数据。如果包含逻辑删除字段，则进行逻辑删除。
+     *
+     * @param id 主键Id值。
+     * @return true删除成功，false数据不存在。
+     */
+    boolean removeById(K id);
+
+    /**
+     * 判断指定字段的数据是否存在，且仅仅存在一条记录。
+     * 如果是基于主键的过滤，会直接调用existId过滤函数，提升性能。在有缓存的场景下，也可以利用缓存。
+     *
+     * @param fieldName  待过滤的字段名(Java 字段)。
+     * @param fieldValue 字段值。
+     * @return 存在且仅存在一条返回true，否则false。
+     */
+    boolean existOne(String fieldName, Object fieldValue);
+
+    /**
+     * 判断主键Id关联的数据是否存在。
+     *
+     * @param id 主键Id。
+     * @return 存在返回true，否则false。
+     */
+    boolean existId(K id);
+
+    /**
+     * 获取主键Id关联的数据。
+     *
+     * @param id 主键Id。
+     * @return 主键关联的数据，不存在返回null。
+     */
+    M getById(K id);
+
+    /**
+     * 返回符合 filterField = filterValue 条件的一条数据。
+     *
+     * @param filterField 过滤的Java字段。
+     * @param filterValue 过滤的Java字段值。
+     * @return 查询后的数据对象。
+     */
+    M getOne(String filterField, Object filterValue);
+
+    /**
+     * 获取主表的查询结果，以及主表关联的字典数据和一对一从表数据，以及一对一从表的字典数据。
+     *
+     * @param id             主表主键Id。
+     * @param relationParam  实体对象数据组装的参数构建器。
+     * @return 查询结果对象。
+     */
+    M getByIdWithRelation(K id, MyRelationParam relationParam);
+
+    /**
+     * 获取所有数据。
+     *
+     * @return 返回所有数据。
+     */
+    List<M> getAllList();
+
+    /**
+     * 获取排序后所有数据。
+     *
+     * @param orderByProperties 需要排序的字段属性，这里使用Java对象中的属性名，而不是数据库字段名。
+     * @return 返回排序后所有数据。
+     */
+    List<M> getAllListByOrder(String... orderByProperties);
+
+    /**
+     * 判断参数值主键集合中的所有数据，是否全部存在
+     *
+     * @param idSet  待校验的主键集合。
+     * @return 全部存在返回true，否则false。
+     */
+    boolean existAllPrimaryKeys(Set<K> idSet);
+
+    /**
+     * 判断参数值列表中的所有数据，是否全部存在。另外，keyName字段在数据表中必须是唯一键值，否则返回结果会出现误判。
+     *
+     * @param inFilterField  待校验的数据字段，这里使用Java对象中的属性，如courseId，而不是数据字段名course_id
+     * @param inFilterValues 数据值列表。
+     * @return 全部存在返回true，否则false。
+     */
+    <T> boolean existUniqueKeyList(String inFilterField, Set<T> inFilterValues);
+
+    /**
+     * 返回符合主键 in (idValues) 条件的所有数据。
+     *
+     * @param idValues 主键值集合。
+     * @return 检索后的数据列表。
+     */
+    List<M> getInList(Set<K> idValues);
+
+    /**
+     * 返回符合 inFilterField in (inFilterValues) 条件的所有数据。
+     *
+     * @param inFilterField  参与(In-list)过滤的Java字段。
+     * @param inFilterValues 参与(In-list)过滤的Java字段值集合。
+     * @return 检索后的数据列表。
+     */
+    <T> List<M> getInList(String inFilterField, Set<T> inFilterValues);
+
+    /**
+     * 返回符合 inFilterField in (inFilterValues) 条件的所有数据，并根据orderBy字段排序。
+     *
+     * @param inFilterField  参与(In-list)过滤的Java字段。
+     * @param inFilterValues 参与(In-list)过滤的Java字段值集合。
+     * @param orderBy        排序字段。
+     * @return 检索后的数据列表。
+     */
+    <T> List<M> getInList(String inFilterField, Set<T> inFilterValues, String orderBy);
+
+    /**
+     * 用参数对象作为过滤条件，获取数据数量。
+     *
+     * @param filter 该方法基于mybatis 通用mapper，过滤对象中，只有被赋值的字段，才会成为where中的条件。
+     * @return 返回过滤后的数据数量。
+     */
+    int getCountByFilter(M filter);
+
+    /**
+     * 用参数对象作为过滤条件，判断是否存在过滤数据。
+     *
+     * @param filter 该方法基于mybatis 通用mapper，过滤对象中，只有被赋值的字段，才会成为where中的条件。
+     * @return 存在返回true，否则false。
+     */
+    boolean existByFilter(M filter);
+
+    /**
+     * 用参数对象作为过滤条件，获取查询结果。
+     *
+     * @param filter 该方法基于mybatis的通用mapper。如果参数为null，则返回全部数据。
+     * @return 返回过滤后的数据。
+     */
+    List<M> getListByFilter(M filter);
+
+    /**
+     * 获取父主键Id下的所有子数据列表。
+     *
+     * @param parentIdFieldName 父主键字段名字，如"courseId"。
+     * @param parentId          父主键的值。
+     * @return 父主键Id下的所有子数据列表。
+     */
+    List<M> getListByParentId(String parentIdFieldName, K parentId);
+
+    /**
+     * 根据指定的显示字段列表、过滤条件字符串和分组字符串，返回聚合计算后的查询结果。(基本是内部框架使用，不建议外部接口直接使用)。
+     *
+     * @param selectFields 选择的字段列表，多个字段逗号分隔。
+     *                     NOTE: 如果数据表字段和Java对象字段名字不同，Java对象字段应该以别名的形式出现。
+     *                     如: table_column_name modelFieldName。否则无法被反射回Bean对象。
+     * @param whereClause  SQL常量形式的条件从句。
+     * @param groupBy      SQL常量形式分组字段列表，逗号分隔。
+     * @return 聚合计算后的数据结果集。
+     */
+    List<Map<String, Object>> getGroupedListByCondition(String selectFields, String whereClause, String groupBy);
+
+    /**
+     * 根据指定的显示字段列表、过滤条件字符串和排序字符串，返回查询结果。(基本是内部框架使用，不建议外部接口直接使用)。
+     *
+     * @param selectList  选择的Java字段列表。如果为空表示返回全部字段。
+     * @param filter      过滤对象。
+     * @param whereClause SQL常量形式的条件从句。
+     * @param orderBy     SQL常量形式排序字段列表，逗号分隔。
+     * @return 查询结果。
+     */
+    List<M> getListByCondition(List<String> selectList, M filter, String whereClause, String orderBy);
+
+    /**
+     * 用指定过滤条件，计算记录数量。(基本是内部框架使用，不建议外部接口直接使用)。
+     *
+     * @param whereClause SQL常量形式的条件从句。
+     * @return 返回过滤后的数据数量。
+     */
+    Integer getCountByCondition(String whereClause);
+
+    /**
+     * 集成所有与主表实体对象相关的关联数据列表。包括一对一、字典、一对多和多对多聚合运算等。
+     * 也可以根据实际需求，单独调用该函数所包含的各个数据集成函数。
+     * NOTE: 该方法内执行的SQL将禁用数据权限过滤。
+     *
+     * @param resultList      主表实体对象列表。数据集成将直接作用于该对象列表。
+     * @param relationParam   实体对象数据组装的参数构建器。
+     */
+    void buildRelationForDataList(List<M> resultList, MyRelationParam relationParam);
+
+    /**
+     * 集成所有与主表实体对象相关的关联数据对象。包括一对一、字典、一对多和多对多聚合运算等。
+     * 也可以根据实际需求，单独调用该函数所包含的各个数据集成函数。
+     * NOTE: 该方法内执行的SQL将禁用数据权限过滤。
+     *
+     * @param dataObject      主表实体对象。数据集成将直接作用于该对象。
+     * @param relationParam   实体对象数据组装的参数构建器。
+     * @param <T>             实体对象类型。
+     */
+    <T extends M> void buildRelationForData(T dataObject, MyRelationParam relationParam);
+
+    /**
+     * 仅仅在spring boot 启动后的监听器事件中调用，缓存所有service的关联关系，加速后续的数据绑定效率。
+     */
+    void loadRelationStruct();
+}

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/cache/MapDictionaryCache.java

@@ -24,15 +24,15 @@ public class MapDictionaryCache<K, V> implements DictionaryCache<K, V> {
     /**
      * 存储字典数据的Map。
      */
-    protected LinkedHashMap<K, V> dataMap = new LinkedHashMap<>();
+    protected final LinkedHashMap<K, V> dataMap = new LinkedHashMap<>();
     /**
      * 获取字典主键数据的函数对象。
      */
-    protected Function<V, K> idGetter;
+    protected final Function<V, K> idGetter;
     /**
      * 由于大部分场景是读取操作，所以使用读写锁提高并发的伸缩性。
      */
-    protected ReadWriteLock lock = new ReentrantReadWriteLock();
+    protected final ReadWriteLock lock = new ReentrantReadWriteLock();
     /**
      * 超时时长。单位毫秒。
      */

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/cache/MapTreeDictionaryCache.java

@@ -28,7 +28,7 @@ public class MapTreeDictionaryCache<K, V> extends MapDictionaryCache<K, V> {
     /**
      * 获取字典父主键数据的函数对象。
      */
-    protected Function<V, K> parentIdGetter;
+    protected final Function<V, K> parentIdGetter;
 
     /**
      * 当前对象的构造器函数。

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/config/DataSourceContextHolder.java

@@ -0,0 +1,41 @@
+package com.orange.demo.common.core.config;
+
+/**
+ * 通过线程本地存储的方式，保存当前数据库操作所需的数据源类型，动态数据源会根据该值，进行动态切换。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+public class DataSourceContextHolder {
+
+    private static final ThreadLocal<Integer> CONTEXT_HOLDER = new ThreadLocal<>();
+
+    /**
+     * 设置数据源类型
+     * @param type 数据源类型
+     */
+    public static void setDataSourceType(Integer type) {
+        CONTEXT_HOLDER.set(type);
+    }
+
+    /**
+     * 获取当前数据库操作执行线程的数据源类型，同时由动态数据源的路由函数调用。
+     * @return 数据源类型。
+     */
+    public static Integer getDataSourceType() {
+        return CONTEXT_HOLDER.get();
+    }
+
+    /**
+     * 清除线程本地变量，以免内存泄漏
+     */
+    public static void clear() {
+        CONTEXT_HOLDER.remove();
+    }
+
+    /**
+     * 私有构造函数，明确标识该常量类的作用。
+     */
+    private DataSourceContextHolder() {
+    }
+}

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/config/DynamicDataSource.java

@@ -0,0 +1,17 @@
+package com.orange.demo.common.core.config;
+
+import org.springframework.jdbc.datasource.lookup.AbstractRoutingDataSource;
+
+/**
+ * 动态数据源对象。当存在多个数据连接时使用。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+public class DynamicDataSource extends AbstractRoutingDataSource {
+
+    @Override
+    protected Object determineCurrentLookupKey() {
+        return DataSourceContextHolder.getDataSourceType();
+    }
+}

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/constant/ErrorCodeEnum.java

@@ -71,7 +71,7 @@ public enum ErrorCodeEnum {
     /**
      * 错误信息。
      */
-    private String errorMessage;
+    private final String errorMessage;
 
     /**
      * 获取错误信息。

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/interceptor/MyRequestArgumentResolver.java

@@ -36,18 +36,18 @@ public class MyRequestArgumentResolver implements HandlerMethodArgumentResolver
 
     private static final String JSONBODY_ATTRIBUTE = "MY_REQUEST_BODY_ATTRIBUTE_XX";
 
-    private static Set<Class<?>> classSet = new HashSet<>();
+    private static final Set<Class<?>> CLASS_SET = new HashSet<>();
 
     static {
-        classSet.add(Integer.class);
-        classSet.add(Long.class);
-        classSet.add(Short.class);
-        classSet.add(Float.class);
-        classSet.add(Double.class);
-        classSet.add(Boolean.class);
-        classSet.add(Byte.class);
-        classSet.add(BigDecimal.class);
-        classSet.add(Character.class);
+        CLASS_SET.add(Integer.class);
+        CLASS_SET.add(Long.class);
+        CLASS_SET.add(Short.class);
+        CLASS_SET.add(Float.class);
+        CLASS_SET.add(Double.class);
+        CLASS_SET.add(Boolean.class);
+        CLASS_SET.add(Byte.class);
+        CLASS_SET.add(BigDecimal.class);
+        CLASS_SET.add(Character.class);
     }
 
     /**
@@ -214,7 +214,7 @@ public class MyRequestArgumentResolver implements HandlerMethodArgumentResolver
     }
 
     private boolean isBasicDataTypes(Class<?> clazz) {
-        return classSet.contains(clazz);
+        return CLASS_SET.contains(clazz);
     }
 
     private JSONObject getRequestBody(NativeWebRequest webRequest) throws IOException {

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/object/DummyClass.java

@@ -0,0 +1,27 @@
+package com.orange.demo.common.core.object;
+
+/**
+ * 哑元对象，主要用于注解中的缺省对象占位符。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+public final class DummyClass {
+
+    private static final Object EMPTY_OBJECT = new Object();
+
+    /**
+     * 可以忽略的空对象。避免sonarqube的各种警告。
+     *
+     * @return 空对象。
+     */
+    public static Object emptyObject() {
+        return EMPTY_OBJECT;
+    }
+
+    /**
+     * 私有构造函数，明确标识该常量类的作用。
+     */
+    private DummyClass() {
+    }
+}

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/object/MyRelationParam.java

@@ -26,6 +26,12 @@ public class MyRelationParam {
      */
     private boolean buildOneToOne;
 
+    /**
+     * 是否组装一对多关联的标记。
+     * 组装RelationOneToMany注解标记的字段。
+     */
+    private boolean buildOneToMany;
+
     /**
      * 在组装一对一关联的同时，是否继续关联从表中的字典。
      * 从表中RelationDict和RelationConstDict注解标记的字段。
@@ -65,6 +71,7 @@ public class MyRelationParam {
                 .buildDict(true)
                 .buildOneToOneWithDict(true)
                 .buildRelationAggregation(true)
+                .buildOneToMany(true)
                 .build();
     }
 
@@ -79,6 +86,7 @@ public class MyRelationParam {
                 .buildOneToOneWithDict(true)
                 .buildRelationAggregation(true)
                 .buildRelationManyToMany(true)
+                .buildOneToMany(true)
                 .build();
     }
 }

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/upload/UpDownloaderFactory.java

@@ -14,7 +14,7 @@ import java.util.Map;
 @Component
 public class UpDownloaderFactory {
 
-    private Map<UploadStoreTypeEnum, BaseUpDownloader> upDownloaderMap = new HashMap<>();
+    private final Map<UploadStoreTypeEnum, BaseUpDownloader> upDownloaderMap = new HashMap<>();
 
     /**
      * 根据存储类型获取上传下载对象。

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/util/ApplicationContextHolder.java

@@ -56,7 +56,7 @@ public class ApplicationContextHolder implements ApplicationContextAware {
     /**
      * 根据Bean的ClassType，获取Bean对象。
      *
-     * @param beanType Bean的Class类型。。
+     * @param beanType Bean的Class类型。
      * @param <T> 返回的Bean类型。
      * @return Bean对象。
      */
@@ -68,7 +68,7 @@ public class ApplicationContextHolder implements ApplicationContextAware {
     /**
      * 根据Bean的ClassType，获取Bean对象列表。
      *
-     * @param beanType Bean的Class类型。。
+     * @param beanType Bean的Class类型。
      * @param <T>      返回的Bean类型。
      * @return Bean对象列表。
      */

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/util/ImportUtil.java

@@ -101,11 +101,11 @@ public class ImportUtil {
      * @param <T> 导入数据对象类型。
      */
     public abstract static class BaseImporter<T> {
-        private Class<T> beanType;
-        private List<T> batchRowList = new LinkedList<>();
-        private int batchSize;
+        private final Class<T> beanType;
+        private final List<T> batchRowList = new LinkedList<>();
+        private final int batchSize;
+        private final Map<String, String> headerColumnMap;
         private Field[] fieldArray = null;
-        private Map<String, String> headerColumnMap;
 
         public BaseImporter(int batchSize, Class<T> beanType, Map<String, String> headerColumnMap) {
             if (batchSize <= 0) {
@@ -185,7 +185,7 @@ public class ImportUtil {
     }
 
     static class MyExcel07SaxReader<T> extends Excel07SaxReader {
-        private BaseImporter<T> importer;
+        private final BaseImporter<T> importer;
 
         MyExcel07SaxReader(BaseImporter<T> importer) {
             super((sheetIndex, rowIndex, rowList) -> importer.doImport(rowIndex, rowList));

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/util/MyCommonUtil.java

@@ -1,9 +1,9 @@
 package com.orange.demo.common.core.util;
 
+import cn.hutool.core.collection.CollUtil;
 import cn.hutool.core.util.ReflectUtil;
+import cn.hutool.core.util.StrUtil;
 import cn.hutool.crypto.digest.DigestUtil;
-import org.apache.commons.collections4.CollectionUtils;
-import org.apache.commons.lang3.StringUtils;
 
 import javax.validation.ConstraintViolation;
 import javax.validation.Validation;
@@ -20,10 +20,10 @@ import java.util.stream.Collectors;
  */
 public class MyCommonUtil {
 
-    private static Validator validator;
+    private static final Validator VALIDATOR;
 
     static {
-        validator = Validation.buildDefaultValidatorFactory().getValidator();
+        VALIDATOR = Validation.buildDefaultValidatorFactory().getValidator();
     }
 
     /**
@@ -85,9 +85,9 @@ public class MyCommonUtil {
      */
     public static boolean isBlankOrNull(Object obj) {
         if (obj instanceof Collection) {
-            return CollectionUtils.isEmpty((Collection<?>) obj);
+            return CollUtil.isEmpty((Collection<?>) obj);
         }
-        return obj == null || (obj instanceof CharSequence && StringUtils.isBlank((CharSequence) obj));
+        return obj == null || (obj instanceof CharSequence && StrUtil.isBlank((CharSequence) obj));
     }
 
     /**
@@ -108,7 +108,7 @@ public class MyCommonUtil {
      * @return 没有错误返回null，否则返回具体的错误信息。
      */
     public static <T> String getModelValidationError(T model, Class<?>...groups) {
-        Set<ConstraintViolation<T>> constraintViolations = validator.validate(model, groups);
+        Set<ConstraintViolation<T>> constraintViolations = VALIDATOR.validate(model, groups);
         if (!constraintViolations.isEmpty()) {
             Iterator<ConstraintViolation<T>> it = constraintViolations.iterator();
             ConstraintViolation<T> constraint = it.next();
@@ -136,6 +136,19 @@ public class MyCommonUtil {
         return sb.toString();
     }
 
+    /**
+     * 将SQL Like中的通配符替换为字符本身的含义，以便于比较。
+     *
+     * @param str 待替换的字符串。
+     * @return 替换后的字符串。
+     */
+    public static String replaceSqlWildcard(String str) {
+        if (StrUtil.isBlank(str)) {
+            return str;
+        }
+        return StrUtil.replaceChars(StrUtil.replaceChars(str, "_", "\\_"), "%", "\\%");
+    }
+
     /**
      * 获取对象中，非空字段的名字列表。
      *
@@ -149,7 +162,7 @@ public class MyCommonUtil {
         List<String> fieldNameList = Arrays.stream(fields)
                 .filter(f -> ReflectUtil.getFieldValue(object, f) != null)
                 .map(Field::getName).collect(Collectors.toList());
-        if (CollectionUtils.isNotEmpty(fieldNameList)) {
+        if (CollUtil.isNotEmpty(fieldNameList)) {
             return fieldNameList.toArray(new String[]{});
         }
         return new String[]{};

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/util/MyModelUtil.java

@@ -2,11 +2,9 @@ package com.orange.demo.common.core.util;
 
 import cn.hutool.core.bean.BeanUtil;
 import cn.hutool.core.util.ReflectUtil;
-import com.orange.demo.common.core.annotation.RelationConstDict;
-import com.orange.demo.common.core.annotation.RelationDict;
-import com.orange.demo.common.core.annotation.RelationOneToOne;
-import com.orange.demo.common.core.annotation.UploadFlagColumn;
+import com.orange.demo.common.core.annotation.*;
 import com.orange.demo.common.core.exception.MyRuntimeException;
+import com.orange.demo.common.core.object.TokenData;
 import com.orange.demo.common.core.object.Tuple2;
 import com.orange.demo.common.core.upload.UploadStoreInfo;
 import lombok.extern.slf4j.Slf4j;
@@ -18,8 +16,8 @@ import tk.mybatis.mapper.entity.Example;
 import javax.persistence.Column;
 import javax.persistence.Table;
 import javax.persistence.Transient;
-import java.lang.reflect.Field;
 import java.lang.reflect.Modifier;
+import java.lang.reflect.Field;
 import java.util.*;
 import java.util.concurrent.ConcurrentHashMap;
 import java.util.function.Function;
@@ -46,10 +44,26 @@ public class MyModelUtil {
      * 日期型字段。
      */
     public static final Integer DATE_FIELD_TYPE = 2;
+    /**
+     * 整个工程的实体对象中，创建者Id字段的Java对象名。
+     */
+    public static final String CREATE_USER_ID_FIELD_NAME = "createUserId";
+    /**
+     * 整个工程的实体对象中，创建时间字段的Java对象名。
+     */
+    public static final String CREATE_TIME_FIELD_NAME = "createTime";
+    /**
+     * 整个工程的实体对象中，更新者Id字段的Java对象名。
+     */
+    public static final String UPDATE_USER_ID_FIELD_NAME = "updateUserId";
+    /**
+     * 整个工程的实体对象中，更新时间字段的Java对象名。
+     */
+    public static final String UPDATE_TIME_FIELD_NAME = "updateTime";
     /**
      * mapToColumnName和mapToColumnInfo使用的缓存。
      */
-    private static Map<String, Tuple2<String, Integer>> cachedColumnInfoMap = new ConcurrentHashMap<>();
+    private static final Map<String, Tuple2<String, Integer>> CACHED_COLUMNINFO_MAP = new ConcurrentHashMap<>();
 
     /**
      * 拷贝源类型的集合数据到目标类型的集合中，其中源类型和目标类型中的对象字段类型完全相同。
@@ -140,17 +154,17 @@ public class MyModelUtil {
         }
         StringBuilder sb = new StringBuilder(128);
         sb.append(modelClazz.getName()).append("-#-").append(fieldName);
-        Tuple2<String, Integer> columnInfo = cachedColumnInfoMap.get(sb.toString());
+        Tuple2<String, Integer> columnInfo = CACHED_COLUMNINFO_MAP.get(sb.toString());
         if (columnInfo == null) {
             Field field = ReflectUtil.getField(modelClazz, fieldName);
             if (field == null) {
                 return null;
             }
             Column c = field.getAnnotation(Column.class);
-            String typeName = field.getType().getSimpleName();
             String columnName = c == null ? fieldName : c.name();
             // 这里缺省情况下都是按照整型去处理，因为他覆盖太多的类型了。
             // 如Integer/Long/Double/BigDecimal，可根据实际情况完善和扩充。
+            String typeName = field.getType().getSimpleName();
             Integer type = NUMERIC_FIELD_TYPE;
             if (String.class.getSimpleName().equals(typeName)) {
                 type = STRING_FIELD_TYPE;
@@ -158,7 +172,7 @@ public class MyModelUtil {
                 type = DATE_FIELD_TYPE;
             }
             columnInfo = new Tuple2<>(columnName, type);
-            cachedColumnInfoMap.put(sb.toString(), columnInfo);
+            CACHED_COLUMNINFO_MAP.put(sb.toString(), columnInfo);
         }
         return columnInfo;
     }
@@ -447,6 +461,43 @@ public class MyModelUtil {
         }
     }
 
+    /**
+     * 在主Model类型中，根据thisRelationField字段的RelationOneToMany注解参数，将被关联对象列表thatModelList中的数据，
+     * 逐个关联到thisModelList每一个元素的thisRelationField字段中。
+     *
+     * @param thisClazz         主对象的Class对象。
+     * @param thisModelList     主对象列表。
+     * @param thatModelList     一对多关联对象列表。
+     * @param thisRelationField 主表对象中保存被关联对象的字段名称。
+     * @param <T>               主表对象类型。
+     * @param <R>               从表对象类型。
+     */
+    public static <T, R> void makeOneToManyRelation(
+            Class<T> thisClazz, List<T> thisModelList, List<R> thatModelList, String thisRelationField) {
+        if (CollectionUtils.isEmpty(thatModelList) || CollectionUtils.isEmpty(thisModelList)) {
+            return;
+        }
+        // 这里不做任何空值判断，从而让配置错误在调试期间即可抛出
+        Field thisTargetField = ReflectUtil.getField(thisClazz, thisRelationField);
+        RelationOneToMany r = thisTargetField.getAnnotation(RelationOneToMany.class);
+        Field masterIdField = ReflectUtil.getField(thisClazz, r.masterIdField());
+        Class<?> thatClass = r.slaveModelClass();
+        Field slaveIdField = ReflectUtil.getField(thatClass, r.slaveIdField());
+        Map<Object, List<R>> thatMap = new HashMap<>(20);
+        thatModelList.forEach(thatModel -> {
+            Object id = ReflectUtil.getFieldValue(thatModel, slaveIdField);
+            List<R> thatModelSubList = thatMap.computeIfAbsent(id, k -> new LinkedList<>());
+            thatModelSubList.add(thatModel);
+        });
+        thisModelList.forEach(thisModel -> {
+            Object id = ReflectUtil.getFieldValue(thisModel, masterIdField);
+            List<R> thatModel = thatMap.get(id);
+            if (thatModel != null) {
+                ReflectUtil.setFieldValue(thisModel, thisTargetField, thatModel);
+            }
+        });
+    }
+
     private static <M> Object normalize(boolean isMap, M model) {
         return isMap ? BeanUtil.beanToMap(model) : model;
     }
@@ -512,6 +563,86 @@ public class MyModelUtil {
         return uploadStoreInfo;
     }
 
+    /**
+     * 在插入实体对象数据之前，可以调用该方法，初始化通用字段的数据。
+     *
+     * @param data 实体对象。
+     * @param <M>  实体对象类型。
+     */
+    public static <M> void fillCommonsForInsert(M data) {
+        try {
+            Field createdByField = ReflectUtil.getField(data.getClass(), CREATE_USER_ID_FIELD_NAME);
+            if (createdByField != null) {
+                ReflectUtil.setAccessible(createdByField);
+                createdByField.set(data, TokenData.takeFromRequest().getUserId());
+            }
+            Field createTimeField = ReflectUtil.getField(data.getClass(), CREATE_TIME_FIELD_NAME);
+            if (createTimeField != null) {
+                ReflectUtil.setAccessible(createTimeField);
+                createTimeField.set(data, new Date());
+            }
+            Field updatedByField = ReflectUtil.getField(data.getClass(), UPDATE_USER_ID_FIELD_NAME);
+            if (updatedByField != null) {
+                ReflectUtil.setAccessible(updatedByField);
+                updatedByField.set(data, TokenData.takeFromRequest().getUserId());
+            }
+            Field updateTimeField = ReflectUtil.getField(data.getClass(), UPDATE_TIME_FIELD_NAME);
+            if (updateTimeField != null) {
+                ReflectUtil.setAccessible(updateTimeField);
+                updateTimeField.set(data, new Date());
+            }
+        } catch (IllegalAccessException e) {
+            throw new MyRuntimeException(e);
+        }
+    }
+
+    /**
+     * 在更新实体对象数据之前，可以调用该方法，更新通用字段的数据。
+     *
+     * @param data         实体对象。
+     * @param originalData 原有实体对象。
+     * @param <M>          实体对象类型。
+     */
+    public static <M> void fillCommonsForUpdate(M data, M originalData) {
+        try {
+            Object createdByValue = ReflectUtil.getFieldValue(originalData, CREATE_USER_ID_FIELD_NAME);
+            if (createdByValue != null) {
+                ReflectUtil.setFieldValue(data, CREATE_USER_ID_FIELD_NAME, createdByValue);
+            }
+            Object createTimeValue = ReflectUtil.getFieldValue(originalData, CREATE_TIME_FIELD_NAME);
+            if (createTimeValue != null) {
+                ReflectUtil.setFieldValue(data, CREATE_TIME_FIELD_NAME, createTimeValue);
+            }
+            Field updatedByField = ReflectUtil.getField(data.getClass(), UPDATE_USER_ID_FIELD_NAME);
+            if (updatedByField != null) {
+                ReflectUtil.setAccessible(updatedByField);
+                updatedByField.set(data, TokenData.takeFromRequest().getUserId());
+            }
+            Field updateTimeField = ReflectUtil.getField(data.getClass(), UPDATE_TIME_FIELD_NAME);
+            if (updateTimeField != null) {
+                ReflectUtil.setAccessible(updateTimeField);
+                updateTimeField.set(data, new Date());
+            }
+        } catch (IllegalAccessException e) {
+            throw new MyRuntimeException(e);
+        }
+    }
+
+    /**
+     * 为实体对象字段设置缺省值。如果data对象中指定字段的值为NULL，则设置缺省值，否则跳过。
+     * @param data         实体对象。
+     * @param fieldName    实体对象字段名。
+     * @param defaultValue 缺省值。
+     * @param <M> 实体对象类型。
+     * @param <V> 缺省值类型。
+     */
+    public static <M, V> void setDefaultValue(M data, String fieldName, V defaultValue) {
+        Object v = ReflectUtil.getFieldValue(data, fieldName);
+        if (v == null) {
+            ReflectUtil.setFieldValue(data, fieldName, defaultValue);
+        }
+    }
+
     /**
      * 私有构造函数，明确标识该常量类的作用。
      */

orange-demo-single-service-for-app/common/common-core/src/main/java/com/orange/demo/common/core/util/RsaUtil.java

@@ -26,7 +26,7 @@ public class RsaUtil {
     /**
      * 用于封装随机产生的公钥与私钥
      */
-    private static Map<Integer, String> keyMap = new HashMap<>();
+    private static final Map<Integer, String> KEY_MAP = new HashMap<>();
 
     /**
      * 随机生成密钥对。
@@ -47,9 +47,9 @@ public class RsaUtil {
         String privateKeyString = Base64.getEncoder().encodeToString(privateKey.getEncoded());
         // 将公钥和私钥保存到Map
         // 0表示公钥
-        keyMap.put(0, publicKeyString);
+        KEY_MAP.put(0, publicKeyString);
         // 1表示私钥
-        keyMap.put(1, privateKeyString);
+        KEY_MAP.put(1, privateKeyString);
     }
 
     /**
@@ -96,19 +96,19 @@ public class RsaUtil {
         // 生成公钥和私钥
         genKeyPair();
         // 加密字符串
-        System.out.println("公钥:" + keyMap.get(0));
-        System.out.println("私钥:" + keyMap.get(1));
+        System.out.println("公钥:" + KEY_MAP.get(0));
+        System.out.println("私钥:" + KEY_MAP.get(1));
         System.out.println("生成密钥消耗时间:" + (System.currentTimeMillis() - temp) / 1000.0 + "秒");
         System.out.println("生成后的公钥前端使用!");
         System.out.println("生成后的私钥后台使用!");
         String message = "RSA测试ABCD~!@#$";
         System.out.println("原文:" + message);
         temp = System.currentTimeMillis();
-        String messageEn = encrypt(message, keyMap.get(0));
+        String messageEn = encrypt(message, KEY_MAP.get(0));
         System.out.println("密文:" + messageEn);
         System.out.println("加密消耗时间:" + (System.currentTimeMillis() - temp) / 1000.0 + "秒");
         temp = System.currentTimeMillis();
-        String messageDe = decrypt(messageEn, keyMap.get(1));
+        String messageDe = decrypt(messageEn, KEY_MAP.get(1));
         System.out.println("解密:" + messageDe);
         System.out.println("解密消耗时间:" + (System.currentTimeMillis() - temp) / 1000.0 + "秒");
     }

orange-demo-single-service-for-app/common/common-sequence/src/main/java/com/orange/demo/common/sequence/generator/BasicIdGenerator.java

@@ -13,7 +13,7 @@ import cn.hutool.core.util.IdUtil;
  */
 public class BasicIdGenerator implements MyIdGenerator {
 
-    private Snowflake snowflake;
+    private final Snowflake snowflake;
 
     /**
      * 构造函数。

orange-demo-single-service-for-app/common/common-swagger/pom.xml

@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <parent>
+        <artifactId>common</artifactId>
+        <groupId>com.orange.demo</groupId>
+        <version>1.0.0</version>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+
+    <artifactId>common-swagger</artifactId>
+    <version>1.0.0</version>
+    <name>common-swagger</name>
+    <packaging>jar</packaging>
+
+    <dependencies>
+        <dependency>
+            <groupId>com.github.xiaoymin</groupId>
+            <artifactId>knife4j-spring-boot-starter</artifactId>
+            <version>${knife4j.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>com.orange.demo</groupId>
+            <artifactId>common-core</artifactId>
+            <version>1.0.0</version>
+        </dependency>
+    </dependencies>
+</project>

orange-demo-single-service-for-app/common/common-swagger/src/main/java/com/orange/demo/common/swagger/config/SwaggerAutoConfiguration.java

@@ -0,0 +1,56 @@
+package com.orange.demo.common.swagger.config;
+
+import com.orange.demo.common.core.annotation.MyRequestBody;
+import com.github.xiaoymin.knife4j.spring.annotations.EnableKnife4j;
+import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
+import org.springframework.boot.context.properties.EnableConfigurationProperties;
+import org.springframework.context.annotation.Bean;
+import springfox.documentation.builders.ApiInfoBuilder;
+import springfox.documentation.builders.PathSelectors;
+import springfox.documentation.builders.RequestHandlerSelectors;
+import springfox.documentation.service.ApiInfo;
+import springfox.documentation.spi.DocumentationType;
+import springfox.documentation.spring.web.plugins.Docket;
+import springfox.documentation.swagger2.annotations.EnableSwagger2;
+
+/**
+ * 自动加载bean的配置对象。
+ *
+ * @author Jerry
+ * @date 2020-09-24
+ */
+@EnableSwagger2
+@EnableKnife4j
+@EnableConfigurationProperties(SwaggerProperties.class)
+@ConditionalOnProperty(prefix = "swagger", name = "enabled")
+public class SwaggerAutoConfiguration {
+
+    @Bean
+    public Docket upmsDocket(SwaggerProperties properties) {
+        return new Docket(DocumentationType.SWAGGER_2)
+                .groupName("1. 用户权限分组接口")
+                .ignoredParameterTypes(MyRequestBody.class)
+                .apiInfo(apiInfo(properties))
+                .select()
+                .apis(RequestHandlerSelectors.basePackage(properties.getBasePackage() + ".upms.controller"))
+                .paths(PathSelectors.any()).build();
+    }
+
+    @Bean
+    public Docket bizDocket(SwaggerProperties properties) {
+        return new Docket(DocumentationType.SWAGGER_2)
+                .groupName("2. 业务应用分组接口")
+                .ignoredParameterTypes(MyRequestBody.class)
+                .apiInfo(apiInfo(properties))
+                .select()
+                .apis(RequestHandlerSelectors.basePackage(properties.getBasePackage() + ".app.controller"))
+                .paths(PathSelectors.any()).build();
+    }
+
+    private ApiInfo apiInfo(SwaggerProperties properties) {
+        return new ApiInfoBuilder()
+                .title(properties.getTitle())
+                .description(properties.getDescription())
+                .version(properties.getVersion()).build();
+    }
+}