package com.service;

import com.baomidou.mybatisplus.mapper.Wrapper;
import com.baomidou.mybatisplus.service.IService;
import com.utils.PageUtils;
import com.entity.YonghuEntity;
import java.util.List;
import java.util.Map;
import com.entity.vo.YonghuVO;
import org.apache.ibatis.annotations.Param;
import com.entity.view.YonghuView;

/**
 * 用户服务接口，继承自 MyBatis-Plus 的 IService 接口，用于对用户实体（YonghuEntity）进行业务操作。
 *
 * @author
 * @email
 * @date 2022-04-04 00:20:04
 */
public interface YonghuService extends IService<YonghuEntity> {

	/**
	 * 根据传入的分页参数进行用户数据的分页查询。
	 *
	 * @param params 包含分页信息的参数映射，例如当前页码、每页记录数等。
	 * @return 返回一个 PageUtils 对象，其中封装了分页查询的结果，方便前端进行分页展示。
	 */
	PageUtils queryPage(Map<String, Object> params);

	/**
	 * 根据指定的查询条件包装器（Wrapper），查询符合条件的用户 YonghuVO 列表。
	 * YonghuVO 是一个值对象，可能包含了经过处理或特定格式的用户相关数据，用于业务逻辑层的数据传输。
	 *
	 * @param wrapper 包含具体查询条件的包装器，用于构建数据库查询语句的 WHERE 部分。
	 * @return 满足条件的用户 YonghuVO 对象的列表，如果没有符合条件的数据，则返回空列表。
	 */
	List<YonghuVO> selectListVO(Wrapper<YonghuEntity> wrapper);

	/**
	 * 根据指定的查询条件包装器（Wrapper），查询符合条件的单个用户 YonghuVO 对象。
	 * 通常用于获取唯一一条满足特定条件的用户数据。
	 *
	 * @param wrapper 包含查询条件的包装器，用于精确筛选出符合条件的记录。
	 * @return 满足条件的单个用户 YonghuVO 对象，如果没有符合条件的数据，则返回 null。
	 */
	YonghuVO selectVO(@Param("ew") Wrapper<YonghuEntity> wrapper);

	/**
	 * 根据指定的查询条件包装器（Wrapper），查询符合条件的用户 YonghuView 列表。
	 * YonghuView 是一个视图对象，可能用于展示经过处理或格式化后的用户信息，适合前端展示等场景。
	 *
	 * @param wrapper 包含查询条件的包装器，用于筛选出符合要求的用户视图数据。
	 * @return 满足条件的用户 YonghuView 对象的列表，如果没有符合条件的数据，则返回空列表。
	 */
	List<YonghuView> selectListView(Wrapper<YonghuEntity> wrapper);

	/**
	 * 根据指定的查询条件包装器（Wrapper），查询符合条件的单个用户 YonghuView 对象。
	 * 用于获取唯一一条满足特定条件的用户视图数据，例如获取某个具体用户的详细展示信息。
	 *
	 * @param wrapper 包含查询条件的包装器，用于精确筛选出符合条件的记录。
	 * @return 满足条件的单个用户 YonghuView 对象，如果没有符合条件的数据，则返回 null。
	 */
	YonghuView selectView(@Param("ew") Wrapper<YonghuEntity> wrapper);

	/**
	 * 根据传入的分页参数和查询条件包装器（Wrapper），进行带条件的用户数据分页查询。
	 *
	 * @param params  包含分页信息的参数映射，例如当前页码、每页记录数等。
	 * @param wrapper 包含具体查询条件的包装器，用于构建数据库查询语句的 WHERE 部分。
	 * @return 返回一个 PageUtils 对象，其中封装了分页查询的结果，方便前端进行分页展示。
	 */
	PageUtils queryPage(Map<String, Object> params, Wrapper<YonghuEntity> wrapper);
}