package com.service;

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

// 员工管理
 // 此接口用于处理员工管理相关的业务逻辑，继承自 MyBatis-Plus 的 IService 接口，
 // 具备对 YuangongguanliEntity 实体的基本增删改查功能，同时提供了自定义的查询和分页方法。
 // @author
 //@email
 // @date 2021-04-24 15:19:31

public interface YuangongguanliService extends IService<YuangongguanliEntity> {

	//根据传入的参数对员工管理信息进行分页查询。
	 // @param params 包含查询条件和分页信息的参数映射，如页码、每页记录数、查询关键字等。
	 // @return 封装了分页信息和查询结果的 PageUtils 对象，包含当前页的员工管理信息列表、总记录数、总页数等。

	PageUtils queryPage(Map<String, Object> params);

	// 根据指定的查询条件，查询员工管理值对象（VO）列表。
	 //值对象（VO）通常用于封装特定业务场景下需要展示或处理的数据，可能只包含实体类的部分字段。
	 // @param wrapper 用于构建查询条件的包装器，可设置各种条件（如等于、大于、小于等）来筛选员工管理信息。
	// @return 符合查询条件的员工管理值对象列表，如果没有符合条件的数据则返回空列表。

	List<YuangongguanliVO> selectListVO(Wrapper<YuangongguanliEntity> wrapper);

	// 根据指定的查询条件，查询单个员工管理值对象（VO）。
	 // @param wrapper 用于构建查询条件的包装器。
	 // @return 符合查询条件的单个员工管理值对象，如果没有符合条件的数据则返回 null。

	YuangongguanliVO selectVO(@Param("ew") Wrapper<YuangongguanliEntity> wrapper);

	// 根据指定的查询条件，查询员工管理视图对象列表。
	//视图对象通常用于展示数据，可能包含关联查询或格式化后的数据。
	// @param wrapper 用于构建查询条件的包装器。
	// @return 符合查询条件的员工管理视图对象列表，如果没有符合条件的数据则返回空列表。

	List<YuangongguanliView> selectListView(Wrapper<YuangongguanliEntity> wrapper);

	//根据指定的查询条件，查询单个员工管理视图对象。
	 // @param wrapper 用于构建查询条件的包装器。
	 // @return 符合查询条件的单个员工管理视图对象，如果没有符合条件的数据则返回 null。

	YuangongguanliView selectView(@Param("ew") Wrapper<YuangongguanliEntity> wrapper);

	//根据传入的参数和查询条件对员工管理信息进行分页查询。
	// @param params 包含查询条件和分页信息的参数映射。
	// @param wrapper 用于构建查询条件的包装器，可进一步细化查询条件。
	 // @return 封装了分页信息和查询结果的 PageUtils 对象。

	PageUtils queryPage(Map<String, Object> params, Wrapper<YuangongguanliEntity> wrapper);
}