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;

/**
 * 用户服务接口，定义了对用户实体进行操作的方法。
 * 继承自 IService<YonghuEntity>，提供基本的 CRUD 操作。
 * 包含分页查询、条件查询、视图对象查询等方法。
 * 
 * @author 
 * @email 
 * @date 2023-02-21 09:46:06
 */
public interface YonghuService extends IService<YonghuEntity> {

    /**
     * 根据参数查询分页信息。
     * 
     * @param params 包含查询条件的参数集合。
     * @return 返回封装了分页信息的 PageUtils 对象。
     */
    PageUtils queryPage(Map<String, Object> params);
    
    /**
     * 根据条件查询视图对象列表。
     * 
     * @param wrapper 查询条件包装器。
     * @return 返回符合条件的视图对象列表。
     */
    List<YonghuVO> selectListVO(Wrapper<YonghuEntity> wrapper);
    
    /**
     * 根据条件查询单个视图对象。
     * 
     * @param wrapper 查询条件包装器。
     * @return 返回符合条件的单个视图对象。
     */
    YonghuVO selectVO(@Param("ew") Wrapper<YonghuEntity> wrapper);
    
    /**
     * 根据条件查询视图对象列表。
     * 
     * @param wrapper 查询条件包装器。
     * @return 返回符合条件的视图对象列表。
     */
    List<YonghuView> selectListView(Wrapper<YonghuEntity> wrapper);
    
    /**
     * 根据条件查询单个视图对象。
     * 
     * @param wrapper 查询条件包装器。
     * @return 返回符合条件的单个视图对象。
     */
    YonghuView selectView(@Param("ew") Wrapper<YonghuEntity> wrapper);
    
    /**
     * 根据参数和条件查询分页信息。
     * 
     * @param params 包含查询条件的参数集合。
     * @param wrapper 查询条件包装器。
     * @return 返回封装了分页信息的 PageUtils 对象。
     */
    PageUtils queryPage(Map<String, Object> params, Wrapper<YonghuEntity> wrapper);
    
    /**
     * 根据参数和条件选择值信息。
     * 
     * @param params 包含查询条件的参数集合。
     * @param wrapper 查询条件包装器。
     * @return 返回一个包含值信息的列表，每个元素是一个映射。
     */
    List<Map<String, Object>> selectValue(Map<String, Object> params, Wrapper<YonghuEntity> wrapper);
    
    /**
     * 根据参数和条件选择时间统计值信息。
     * 
     * @param params 包含查询条件的参数集合。
     * @param wrapper 查询条件包装器。
     * @return 返回一个包含时间统计值信息的列表，每个元素是一个映射。
     */
    List<Map<String, Object>> selectTimeStatValue(Map<String, Object> params, Wrapper<YonghuEntity> wrapper);
    
    /**
     * 根据参数和条件选择分组信息。
     * 
     * @param params 包含查询条件的参数集合。
     * @param wrapper 查询条件包装器。
     * @return 返回一个包含分组信息的列表，每个元素是一个映射。
     */
    List<Map<String, Object>> selectGroup(Map<String, Object> params, Wrapper<YonghuEntity> wrapper);
}