Struct JwtUtil 

pub struct JwtUtil { /* private fields */ }

JWT 生成与解析工具

基于 HMAC-SHA256 签名的 JWT Token 管理。

示例

use tdm_server_rust::utils::JwtUtil;

let util = JwtUtil::new("my_secret_key", 7_200_000); // 2h 过期
let token = util.generate(42).expect("生成应成功");

// 解析并验证
let claims = util.parse(&token).expect("解析应成功");
assert_eq!(claims.id, 42);

Panics

不 panic。所有错误通过 jsonwebtoken::errors::Result 返回。

安全性

• 签名密钥从配置文件 jwt.sign_key 加载
• 默认有效期由 jwt.expire_ms 控制
• 解析时自动验证签名和过期时间

Implementations

impl JwtUtil

pub fn new(sign_key: impl Into<String>, expire_ms: i64) -> Self

构造 JWT 工具实例。

参数

• sign_key: HMAC-SHA256 签名密钥
• expire_ms: Token 过期时间（毫秒）

返回值

返回配置好的 JwtUtil。

pub fn generate(&self, member_id: i32) -> Result<String>

生成 JWT Token。

Claims 仅包含 id 和 exp 字段，与 Java 端一致。

参数

• member_id: 组员 ID

返回值

成功返回签名的 JWT 字符串。

Errors

仅当 HMAC 签名算法不可用时失败（不应发生）。

pub fn parse(&self, token: &str) -> Result<JwtClaims>

解析并验证 JWT Token。

自动验证签名和过期时间。

参数

• token: 待解析的 JWT 字符串

返回值

成功返回反序列化的 JwtClaims。

Errors

错误	说明
InvalidSignature	签名不匹配（密钥错误或 token 被篡改）
ExpiredSignature	Token 已过期
InvalidToken	Token 格式不合法

在 auth 中间件中，ExpiredSignature 会被转为 AppError::login_expired("登录数据过期,请重新登录喵！")。

pub fn generate_from_map( &self, claims: HashMap<String, Value>, ) -> Result<String>

从 HashMap 生成（扩展用）