今天主要讲一下werkzeug中的routing模块。这个模块是werkzeug中的重点模块，Flask中的路由相关的操作使用的都是这个模块
routing模块的用法
在讲解模块的源码之前，先讲讲这个模块怎么用。
创建Map()对象：
>>> m = Map([
... # Static URLs
... Rule('/', endpoint='static/index'),
... Rule('/about', endpoint='static/about'),
... Rule('/help', endpoint='static/help'),
... # Knowledge Base
... Subdomain('kb', [
... Rule('/', endpoint='kb/index'),
... Rule('/browse/', endpoint='kb/browse'),
... Rule('/browse/<int:id>/', endpoint='kb/browse'),
... Rule('/browse/<int:id>/<int:page>', endpoint='kb/browse')
... ])
... ], default_subdomain='www')
我们可以看到，一个Map中以列表的形式包含多个Rule. 示例里面还有个Subdomain，除了Subdomain名外，它里面以列表的形式包含多个Rule，如果没有Subdomain，后面的default_subdomain可以省略(default_subdomain适配于除了Subdomain之外的Rule部分)
在创建了Map的实例后，我们可以为每个Subdomain创建URL适配器
>>> c = m.bind('example.com')
>>> c.build("kb/browse", dict(id=42)) #如果url有参数，使用dict()里面填参数名和值
'http://kb.example.com/browse/42/'
>>> c.build("kb/browse", dict()) #build接受的参数是endpoint，返回url地址
'http://kb.example.com/browse/'
>>> c.build("kb/browse", dict(id=42, page=3))
'http://kb.example.com/browse/42/3'
>>> c.build("static/about")
'/about'
>>> c.build("static/index", force_external=True)
'http://www.example.com/'
>>> c = m.bind('example.com', subdomain='kb')
>>> c.build("static/about")
'http://www.example.com/about'
部分源码分析
在routing模块中有个RuleFactory类，提供了get_rules()工厂方法，该方法的设计目的是使得URL重用. 所有继承该类的类必须实现该方法
比如Subdomain类：
class Subdomain(RuleFactory):
def __init__(self, subdomain, rules):
self.subdomain = subdomain
self.rules = rules
def get_rules(self, map):
for rulefactory in self.rules:
for rule in rulefactory.get_rules(map):
rule = rule.empty()
rule.subdomain = self.subdomain
yield rule
在该类中get_rules方法是一个生成器，调用一次返回一个subdomain中的rule，且该Rule未绑定.
同理还有Submount,EndpointPrefix类，源码差不多，就不细讲了。只说下怎么用：
Submount的用法：
url_map = Map([
Rule('/', endpoint='index'),
Submount('/blog', [
Rule('/', endpoint='blog/index'),
Rule('/entry/<entry_slug>', endpoint='blog/show')
])
])
把submount中第一个元素(路径)跟在原路径后，里面的Rule均以这个路径为挂载点
这里当访问'blog/entry/<entry_slug>'就会找到'blog/show'这个endpoint；当访问'blog'就会找到'blog/index'这个endpoint
EndpointPrefix的用法：
url_map = Map([
Rule('/', endpoint='index'),
EndpointPrefix('blog/', [Submount('/blog', [
Rule('/', endpoint='index'),
Rule('/entry/<entry_slug>', endpoint='show')
])])
])
和上一个示例等效，只不过是提取出了所有endpoint中相同的前缀放在前面
Rule类
在该类的实例中最重要的就是存储了URL地址。以下是它的构造方法的头部：
def __init__(self, string, defaults=None, subdomain=None, methods=None,
build_only=False, endpoint=None, strict_slashes=None,
redirect_to=None, alias=False, host=None)
在该类中，实现了bind方法，源码如下：
def bind(self, map, rebind=False):
if self.map is not None and not rebind:
raise RuntimeError('url rule %r already bound to map %r' %
(self, self.map))
self.map = map
if self.strict_slashes is None:
self.strict_slashes = map.strict_slashes
if self.subdomain is None:
self.subdomain = map.default_subdomain
self.compile()
该方法的作用就是把Rule的实例绑定到一个Map实例上去
Map类
在该类的实例中，存储了很多个Rule类的实例，同时还有部分配置参数。以下是它的构造方法的头部：
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)
对照本文中开头的部分，可以发现rules参数是一个列表，该列表中包含了多个Rule的实例
在该类中实现了几个重要的方法：
add()方法：它的作用是把一个Rule的实例添加到该Map实例中，并绑定。源码很简单：
def add(self, rulefactory):
for rule in rulefactory.get_rules(self): #获得rule实例
rule.bind(self) #绑定该实例(源码见上面Rule类中的bind方法)
#在Map的_rules列表中加入该Rule实例，_rules用来装Map初始化函数中rules参数传进的Rules
self._rules.append(rule)
self._rules_by_endpoint.setdefault(rule.endpoint, []).append(rule)
self._remap = True
bind()方法：返回一个MapAdapter类的实例，该类的作用是用来做URL的匹配。bind的头部为：
bind(self, server_name, script_name=None, subdomain=None,
url_scheme='http', default_method='GET', path_info=None,
query_args=None)
MapAdapter类
该类用来做URL匹配。
dispatcher()方法：该方法的作用是，传入path_info，该方法会使用match()方法找到对应的endpoint和相关参数，然后再把这个endpoint作为参数传入view_func视图函数中，返回一个view_func对象. 源码如下
def dispatch(self, view_func, path_info=None, method=None,
catch_http_exceptions=False):
try:
try:
endpoint, args = self.match(path_info, method) #获得endpoint和所需参数
except RequestRedirect as e:
return e
return view_func(endpoint, args)
except HTTPException as e:
if catch_http_exceptions:
return e
raise
match()方法：该方法的作用是，传入path_info和method，该方法会返回对应的endpoint和路径包含的参数，比如：
>>> m = Map([
... Rule('/', endpoint='index'),
... Rule('/downloads/', endpoint='downloads/index'),
... Rule('/downloads/<int:id>', endpoint='downloads/show')
... ])
>>> urls = m.bind("example.com", "/") #urls是MapAdapter对象
>>> urls.match("/", "GET")
('index', {})
>>> urls.match("/downloads/42")
('downloads/show', {'id': 42})
build()方法：该方法与match()对应，传入endpoint和对应参数，返回path_info. 用法如下
>>> m = Map([
... Rule('/', endpoint='index'),
... Rule('/downloads/', endpoint='downloads/index'),
... Rule('/downloads/<int:id>', endpoint='downloads/show')
... ])
>>> urls = m.bind("example.com", "/")
>>> urls.build("index", {})
'/'
>>> urls.build("downloads/show", {'id': 42})
'/downloads/42'