// 声明类所在的包为 com.service.impl
package com.service.impl;

// 导入 Java 中的 List 接口，用于存储元素集合
import java.util.List;
// 导入 Java 中的 Map 接口，用于存储键值对
import java.util.Map;

// 导入系统用户服务接口
import com.service.UsersService;
// 导入 Spring 框架的 Service 注解，用于将类标记为服务层组件
import org.springframework.stereotype.Service;

// 导入 MyBatis-Plus 的 EntityWrapper 类，用于构建查询条件
import com.baomidou.mybatisplus.mapper.EntityWrapper;
// 导入 MyBatis-Plus 的 Wrapper 接口，是 EntityWrapper 的父接口
import com.baomidou.mybatisplus.mapper.Wrapper;
// 导入 MyBatis-Plus 的 Page 类，用于分页查询
import com.baomidou.mybatisplus.plugins.Page;
// 导入 MyBatis-Plus 的 ServiceImpl 类，作为服务实现类的基类
import com.baomidou.mybatisplus.service.impl.ServiceImpl;
// 导入系统用户数据访问对象接口
import com.dao.UsersDao;
// 导入系统用户实体类
import com.entity.UsersEntity;
// 导入自定义的分页工具类
import com.utils.PageUtils;
// 导入自定义的查询工具类
import com.utils.Query;

// 使用 Service 注解将该类标记为 Spring 服务组件，名称为 userService
@Service("userService")
// 定义系统用户服务实现类，继承自 MyBatis-Plus 的 ServiceImpl 类，并实现 UsersService 接口
public class UsersServiceImpl extends ServiceImpl<UsersDao, UsersEntity> implements UsersService {

	// 重写 UsersService 接口中的 queryPage 方法，用于分页查询系统用户数据
	@Override
	public PageUtils queryPage(Map<String, Object> params) {
		// 根据传入的参数创建一个 UsersEntity 类型的分页对象
		Page<UsersEntity> page = this.selectPage(
				// 通过 Query 工具类根据参数获取分页信息
				new Query<UsersEntity>(params).getPage(),
				// 创建一个空的查询条件包装器
				new EntityWrapper<UsersEntity>()
		);
		// 根据分页对象创建 PageUtils 对象并返回
		return new PageUtils(page);
	}

	// 重写 UsersService 接口中的 selectListView 方法，用于查询系统用户列表数据
	@Override
	public List<UsersEntity> selectListView(Wrapper<UsersEntity> wrapper) {
		// 调用数据访问对象的 selectListView 方法，根据查询条件包装器查询列表数据并返回
		return baseMapper.selectListView(wrapper);
	}

	// 重写 UsersService 接口中的 queryPage 方法，支持带查询条件的分页查询系统用户数据
	@Override
	public PageUtils queryPage(Map<String, Object> params,
							   Wrapper<UsersEntity> wrapper) {
		// 根据传入的参数创建一个 UsersEntity 类型的分页对象
		Page<UsersEntity> page = new Query<UsersEntity>(params).getPage();
		// 调用数据访问对象的 selectListView 方法，根据分页对象和查询条件包装器查询列表数据并设置到分页对象中
		page.setRecords(baseMapper.selectListView(page, wrapper));
		// 根据分页对象创建 PageUtils 对象
		PageUtils pageUtil = new PageUtils(page);
		// 返回 PageUtils 对象
		return pageUtil;
	}
}