flask文档学习笔记1-快速入门

开始决定认真的在网上写一些东西，主要原因还是在于希望能提升学习效果。虽说python写了有几年，但是web后端框架的确没怎么接触过，买了本狗书寥寥草草的过了一遍，发现很多东西还是理解不深，真的是好记性不如烂笔头，知识也要从基础开始，退回来好好看看官方文档，再去看狗书吧。
网上有翻译好的官方文档，基本是基于0.10.1版本翻译的，和目前版本对比了一下，细节上还是有一些不同（狗书也存在这个问题），所以还是老老实实的看英文原版学习吧，目前的版本是0.12.2

“微型”的含义

众所周知，flask是一个使用Python开发的“微型”Web框架，文档中特意强调了，所谓“微型”并不意味着Web应用的开发只能写在一个Python文件里，也不意味着flask自身功能不够丰富。“微型”的目的在于，保持一个“简单”并且“可扩展”的框架核心，为开发者提供一个选择自由的Web框架。基于此，开发者可以自由的选择数据库或模板引擎，为自己的Web应用做合适的选择。

最小应用

通过flask实现一个Hello World只需要几行代码

from flask import Flask
app = Flask(__name__)

@app.route('/')
def hello_world():
    return 'Hello, World!'

把一头大象放进冰箱只需三步：

引用Flask类，并创建Flask类的实例。这个实例就是HelloWorld应用的WSGI接口。
编写hello_world函数，返回'hello, World!'字符串消息。
使用route装饰器，为hello_world创建路径为'/'的路由。

这个示例代码与0.10版不同，在旧版文档中，通过在代码中添加app.run()方法来运行这个Web应用，而在0.12版文档中，应用的启动工作使用了命令行的方式来处理:

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

或者：

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

通过给FLASK_APP环境变量赋值，告诉flask它的web应用是哪个。我尝试了在代码中使用app.run()方法启动，也一样可以执行。

from flask import Flask

app = Flask(__name__)

@app.route('/')
def hello_world():
    return 'Hello World!'

if __name__ == '__main__':
    app.run('0.0.0.0')

Debug模式

开启debug模式可实现代码变更的热加载，即：代码修改后，不需要重启flask server，就可以自动触发变更代码的载入。
另外，开启debug模式可以实现在页面查看运行中的错误信息，追踪错误发生原因，适合开发过程中的错误调试。
开启Debug模式的方法包括：

$ export FLASK_DEBUG=1
$ flask run

以及在代码中，为Flask类实例的run方法中，指明debug参数为True：

app.run(debug=True)

路由

在Flask下，用户可以使用@app.route()装饰器为页面设计具有可读性的静态路由，也可以在路由部分中加入变量，以使路由动态可变。
路由的形式类似于linux下的文件路径。
示例如下：

#静态路由
@app.route('/hello')
def hello():
    return 'Hello, World'
#使用动态变量的路由（未指定变量类型）
@app.route('/user/<username>')
def show_user_profile(username):
    # show the user profile for that user
    return 'User %s' % 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

指定的路由变量，可以作为被装饰的函数参数传入进来。当路由尾部加入'/'时，无论在浏览器地址栏中输入的网址尾部是否加'/'，浏览器都会自动重定向到有/的路由上。

url_for()函数

flask模块提供了url_for()函数用于获取函数的URL，因此在项目中所有引用到URL字符串的地方，都可以使用url_for(func, **kwargs)来获取函数的URL，这样做的好处在于，可以使项目更容易维护。当某函数URL发生变更时，只需修改一处地方即可，而无须修改每一处URL引用。个人认为，在开发过程的任何时候，使用硬编码都是极为不妥的。

HTTP方法

http作为客户端与服务端的交互协议，包含了不同类型的请求方法（method），Flask中，最长使用的是GET、PUT和POST方法，一条路由适用哪种方法，可以在route装饰器中定义。如不明确定义，route装饰器中默认定义为GET方法。
官方例子：

from flask import request

@app.route('/login', methods=['GET', 'POST'])
def login():
    if request.method == 'POST':
        do_the_login()
    else:
        show_the_login_form()

http还包括HEAD以及OPTIONS方法，在较新的Flask中，已经为用户内部实现，因此一般开发过程中无需在意。

静态文件

Flask的静态文件目录默认为项目目录内的static目录，一般所有静态文件都存放在这个目录内。

模板渲染

Flask内置了Jinja2作为模板引擎，并提供render_template方法用于模板渲染，使用起来很方便，只需在方法内指定需要渲染的html文件名称，并传入模板变量值即可实现模板渲染。
官方示例：

from flask import render_template

@app.route('/hello/')
@app.route('/hello/<name>')
def hello(name=None):
    return render_template('hello.html', name=name)

默认情况下，Flask会到当前项目目录下的templates目录内寻找模板文件。
官方模板文件示例：

<!doctype html>
<title>Hello from Flask</title>
{% if name %}
  <h1>Hello {{ name }}!</h1>
{% else %}
  <h1>Hello, World!</h1>
{% endif %}

模板文件之间可实现继承，这一特性保证了不同页面内的重复页面元素（页头、页脚、导航栏）等，可通过模板继承的方式迅速实现。

访问请求数据

来自客户端的http请求，在server端以request对象存在。
Flask为每一个request创建一个处理线程，并在线程内部创建上下文实现线程安全。因此开发者在开发过程中不需要为线程安全费太多心思。
关于request对象，获取客户端传输来的数据方式非常简单，类似于字典的形式，只需要在request.method中指明key的值即可实现：

#获取登录表单数据
@app.route('/login', methods=['POST', 'GET'])
def login():
    error = None
    if request.method == 'POST':
        if valid_login(request.form['username'],
                       request.form['password']):
            return log_the_user_in(request.form['username'])
        else:
            error = 'Invalid username/password'
    # the code below is executed if the request method
    # was GET or the credentials were invalid
    return render_template('login.html', error=error)

文档在此处还提及了文件上传场景以及cookie的简单用法，后续文档应当有更加详细的记录，在此不详述。

错误与重定向

Flask使用redirect()函数处理重定向逻辑。使用abort(error_code)处理错误返回。
若希望对错误页面进行定制，可使用errorhandler(error_code)装饰器修饰对应的视图函数，定义本地错误页面。

关于应答

flask有自己的应答处理逻辑，可大致总结为：
1.视图函数返回字符串时，flask会自动将返回字符串封装如标准response对象内
2.用户也可以在视图函数内使用make_response()函数创建response对象并返回，这样做的意义是，在返回前用户可以对response对象的部分内容进行设置，例如cookie。
3.如果返回对象是一个tuple，那么内容顺序格式应满足(response, status, headers)这样的格式

会话session

session记录了客户端与server之间的一些信息，官方文档给出了用户登陆状态的例子。通过判断session中是否存在username键值来判断用户是否已登录，以此为依据返回不同的展示内容。
示例如下：

from flask import Flask, session, redirect, url_for, escape, request

app = Flask(__name__)

@app.route('/')
def index():
    if 'username' in session:
        return 'Logged in as %s' % escape(session['username'])
    return 'You are not logged in'

@app.route('/login', methods=['GET', 'POST'])
def login():
    if request.method == 'POST':
        session['username'] = request.form['username']
        return redirect(url_for('index'))
    return '''
        <form method="post">
            <p><input type=text name=username>
            <p><input type=submit value=Login>
        </form>
    '''

@app.route('/logout')
def logout():
    # remove the username from the session if it's there
    session.pop('username', None)
    return redirect(url_for('index'))

# set the secret key.  keep this really secret:
app.secret_key = 'A0Zr98j/3yX R~XHH!jmN]LWX/,?RT'

使用session的前提是必须设置密钥，密钥的获取可以使用python提供的随机函数生成。

>>> import os
>>> os.urandom(24)

日志模块

flask的日志模块与python的logging模块使用方式类似，应该是做了内部集成，代码形式略微不同，在此做记录：

app.logger.debug('A value for debugging')
app.logger.warning('A warning occurred (%d apples)', 42)
app.logger.error('An error occurred')

flask文档学习笔记1-快速入门

“微型”的含义

最小应用

Debug模式

路由

url_for()函数

HTTP方法

静态文件

模板渲染

访问请求数据

错误与重定向

关于应答

会话session

日志模块

youjia0721

引用和评论

开发者需要了解的MongoDB知识点

将 Python 和 Rust 融合在一起，为 pyQuil® 4.0 带来和谐

Ubuntu20.04 从源代码编译安装 python3.10

Python装饰器：让你的代码优雅又高效的秘密武器

从javascript到python(一):基本环境搭建

Python编程：创意爱心表白代码集

你不知道的Requests进阶技巧：用Retry实现完美重试