package com.hdkj.lt.core.sys.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.hdkj.lt.core.sys.model.dto.UserQueryDTO;
import com.hdkj.lt.core.sys.model.po.SysUser;
import com.hdkj.lt.core.sys.model.po.SysRoles;


import javax.annotation.Nonnull;
import javax.annotation.Nullable;
import java.util.Collection;
import java.util.List;
import java.util.Map;
import java.util.Set;

/**
 * @Description:
 * @Author: wenhao
 * @Create: 2024/02/20 9:35
 * @Version: 1.0
 */
public interface ISysUserService extends IService<SysUser> {

    /**
     * 将用户信息全部放入缓存中
     */
    void putAllToCache();

    /**
     * 根据用户ID从缓存中获取用户信息，缓存中没有则查询数据库，再更新缓存中的用户信息
     *
     * @param userId 用户ID
     * @return 用户信息（SYS_USERS表）
     */
    SysUser getCacheOne(@Nonnull Long userId);

    /**
     * 根据用户ID从缓存中获取用户信息，缓存中没有则查询数据库，再更新缓存中的用户信息
     *
     * @param userId 用户ID
     * @return 用户信息（SYS_USERS表）
     */
    SysUser getCacheById(@Nonnull Long userId);

    /**
     * 根据用户ID集合批量从缓存中获取用户信息，缓存中没有的部分则查询数据库，再更新缓存中的用户信息
     *
     * @param userIds 用户ID集合
     * @return 用户信息Map（key为用户ID，value为用户信息）
     */
    Map<Long, SysUser> getCacheMapByIds(Collection<Long> userIds);

    /**
     * 根据用户ID集合批量从缓存中获取用户信息，缓存中没有的部分则查询数据库，再更新缓存中的用户信息
     *
     * @param userIds 用户ID集合
     * @return 用户信息Set
     */
    Set<SysUser> getCacheSetByIds(Collection<Long> userIds);

    /**
     * 查询用户角色集合，支持根据用户ID查询，当用户ID为空时默认查询当前登录用户的角色集合
     *
     * @param userId 指定查询的用户ID
     * @return 用户角色信息Set
     */
    Set<SysRoles> getRoles(@Nullable Long userId);

    /**
     * 根据各种条件查询用户
     *
     * @param queryDTO
     * @return
     */
    List<SysUser> listByCondition(UserQueryDTO queryDTO);

}
