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的时候就触发重定向。