flask简介
Flask是一个使用python编写的轻量级WEB应用框架。基于Werkzeug WSGI工具箱和Jinja2 模板引擎。Flask使用BSD授权。
Flask被称为“microframework”,因为它使用简单的核心,用extension增加其他功能。Flask没有默认使用的数据库、窗体验证工具。然而,Flask保留了扩增的弹性,可以用Flask-extension加入这些功能:ORM、窗体验证工具、文件上传、各种开放式身份验证技术。
Flask英文翻译为瓶子,烧瓶,与另一个web框架Bottle同义,意在表示另一种容器,另一个框架。而且他们两个也有一些相似的地方。
第一个Flask程序
from flask import Flask
app = Flask(__name__)
@app.route('/')
def index():
return '<h1>Hello,Flask<h1/>'
app.run('127.0.0.1',8000)
运行后可见控制台输出:
- Serving Flask app “hello” (lazy loading)
- Environment: production
WARNING: Do not use the development server in a production environment.
Use a production WSGI server instead.- Debug mode: off
- Running on Http://127.0.0.1:8000/ (Press CTRL+C to quit)
URL路由
Flask路由采用装饰器的方式
@app.route('/')
def index():
绑定多个路由
@app.route('/index')
@app.route('/')
def index():
动态路由
@app.route('/index/<name>')
def index(name):
name会作为参数传入视图函数
也可以为参数设置默认值:
@app.route('/index',defaults={'name':'sfencs'})
@app.route('/index/<name>')
def index(name):
它其实相当于
@app.route('/index')
@app.route('/index/<name>')
def index(name='sfencs'):
还可以指定参数的类型:
@app.route('/index/<int:num>')
def index(num):
这样路由只会匹配index后是数值类型参数的url,并且还会把num转换为int型
除了int之外还有path,string,float,any,uuid等
指定请求方式的路由
@app.route('/index/<int:num>',methods=['get'])
def index(num):
method参数是一个列表
使用url_for()获取url
当视图函数绑定的路由发送改变时,我们可能在其他使用该路径的地方一个一个手动修改,这种硬编码的方式降低了代码的易用性,这种情况可以使用url_for()函数来获取url
url_for()函数的参数为视图函数名,也可以在路由的装饰器中指定endpoint参数设置别名
例如
@app.route('/index')
def aaa():
那么url_for(’aaa‘)就是’/index’
当然如果是有参数的路由,那么需要在url_for()函数中传入参数
例如
@app.route('/index/<int:num>')
def aaa(num):
url_for函数就应该写为:url_for(‘aaa’,num=123)
url_for()函数默认生成的是相对URL,要想生成绝对URL需要加入参数_external=True
http请求与响应
请求
如何在视图函数中获取请求,首先需要引入request对象
from flask import Flask,request
在视图函数中可以直接通过request获得属性或方法
举个简单的例子
@app.route('/index/<int:num>',methods=['get'])
def index(num):
print(request.method)
print(request.args.get('name','sfencs'))
return '<h1>Hello,Flask<h1/>'
request中的方法和属性未来都会对我们很有用,这里就不一一介绍了。
响应
1.普通响应
return '<h1>Hello,Flask<h1/>'
return '<h1>Hello,Flask<h1/>',200 #可以设置状态码
2.重定向
return redirect(url_for('index'))
3.错误响应
abort(404)
abort()函数直接返回错误响应,后面的代码不再执行
4.返回响应对象
response = make_response('<h1>Hello,Flask<h1/>')
response.mimetype = 'text/html'
return response
通过设置mimetype可以返回不同类型的数据,常用的有纯文本,html,xml,JSON
返回json格式数据时Flask提供一种更简洁的方式
return jsonify({'name':'sfencs'})
这一个东西把生成response对象,设置数据类型,json序列化都做完了。
请求钩子
请求钩子是在视图函数处理请求的前或者后的阶段进行的处理函数
Flask默认实现的五种请求钩子:
- before_first_request 处理第一个请求之前
- before_request 处理请求之前
- after_request 处理请求之后
- after_this_request 在视图函数内注册一个函数,会在这个请求结束后运行
- teardown_request 在请求结束后,如果有异常也会执行的钩子,它在所有钩子中最后一个执行,需要传入异常对象
钩子通过装饰器注册,比如
@app.before_request
def func():
pass
after_request和after_this_request的钩子必须接受一个响应类对象做参数,最后并将其返回
配置变量
Flask中,配置变量通过Flask对象的config属性配置与获取
在Flask对象的源码中看到config中已经存储了很多默认值
default_config = ImmutableDict({
'ENV': None,
'DEBUG': None,
'TESTING': False,
'PROPAGATE_EXCEPTIONS': None,
'PRESERVE_CONTEXT_ON_EXCEPTION': None,
'SECRET_KEY': None,
'PERMANENT_SESSION_LIFETIME': timedelta(days=31),
'USE_X_SENDFILE': False,
'SERVER_NAME': None,
'APPLICATION_ROOT': '/',
'SESSION_COOKIE_NAME': 'session',
'SESSION_COOKIE_DOMaiN': None,
'SESSION_COOKIE_PATH': None,
'SESSION_COOKIE_HTTPONLY': True,
'SESSION_COOKIE_SECURE': False,
'SESSION_COOKIE_SAMESITE': None,
'SESSION_REFRESH_EACH_REQUEST': True,
'MAX_CONTENT_LENGTH': None,
'SEND_FILE_MAX_AGE_DEFAULT': timedelta(hours=12),
'TRAP_BAD_REQUEST_ERRORS': None,
'TRAP_HTTP_EXCEPTIONS': False,
'EXPLAIN_TEMPLATE_LOADING': False,
'PREFERRED_URL_SCHEME': 'http',
'JSON_AS_ASCII': True,
'JSON_SORT_KEYS': True,
'JSONIFY_PRETTYPRINT_REGULAR': False,
'JSONIFY_MIMETYPE': 'application/json',
'TEMPLATES_AUTO_RELOAD': None,
'MAX_COOKIE_SIZE': 4093,
})
它其实是字典的子类,所以我们可以以字典的方式操作它
app.config['SWITCH'] = 'on'
print(app.config['SWITCH'])
也可以使用update方法一次添加多个配置
app.config.update(SWITCH_A=True,SWITCH_B=False)
还可以通过类的方式进行配置
app.config.from_object("settings.DebuGConfig")
在同级目录建立settings.py
class DebugConfig(Config):
DEBUG = True
最后要注意配置变量的名称必须要大写,小写的变量不会被读取
debug模式
如运行时控制台的输出
- Debug mode: off
可知默认debug模式是关闭的,所以当访问路径的程序出现错误的时候页面会显示
若要开启debug模式,可在run方法添加debug=True参数
app.run('127.0.0.1',8000,debug=True)
此时我们故意使程序出错,即将视图函数多添加一个参数,再次访问url,会出现
这个页面对于我们调试错误非常有用,同时还允许我们在页面上执行Python代码,我们只需要点击错误最右边的命令行图标
这时会弹出一个窗口让我们输入PIN码,这个可以在程序刚允许时控制台输出找到
输入后就可在页面执行代码了