sa-token-core 0.2.0

// Author: 金书记
//
//! Token 验证器

use crate::error::{SaTokenError, SaTokenResult};
use crate::token::TokenInfo;

/// Token 验证器 | Token Validator
///
/// 用于验证 Token 的有效性和格式
/// Used to validate token validity and format
///
/// # 使用示例 | Usage Example
///
/// ```rust,ignore
/// use sa_token_core::TokenValidator;
///
/// // 验证 Token 信息 | Validate token info
/// TokenValidator::validate(&token_info)?;
///
/// // 检查 Token 格式 | Check token format
/// TokenValidator::check_format("my-token-123")?;
/// ```
pub struct TokenValidator;

impl TokenValidator {
    /// 验证 token 是否有效 | Validate if Token is Valid
    ///
    /// 检查 Token 是否过期
    /// Check if token is expired
    ///
    /// # 参数 | Parameters
    /// - `token_info`: Token 信息 | Token information
    ///
    /// # 返回 | Returns
    /// - `Ok(())`: Token 有效 | Token is valid
    /// - `Err(TokenExpired)`: Token 已过期 | Token has expired
    pub fn validate(token_info: &TokenInfo) -> SaTokenResult<()> {
        // 检查是否过期 | Check if expired
        if token_info.is_expired() {
            return Err(SaTokenError::TokenExpired);
        }

        Ok(())
    }

    /// 检查 token 格式是否正确 | Check if Token Format is Correct
    ///
    /// 验证 Token 的基本格式要求
    /// Validate basic format requirements of token
    ///
    /// # 参数 | Parameters
    /// - `token`: Token 字符串 | Token string
    ///
    /// # 返回 | Returns
    /// - `Ok(())`: 格式正确 | Format is correct
    /// - `Err(TokenEmpty)`: Token 为空 | Token is empty
    /// - `Err(TokenTooShort)`: Token 太短 | Token is too short
    pub fn check_format(token: &str) -> SaTokenResult<()> {
        if token.is_empty() {
            return Err(SaTokenError::TokenEmpty);
        }

        if token.len() < 8 {
            return Err(SaTokenError::TokenTooShort);
        }

        Ok(())
    }
}

impl std::fmt::Debug for TokenValidator {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.write_str("TokenValidator { .. }")
    }
}