package com.dao;

import com.entity.YonghuEntity;
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.YonghuVO;
import com.entity.view.YonghuView;


/**
 * 用户
 * 业务用户数据访问接口
 * 用于管理业务系统中的普通用户数据
 * @author
 * @email
 * @date 2023-02-17 16:59:28
 */
public interface YonghuDao extends BaseMapper<YonghuEntity> {

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

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

    /**
     * 查询用户视图列表
     * 返回视图对象列表，通常包含关联表的数据（如地址信息、订单统计等）
     * @param wrapper 查询条件包装器
     * @return 用户视图列表
     */
    List<YonghuView> selectListView(@Param("ew") Wrapper<YonghuEntity> wrapper);

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

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