package com.service;

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

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

public interface YuangongService extends IService<YuangongEntity> {

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

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

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

	List<YuangongVO> selectListVO(Wrapper<YuangongEntity> wrapper);

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

	YuangongVO selectVO(@Param("ew") Wrapper<YuangongEntity> wrapper);

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

	List<YuangongView> selectListView(Wrapper<YuangongEntity> wrapper);

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

	YuangongView selectView(@Param("ew") Wrapper<YuangongEntity> wrapper);

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

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