如何使用django session

如题所述

  Django 完全支持匿名 Session。 Session 框架允许每一个用户保存并取回数据。它将数据保存在服务器端,并将发送和接收 Cookie 的操作包装起来。在 Cookie 中包含的是 Session ID,而不是数据本身。
  启用 Sessions¶
  Session 是通过 中间件 的方式实现的。
  要启用 Session 的功能,需要完成以下步骤:
  修改 MIDDLEWARE_CLASSES 设置,并确定其中包含了 'django.contrib.sessions.middleware.SessionMiddleware' 。``django-admin.py startproject`` 所创建的缺省的 settings.py 就已经激活了 SessionMiddleware 。
  将 'django.contrib.sessions' 添加到你的 INSTALLED_APPS 设置中,并执行 manage.py syncdb 以便安装用于存储 Session 数据的表格。
  Changed in Django 1.0: 如果你并未使用数据库存储 Session,则此步骤可以忽略;参考 配置 Session 引擎 。
  If you don’t want to use sessions, you might as well remove the SessionMiddleware line from MIDDLEWARE_CLASSES and 'django.contrib.sessions' from your INSTALLED_APPS. It’ll save you a small bit of overhead.
  配置 Session 引擎¶
  New in Django 1.0..
  缺省情况下,Django 将 Session 存储在数据库中 (使用模型 django.contrib.sessions.models.Session)。尽管这很方便,但在某些情况下,把 Session 放在其它的地方速度会更快。因此 Django 允许您通过配置让它将 Session 数据保存在文件系统或缓冲区中。
  使用基于文件的 Session¶
  要使用基于文件的 Session,请将 SESSION_ENGINE 设置为 "django.contrib.sessions.backends.file" 。
  您可能还需要修改 SESSION_FILE_PATH 这一设置以便控制 Django 存储 Session 文件的位置,缺省情况下,它使用 tempfile.gettempdir() ,通常是 /tmp 。
  使用基于缓冲区的 Session¶
  要使用 Django 的缓冲区系统来保存 Session,需要将 SESSION_ENGINE 设置为 "django.contrib.sessions.backends.cache" 。您必须确保您已经配置了缓冲区,详情请参考 缓冲区文档 。
  Note
  只有在使用 Memcached 作为缓冲后台时,才能使用基于缓冲区的 Session。因为以本地内存作为缓冲后台时,它存储缓冲数据的时间太短了,这样直接访问文件或数据库的速度,要比通过缓冲区访问文件或数据库的速度更快一些。
  在视图中使用 Session¶
  在开启 SessionMiddleware 后,每一个 HttpRequest 对象 (Django 视图函数的第一个参数) 救火有一个 session 属性,它是一个类字典对象。您可以直接对其读写。
  Session 对象有以下标准字典函数:
  __getitem__(key)
  例子: fav_color = request.session['fav_color']
  __setitem__(key, value)
  例子: request.session['fav_color'] = 'blue'
  __delitem__(key)
  例子: del request.session['fav_color']. This raises KeyError if the given key isn’t already in the session.
  __contains__(key)
  例子: 'fav_color' in request.session
  get(key, default=None)
  例子: fav_color = request.session.get('fav_color', 'red')
  keys()
  items()
  setdefault()
  clear()
  New in Django 1.0: setdefault() 和 clear() 是在这个版本新加的。
  它还有如下方法:
  flush()
  New in Django 1.0.
  从数据库中删除当前的 Session 数据并且重新生成一个 Session 键,并将其发送给浏览器。这用于需要确保 Session 数据无法再从用户浏览器访问时,譬如调用 django.contrib.auth.logout() 时。
  set_test_cookie()
  设定检测 Cookie 以检验用户的浏览器是否支持 Cookie。因 Cookie 的工作方式,在下一次用户请求之前,您都无法得到测试结果。详情参考下面的 设置检测 Cookie 。
  test_cookie_worked()
  判断用户的浏览器是否收到了检测 Cookie,并返回 True 或 False 。因 Cookie 的工作方式,您必须在之前的独立请求中调用 set_test_cookie() 。详情参考下面的 设置检测 Cookie 。
  delete_test_cookie()
  删除检测 Cookie,请自己调用此函数以便清除该 Cookie。
  set_expiry(value)
  New in Django 1.0.
  设定 Session 的过期时间。您可以提供下述几种形式的值:
  如果 value 是整形,则它表示的是秒。例如,调用 request.session.set_expiry(300) 会让 Session 在五分钟后过期。
  如果 value 是 datetime 或 timedelta 对象,则 Session 将会在相应的日期或时间点过期。
  如果 value is 0 ,则用户的 Session 会在浏览器关闭时过期。
  如果 value is None ,则 Session 会使用全局策略来设定过期时间。
  get_expiry_age()
  New in Django 1.0.
  获得此 Session 的过期时间。对于没有自定义过期时间的 Session (或在浏览器关闭时过期的 Session),此函数返回值与 settings.SESSION_COOKIE_AGE 相同。
  get_expiry_date()
  New in Django 1.0.
  获得此 Session 的过期时间点。对于没有自定义过期时间的 Session (或在浏览器关闭时过期的 Session),此函数的返回值等于从现在到时间点 settings.SESSION_COOKIE_AGE 的秒数。
  get_expire_at_browser_close()
  New in Django 1.0.
  返回 Session 是否会在浏览器关闭时过期,返回值为 True 或 False 。
  您在视图中的任何位置都可以修改 request.session ,改多少次都行。
  Session 对象指南¶
  直接在 request.session 上使用 Python 字符串作为字典的键,这比使用 Session 对象的方法来得更直接。
  在 Session 字典中,以下划线开始的键,是保留给 Django 在内部使用的。
  不要用一个新的对象覆盖 request.session ,也不要访问或修改它的属性,它只能作为一个类字典对象使用。
  例子¶
  这个简单的视图在用户提交了评价信息后,将变量 has_commented 设定为 True ,这样就可以防止用户多次提交评价信息:
  def post_comment(request, new_comment): if request.session.get('has_commented', False): return HttpResponse("You've already commented.") c = comments.Comment(comment=new_comment) c.save() request.session['has_commented'] = True return HttpResponse('Thanks for your comment!')
  这个简单的视图让网站的“用户”登录:
  def login(request): m = Member.objects.get(username=request.POST['username']) if m.password == request.POST['password']: request.session['member_id'] = m.id return HttpResponse("You're logged in.") else: return HttpResponse("Your username and password didn't match.")
  ...与上面的例子相对应的,下面的例子则让用户退出:
  def logout(request): try: del request.session['member_id'] except KeyError: pass return HttpResponse("You're logged out.")
  实际上标准的 django.contrib.auth.logout() 还会多做一些事情从而防止因疏忽造成的数据泄露。它会调用 request.session.flush() 函数。我们使用这些例子只是演示如何操作 Session 对象,它可不是一个完整的 logout() 实现。
  设置检测 Cookie¶
  为方便起见,Django 提供了一种简单的方法来检测用户的浏览器是否支持 Cookie。只要在一个请求中调用 request.session.set_test_cookie() 并在后续请求中调用 request.session.test_cookie_worked() 即可。注意千万不要在同一次请求中同时调用。
  之所以要在两次请求中调用 set_test_cookie() 和 test_cookie_worked() 是因为 Cookie 的工作模式。当您设定了 Cookie 后,再下一次请求前,都是没有办法知道浏览器是否会接收它的。
  另外最好在测试完毕后,使用 delete_test_cookie() 清除测试用数据。
  以下是一个典型的例子:
  def login(request): if request.method == 'POST': if request.session.test_cookie_worked(): request.session.delete_test_cookie() return HttpResponse("You're logged in.") else: return HttpResponse("Please enable cookies and try again.") request.session.set_test_cookie() return render_to_response('foo/login_form.html')
  在视图外使用 Session¶
  New in Django 1.0.
  有一个 API 专门用于在视图之外操作 Session 数据:
  >>> from django.contrib.sessions.backends.db import SessionStore >>> s = SessionStore(session_key='2b1189a188b44ad18c35e113ac6ceead') >>> s['last_login'] = datetime.datetime(2005, 8, 20, 13, 35, 10) >>> s['last_login'] datetime.datetime(2005, 8, 20, 13, 35, 0) >>> s.save()
  如果您使用了 django.contrib.sessions.backends.db 后台,则每一个 Session 都是一个普通的 Django 模型。模型 Session 在文件 django/contrib/sessions/models.py 中定义。由于它是一个普通的模型,因此您可以使用 Django 的数据库编程接口直接访问它:
  >>> from django.contrib.sessions.models import Session >>> s = Session.objects.get(pk='2b1189a188b44ad18c35e113ac6ceead') >>> s.expire_date datetime.datetime(2005, 8, 20, 13, 35, 12)
  注意,要获得 Session 字典,需要调用 get_decoded() ,这是因为字典是以编码的方式存储的:
  >>> s.session_data 'KGRwMQpTJ19hdXRoX3VzZXJfaWQnCnAyCkkxCnMuMTExY2ZjODI2Yj...' >>> s.get_decoded() {'user_id': 42}
  Session 是何时存储的¶
  缺省情况下,Django 只在 Session 被修改时才会保存它,即只有字典中的值被修改或删除时:
  # Session is modified. request.session['foo'] = 'bar' # Session is modified. del request.session['foo'] # Session is modified. request.session['foo'] = {} # Gotcha: Session is NOT modified, because this alters # request.session['foo'] instead of request.session. request.session['foo']['bar'] = 'baz'
  对于在上面的最后一个,通过显示地设定 Session 对象的 modified 属性,可以通知 Session 对象它被修改了:
  request.session.modified = True
  要改变这种行为,可以将 SESSION_SAVE_EVERY_REQUEST 设定为 True 。如果 SESSION_SAVE_EVERY_REQUEST 是 True ,则 Django 在每一次独立的请求之后都会保存 Session。
  注意,只有在创建或修改 Session 的时候才会送出 Session Cookie,如果 SESSION_SAVE_EVERY_REQUEST 为 True ,则每次请求都会送出 Cookie。
  同样地,在送出 Cookie 时,它的 expires 部分每次都会被更新。
  与浏览器同步的 Session 和持久的 Session¶
  通过设置 SESSION_EXPIRE_AT_BROWSER_CLOSE ,您可以控制 Session 框架使用与浏览器同步的 Session 或持久的 Session。
  缺省情况下, SESSION_EXPIRE_AT_BROWSER_CLOSE 的值为 False ,这表示 Session Cookie 将会保存在用户的浏览器中,直到超过了 SESSION_COOKIE_AGE 。如果您希望用户不必在每次关闭浏览器后都重新登陆,请使用这种方式。
  如果 SESSION_EXPIRE_AT_BROWSER_CLOSE 设定为 True ,则 Django 会使用与浏览器同步的 Cookie,即用户关闭浏览器时 Cookie 就会过期。如果您希望用户每次打开浏览器都必须登录,请使用这种模式。
  New in Django 1.0.
  这个设置具有全局的缺省值,但可以通过调用 request.session.set_expiry() 为每个 Session 设定独立的值,相关内容在上述的 在视图中使用 Session 中有所阐述。
  清空 Session 表格¶
  注意,Session 数据有可能堆积在数据库表格 django_session 中,Django 不提供 自动清除它们的功能。它把定期清空 Session 数据的任务留给了您。
  要理解这个问题,想像一下用户使用 Session 时会发生什么。当用户登录,Django 向表格 django_session 中添加一条记录。每当 Session 数据变化时,Django 会更新这条记录。如果用户手工退出了,Django 会删除它。但是,如果用户 没有 退出,则这条记录永远都不会被删除。
  Django 提供了一个能够完成清除功能的样例脚本 django-admin.py cleanup ,它从 Session 表格中删除那些 expire_date 已经过期的记录,但是您的应用程序可能会有其它的需求。
  设置¶
  一些 Django 设置 可以帮助您控制 Session 的行为:
  SESSION_ENGINE¶
  New in Django 1.0.
  缺省值: django.contrib.sessions.backends.db
  控制 Django 在何处保存 Session 数据,合法的值为:
  'django.contrib.sessions.backends.db'
  'django.contrib.sessions.backends.file'
  'django.contrib.sessions.backends.cache'
  详情请参考 配置 Session 引擎 。
  SESSION_FILE_PATH¶
  New in Django 1.0.
  缺省值: /tmp/
  如果您使用基于文件的 Session 存储,则此变量控制着 Django 存储 Session 数据的目录。
  SESSION_COOKIE_AGE¶
  缺省值: 1209600 (两周,以秒表示)
  Session Cookie 的过期时间,以秒表示
  SESSION_COOKIE_DOMAIN¶
  缺省值: None
  Session Cookie 的域。如果是要设定跨域的 Cookie,可以将其设定为 ".lawrence.com" 的形式,否则请使用 None 。
  SESSION_COOKIE_NAME¶
  缺省值: 'sessionid'
  Session 所使用的 Cookie 的名称,可根据需要设定。
  SESSION_COOKIE_SECURE¶
  缺省值: False
  对于 Session Cookie,是否要使用安全模式。如果将此设定为 True ,则 Cookie 将会被标记为“安全”,这种情况下,浏览器就需要确定该 Cookie 是否是通过 HTTPS 连接发送的。
  SESSION_EXPIRE_AT_BROWSER_CLOSE¶
  缺省值: False
  是否当用户关闭浏览器时就让 Session 过期。详情参考上文 与浏览器同步的 Session 和持久的Session 。
  SESSION_SAVE_EVERY_REQUEST¶
  缺省值: False
  是否在每次请求时都保存 Session 数据。如果此项为 False (缺省值),则 Session 数据只有在它被修改后才会保存,即它的字典值被赋值或删除时。
  技术细节¶
  Session 字典可以接受任何与 pickle 兼容的 Python 对象,详情参考 pickle 模块 。
  Session 数据存储在数据库表格 django_session 中。
  Django 只在需要的时候才发送 Cookie,如果您没有设定任何的 Session 数据,它不会送出 Cookie。
  URL 中的 Session ID¶
  Django 的 Session 框架是完全基于 Cookie 的,并且它也只能基于 Cookie。它不会像一些软件(譬如 PHP)那样在 Session 不能正常工作时,把 Session ID 放到 URL 中。作出这一决定是经过深思熟虑的,那种方法不仅使得 URL 很丑陋,并且 Session ID 还有可能通过 “Referer” 头泄漏出去,从而给网站带来安全隐患。
温馨提示:答案为网友推荐,仅供参考

相关了解……

你可能感兴趣的内容

本站内容来自于网友发表,不代表本站立场,仅表示其个人看法,不对其真实性、正确性、有效性作任何的担保
相关事宜请发邮件给我们
© 非常风气网