werkzeug/routing.py-Map()源码解析

Map类主要用来存储所有的url规则和一些配置参数的。其中有一些配置的值只存储在Map实例里，因为这些值影响着所有的规则，还有一些其他的默认规则可以被重写。

通过之前分析的add_url_rule源码可以知道，是在add_url_rule方法里调用的Map类，并调用了类的add方法，同时传递了rule对象

# Map()类__init__源码

class Map(object):
    # 定义一个字典格式的默认转换器
    default_converters = ImmutableDict(DEFAULT_CONVERTERS)

    def __init__(self, rules=None, default_subdomain='', charset='utf-8',
                 strict_slashes=True, redirect_defaults=True,
                 converters=None, sort_parameters=False, sort_key=None,
                 encoding_errors='replace', host_matching=False):
        self._rules = []
        self._rules_by_endpoint = {}
        self._remap = True
        self._remap_lock = Lock()

        self.default_subdomain = default_subdomain
        self.charset = charset
        self.encoding_errors = encoding_errors
        self.strict_slashes = strict_slashes
        self.redirect_defaults = redirect_defaults
        self.host_matching = host_matching

        # 由于之前设置了default_converters为不可变类型，所以需要copy一份
        self.converters = self.default_converters.copy()
        # 如果传递了converters参数，则更新到self.converters里面
        if converters:
            self.converters.update(converters)

        self.sort_parameters = sort_parameters
        self.sort_key = sort_key

        # 遍历rules，并调用add方法把每一个遍历对象传递进去
        # 实例化的时候这个rules是空的，所以第二次调用是在解析self.url_map.add(rule)的时候
        # add方法详情请看下面的解析
        for rulefactory in rules or ():
            self.add(rulefactory)

参数解析：

•     default_converters = ImmutableDict(DEFAULT_CONVERTERS)

# 定义一个字典格式的默认转换器
# ImmutableDict是werkzeug/datastructures.py文件里面的一个类，用来把一个字典变成不可变格式
# DEFAULT_CONVERTERS变量是定义在routing.py文件里的一个全局变量
DEFAULT_CONVERTERS = {
    'default':          UnicodeConverter,
    'string':           UnicodeConverter,
    'any':              AnyConverter,
    'path':             PathConverter,
    'int':              IntegerConverter,
    'float':            FloatConverter,
    'uuid':             UUIDConverter,
}

• 
  rules：url规则
• default_subdomain：默认的子域名
• charset：编码格式，默认"utf-8"
• strict_slashes：是否严格要求URL末尾的斜线
• redirect_defaults：重定向到默认的url
• converters：转换器，如果重新定义了，会重写原始的
• sort_parameters：是否排序(url_encode可以看到更详细的信息）
• sort_key：是否关键字
• encoding_errors：用与解码的错误方法
• host_mathcing：如果设置为True，则会通过host去匹配，而不会使用subdomain

备注：sort_parameters 和 sort_key是在0.5版本增加的， encoding_errors和host_matching是在0.7版本增加的

Map类里面的add方法

主要是用来添加新的规则或则工厂函数到map中，并且绑定它。要求这个规则没有被绑定给其他的map

self.url_map.add(rule)

传递的rule是个Rule对象，

# app()源码

def add(self, rulefactory):
    # 调用Rule类的get_rules方法，返回值为yield self
    for rule in rulefactory.get_rules(self):
        # 调用Rule类的bind方法
        rule.bind(self)
        # 添加rule对象到self._rules里面
        # url路径，方法，视图函数
        # [<Rule '/static/<filename>' (HEAD, GET, OPTIONS) -> static>, <Rule '<test4>|/text3' (POST, OPTIONS) -> test>]
        self._rules.append(rule)
        # 根据endpoint的规则
        # {'static': [<Rule '/static/<filename>' (GET, OPTIONS, HEAD) -> static>], 'test123': [<Rule '<test4>|/text3' (POST, OPTIONS) -> test123>]}
        self._rules_by_endpoint.setdefault(rule.endpoint, []).append(rule)
        self._remap = True