// 声明该接口所在的包为 com.service
package com.service;

// 导入 List 类，用于存储一组对象
import java.util.List;
// 导入 Map 类，用于存储键值对，通常用于传递查询参数
import java.util.Map;

// 导入 MyBatis-Plus 的 Wrapper 类，用于构建查询条件
import com.baomidou.mybatisplus.mapper.Wrapper;
// 导入 MyBatis-Plus 的 IService 接口，提供通用的单表业务方法
import com.baomidou.mybatisplus.service.IService;
// 导入 Token 实体类，代表数据库中的 Token 数据
import com.entity.TokenEntity;
// 导入自定义的 PageUtils 类，用于处理分页查询结果
import com.utils.PageUtils;

// 定义 Token 服务接口，继承自 IService<TokenEntity>
public interface TokenService extends IService<TokenEntity> {
	// 定义分页查询方法，根据传入的查询参数进行分页查询
	// params 参数为一个 Map 对象，存储了查询所需的条件
	// 返回值为 PageUtils 对象，包含了分页查询后的结果
	PageUtils queryPage(Map<String, Object> params);

	// 定义查询列表视图的方法，根据传入的查询条件包装器查询 Token 实体列表
	// wrapper 参数为 Wrapper<TokenEntity> 类型，用于构建查询条件
	// 返回值为 List<TokenEntity> 类型，包含符合条件的 Token 实体列表
	List<TokenEntity> selectListView(Wrapper<TokenEntity> wrapper);

	// 定义带查询条件包装器的分页查询方法，根据传入的查询参数和查询条件包装器进行分页查询
	// params 参数为一个 Map 对象，存储了查询所需的条件
	// wrapper 参数为 Wrapper<TokenEntity> 类型，用于构建查询条件
	// 返回值为 PageUtils 对象，包含了分页查询后的结果
	PageUtils queryPage(Map<String, Object> params, Wrapper<TokenEntity> wrapper);

	// 定义生成 Token 的方法，根据传入的用户 ID、用户名、表名和角色生成一个 Token 字符串
	// userid 参数为 Integer 类型，表示用户的 ID
	// username 参数为 String 类型，表示用户的名称
	// tableName 参数为 String 类型，表示相关表的名称
	// role 参数为 String 类型，表示用户的角色
	// 返回值为 String 类型，即生成的 Token 字符串
	String generateToken(Integer userid, String username, String tableName, String role);

	// 定义根据 Token 字符串获取 Token 实体的方法
	// token 参数为 String 类型，表示要查询的 Token 字符串
	// 返回值为 TokenEntity 类型，即符合条件的 Token 实体
	TokenEntity getTokenEntity(String token);
}