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