package com.dao;

import com.entity.DictionaryEntity;
import com.baomidou.mybatisplus.mapper.BaseMapper;
import java.util.List;
import java.util.Map;
import com.baomidou.mybatisplus.plugins.pagination.Pagination;

import org.apache.ibatis.annotations.Param;
import com.entity.view.DictionaryView;

/**
 * 字典表 Dao 接口
 * 该接口继承自 MyBatis Plus
 * 的 `BaseMapper` 接口，用于定义与字典表数据持久化操作相关的方法，
 * 这些方法主要涉及到对数据库中字典表数据的
 * 查询、插入、更新、删除等操作（继承了 `BaseMapper` 中已有的通用方法），
 * 同时在此基础上可以自定义扩展针对字典表的特定查询方法，
 * 方便与数据库进行交互，以满足业务需求。
 * @author
 */
public interface DictionaryDao extends BaseMapper<DictionaryEntity> {

   /**
    * 根据分页信息以及查询参数，获取符合条件的字典表数据列表，
    * 并转换为适合展示的视图实体类列表返回。
    * 此方法通常用于实现分页查询功能，
    * 根据传入的分页设置（如页码、每页显示数量等）以及其他自定义的查询条件参数，
    * 从数据库中检索出对应的字典表数据记录，并将其封装为 `DictionaryView` 类型的列表，
    * `DictionaryView` 可能包含了字典表数据以及关联的其他相关信息，
    * 更适合在前端展示或者其他业务场景下使用。
    *
    * @param page 分页对象，类型为 `Pagination`，
    *             通过该对象可以获取分页相关的参数信息（如当前页码、每页显示数量等），
    *             用于控制数据库查询时的分页逻辑，以获取指定页的数据记录。
    * @param params 查询参数，是一个 `Map` 类型的数据结构，
    *               用于传递各种自定义的查询条件，例如可以包含用于筛选字典表数据的关键字、
    *               按照特定字段进行范围筛选的条件等信息，方便灵活地构建复杂的查询逻辑，
    *               以获取符合业务需求的字典表数据子集。
    * @return 返回一个 `List<DictionaryView>` 类型的列表，
    * 其中包含了符合分页和查询条件的字典表数据记录对应的视图实体类对象，
    *         列表中的每个 `DictionaryView` 对象都承载了一条字典表数据以及相关的展示信息，
    *
    *
    *
    *         方便后续在业务逻辑中进行处理和展示给前端等操作。
    */
   List<DictionaryView> selectListView(Pagination page, @Param("params") Map<String, Object> params);
}