Flask 教程

Flask 路由与视图函数


客户端(例如 Web 浏览器)把请求发送给 Web 服务器,Web 服务器再把请求发送给 Flask 程序实例。程序实例需要知道对每个 URL 请求运行哪些代码,所以保存了一个 URL 到 Python 函数的映射关系。处理 URL 和函数之间关系的程序称为路由。

app.route 路由

在 Flask 程序中定义路由的最简便方式,是使用程序实例提供的 app.route 修饰器,把修饰的函数注册为路由。

下面的例子说明了如何使用这个修饰器声明路由:

@app.route('/hello')
def hello_world():
    return '<h1>hello world</h1>'

像 hello_world() 这样的函数称为视图函数(view function)。视图函数返回的响应可以是包含 HTML 的简单字符串,也可以是复杂的表单等。 

修饰器是 Python 语言的标准特性,可以使用不同的方式修改函数的行为。惯 常用法是使用修饰器把函数注册为事件的处理程序。

add_url_rule 路由

应用程序对象的 add_url_rule() 函数也可用于将 URL 与函数绑定,如下示例:

def hello_world():
    return '<h1>hello world</h1>'

app.add_url_rule('/hello', 'hello_world', hello_world)

可变 url 路由

日常所用服务的某些 URL 格式,会发现很多地址中都包含可变部分。例如,https://www.google.com/acount/<your-name>,用户名(your-name)是地址的一部分。Flask 支持这种形式的URL,只需在 route 修饰器中使用特殊的句法即可。

下例定义的路由中就有一部分是动态名字:

@app.route('/account/<name>')
def user(name):
    return '<h1>Hello, %s!</h1>' % name

尖括号中的内容就是动态部分,任何能匹配静态部分的 URL 都会映射到这个路由上。调用视图函数时,Flask 会将动态部分作为参数传入函数。在这个视图函数中,参数用于生成针对个人的欢迎消息。

路由中的动态部分默认使用字符串,不过也可使用类型定义。例如,路由 /account/<int:id> 只会匹配动态片段 id 为整数的 URL。Flask 支持在路由中使用 int、float 和 path 类型。 path 类型也是字符串,但不把斜线视作分隔符,而将其当作动态片段的一部分。