https://www.cnblogs.com/cwp-bg/p/8916575.html
前言
Flask框架作为一个python极简化的web框架，它不像Django那样的重型，非常适合快速开发一些小型的应用。本人用flask开发了几个项目之后，慢慢研究flask底层的一些原理，开始一步步总结flask框架的使用方法以及设计原理。共勉！
Flask框架简介
-
基于Werkzeug工具箱编写的轻量级Web开发框架，主要面向需求简单的小应用；
-
本身相当于一个内核，其他几乎所有的功能都需要用第三方的扩展来实现；
-
核心是Werkzeug和Jinja2(路由模块和模板引擎)；
安装环境
- 安装Flask和所有可能相关依赖的包:
将所有相关的包放置在一个txt文件，如：requires.txt,内容如下：
alembic==0.9.4
amqp==2.2.2
billiard==3.5.0.3
celery==4.1.0
certifi==2017.7.27.1
chardet==3.0.4
Flask==0.10.1
Flask-Migrate==2.1.0
Flask-Script==2.0.5
Flask-Session==0.3.1
Flask-SQLAlchemy==2.2
Flask-WTF==0.14.2
Jinja2==2.9.6
kombu==4.1.0
Mako==1.0.7- 创建一个python新的虚拟环境，执行安装：
可参考：http://www.cnblogs.com/cwp-bg/p/7701231.html
pip install -r requires.txt 创建一个简单的应用程序
from flask import Flask
app = Flask(__name__)
# 装饰器的作用是将路由映射到视图函数index
@app.route('/')
def index():
return 'ok'
if __name__ == '__main__':
app.run()执行启动后我们在浏览器输入:http://127.0.0.1:5000就可以访问我们刚刚建立的网站了，就这么方便！
- app初始化简介
# Flask实例的源码：
class Flask(_PackageBoundObject):
def __init__(self, import_name, # 指定应用的名字和工程目录，默认为__name__
static_path=None, # 是静态文件存放的路径，会赋值给static_url_path参数
static_url_path=None, # 设置静态文件路由的前缀，默认为“/static”
static_folder='static', # 静态文件的存放目录， 默认值为"static"
template_folder='templates', # 模板文件的存放目录，默认值为"templates"
instance_path=None, # 设置配置文件的路径，在instance_relative_config=True情况下生效
instance_relative_config=False # 设置为True表示配置文件相对于实例路径而不是根路径
root_path=None) # # 应用程序的根路径- 运行测试app程序
app.run(host=None, # 设置ip，默认127.0.0.1
port=None, # 设置端口，默认5000
debug=None) # 设置是否开启调试，默认falseapp的配置参数详解
flask实例化后会加载默认的配置参数，我们也可以手动设置参数更新默认的配置，常用的参数选项有：
DEBUG:是否启用debug模式，默认false。
TESTING :启用/禁止测试模式
SECRET_KEY :密钥,在启用session等很重要
SESSION_COOKIE_NAME :设置保存的session在 cookie 的名称
SESSION_COOKIE_DOMAIN：设置会话的域，默认是当前的服务器，因为Session是一个全局的变量，可能应用在多个app中；设置这个参数必须设置SERVER_NAME,否则报错
PERMANENT_SESSION_LIFETIME：session失效时间，作为一个 datetime.timedelta 对象，也可以用秒表示；
LOGGER_NAME:日志记录器的名称，默认__name__;
SERVER_NAME:服务器的名称以及端口，需要它为了支持子域名 (如: 'myapp.dev:5000')
MAX_CONTENT_LENGTH:设置一个请求所允许的最大的上传数据量，单位字节；
SEND_FILE_MAX_AGE_DEFAULT: 设置调用send_file发送文件的缓存时间；
TRAP_HTTP_EXCEPTIONS:如果这个值被设置为 True ， Flask 不会执行 HTTP 异常的错误处理， 而是像对待其它异常一样，通过异常栈让它冒泡;
PREFERRED_URL_SCHEME:设置URL 模式用于 URL 生成。如果没有设置 URL 模式，默认将为 http 。
JSON_AS_ASCII：默认情况下 Flask 序列化对象成 ascii 编码的 JSON。 如果不对该配置项就行设置的话，Flask 将不会编码成 ASCII 保持字符串原样，并且返回 unicode 字符串。jsonfiy 会自动按照 utf-8 进行编码并且传输。
JSON_SORT_KEYS：默认情况下 Flask 将会依键值顺序的方式序列化 JSON。 这样做是为了确保字典哈希种子的独立性，返回值将会一致不会造成 额外的 HTTP 缓存。通过改变这个变量可以重载默认行为。 这是不推荐也许会带来缓存消耗的性能问题。
JSONIFY_PRETTYPRINT_REGULAR：如果设置成 True (默认下)，jsonify 响应对象将会完美地打印。加载配置文件的方法
- 通过加载文件设置参数
app.config.from_pyfile("./config.cfg") # 指定参数的路径，内容按行书写,配置文件放置在与app的同目录下
def from_pyfile(self, filename, silent=False):
filename = os.path.join(self.root_path, filename)
pass- 通过类设置参数
注意所有的参数必须大写，否则无效。
class Config(object): # 该类可以定义在一个py文件中然后导入py文件
"""配置参数"""
DEBUG = True
app.config.from_object(Config)
- 通过json格式的文件配置
# config.json
{
'DEBUG' = True
}
app.config.from_json('config.json') # 配置文件放置在与app的同目录下- 直接操作app.config对象进行设置
app.config["DEBUG"] = True
或者
app.config.update({
"DEBUG":True,
})获取配置参数的方法
app.config.get("DEBUG")
或者
current_app.config.get("DEBUG")定义视图函数
# 使用methods参数设置
@app.route('/',methods=["POST","GET"])
def index():
return 'ok'route装饰器会将其装饰的视图函数注册到app的视图函数集中，其主要有三个参数：
rule:api路由，如：'/','/index'等；
methods：设置允许的请求方式，如:'POST','GET'等，如果不设置，默认是GET方法；
endpoint:视图函数的标识符，是请求用来寻找对应的视图函数的键，默认是视图函数的名字。注意点
-
相同的路由和请求方式,先定义的覆盖后定义的，如果请求方式不同则不会覆盖；可以对不同的方式请求的分开写视图函数，但视图函数一定不能相同；
-
同一个视图函数加了多个路由，无论哪一个都可以访问到视图；通过加多层装饰器实现；
-
默认的请求方式为get；可以同时设置允许get和post请求访问；
@app.route('/test',methods=["POST","GET"])
@app.route('/',methods=["POST","GET"])
def index():
return 'ok'路由分发
- 步骤:通过程序实例的route装饰器实现;route装饰器内部会调用add_url_route()方法创建一个Rule对象，将该视图函数的标识符和Rule对象作为键值对加入到app的url_map中。
# 源码
def route(self, rule, **options):
def decorator(f):
endpoint = options.pop('endpoint', None)
self.add_url_rule(rule, endpoint, f, **options)
return f
return decorator路由参数转换器
flask允许将参数放置在路由中，通过路由转换器来提取参数。
- 默认的参数转换器
# 将路由转化为int类型的参数
@app.route('/user/<int:id>')
def hello_itcast(id):
return 'ok %d' %id<>这种形式写法就是转换器，有int,float,path，default，uuid等几种;
int : 提取整形
float: 提取浮点数
path: 提取路径，包括/
string：提取字符串
default：即不写类型<id>,除了/之外，默认是字符串
uuid:接受 UUID 字符串- url的规则细节
-
如果url规则以/结尾，请求url没有斜线，则引导到有斜线的页面；
-
如果url规则结尾没有斜线，请求带有斜线，则找不到页面；
获取请求数据
# 导入请求对象request，该对象保存了一切请求的信息
from flask import request
request.args:获取路径请求的参数，返回一个字典；
request.form:获取表单数据；
request.values:包含from和args的全部内容；
request.cookies:获取cookie得到一个dict；
request.data:获取数据作为字符串存于此；
request.headers:获取请求头；
request.files:获取上传的文件；返回响应数据
在视图函数中返回的数据默认是一个三个元素的元组，分别表示返回的数据body，返回状态码和添加头部信息。
@app.route('/')
def index():
return 'ok',200,[("a", "b")] # 列表
# return 'ok',200,{"a":"b"} # 字典
# return 'ok',"666 hhhh",{"a":"b"} # 状态码可以随便，不会报错也可以使用make_response()返回，其会直接创建一个response对象。
@app.route('/')
def test():
return make_response('ok',200,{'a':'b'})自定义异常处理
所有自定义的异常处理函数会加载到app对象的error_handler_spec属性中保存。
@app.errorhandler(404) # number表示自定义的状态码
def handle_errer(errer):
return errer # 表示错误的信息
# 定义好后，当使用abort函数时，会自动调用这个处理函数；设置cookie和session
- 设置coookie
response.set_cookie(key,value,max_age=10) # 设置cookie的键和值，过期时间
# 可以直接设置
response.header["Set-Cookie] = value
# 获取cookie
response.cookie.get(key)
# 删除cookie
response.delete_cookie(key) # 设置过期时间- session需要配置secret_key参数
import flask import session
# 设置加密的密匙
app.config["SECRET_KEY"] = “password”
name = session.get("xx") # 获取session中的数据
session.values() # 获取session中的所有键的值
session.keys() # 获取session中的所有键
session.items() # 获取session中的所有键值对session默认保存在cookie中；通过加密的方式来确保session不被更改；
参考
- https://dormousehole.readthedocs.io/en/latest