actix-extended-session

为 Actix Web 提供扩展会话管理。

是 actix-session 的修改版。

文档与资源

• API 文档
• 最低支持的 Rust 版本 (MSRV)：1.57

lib.rs:

为 Actix Web 提供扩展会话管理。

actix-extended-session 提供了一个易于使用的框架，用于管理在 Actix Web 上构建的应用程序中的会话。 SessionMiddleware 是 actix-extended-session 提供的功能的基础中间件；它负责所有会话cookie的处理，并根据对活动 Session 执行的操作，指导 存储后端 创建/删除/更新会话状态。

有关会话的进一步阅读

• RFC6265;
• OWASP 的会话管理备忘单.

入门指南

要在您的 Actix Web 应用程序中使用会话，您必须将 SessionMiddleware 注册为 App 上的中间件。

use actix_web::{web, App, HttpServer, HttpResponse, Error};
use actix_extended_session::{Session, SessionMiddleware, storage::CookieSessionStore};
use actix_web::cookie::Key;

#[actix_web::main]
async fn main() -> std::io::Result<()> {
    // The secret key would usually be read from a configuration file/environment variables.
    let secret_key = Key::generate();
    HttpServer::new(move ||
            App::new()
            // Add session management to your application using Redis for session state storage
            .wrap(
                SessionMiddleware::new(
                    CookieSessionStore::default(),
                    secret_key.clone()
                )
            )
            .default_service(web::to(|| HttpResponse::Ok())))
        .bind(("127.0.0.1", 8080))?
        .run()
        .await
}

您的请求处理程序可以使用 Session 提取器访问和修改会话状态。请注意，这在流式响应的流中不起作用。

use actix_web::Error;
use actix_extended_session::Session;
use serde_json::Value;

fn index(session: Session) -> Result<&'static str, Error> {
    // access the session state
    if let Some(count) = session.get::<i32>("counter")? {
        println!("SESSION value: {}", count);
        // modify the session state
        session.insert("counter", Value::from(count + 1));
    } else {
        session.insert("counter", Value::from(1));
    }

    Ok("Welcome!")
}