Struct JwtService 

pub struct JwtService { /* private fields */ }

JWT 服务

Implementations

impl JwtService

pub fn new(config: JwtConfig) -> JwtResult<Self>

创建新的 JWT 服务

Arguments

• config - JWT 配置

pub fn generate_token<T: Serialize>(&self, claims: &T) -> JwtResult<String>

生成令牌

Arguments

• claims - JWT Claims

pub fn verify_token<T: DeserializeOwned + 'static>( &self, token: &str, ) -> JwtResult<T>

验证令牌

Arguments

• token - JWT 令牌

pub fn generate_access_token( &self, user_id: &str, claims: AccessTokenClaims, ) -> JwtResult<String>

生成访问令牌

Arguments

• user_id - 用户 ID
• claims - 访问令牌 Claims

pub fn verify_access_token(&self, token: &str) -> JwtResult<JwtClaims>

验证访问令牌

Arguments

• token - 访问令牌

pub fn generate_refresh_token( &self, user_id: &str, session_id: &str, version: u32, ) -> JwtResult<String>

生成刷新令牌

Arguments

• user_id - 用户 ID
• session_id - 会话 ID
• version - 令牌版本

pub fn verify_refresh_token(&self, token: &str) -> JwtResult<RefreshTokenClaims>

验证刷新令牌

Arguments

• token - 刷新令牌

pub fn decode_unchecked<T: DeserializeOwned>(&self, token: &str) -> JwtResult<T>

解码令牌（不验证签名）

Arguments

• token - JWT 令牌

pub fn get_remaining_ttl(&self, token: &str) -> JwtResult<i64>

获取令牌剩余有效期

Arguments

• token - JWT 令牌

pub fn is_token_expiring_soon( &self, token: &str, threshold_seconds: i64, ) -> JwtResult<bool>

检查令牌是否即将过期

Arguments

• token - JWT 令牌
• threshold_seconds - 阈值（秒）

pub fn config(&self) -> &JwtConfig

获取配置

impl JwtService

pub fn generate_token_pair( &self, user_id: &str, access_claims: AccessTokenClaims, session_id: &str, ) -> JwtResult<TokenPair>

生成令牌对

Arguments

• user_id - 用户 ID
• access_claims - 访问令牌 Claims
• session_id - 会话 ID

pub fn rotate_token_pair( &self, refresh_token: &str, new_access_claims: Option<AccessTokenClaims>, ) -> JwtResult<TokenPair>

轮换刷新令牌

使用旧的刷新令牌生成新的令牌对，并递增版本号

Arguments

• refresh_token - 旧的刷新令牌
• new_access_claims - 新的访问令牌 Claims（可选）

Trait Implementations

impl Clone for JwtService

fn clone(&self) -> JwtService

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for JwtService

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.