express中间件之cookie-session的使用

这是一个以cookie为基础的session中间件。

用户session可以通过cookies以下面两种方式存储:存储在客户端或者服务器端。

  • 一个模块通过cookie将session值存储在客户端。
  • 一个模块像express-session那样仅将session identifier通过cookie存储在客户端,将session值存储在服务器端,比如数据库中。

下面几点将帮助你,选择一种去使用:

  • cookie-session不需要任何数据库/资源存放在服务器端,只要所有的session值不超过最大的客户端cookie数量限制。
  • cookie-session可以简化特定的负载均衡场景。
  • cookie-session可以使用轻量级的sesseion并包括一个identifier去查询二级存储,从而减少数据库的查询次数。

API

var cookieSession = require('cookie-session');
var express = require('express');

var app = express();

app.use(cookieSession({
  name: 'session',
  keys: [/*secret keys*/],

  //Cookie Options
  maxAge: 24*60*60*1000; //24hours
}))

cookieSession(options)

通过提供的选项,创建一个新的cookie session中间件。这个中间件会将session属性依附依附到req上,session属性提供一个对象代表加载的session。这个session可以是一个新的session,如果request中没有提供有效的session,或者是一个在request中已经加载了的session。

这个中间件将自动地想response中添加Set-Cookie头,如果req.session的内容被修改了的话。

Options

Cookie session在options对象中接受下面这些属性。

name

设置cookie的名称,默认是session。

keys

用于加密和解密cookie值的秘钥列表。cookies总是使用keys[0]去加密,而其他的keys用来解密。

secret

如果keys没有提供的话,secret是一个字符串将作为单个的秘钥。

Cookie Options

其他的options可以通过cookies.get()和cookies.set()来使用,去控制安全、域名、路径和其他设置项。

这些选项包括下面的这些:

  • maxAge:一个代表从现在到过期的数字,以毫秒为单位。
  • expires:一个日期对象代表cookie失效的日期。(通常expires在session的最后一个选项)
  • path:一个代表cookie路径的字符串。
  • domain:一个代表cookie域名的选项(默认没有)
  • sameSite:一个boolean值或者字符串代表cookie是否是同一个网站的cookie(默认false)。这个选项可以被设置为’strict’,’lax’或者true(会被映射为’strict’)。
  • secure:一个boolean值暗示这个cokkie是否只能在https上传输(默认为false)
  • httpOnly:一个boolean值代表cookie是否只能在HTTP(S)上传输,并且不可以通过javascript传输。
  • signed:一个boolean值代表这个cookie是否可以被加密。(默认是true)
  • overwrite:一个boolean值代表是否可以设置同样name的cookie的值(默认为true)

req.session

代表request中的session。

.isChanged
如果在请求期间session发生了改变,值为true

.isNew
如果session是新的,值为true

.isPopulated
决定这个session是否已经存在或者是空的。

req.sessionOptions

代表当前请求的session设置项。

Destroying a session

删除一个session,只需要把它置为null。

req.session = null
  • 1
    点赞
  • 4
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值