python-flask-路由匹配源码分析

@app.route('/')
def hello_world():
    return 'Hello World!'

第1步:

class Flask(_PackageBoundObject):
    def route(self, rule, **options):
        def decorator(f):                 #f = hello_world
#1.1获取别名 endpoint = options.pop('endpoint', None)
#1.2 self.add_url_rule(rule, endpoint, f, **options) return f return decorator

第1.2步:

class Flask(_PackageBoundObject):
    def add_url_rule(self, rule, endpoint=None, view_func=None, **options):
        #1.2.1如果别名是None,执行_endpoint_from_view_func函数
        if endpoint is None:
            endpoint = _endpoint_from_view_func(view_func)
#1.2.2 给endpoint赋值 options['endpoint'] = endpoint
#1.2.3 获取允许的请求方法 methods = options.pop('methods', None)      #1.2.4如果方法为None if methods is None:
#默认为GET methods = getattr(view_func, 'methods', None) or ('GET',)
#1.2.5如果方法是字符串,抛出异常: 必须是methods=["POST"]这样可迭代的 if isinstance(methods, string_types): raise TypeError('Allowed methods have to be iterables of strings, ' 'for example: @app.route(..., methods=["POST"])')
#1.2.6把方法变成大写 methods = set(item.upper() for item in methods)      #1.2.7把匹配url和允许请求的方法封装到了Rule的一个对象中 rule = self.url_rule_class(rule, methods=methods, **options)
#self.url_rule_class = Rul
#1.2.8 self.url_map.add(rule)
#self.url_map = Map() if view_func is not None:        #1.2.9 此步完成后: {"别名":被装饰的函数名} self.view_functions[endpoint] = view_func

第1.2.1步:

def _endpoint_from_view_func(view_func):
    #返回被装饰的函数名
    return view_func.__name__

第1.2.8步:

class Map(object):
    def add(self, rulefactory):
        #1.2.8.1
        for rule in rulefactory.get_rules(self):
#1.2.8.2 Rule对象进行re正则绑定 rule.bind(self)
#1.2.8.3 添加到self._rules列表中,此时列表中就有了url self._rules.append(rule)
#1.2.8.4 此步完成后: {"别名":url} self._rules_by_endpoint.setdefault(rule.endpoint, []).append(rule)

第1.2.8.1步:

class Rule(RuleFactory):
def get_rules(self, map): yield self
#返回Rule对

第1.2.8.2步:

class Rule(RuleFactory):
def bind(self, map, rebind=False):
#1.2.8.2.1 self.compile()

第1.2.8.2.1步: 看不懂,猜里面是把url进行了re正则处理

class Rule(RuleFactory):
    def compile(self):
        if self.map.host_matching:
            domain_rule = self.host or ''
        else:
            domain_rule = self.subdomain or ''

        self._trace = []
        self._converters = {}
        self._static_weights = []
        self._argument_weights = []
        regex_parts = []

        def _build_regex(rule):
            index = 0
            for converter, arguments, variable in parse_rule(rule):
                if converter is None:
                    regex_parts.append(re.escape(variable))
                    self._trace.append((False, variable))
                    for part in variable.split('/'):
                        if part:
                            self._static_weights.append((index, -len(part)))
                else:
                    if arguments:
                        c_args, c_kwargs = parse_converter_args(arguments)
                    else:
                        c_args = ()
                        c_kwargs = {}
                    convobj = self.get_converter(
                        variable, converter, c_args, c_kwargs)
                    regex_parts.append('(?P<%s>%s)' % (variable, convobj.regex))
                    self._converters[variable] = convobj
                    self._trace.append((True, variable))
                    self._argument_weights.append(convobj.weight)
                    self.arguments.add(str(variable))
                index = index + 1

        _build_regex(domain_rule)
        regex_parts.append('\\|')
        self._trace.append((False, '|'))
        _build_regex(self.is_leaf and self.rule or self.rule.rstrip('/'))
        if not self.is_leaf:
            self._trace.append((False, '/'))

        if self.build_only:
            return
        regex = r'^%s%s$' % (
            u''.join(regex_parts),
            (not self.is_leaf or not self.strict_slashes) and
            '(?<!/)(?P<__suffix__>/?)' or ''
        )
        self._regex = re.compile(regex, re.UNICODE)

到此为止:

路由规则列表里新增了一条绑定正则的rule ;{"别名":rule} ;{"别名":被装饰的函数名}