/**
 * 定义包名，表明该接口所属的模块和服务层目录结构。
 * 此包路径用于组织系统用户模块下的服务接口类。
 */
package com.yf.exam.modules.sys.user.service;

/**
 * 导入 MyBatis-Plus 框架的分页元数据接口，
 * 该接口用于表示分页查询的结果，包含总记录数、当前页码等信息。
 */
import com.baomidou.mybatisplus.core.metadata.IPage;
/**
 * 导入 MyBatis-Plus 框架的扩展服务接口，
 * 该接口提供了通用的 CRUD 操作方法，可减少重复代码编写。
 */
import com.baomidou.mybatisplus.extension.service.IService;
/**
 * 导入系统角色数据传输对象类，
 * 用于在不同层之间传输角色相关的数据，避免直接暴露实体类。
 */
import com.yf.exam.modules.sys.user.dto.SysRoleDTO;
/**
 * 导入系统角色实体类，
 * 该类用于映射数据库中的角色表，封装角色的属性信息。
 */
import com.yf.exam.modules.sys.user.entity.SysRole;
/**
 * 导入自定义的分页请求数据传输对象类，
 * 用于封装分页查询的请求参数，如当前页码、每页记录数等。
 */
import com.yf.exam.core.api.dto.PagingReqDTO;

/**
 * <p>
 * 角色业务类接口，定义了与系统角色相关的业务方法。
 * 继承自 MyBatis-Plus 的 IService 接口，可使用其提供的通用服务方法。
 * </p>
 *
 * @author 聪明笨狗
 * @since 2020-04-13 16:57
 */
public interface SysRoleService extends IService<SysRole> {

    /**
     * 分页查询角色数据。
     * 根据传入的分页请求参数，从数据库中查询角色数据并进行分页处理。
     *
     * @param reqDTO 分页请求数据传输对象，包含分页查询的条件和参数。
     * @return 分页查询结果，包含符合条件的角色数据传输对象列表。
     */
    IPage<SysRoleDTO> paging(PagingReqDTO<SysRoleDTO> reqDTO);
}