Struct Session 

pub struct Session { /* private fields */ }

HTTP Session，持有 Redis 缓存引用、配置参数和当前会话数据。 实现了 axum FromRequestParts，可直接作为 handler 参数提取。

Implementations

impl Session

pub fn new(cache: &'static RedisCache, params: Arc<SessionParams>) -> Self

创建未登录的空 Session，数据从下一次请求中按需加载。

pub fn is_login(&self) -> bool

返回 true 表示用户已登录（account 非空）。

pub fn can_renew(&self) -> bool

返回 true 表示 Session 尚未达到最大续期次数，可以续期。

pub fn with_account(self, account: impl Into<String>, user_id: i64) -> Self

设置账号和用户 ID，账号变更时自动生成新的 Session ID，支持链式调用。

pub fn with_roles(self, roles: Vec<String>) -> Self

设置角色列表，支持链式调用。

pub fn with_groups(self, groups: Vec<String>) -> Self

设置用户组列表，支持链式调用。

pub fn refresh(&mut self)

续期：累加续期计数并更新签发时间戳。

pub fn get_account(&self) -> &str

返回当前登录的用户账号。

pub fn get_user_id(&self) -> i64

返回当前登录的用户 ID。

pub fn get_expired_at(&self) -> String

返回 Session 过期时间的格式化字符串。

pub fn is_will_expired(&self) -> bool

返回 true 表示 Session 将在 1 小时内过期。

pub fn get_issued_at(&self) -> String

返回 Session 签发时间的格式化字符串。

pub fn is_expired(&self) -> bool

返回 true 表示 Session 已超过 TTL 过期。

pub fn reset(&mut self)

重置 Session（登出），清除 ID 和账号信息。

pub async fn save(&self) -> Result<(), Error>

将当前 Session 数据持久化到 Redis，TTL 与配置一致。

Trait Implementations

impl Clone for Session

fn clone(&self) -> Session

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl From<AdminSession> for Session

fn from(se: AdminSession) -> Self

Converts to this type from the input type.

impl From<UserSession> for Session

fn from(se: UserSession) -> Self

Converts to this type from the input type.

impl<S> FromRequestParts<S> for Session

where S: Send + Sync,

axum extractor：从请求扩展中提取 Session，按需从 Redis 加载数据。 若 Cookie 中存在有效 Session ID 且 Redis 中有对应数据，则填充 SessionData。

type Rejection = Error

If the extractor fails it’ll use this “rejection” type. A rejection is a kind of error that can be converted into a response.

async fn from_request_parts( parts: &mut Parts, _state: &S, ) -> Result<Self, Self::Rejection>

Perform the extraction.

impl IntoResponse for Session

将 Session 序列化为 HTTP 响应：设置签名 Cookie + JSON 账号信息。

fn into_response(self) -> Response

Create a response.

impl TryFrom<&Session> for SignedCookieJar

将 Session 转换为携带签名 Cookie 的 SignedCookieJar。 Session ID 为空时将 Cookie max-age 设为 0（即删除 Cookie）。

type Error = Error

The type returned in the event of a conversion error.

fn try_from(se: &Session) -> Result<Self, Self::Error>

Performs the conversion.