程序包 cn.dev33.satoken.apikey

类 SaApiKeyUtil

java.lang.Object
cn.dev33.satoken.apikey.SaApiKeyUtil
public class SaApiKeyUtil extends Object
API Key 操作工具类
从以下版本开始:
1.42.0
作者:
click33

  • 构造器详细资料

    • SaApiKeyUtil

      public SaApiKeyUtil()

  • 方法详细资料

    • getApiKey

      public static ApiKeyModel getApiKey(String apiKey)
      获取 ApiKeyModel，无效的 ApiKey 会返回 null
      参数:
      apiKey - /
      返回:
      /

    • checkApiKey

      public static ApiKeyModel checkApiKey(String apiKey)
      校验 ApiKey，成功返回 ApiKeyModel，失败则抛出异常
      参数:
      apiKey - /
      返回:
      /

    • saveApiKey

      public static void saveApiKey(ApiKeyModel ak)
      持久化：ApiKeyModel
      参数:
      ak - /

    • getLoginIdByApiKey

      public static Object getLoginIdByApiKey(String apiKey)
      获取 ApiKey 所代表的 LoginId
      参数:
      apiKey - ApiKey
      返回:
      LoginId

    • deleteApiKey

      public static void deleteApiKey(String apiKey)
      删除 ApiKey
      参数:
      apiKey - ApiKey

    • deleteApiKeyByLoginId

      public static void deleteApiKeyByLoginId(Object loginId)
      删除指定 loginId 的所有 ApiKey
      参数:
      loginId - /

    • createApiKeyModel

      public static ApiKeyModel createApiKeyModel()
      创建一个 ApiKeyModel 对象
      返回:
      /

    • createApiKeyModel

      public static ApiKeyModel createApiKeyModel(Object loginId)
      创建一个 ApiKeyModel 对象
      返回:
      /

    • hasApiKeyScope

      public static boolean hasApiKeyScope(String apiKey, String... scopes)
      判断：指定 ApiKey 是否具有指定 Scope 列表 (AND 模式，需要全部具备)，返回 true 或 false
      参数:
      apiKey - ApiKey
      scopes - 需要校验的权限列表

    • checkApiKeyScope

      public static void checkApiKeyScope(String apiKey, String... scopes)
      校验：指定 ApiKey 是否具有指定 Scope 列表 (AND 模式，需要全部具备)，如果不具备则抛出异常
      参数:
      apiKey - ApiKey
      scopes - 需要校验的权限列表

    • hasApiKeyScopeOr

      public static boolean hasApiKeyScopeOr(String apiKey, String... scopes)
      判断：指定 ApiKey 是否具有指定 Scope 列表 (OR 模式，具备其一即可)，返回 true 或 false
      参数:
      apiKey - ApiKey
      scopes - 需要校验的权限列表

    • checkApiKeyScopeOr

      public static void checkApiKeyScopeOr(String apiKey, String... scopes)
      校验：指定 ApiKey 是否具有指定 Scope 列表 (OR 模式，具备其一即可)，如果不具备则抛出异常
      参数:
      apiKey - ApiKey
      scopes - 需要校验的权限列表

    • isApiKeyLoginId

      public static boolean isApiKeyLoginId(String apiKey, Object loginId)
      判断：指定 ApiKey 是否属于指定 LoginId，返回 true 或 false
      参数:
      apiKey - /
      loginId - /

    • checkApiKeyLoginId

      public static void checkApiKeyLoginId(String apiKey, Object loginId)
      校验：指定 ApiKey 是否属于指定 LoginId，如果不是则抛出异常
      参数:
      apiKey - /
      loginId - /

    • readApiKeyValue

      public static String readApiKeyValue(SaRequest request)
      数据读取：从请求对象中读取 ApiKey，获取不到返回 null

    • currentApiKey

      public static ApiKeyModel currentApiKey()
      数据读取：从请求对象中读取 ApiKey，并查询到 ApiKeyModel 信息

    • adjustIndex

      public static void adjustIndex(Object loginId, SaSession session)
      调整指定 SaSession 的 TTL 值，以保证最小化内存占用
      参数:
      loginId - /
      session - 可填写 null，代表使用 loginId 现场查询

    • getApiKeyList

      public static List<ApiKeyModel> getApiKeyList(Object loginId)
      获取指定 loginId 的 ApiKey 列表记录
      参数:
      loginId - /
      返回:
      /