package com.service; // 声明该类所属的包为com.service

// 导入List接口，用于存储多个对象的集合
import java.util.List;
// 导入Map接口，用于存储键值对，通常用于传递参数
import java.util.Map;

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

/**
 * token
 */
// 定义TokenService接口，继承自IService<TokenEntity>，具备对TokenEntity的基本CRUD操作能力
public interface TokenService extends IService<TokenEntity> {
	// 根据传入的参数进行分页查询，返回一个包含分页信息和查询结果的PageUtils对象
	PageUtils queryPage(Map<String, Object> params);

	// 根据传入的查询条件Wrapper，查询符合条件的Token实体列表，返回一个List集合
	List<TokenEntity> selectListView(Wrapper<TokenEntity> wrapper);

	// 根据传入的参数和查询条件Wrapper进行分页查询，返回一个包含分页信息和查询结果的PageUtils对象
	PageUtils queryPage(Map<String, Object> params, Wrapper<TokenEntity> wrapper);

	// 根据用户ID、用户名、表名和角色生成一个token字符串
	// 参数userid为用户的ID
	// 参数username为用户的名称
	// 参数tableName为相关表的名称
	// 参数role为用户的角色
	// 返回生成的token字符串
	String generateToken(Long userid, String username, String tableName, String role);

	// 根据传入的token字符串，查询对应的Token实体对象
	// 参数token为要查询的token字符串
	// 返回查询到的Token实体对象，如果未找到则可能返回null
	TokenEntity getTokenEntity(String token);
}