Flask之基于route装饰器的路由系统(源码阅读解析)

一 路由系统

1. 在flask中配置URL和视图函数的路由时,首先需要在main.py中实例化一个app对象:

1 from flask import Flask, render_template
2 
3 app = Flask(__name__)

2. 然后通过app实例的route方法装饰视图函数,实现路由的配置:

1 @app.route('/')
2 def hello_world():
3     return 'Hellow World!'

3. 所有这里需要关注在Flask类里定义的route方法,以理解Flask内部的路由配置逻辑

    def route(self, rule, **options):
    
        def decorator(f):
            endpoint = options.pop('endpoint', None)
            self.add_url_rule(rule, endpoint, f, **options)
            return f
        return decorator

可见app实例的route实际上是一个带参数的装饰器,其中rule是URL规则(字符串形式),而options可以接收其他按关键字传参的配置项,在上面Hello World的例子中,options应该是一个空字典。

这个装饰器的作用是把URL规则和视图函数交由app实例的add_url_rule方法处理,并返回被装饰函数本身,所以在main.py中视图函数名依然原来的视图函数对象的引用。

4. 下一部需要关注的是add_url_rule方法的内部实现:

在add_url_rule方法里首先处理endpoint,这里endpoint可以理解为和URL规则映射的视图函数对象

1         if endpoint is None:
2             endpoint = _endpoint_from_view_func(view_func)
3         options['endpoint'] = endpoint

由于在Hellow World例子里,endpoint是None, 这里会调用_endpoint_from_view_func方法:

1 def _endpoint_from_view_func(view_func):
2     assert view_func is not None, 'expected view func if endpoint ' \
3                                   'is not provided.'
4     return view_func.__name__  # 返回被装饰视图函数的函数名

这里view_func就是被装饰的视图函数,所以endpoint就被设置成立被装饰视图函数的函数名

由此可见,如果用户希望endpoint不是被装饰视图函数时,需要在@app.route()里以endpoint关键子传参给定一个函数对象名

处理完之后,endpoint被添加到options字典中

接着add_url_rule方法继续处理methods, 这里methods可以理解为这条URL和视图的映射适用于那种Http请求方法:

1 methods = options.pop('methods', None)
2 if methods is None:
3      methods = getattr(view_func, 'methods', None) or ('GET',)
4 if isinstance(methods, string_types):
5       raise TypeError('Allowed methods have to be iterables of strings, '
6                            'for example: @app.route(..., methods=["POST"])')
7         methods = set(item.upper() for item in methods) # 最后methods是一个包含用户传入的Http请求方法,或默认GET请求方法的集合

首先从options字典里取出'methods'对应的值,在Hellow World的例子中,此时methods = None

接着,把methods设置为视图函数的‘methods’属性。

  p.s.:看到这里使用了getattr函数,我们可以发现,app.route装饰的视图,并不要求是一定要定义成函数的形式,也可以定义成一个python模块导入到main.py中,这样以来flask的视图系统就具有了更加灵活的扩展性。所以methods参数既可以作为app.route的关键字参数,也通过定义视图的模块中methods标量来定义。

如果app.route()没有传入methods参数,也没有再视图模块中定义methods变量,methods默认赋值为('GET'),可见flask中路由配置默认是对应HTTP GET请求的。

Flask要求用户传入各个的methods方法必须是字符串形式,并且放在符合python协议的可迭代对象中,否则,会抛出异常提示,上面4 - 6行代码都是在做这一层判断

最后,methods变量里的元素被取出并放入集合。

至此用户定义的URL规则和Http请求方法处理完毕。

5. 如果视图模块中有定义了'requeire_methods'参数,也需要处理:

1 required_methods = set(getattr(view_func, 'required_methods', ()))
required_methods的作用这里暂时先不关注,后续再介绍

6 接下来之前的处理的methods和required_methos进行并集处理,都添加到methods参数中

methods |= required_methods

7. 把处理好的URL规则和methods参数,以及options字典委托给app实例的url_rule_class方法做进一步的处理

1 rule = self.url_rule_class(rule, methods=methods, **options)

url_rule_class实际上是一个叫Rule的类,这一步如果处理通过,参数rule会接收一个Rule的实例

8. Rule这个类的__init__方法如下:

 1 class Rule(RuleFactory):
 2     def __init__(self, string, defaults=None, subdomain=None, methods=None,
 3                  build_only=False, endpoint=None, strict_slashes=None,
 4                  redirect_to=None, alias=False, host=None):
 5         if not string.startswith('/'):
 6             raise ValueError('urls must start with a leading slash')
 7         self.rule = string
 8         self.is_leaf = not string.endswith('/')
 9 
10         self.map = None
11         self.strict_slashes = strict_slashes
12         self.subdomain = subdomain
13         self.host = host
14         self.defaults = defaults
15         self.build_only = build_only
16         self.alias = alias
17         if methods is None:
18             self.methods = None
19         else:
20             if isinstance(methods, str):
21                 raise TypeError('param `methods` should be `Iterable[str]`, not `str`')
22             self.methods = set([x.upper() for x in methods])
23             if 'HEAD' not in self.methods and 'GET' in self.methods:
24                 self.methods.add('HEAD')
25         self.endpoint = endpoint
26         self.redirect_to = redirect_to
27 
28         if defaults:
29             self.arguments = set(map(str, defaults))
30         else:
31             self.arguments = set()
32         self._trace = self._converters = self._regex = self._argument_weights = None

这里再回顾一下上面给__init__方法的传入的参数:

1  rule = self.url_rule_class(rule, methods=methods, **options)

URL规则是第一个位置参数,methods以及options字典里的键值对,都被__init__方法按关键字接收

首先,如果app.route传入的URL不是一个以'/'开头的字符串,会抛出异常

self.is_leaf记录URL是否没有以‘/’结尾 

然后,如果methos里有"GET"方法,而没有"HEAD",会把'HEAD'添加进入,'HEAD'的作用会把后续笔记中分析。

这里注意到,__init__里有一个self.redirect_to = redirect_to,可能是可以直接在app.route()里设置视图的跳转,这个放到后面再具体分析。

可以发现,flask里把路由相关的:URL,host,适用的HTTP请求方法,endpoint视图都保存到了Rule这个类的实例中。

9. 得到Rule的实例后,回到add_url_rule方法,继续看对rule实例的处理:

1 self.url_map.add(rule)

这里url_map是Map类的一个实例,是在app实例化的时候绑定到app实例的,下面只需要关注Map类的add方法:

class Map:
... ...无关代码省略
def add(self, rulefactory): """Add a new rule or factory to the map and bind it. Requires that the rule is not bound to another map. :param rulefactory: a :class:`Rule` or :class:`RuleFactory` """ for rule in rulefactory.get_rules(self): rule.bind(self) self._rules.append(rule) self._rules_by_endpoint.setdefault(rule.endpoint, []).append(rule) self._remap = True

可以看到这里rulefactory可以接收Rule实例或者RuleFactory实例,RuleFactory实例对应另一种设置路由的方法。在我们这个例子里,rulefactory应该是一个Rule的实例

所以还需要进一步关注,Rule的实例的get_rules方法:

1     def get_rules(self, map):
2         yield self

get_rules方法接收两个参数,Rule的实例,和Map的实例,我们的例子里,Map实例没有作用,这个方法直接yield返回了Rule实例

下面继续看rule实例的bind方法:

 1 Class Rule:
 2     ... ... 省略无关代码
 3  1     def bind(self, map, rebind=False):
 4  2         """Bind the url to a map and create a regular expression based on
 5  3         the information from the rule itself and the defaults from the map.
 6  4 
 7  5         :internal:
 8  6         """
 9  7         if self.map is not None and not rebind:
10  8             raise RuntimeError('url rule %r already bound to map %r' %
11  9                                (self, self.map))
12 10         self.map = map
13 11         if self.strict_slashes is None:
14 12             self.strict_slashes = map.strict_slashes
15 13         if self.subdomain is None:
16 14             self.subdomain = map.default_subdomain
17 15         self.compile()
View Code

这个实在判断rule实例的map属性是否为None,如果是None,就把map实例绑定到rule实例的map实行,否则报错,这里就控制了一个rule实例只能跟一个map实例进行绑定。

之后会把rule实例append到这个map实例的self._rules列表中

之后这个map实例的_rules_by_endpoint属性的会添加这样一个键值对:rule.endpoint: [rule]      也就是 视图对象:[rule实例]

至此,整个通过app,route装饰视图,来绑定URL和视图映射关系的逻辑流程已经结束,此时

app实例的self.map保存的Map类实例里保存了一个:视图对象 和 rule实例映射的键值对。

总结起来:

--- app.route()装饰器

  获取URL, 视图对象,其他opeions方法,并调用app实例的add_url_rule方法

--- add_url_rule方法:

 1. 获取app.route的methods关键字参数,视图模块里定义的methods参数等Http 请求方法

    这里视图可以是一个函数,也可以是一个python模块

    2. 把URL,视图对象,Http请求方法,绑定到一个Rule实例(app实例的),通过app实例的url_rule_class方法。

    Rule的__init__方法的其他参数来自app.route的关键字传参,可以控制一些URL的匹配规则

    build_only参数可以让URL不绑定任何视图,实现static文件夹等。

---- url_map.add

  把Rule实例和app实例保存的map实例绑定。

  

  

原文地址:https://www.cnblogs.com/mikellxy1990/p/8439228.html