Flask框架入门（3）路由

从最简单的Flask例子说起，介绍一些基本的概念，包括路由，模板，请求跟响应，错误处理。

目录

一个最简单的Flask应用

运行失败原因

带参数的路由

URLS唯一性跟重定向行为

多URL路由

设置请求方式

构建URL

---

一个最简单的Flask应用

# 导入Flask依赖
from flask import Flask

# 创建一个Flask实例，参数__name__是模块或应用的名称
app = Flask(__name__)

# 映射路由
@app.route('/')
def hello_world():
    return 'Hello, World!'

@app.route('/') 这种注解路由写法相信学过其它web框架开发的同学应该不陌生。

我们把hello_word函数映射到‘/’请求路径上了。当我们运行这个简单应用，用浏览器访问http://localhost在浏览器页面就会显示“Hello, World!”文本。

运行这个应用有两种方式，可以使用flask内置的命令工具或者是python’s -m切换到Flask。

在运行之前要通过设置FLASK_APP环境变量指定运行文件的位置，例如这里我们保存例子为hello.py文件。

$ export FLASK_APP=hello.py
$ flask run
 * Running on http://127.0.0.1:5000/

或者是使用python -m：

$ export FLASK_APP=hello.py
$ python -m flask run
 * Running on http://127.0.0.1:5000/

window命令：

C:\path\to\app>set FLASK_APP=hello.py
C:\path\to\app> $env:FLASK_APP = "hello.py"

如果要其它电脑来访问你的本地应用可以设置参数--host=0.0.0.0

$ flask run --host=0.0.0.0

 

运行失败原因

python -m flask 执行失败或者 flask不存在的原因

（1）Flask太旧，升级为新版本，0.11版本之前是没有python -m flask跟flask命令的。

（2）无效导入名称

检查FLASK_APP环境变量，一般的原因是打错字没有创建app实例。

（3）Debug模式

修改代码需要重启本地测试服务器，如果启动Debug模式，它会自动加载修改的代码。

想开启开发模式所有功能，在启动服务之前设置FLASK_ENV环境变量的值为development

Linux命令：
$ export FLASK_ENV=development
$ flask run

window命令：
> set FLASK_ENV=development
> flask run

这些命令做了下面的事情：

1.激活debugger

2.激活自动加载器

3.开启debug模式

 

带参数的路由

上面的例子只是简单不带参数的路由，在实际应用中还有些路由是带参数的，格式为<variable_name>：

例如：

@app.route('/hello/<name>')
def hello(name):
    return 'Hello %s' % name

在浏览器的地址栏中输入http://localhost:5000/hello/aaron，你将在页面上看到”Hello aaron”的字样。

可以在路由参数添加类型转换器，格式为：<converter:variable_name>.

@app.route('/user/<username>')
def show_user_profile(username):
    # show the user profile for that user
    return 'User %s' % escape(username)

@app.route('/post/<int:post_id>')
def show_post(post_id):
    # show the post with the given id, the id is an integer
    return 'Post %d' % post_id

@app.route('/path/<path:subpath>')
def show_subpath(subpath):
    # show the subpath after /path/
    return 'Subpath %s' % escape(subpath)

转换器有如下类型：

URLS唯一性跟重定向行为

@app.route('/projects/')
def projects():
    return 'The project page'

@app.route('/about')
def about():
    return 'The about page'

上面两个路由的写法一个是带反斜杠‘/’结尾一个不带反斜杠结尾。

带反斜杠‘/’结尾的路由跟文件系统文件夹路径类似，不带反斜杠结尾的路由跟指向一个文件类似。访问不带反斜杠的路由Flask会会将您重定向到带有斜杠的规范URL。

多URL路由

一个函数可以绑定多个路由

@app.route('/')
@app.route('/hello')
@app.route('/hello/<name>')
def hello(name=None):
    if name is None:
        name = 'World'
    return 'Hello %s' % name

设置请求方式

from flask import request
@app.route('/login', methods=['GET', 'POST'])
def login():
    if request.method == 'POST':
        return 'This is a POST request'
    else:
        return 'This is a GET request'

在路由修饰器route的第二个参数可以传入一个由请求方式组成的列表。

当你请求地址http://localhost:5000/login，”GET”和”POST”请求会返回不同的内容，其他请求方法则会返回405错误。

构建URL

Flask提供了url_for函数构建一个URL信息。

from flask import Flask, escape, url_for

app = Flask(__name__)

@app.route('/')
def index():
    return 'index'

@app.route('/login')
def login():
    return 'login'

@app.route('/user/<username>')
def profile(username):
    return '{}\'s profile'.format(escape(username))

with app.test_request_context():
    print(url_for('index'))
    print(url_for('login'))
    print(url_for('login', next='/'))
    print(url_for('profile', username='John Doe'))

/
/login
/login?next=/
/user/John%20Doe

# 指向静态文件
url_for('static', filename='style.css')    # 静态文件地址，返回/static/style.css