Tornado源码分析 --- Redirect重定向

“重定向”简单介绍:

  “重定向”指的是HTTP重定向,是HTTP协议的一种机制。当client向server发送一个请求,要求获取一个资源时,在server接收到这个请求后发现请求的这个资源实际存放在另一个位置,于是server在返回的response中写入那个请求资源的正确的URL,并设置reponse的状态码为301(永久)或者 302(暂时),当client接受到这个response后就会根据新的URL重新发起请求。重定向有一个典型的特症,即,当一个请求被重定向以后,最终浏览器上显示的URL往往不再是开始时请求的那个URL了。这就是重定向的由来。

下面我们先看Redirect的源码,之后分析完源码后可以更好的理解其用法。

Tornado Redirect源码分析:

  在 web.py 中发现有俩个地方实现了重定向的机制:

  1. 基类 RequestHandler 中定义的 self.redirect:

 1 def redirect(self, url, permanent=False, status=None):
 2     if self._headers_written:
 3         raise Exception("Cannot redirect after headers have been written")
 4     if status is None:
 5         status = 301 if permanent else 302
 6     else:
 7         assert isinstance(status, int) and 300 <= status <= 399
 8     self.set_status(status)
 9     self.set_header("Location", utf8(url))
10     self.finish()

  先看传入进来的参数:

  • url:重定向后所返回的新的URL地址
  • permanent:默认为False,表示该重定向为临时性的;如果为True,则该重定向为永久性。
  • status:当status被指定了值的话,那个该值将会作为HTTP返回给客户端的状态码;如果没有指定特定的值,那么根据上方的permanent状态,如果permanent为True,则该status返回301;如果permanent为False,则该status返回302。

  注: 默认值为302。

  分析:

  1. 通过检测 self._headers_written 的值,来判断是否该请求已经被返回给了客户端:                                                                                                                                                                                                                                                在 基类 RequestHandler 的初始化中,self._headers_written = False,之后如果当前输出的缓冲区已经flush到了网络的时候,函数 def flush() 中会将 self._headers_written = True。所以此时头信息headers已经别写入了请求且已经返回给了客户端,是无法进行重定向了。
  2. status状态码默认为302,除非permanent参数为True(永久重定向)才会返回301。如果status指定了特定的值的话,那么对指定的值进行数据类型判断,并且status的范围为 300~399,否则会返回异常。
  3. 写入状态信息,以及 字段“Location” (用来重定向接收方到非请求URL的位置来完成请求或标识新的资源)的值
  4. 调用 finish() ,完成该HTTP请求。

  2. 类 RedirectHandler实现的重定向:

1 class RedirectHandler(RequestHandler):
2     def initialize(self, url, permanent=True):
3          self._url = url
4          self._permanent = permanent
5
6     def get(self, *args):
7          self.redirect(self._url.format(*args), permanent=self._permanent)

  介绍和用法:

  • 重定向客户端的GET请求到给定的URL。
  • 需要提供关键参数URL传入该处理类中,例如:
1 application = web.Application([
2     (r"/oldpath", web.RedirectHandler, {"url": "/newpath"}),
3 ])

   在Application中调用该 RedirectHandlerf方法,给定参数“url”,其会将 地址’/oldpath‘ 重定向到 ’/newpath‘ 中。

  • 该类也支持对重定向URL地址进行正则表达式匹配,例如为了实现交换第一个和第二个参数部分,同事保留其余部分不变: 
1 application = web.Application([
2     (r"/(.*?)/(.*?)/(.*)", web.RedirectHandler, {"url": "/{1}/{0}/{2}"}),
3 ])

   最终的URL可以使用格式化方法: str.format,子串会被捕获然后进行对应的匹配。在上面的例子中,一个 “a/b/c” 的请求能够被格式化,如下:   

str.format("/{1}/{0}/{2}", "a", "b", "c")  # -> "/b/a/c"

  源码分析:

  1. 通过 initiaialize() 函数进行参数 URL, permanent 的初始化。permanent初始化为True,则该重定向为永久化的。
  2. 定义 get() 函数,调用 基类中定义的 self.redirect 进行重定向的处理。

两种重定向方法的比较和思考:

  对于两种方法中的 permanent 参数,类 RedirectHandler 中默认为True(永久性重定向301);self.redirect中默认为False(临时性重定向302);

  原因:self.redirect 多数情况下被用于用户自定义的情况下进行重定向操作(例如环境变更、用户认证、以及表单提交),所以其默认为临时的重定向。类RedirectHandler 是每次匹配到该请求URL的时候就触发重定向。

  

时间: 2024-10-21 21:21:12

Tornado源码分析 --- Redirect重定向的相关文章

Tornado源码分析系列之一: 化异步为&#39;同步&#39;的Future和gen.coroutine

转自:http://blog.nathon.wang/2015/06/24/tornado-source-insight-01-gen/ 用Tornado也有一段时间,Tornado的文档还是比较匮乏的,但是幸好其代码短小精悍,很有可读性,遇到问题时总是习惯深入到其源码中.这对于提升自己的Python水平和对于网络及HTTP的协议的理解也很有帮助.本文是Tornado源码系列的第一篇文章,网上关于Tornado源码分析的文章也不少,大多是从Event loop入手,分析Event loop的工作

tornado 源码分析 之 异步io的实现方式

前言 本文将尝试详细的带大家一步步走完一个异步操作,从而了解tornado是如何实现异步io的. 其实本文是对[上一篇文][1]的实践和复习 主旨在于关注异步io的实现,所以会忽略掉代码中的一些异常处理.文字较多,凑合下吧 接下来只会贴出部分源码,帮助理解,希望有耐心的同学打开tornado源码,一起跟踪一遍吧. AsyncHTTPClient : AsyncHTTPClient 继承 Configurable ,从__new__重看出是单例模式. 根据 Configurable 的__new_

Tornado源码分析 --- Cookie和XSRF机制

Cookie和Session的理解: 具体Cookie的介绍,可以参考:HTTP Cookie详解 可以先查看之前的一篇文章:Tornado的Cookie过期问题 XSRF跨域请求伪造(Cross-Site-Request-Forgery): 简单的说,是攻击者通过一些技术手段欺骗用户的浏览器去访问一个自己曾经认证过的网站并执行一些操作(如发邮件,发消息,甚至财产操作如转账和购买商品).由于浏览器曾经认证过,所以被访问的网站会认为是真正的用户操作而去执行.这利用了web中用户身份验证的一个漏洞:

tornado源码分析系列一

先来看一个简单的示例: #!/usr/bin/env  python #coding:utf8 import socket def run():     sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)     sock.bind(('127.0.0.1',8008))     sock.listen(5)          while True:         connection,address = sock.accept()

Tornado源码分析之http服务器篇

一. Tornado是什么? Facebook发布了开源网络服务器框架Tornado,该平台基于Facebook刚刚收购的社交聚合网站FriendFeed的实时信息服务开发而来.Tornado由Python编写,是一款轻量级的Web服务器,同时又是一个开发框架.采用非阻塞I/O模型(epoll),主要是为了应对高并发 访问量而被开发出来,尤其适用于comet应用. 二. 为什么要阅读Tornado的源代码 Tornado由前google员工开发, 代码非常精练, 实现也很轻巧, 加上清晰的注释和

tornado源码分析-Application

tornado.web包含web框架的大部分主要功能,Application是其中一个重要的类 Application类的作用是实现 URI 转发,将 Application 的实例传递给 httpserver ,当监听到请求时,把服务器传回来的请求进行转发,通过调用 __call__ ,处理请求. Application源码: class Application(httputil.HTTPServerConnectionDelegate): """A collection

(tornado源码分析_004)HTTP服务器处理解析出来的http数据

tornado中HTTP服务器是承上启下的作用,它通过tornado.http1connection.HTTP1ServerConnection与tornado.http1connection.HTTP1Connection从socket中读取并解析http消息 然后调用application处理解析出来的http消息,具体方法为:将application作为数据处理类传给上述两个读取数据的类 具体代码如下 #常见的torando启动方式 application = tornado.web.Ap

SpringMVC拦截器详解[附带源码分析]

目录 前言 重要接口及类介绍 源码分析 拦截器的配置 编写自定义的拦截器 总结 前言 SpringMVC是目前主流的Web MVC框架之一. 如果有同学对它不熟悉,那么请参考它的入门blog:http://www.cnblogs.com/fangjian0423/p/springMVC-introduction.html 拦截器是每个Web框架必备的功能,也是个老生常谈的主题了. 本文将分析SpringMVC的拦截器功能是如何设计的,让读者了解该功能设计的原理. 重要接口及类介绍 1. Hand

“Tornado源码解析篇”导读索引

最近花了2周时间断断续续地阅读了 Tornado 的源码,写了“Tornado源码解析”这个系列专题.由于写得比较散,这里简单做一个索引与导读. 为什么要选择 Tornado 这个框架?先给大家讲一个小故事:赌王娱乐城 "[web.py inspired the] web framework we use at FriendFeed [and] the webapp framework that ships with App Engine..." — Brett Taylor, co-