Session 管理是比较复杂,Malagu 框架并没有提供一颗银弹解决任何复杂的业务场景,但提供了一套高度抽象的可扩展模型来满足大部分业务场景,特殊的场景可以通过框架提供的扩展点很方便的进行扩展。

设计图Session 设计.svg

Session

  1. export interface Session {
  2. id: string;
  3. isNew: boolean;
  4. expire: number;
  5. maxAge: number;
  6. readonly changed: boolean;
  7. [key: string]: any;
  8. toJSON(): any;
  9. }

Session 中间件

Session 默认存储器是基于 Cookie 实现,所以 Session 中间件的优先级必须比 Cookie 中间件低。当您需要在自定义的中间件中获取 Session,请务必设置您的中间件的优先级低于 Session 中间件。

Session 管理器

Session 管理器实现一般情况下不需要扩展,Malagu 框架已经 Session 管理器经常变的逻辑抽象到了 Session 存储器和 Session 策略中,大家可以通过自己的 Session 存储器和 Session 策略来满足业务需求。

  1. export interface SessionManager {
  2. get(): Promise<Session>;
  3. remove(): Promise<void>;
  4. commit(): Promise<void>;
  5. }

Session 存储器

Malagu 框架默认提供了基于 Cookie 存储的 Session 存储器,用户也可以实现基于 Redis 存储的 Session 存储器。

  1. export interface SessionStore {
  2. get(id: string): Promise<Session | undefined>;
  3. set(session: Session): Promise<void>;
  4. remove(id: string): Promise<void>;
  5. }

Session 策略

  1. export interface SessionStrategy {
  2. valid(session: Session): Promise<boolean>;
  3. create(obj?: any): Promise<Session>;
  4. shouldSaveSession(session: Session): Promise<boolean>;
  5. }

Session 配置属性

  1. malagu:
  2. session:
  3. autoCommit: true
  4. maxAge: 86400000
  5. sessionIdKey: malagu:sessionId
  6. sessionKey: malagu:session