refactor: CommentsAreaService

src/main/kotlin/plus/maa/backend/common/utils/KtExtensions.kt

@@ -0,0 +1,4 @@
+package plus.maa.backend.common.utils
+
+
+inline fun <T> T?.requireNotNull(lazyMessage: () -> Any): T = requireNotNull(this, lazyMessage)

src/main/kotlin/plus/maa/backend/controller/request/comments/CommentsAddDTO.kt

@@ -8,13 +8,22 @@ import org.hibernate.validator.constraints.Length
  * Date  2023-02-17 14:58
  */
 data class CommentsAddDTO(
-    // 评论内容
+    /**
+     * 评论内容
+     */
     @field:Length(min = 1, max = 150, message = "评论内容不可超过150字，请删减")
     @field:NotBlank(message = "请填写评论内容")
     val message: String,
-    // 评论的作业id
+    /**
+     * 评论所在作业的 id
+     */
     val copilotId: Long,
-    // 子评论来源评论id(回复评论)
+    /**
+     * 被回复评论的 id
+     */
     val fromCommentId: String? = null,
+    /**
+     * 是否接收通知
+     */
     val notification: Boolean = true
 )

src/main/kotlin/plus/maa/backend/controller/response/comments/CommentsAreaInfo.kt

@@ -6,7 +6,13 @@ package plus.maa.backend.controller.response.comments
  */
 data class CommentsAreaInfo (
     val hasNext: Boolean,
+    /**
+     * Total number of pages
+     */
     val page: Int,
+    /**
+     * Total number of elements
+     */
     val total: Long,
     val data: List<CommentsInfo>
 )