package com.dao;

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

import org.apache.ibatis.annotations.Param;
import com.entity.vo.QujianxinxiVO;
import com.entity.view.QujianxinxiView;


/**
 * 取件信息
 * 数据访问接口
 * @author
 * @email
 * @date 2023-02-17 16:59:28
 */
public interface QujianxinxiDao extends BaseMapper<QujianxinxiEntity> {

    /**
     * 查询取件信息VO列表
     * 返回值对象(VO)列表，通常包含取件信息的核心字段，用于列表展示
     * @param wrapper 查询条件包装器，用于构建WHERE条件、排序等
     * @return 取件信息VO列表
     */
    List<QujianxinxiVO> selectListVO(@Param("ew") Wrapper<QujianxinxiEntity> wrapper);

    /**
     * 查询单个取件信息VO
     * 返回单个值对象(VO)，用于详情展示，包含必要的取件信息字段
     * @param wrapper 查询条件包装器
     * @return 单个取件信息VO对象
     */
    QujianxinxiVO selectVO(@Param("ew") Wrapper<QujianxinxiEntity> wrapper);

    /**
     * 查询取件信息视图列表
     * 返回视图对象列表，通常包含关联表的数据（如快递信息、用户信息、快递员信息等）
     * @param wrapper 查询条件包装器
     * @return 取件信息视图列表
     */
    List<QujianxinxiView> selectListView(@Param("ew") Wrapper<QujianxinxiEntity> wrapper);

    /**
     * 分页查询取件信息视图列表
     * 支持分页的视图查询，用于前端分页展示，包含关联数据
     * @param page 分页对象，包含当前页码、每页大小、总记录数等信息
     * @param wrapper 查询条件包装器
     * @return 分页后的取件信息视图列表
     */
    List<QujianxinxiView> selectListView(Pagination page, @Param("ew") Wrapper<QujianxinxiEntity> wrapper);

    /**
     * 查询单个取件信息视图
     * 返回单个视图对象，用于详情页展示，包含所有关联的表数据
     * @param wrapper 查询条件包装器
     * @return 单个取件信息视图对象
     */
    QujianxinxiView selectView(@Param("ew") Wrapper<QujianxinxiEntity> wrapper);
}