package com.dao;

import com.entity.KuaidixinxiEntity;
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.KuaidixinxiVO;
import com.entity.view.KuaidixinxiView;


/**
 * 快递信息
 * 数据访问接口
 * @author
 * @email
 * @date 2023-02-17 16:59:28
 */
public interface KuaidixinxiDao extends BaseMapper<KuaidixinxiEntity> {

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

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

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

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

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