package com.aurora.mapper;
// 导入评论数据传输对象(DTO)，用于前台数据展示
import com.aurora.model.dto.CommentAdminDTO;
import com.aurora.model.dto.CommentCountDTO;
import com.aurora.model.dto.CommentDTO;
import com.aurora.model.dto.ReplyDTO;
import com.aurora.entity.Comment;// 导入与数据库表对应的实体类Comment
// 导入查询条件值对象
import com.aurora.model.vo.CommentVO;
import com.aurora.model.vo.ConditionVO;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import org.apache.ibatis.annotations.Param;
import org.springframework.stereotype.Repository;

import java.util.List;

@Repository
public interface CommentMapper extends BaseMapper<Comment> {
    // 分页获取评论列表（通常用于前台文章详情页的评论展示）
    // @Param注解给参数起别名，在XML中可以通过#{current}、#{size}、#{commentVO.xxx}引用
    // current: 当前页码，size: 每页大小，commentVO: 封装评论查询条件（如文章ID、排序方式等）
    // 返回CommentDTO列表，包含评论的基本信息和作者信息
    List<CommentDTO> listComments(@Param("current") Long current, @Param("size") Long size, @Param("commentVO") CommentVO commentVO);
    // 根据评论ID列表获取这些评论的所有回复列表
    // commentIdList: 评论ID集合，用于批量查询多个评论的回复
    // 返回ReplyDTO列表，包含回复的详细信息（如回复内容、回复对象等）
    List<ReplyDTO> listReplies(@Param("commentIds") List<Integer> commentIdList);
    // 获取前六个热门评论（通常用于前端优先首页展示）
    // 可能按点赞数、创建时间等排序规则选取前六个评论
    List<CommentDTO> listTopSixComments();
    // 统计评论数量（根据查询条件）
    // conditionVO: 封装统计条件（如时间范围、文章ID、评论状态等）
    // 返回符合条件的评论总数，用于后台分页计算和数据统计
    Integer countComments(@Param("conditionVO") ConditionVO conditionVO);
    // 分页获取后台评论列表（管理员功能）
    // 返回CommentAdminDTO列表，可能包含更多管理字段（如IP地址、审核状态、操作日志等）
    List<CommentAdminDTO> listCommentsAdmin(@Param("current") Long current, @Param("size") Long size, @Param("conditionVO") ConditionVO conditionVO);
    // 根据类型和主题ID列表批量统计评论数量
    // type: 评论类型（如文章评论、友链评论等），topicIds: 主题ID列表（如文章ID列表）
    // 返回CommentCountDTO列表，包含每个主题的评论数量统计
    List<CommentCountDTO> listCommentCountByTypeAndTopicIds(@Param("type") Integer type, @Param("topicIds") List<Integer> topicIds);
    // 根据类型和单个主题ID统计评论数量
    // topicId: 单个主题ID（如某篇文章的ID）
    // 返回CommentCountDTO，包含指定主题的评论数量统计
    CommentCountDTO listCommentCountByTypeAndTopicId(@Param("type") Integer type, @Param("topicId") Integer topicId);

}