Class JWT

java.lang.Object
com.sure.tool.jwt.JWT

public class JWT extends Object
JWT 令牌:链式构建与解析校验,支持 HS256/HS384/HS512/RS256,参考 Hutool 的 JWT 设计。

三段式 header.payload.signature,payload 与 header 使用 sure-json 序列化,签名基于 sure-crypto 同源 JDK 算法。

Since:
0.1.0
Author:
suretool
  • Field Details

  • Method Details

    • create

      public static JWT create()
      创建构建器。
      Returns:
      JWT 构建器
    • of

      public static JWT of(String token)
      解析既有 token(header/payload 立即可读,校验须设置密钥后调 verify())。
      Parameters:
      token - JWT 字符串
      Returns:
      JWT 对象
    • setAlgorithm

      public JWT setAlgorithm(String algorithm)
      设置签名算法。
      Parameters:
      algorithm - 算法名(HS256/HS384/HS512/RS256)
      Returns:
      this
    • setKey

      public JWT setKey(String secret)
      设置 HMAC 密钥(字符串按 UTF-8 编码)。
      Parameters:
      secret - 密钥
      Returns:
      this
    • setKey

      public JWT setKey(byte[] key)
      设置 HMAC 密钥。
      Parameters:
      key - 密钥字节
      Returns:
      this
    • setKeyPair

      public JWT setKeyPair(KeyPair keyPair)
      设置 RSA 密钥对(签名用私钥、校验用公钥)。
      Parameters:
      keyPair - 密钥对
      Returns:
      this
    • setPayload

      public JWT setPayload(String claim, Object value)
      添加 payload claim。
      Parameters:
      claim - claim 名
      value - 值
      Returns:
      this
    • setPayload

      public JWT setPayload(Map<String,Object> claims)
      批量添加 payload claims。
      Parameters:
      claims - claim 集合
      Returns:
      this
    • setExpiresAt

      public JWT setExpiresAt(Date expiresAt)
      设置过期时间(写入 exp,Unix 秒)。
      Parameters:
      expiresAt - 过期时间
      Returns:
      this
    • setIssuedAt

      public JWT setIssuedAt(Date issuedAt)
      设置签发时间(写入 iat,Unix 秒)。
      Parameters:
      issuedAt - 签发时间
      Returns:
      this
    • setNotBefore

      public JWT setNotBefore(Date notBefore)
      设置生效时间(写入 nbf,Unix 秒)。
      Parameters:
      notBefore - 生效时间
      Returns:
      this
    • sign

      public String sign()
      签发并返回 token。
      Returns:
      JWT 字符串
    • verify

      public boolean verify()
      校验签名与时间有效性(exp/nbf)。
      Returns:
      是否有效
    • verifySignature

      public boolean verifySignature()
      仅校验签名(不检查过期与生效时间)。
      Returns:
      签名是否有效
    • getPayload

      public JSONObject getPayload()
      获取 payload。
      Returns:
      payload JSON 对象
    • getHeader

      public JSONObject getHeader()
      获取 header。
      Returns:
      header JSON 对象
    • getAlgorithm

      public String getAlgorithm()
      获取算法名。
      Returns:
      算法名