package com.service;  // 定义包路径为com.service，表示该接口属于服务层

import com.baomidou.mybatisplus.service.IService;  // 导入MyBatis-Plus服务接口
import com.utils.PageUtils;  // 导入分页工具类
import com.entity.JianshenkechengCollectionEntity;  // 导入课程收藏实体类
import java.util.Map;  // 导入Map接口，用于参数传递
import javax.servlet.http.HttpServletRequest;  // 导入HTTP请求类（保留参数）
import org.springframework.lang.Nullable;  // 导入Spring的Nullable注解（保留参数）
import java.util.List;  // 导入List接口（保留参数）


 // 健身课程收藏服务接口
 //继承MyBatis-Plus的IService接口，提供课程收藏相关业务方法

public interface JianshenkechengCollectionService extends IService<JianshenkechengCollectionEntity> {


     // 分页查询课程收藏记录
     //@param params 查询参数Map，包含以下常用键值：
     //              - page：当前页码（从1开始）
     //              - limit：每页记录数
     //              - userId：用户ID（筛选特定用户的收藏）
     //              - courseId：课程ID（筛选特定课程的收藏）
     //              - collectionTime：收藏时间（时间范围查询）
     //@return PageUtils分页对象，包含：
     //        - list：当前页收藏记录列表
     //        - totalCount：总记录数
     //        - pageSize：每页条数
     //        - totalPage：总页数
     //        - currPage：当前页码

    PageUtils queryPage(Map<String, Object> params);

    // 可扩展的业务方法示例：
    // boolean addCollection(Long userId, Long courseId); // 添加收藏
    // boolean cancelCollection(Long collectionId); // 取消收藏
    // boolean checkCollected(Long userId, Long courseId); // 检查是否已收藏
    // List<Long> getUserCollectionIds(Long userId); // 获取用户收藏课程ID列表
}