package com.aurora.mapper;
// 导入相册管理数据传输对象（PhotoAlbumAdminDTO），用于后台管理界面展示相册信息，通常包含相册基本属性及统计字段（如照片数量）
import com.aurora.model.dto.PhotoAlbumAdminDTO;
// 导入相册实体类（PhotoAlbum），该实体类与数据库中的相册表（如 photo_album）相对应，其字段（如相册名、封面图路径）与表结构映射
import com.aurora.entity.PhotoAlbum;
// 导入条件查询值对象（ConditionVO），用于封装前端传递的复杂查询参数（如关键词、状态、时间范围等）
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;// 导入 Java 集合框架中的 List 接口，用于返回多个相册管理DTO对象的集合

@Repository
public interface PhotoAlbumMapper extends BaseMapper<PhotoAlbum> {
    // 自定义查询方法：分页获取后台相册管理列表（通常用于管理员控制台）
    // @Param 注解为参数指定别名，在 XML 映射文件中可通过 `#{current}`、`#{size}`、`#{condition.xxx}` 引用参数值
    // current: 当前页码（从1开始），size: 每页记录数，用于实现分页查询
    // condition: 封装查询条件的对象，可能包含搜索关键词（如相册名称）、筛选状态（如是否公开）、时间范围等
    // 返回 PhotoAlbumAdminDTO 列表，该 DTO 通常扩展了相册基础信息，包含管理所需的附加字段（如相册下照片数量、创建人信息等）
    List<PhotoAlbumAdminDTO> listPhotoAlbumsAdmin(@Param("current") Long current, @Param("size") Long size, @Param("condition") ConditionVO conditionVO);

}