// 声明该类所属的包，用于组织和管理服务实现类，这里是 com.service.impl 包
package com.service.impl;

// 导入 Spring 框架的 Service 注解，用于将当前类标记为一个服务组件，使其能被 Spring 容器管理
import org.springframework.stereotype.Service;
// 导入 Java 标准库中的 Map 接口，用于处理键值对数据，常用于方法参数传递等场景
import java.util.Map;
// 导入 Java 标准库中的 List 接口，用于处理一组有序的对象集合，常用于方法的返回值或参数中
import java.util.List;

// 导入 MyBatis-Plus 框架的 Wrapper 接口，用于构建查询条件的包装器
import com.baomidou.mybatisplus.mapper.Wrapper;
// 导入 MyBatis-Plus 框架的 EntityWrapper 类，用于创建基于实体类的查询条件包装器
import com.baomidou.mybatisplus.mapper.EntityWrapper;
// 导入 MyBatis-Plus 框架的 Page 类，用于处理分页查询，存储分页相关的数据
import com.baomidou.mybatisplus.plugins.Page;
// 导入 MyBatis-Plus 框架的 ServiceImpl 类，提供了基础的服务层实现方法和通用功能
import com.baomidou.mybatisplus.service.impl.ServiceImpl;
// 导入自定义的 PageUtils 工具类，用于处理分页结果，将 MyBatis-Plus 的 Page 对象转换为自定义的分页工具对象
import com.utils.PageUtils;
// 导入自定义的 Query 工具类，用于从参数 Map 中构建分页查询所需的参数和 Page 对象
import com.utils.Query;

// 导入自定义的数据访问对象接口，用于对如转派（根据类名推测）相关数据进行数据库操作
import com.dao.RuzhuanpaiDao;
// 导入自定义的如转派实体类，用于表示数据库中如转派表的记录
import com.entity.RuzhuanpaiEntity;
// 导入自定义的如转派服务接口，当前类实现该接口以提供具体的如转派业务逻辑
import com.service.RuzhuanpaiService;
// 导入自定义的如转派值对象类，用于在特定业务场景下传输和处理如转派相关的数据
import com.entity.vo.RuzhuanpaiVO;
// 导入自定义的如转派视图类，用于以特定的视图形式展示如转派相关的数据
import com.entity.view.RuzhuanpaiView;

// 使用 Service 注解将该类注册为 Spring 的服务组件，服务名称为 "ruzhuanpaiService"
@Service("ruzhuanpaiService")
// 继承 ServiceImpl 类，并指定数据访问对象为 RuzhuanpaiDao 和实体类为 RuzhuanpaiEntity，实现 RuzhuanpaiService 接口
public class RuzhuanpaiServiceImpl extends ServiceImpl<RuzhuanpaiDao, RuzhuanpaiEntity> implements RuzhuanpaiService {

	// 重写 queryPage 方法，根据传入的参数进行分页查询如转派实体数据
	// @param params 包含查询条件、分页参数等信息的 Map 集合
	// @return PageUtils 对象，包含了分页查询结果的相关信息，如总记录数、当前页码等
	@Override
	public PageUtils queryPage(Map<String, Object> params) {
		// 创建分页对象，使用 Query 工具类从参数中构建分页参数并获取 Page 对象
		Page<RuzhuanpaiEntity> page = this.selectPage(
				new Query<RuzhuanpaiEntity>(params).getPage(),
				// 创建一个空的实体查询条件包装器，即查询所有符合条件的记录（这里未添加具体条件）
				new EntityWrapper<RuzhuanpaiEntity>()
		);
		// 使用 PageUtils 工具类将 MyBatis-Plus 的 Page 对象转换为自定义的分页工具对象并返回
		return new PageUtils(page);
	}

	// 重写 queryPage 方法，根据传入的参数和查询条件进行分页查询如转派视图数据
	// @param params 包含查询条件、分页参数等信息的 Map 集合
	// @param wrapper 用于构建查询条件的包装器，类型为 RuzhuanpaiEntity 的包装器
	// @return PageUtils 对象，包含了分页查询结果的相关信息
	@Override
	public PageUtils queryPage(Map<String, Object> params, Wrapper<RuzhuanpaiEntity> wrapper) {
		// 创建分页对象，使用 Query 工具类从参数中构建分页参数并获取 Page 对象，指定类型为 RuzhuanpaiView
		Page<RuzhuanpaiView> page = new Query<RuzhuanpaiView>(params).getPage();
		// 设置分页对象的记录，通过调用数据访问对象的 selectListView 方法，传入分页对象和查询条件包装器获取结果
		page.setRecords(baseMapper.selectListView(page, wrapper));
		// 使用 PageUtils 工具类将 MyBatis-Plus 的 Page 对象转换为自定义的分页工具对象并返回
		PageUtils pageUtil = new PageUtils(page);
		return pageUtil;
	}

	// 重写 selectListVO 方法，根据传入的查询条件查询如转派值对象列表
	// @param wrapper 用于构建查询条件的包装器，类型为 RuzhuanpaiEntity 的包装器
	// @return 包含如转派值对象的 List 集合
	@Override
	public List<RuzhuanpaiVO> selectListVO(Wrapper<RuzhuanpaiEntity> wrapper) {
		// 调用数据访问对象的 selectListVO 方法，传入查询条件包装器，获取如转派值对象列表
		return baseMapper.selectListVO(wrapper);
	}

	// 重写 selectVO 方法，根据传入的查询条件查询单个如转派值对象
	// @param wrapper 用于构建查询条件的包装器，类型为 RuzhuanpaiEntity 的包装器
	// @return 单个如转派值对象
	@Override
	public RuzhuanpaiVO selectVO(Wrapper<RuzhuanpaiEntity> wrapper) {
		// 调用数据访问对象的 selectVO 方法，传入查询条件包装器，获取单个如转派值对象
		return baseMapper.selectVO(wrapper);
	}

	// 重写 selectListView 方法，根据传入的查询条件查询如转派视图列表
	// @param wrapper 用于构建查询条件的包装器，类型为 RuzhuanpaiEntity 的包装器
	// @return 包含如转派视图的 List 集合
	@Override
	public List<RuzhuanpaiView> selectListView(Wrapper<RuzhuanpaiEntity> wrapper) {
		// 调用数据访问对象的 selectListView 方法，传入查询条件包装器，获取如转派视图列表
		return baseMapper.selectListView(wrapper);
	}

	// 重写 selectView 方法，根据传入的查询条件查询单个如转派视图
	// @param wrapper 用于构建查询条件的包装器，类型为 RuzhuanpaiEntity 的包装器
	// @return 单个如转派视图
	@Override
	public RuzhuanpaiView selectView(Wrapper<RuzhuanpaiEntity> wrapper) {
		// 调用数据访问对象的 selectView 方法，传入查询条件包装器，获取单个如转派视图
		return baseMapper.selectView(wrapper);
	}
}