Flask 中的动态路由

在前面章节使用的路由中，我们已经知道了一条固定的路径和一个处理函数相绑定，当访问这条路径时会触发相应的处理函数。路由中的路径是固定的，一条路径对应一个处理函数，无法处理复杂的情况。本小节介绍动态路由，路由中的路径是一个包含有参数的模板，可以匹配多条路径。

Tips：本节课所有的代码已经上传到 Github 可以点击这里进行下载。

1. 静态路由

在前面章节使用的路由中，路径是固定的、不变的。例如，网站中有 3 个用户 tom、jerry、mike，提供了 3 个路径访问这 3 个用户的信息，如下表所示：

路径	处理函数
/user/tom	show_user_tom()
/user/jerry	show_user_jerry()
/user/mike	show_user_mike()

编写程序 static.py，包含有 3 个路由：

from flask import Flask
app = Flask(__name__)

@app.route('/user/tom')
def show_user_tom():
    return 'My name is tom'

@app.route('/user/jerry')
def show_user_jerry():
    return 'My name is jerry'

@app.route('/user/mike')
def show_user_mike():
    return 'My name is mike'

app.run()

在第 4 行，将路径 ‘/user/tom’ 与处理函数 show_user_tom () 绑定；在第 8 行，将路径 ‘/user/jerry’ 与处理函数 show_user_jerry () 绑定；在第 12 行，将路径 ‘/user/mike’ 与处理函数 show_user_mike () 绑定。

程序 static.py 存在一个明显的问题：3 个页面处理函数的功能逻辑是相同的，存在有明显的代码重复。在下个小节，使用动态路由解决代码重复的问题。

2. 动态路由

Flask 中动态路由是指带有参数的页面路径，如下所示：

/prefix/<参数>

它是一个模板，可以匹配多条路径，将参数放置在符号 <和> 之间。

针对上一节的例子，页面路径 /user/<name> 可以匹配如下 3 个页面路径：

• /user/tom
• /user/jerry
• /user/mike

因此，只需要编写一个页面处理函数即可处理以上 3 个页面，编写程序 dynamic.py：

from flask import Flask
app = Flask(__name__)

@app.route('/user/<name>')
def show_user(name):
    return 'My name is %s' % name

app.run()

在第 4 行，定义了动态路径 /user/<name>，匹配所有以 /user/ 开头的路径；在第 5 行，定义了相应的处理函数 show_user，函数有一个参数 name；假设实际的路径是 /user/tom，与 /user/<name> 匹配成功，并且将 tom 存储到参数 name 中。

比较上一个小节 static.py 和本小节的 dynamic.py，通过动态路由可以使用一个处理函数处理一批相关的页面路径，在很多应用场景中是必需的。

3. 转换器

在 Flask 中，参数类型默认是 string，但是也可以指定其他类型，比如数字 int 等，如下所示：

/prefix/<类型转换器:参数>

类型转换器将默认的字符串类型转换为指定的类型，Flask 中主要有以下 4 种基本类型转换器:

类型	说明
string	默认，可以不用写
int	整数
float	同 int，但是接受浮点数
path	和 string 相似，但接受斜线

4. 类型转换的例子

本节编写程序 conv.py 演示转换器的功能：

from flask import Flask
app = Flask(__name__)

@app.route('/user/<name>')
def show_user(name):
    return 'My name is %s' % name

@app.route('/age/<int:age>')
def show_age(age):
    return 'age is %d' % age

@app.route('/price/<float:price>')
def show_price(price):
    return 'price is %f' % price

@app.route('/path/<path:name>')
def show_path(name):
    return 'path is %s' % name

app.run()

程序 conv.py 中定义了 4 条动态路由，如下表所示：

动态路由	参数类型	参数	处理函数
/user/<name>	字符串	name	show_user
/age/<int:age>	int	age	show_age
/price/<float:price>	float	price	show_price
/path/<path:name>	path	name	show_path

当用户访问路径时，与动态路由匹配并提取出相应的参数，处理函数返回如下：

动态路由	实际路径	返回值
/user/<name>	/user/tom	My name is tom
/age/<int:age>	/age/26	age is 26
/price/<float:price>	/price/31.4	price is 31.4
/path/<path:name>	/path/abc/xyz	path is abc/xyz

5. 小结

本节讲解了 Flask 中的动态路由的概念、如何提取路由中的参数和设置参数类型，使用思维导图概括如下：