day96:flask:flask-migrate&flask-session&蓝图Blueprint&蓝图的运行机制

1.数据库迁移:flask-migrate

1.Flask的数据库迁移

在开发过程中，需要修改数据库模型，而且还要在修改之后更新数据库。最直接的方式就是删除旧表，但这样会丢失数据。
更好的解决办法是使用数据库迁移框架，它可以追踪数据库模式的变化，然后把变动应用到数据库中。
在Flask中可以使用Flask-Migrate扩展，来实现数据迁移。并且集成到Flask-Script中，所有操作通过命令就能完成。
为了导出数据库迁移命令，Flask-Migrate提供了一个MigrateCommand类，可以附加到flask-script的manager对象上。

2.flask-migrate的安装

pip install flask-migrate

3.在flask代码中引入数据库迁移

from flask import Flask
from config import Config
from flask_sqlalchemy import SQLAlchemy
from flask_migrate import Migrate,MigrateCommand # 1.引入Migrate和MigrateCommand
from flask_script import Manager,Command
 
app = Flask(__name__,template_folder='templates')
app.config.from_object(Config)
 
manage = Manager(app)
 
db = SQLAlchemy(app)
 
# 2.创建migrate对象。第一个参数是Flask的实例，第二个参数是Sqlalchemy数据库实例
migrate = Migrate(app,db)
 
# 3.manager是Flask-Script的实例，这条语句在flask-Script中添加一个db命令
manage.add_command('db',MigrateCommand)
 
achieve = db.Table('tb_achievement',
    db.Column('student_id', db.Integer, db.ForeignKey('tb_student.id')),
    db.Column('course_id', db.Integer, db.ForeignKey('tb_course.id'))
)
 
class Course(db.Model):
    __tablename__ = 'tb_course'
    id = db.Column(db.Integer, primary_key=True)
    name = db.Column(db.String(64), unique=True)
    price = db.Column(db.Numeric(6,2))
    teacher_id = db.Column(db.Integer, db.ForeignKey('tb_teacher.id'))
    students = db.relationship('Student', secondary=achieve, backref='courses', lazy='subquery')
 
    def __repr__(self):
        return 'Course:%s'% self.name
 
class Student(db.Model):
    __tablename__ = 'tb_student'
    id = db.Column(db.Integer, primary_key=True)
    name = db.Column(db.String(64), unique=True)
    email = db.Column(db.String(64),unique=True)
    age = db.Column(db.SmallInteger,nullable=False)
    sex = db.Column(db.Boolean,default=1)
 
    def __repr__(self):
        return 'Student:%s' % self.name
 
class Teacher(db.Model):
    __tablename__ = 'tb_teacher'
    id = db.Column(db.Integer, primary_key=True)
    name = db.Column(db.String(64), unique=True)
    courses = db.relationship('Course', backref='teacher', lazy='subquery')
 
    def __repr__(self):
        return 'Teacher:%s' % self.name
 
@app.route("/")
def index():
    return "ok"
 
if __name__ == '__main__':
    manage.run()

4.flask中数据库迁移常用的命令

1.创建迁移版本仓库

# 这个命令会创建migrations文件夹，所有迁移文件都放在里面。
python main.py db init

2.创建迁移版本仓库

# 这里等同于django里面的 makemigrations，生成迁移版本文件
python main.py db migrate -m 'initial migration'

3.升级迁移版本库的版本

python main.py db upgrade

4.降级迁移版本库的版本

python main.py db downgrade

5.回滚到指定版本

python manage.py db downgrade 版本号   # 返回到指定版本号对应的版本

6.查看数据库迁移历史(可查看数据库迁移版本号)

python manage.py db history
 
# 输出格式：<base> ->  版本号 (head), initial migration

一般数据迁移的步骤是:init-->migrate-->upgrade/downgrade

2.flask-session

flask-session:允许设置session到指定存储的空间中

安装命令: https://pythonhosted.org/Flask-Session/

1.flask-session的安装和配置

pip install flask-Session

使用session之前,必须配置一下配置项:

SECRET_KEY = "*(%#4sxcz(^(#$#8423" # session秘钥

2.redis保存session的基本配置

from flask import Flask,session
from flask_redis import FlaskRedis
from flask_session import Session
app = Flask(__name__)
redis = FlaskRedis()
session_store = Session()
class Config():
    # DEBUG调试模式
    DEBUG = True
 
    # json多字节转unicode编码
    JSON_AS_ASCII = False
 
    # 数据库链接配置
    SECRET_KEY = "*(%#4sxcz(^(#$#8423"
 
    # 1.session存储方式为redis
    SESSION_TYPE = "redis"
 
    # 2.session保存数据到redis时启用的链接对象
    SESSION_REDIS = redis
 
    # 3.如果设置session的生命周期是否是会话期, 为True，则关闭浏览器session就失效
    SESSION_PERMANENT = True
 
    # 4.是否对发送到浏览器上session的cookie值进行加密
    SESSION_USE_SIGNER = True
 
    # 5.保存到redis的session数的名称前缀
    SESSION_KEY_PREFIX = "session:"
 
    # 6.redis的链接配置
    REDIS_URL = "redis://localhost:6379/1"
 
app.config.from_object(Config) # 将Config类注册到app上
redis.init_app(app)  # 将flask-redis对象挂载到app上
session_store.init_app(app) # 将flask-session对象挂载到app上
 
@app.route("/")
def index():
    session["username"] = "xiaoming"
    return "Ok"
 
@app.route("/get_session")
def get_session():
    print( session["username"] )
    return "ok"
 
@app.route("/redis1")
def set_redis():
    # redis给集合数据类型/哈希数据类型设置值
    redis.set("username","xiaohuihui")
    redis.hset("brother","zhangfei","17")
    return "ok"
 
@app.route("/redis2")
def get_redis():
    user = redis.get("username").decode()
 
    brother = redis.hgetall("brother")
    print(brother["zhangfei".encode()].decode())
 
    return "ok"
 
if __name__ == '__main__':
    app.run()

执行程序，访问127.0.0.1:5000，即可将session值存储到redis中

如图所示:

3.SQLAlchemy存储session的基本配置

from flask import Flask,session
from flask_redis import FlaskRedis
from flask_session import Session
from flask_sqlalchemy import SQLAlchemy
 
app = Flask(__name__)
db = SQLAlchemy()
redis = FlaskRedis()
session_store = Session()
 
class Config():
 
    ......
    '''数据库链接配置'''
    # SQLALCHEMY_DATABASE_URI = "mysql://账号:密码@IP/数据库名?编码"
    SQLALCHEMY_DATABASE_URI = "mysql://root:123@127.0.0.1:3306/students?charset=utf8mb4"
 
    # 动态追踪修改设置，如未设置只会提示警告
    SQLALCHEMY_TRACK_MODIFICATIONS = True
 
    # 查询时会显示原始SQL语句
    SQLALCHEMY_ECHO = True
 
    '''数据库保存session'''
    SESSION_TYPE = 'sqlalchemy'  # session类型为sqlalchemy
    SESSION_SQLALCHEMY = db  # SQLAlchemy对象
    SESSION_SQLALCHEMY_TABLE = 'tb_session'  # session要保存的表名称
    SESSION_PERMANENT = True  # 如果设置为True，则关闭浏览器session就失效。
    SESSION_USE_SIGNER = False  # 是否对发送到浏览器上session的cookie值进行加密
    SESSION_KEY_PREFIX = 'session:'  # 保存到session中的值的前缀
 
db.init_app(app)
app.config.from_object(Config)
redis.init_app(app)
session_store.init_app(app)
 
@app.route("/")
def index():
    session["username"] = "xiaohui"
    return "Ok"
 
@app.route("/get_session")
def get_session():
    return session["username"]
 
if __name__ == '__main__':
    # with app.app_context():
    #     db.create_all()
    app.run()

执行程序，访问127.0.0.1:5000，即可将session值存储到mysql中

如图所示:

3.蓝图:Blueprint

1.蓝图:模块化

随着flask程序越来越复杂,我们需要对程序进行模块化的处理,之前学习过python的模块化管理,于是针对一个简单的flask程序进行模块化处理

简单来说，Blueprint 是一个存储视图方法的容器，这些操作在这个Blueprint 被注册到一个应用之后就可以被调用，Flask 可以通过Blueprint来组织URL以及处理请求。

Flask使用Blueprint让应用实现模块化，在Flask中，Blueprint具有如下属性：

一个项目可以具有多个Blueprint
可以将一个Blueprint注册到任何一个未使用的URL下比如 “/”、“/sample”或者子域名
在一个应用中，一个模块可以注册多次
Blueprint可以单独具有自己的模板、静态文件或者其它的通用操作方法，它并不是必须要实现应用的视图和函数的
在一个应用初始化时，就应该要注册需要使用的Blueprint

但是一个Blueprint并不是一个完整的应用，它不能独立于应用运行，而必须要注册到某一个应用中。

Blueprint对象用起来和一个应用/Flask对象差不多，最大的区别在于一个蓝图对象没有办法独立运行，必须将它注册到一个应用对象上才能生效.

2.简单使用蓝图

1.创建一个蓝图的包,例如users,并在__init__.py文件中创建蓝图对象

from flask import Blueprint
# 1. 创建蓝图目录并对蓝图对象进行初始化
users_blue = Blueprint("users",__name__,template_folder="users_templates",static_folder='users_static',static_url_path="/libs")

2.在这个蓝图目录下, 创建views.py文件,保存当前蓝图使用的视图函数

from . import users_blue
from flask import render_template
# 2. 编写视图
@users_blue.route("/")
def index():
    return render_template("index.html",title="users/index/index.html")
 
@users_blue.route("/list")
def list():
    return "users/list"

3.在users/__init__.py中引入views.py中所有的视图函数

# 3. 注册视图
from .views import *

4.在主应用main.py文件中的app对象上注册这个users蓝图对象

# 4. 注册蓝图
from users import users_blue
app.register_blueprint(users_blue,url_prefix="/users")

当这个应用启动后,通过/users/可以访问到蓝图中定义的视图函数

3.蓝图的url前缀

当我们在应用对象上注册一个蓝图时，可以指定一个url_prefix关键字参数（这个参数默认是/）

在应用最终的路由表 url_map中，在蓝图上注册的路由URL自动被加上了这个前缀，这个可以保证在多个蓝图中使用相同的URL规则而不会最终引起冲突，只要在注册蓝图时将不同的蓝图挂接到不同的自路径即可
url_for在使用时，如果要生成一个蓝图里面的视图对应的路由地址，则需要声明当前蓝图名称+视图名称

url_for('users.home') # /users/home

4.注册蓝图的静态文件的相关路由

1.static_folder:设置静态文件目录

和应用对象不同，蓝图对象创建时不会默认注册静态目录的路由。需要我们在创建时指定 static_folder 参数。

下面的示例将蓝图所在目录下的static_users目录设置为静态目录

from flask import Blueprint
# 通过static_folder参数设置静态文件目录
users_blue = Blueprint("users",__name__,static_folder='users_static')

2.static_url_path:改变静态文件的路由

定制静态目录URL规则：可以在创建蓝图对象时使用 static_url_path 来改变静态目录的路由。

下面的示例将为 users/static 文件夹的路由设置为 /lib

from flask import Blueprint
# 通过static_url_path设置静态文件路由
users_blue = Blueprint("users",__name__,static_folder='users_static',static_url_path='/lib')

访问http://127.0.0.1:5000/users/libs/1.jpg 即可查看到图片

5.设置蓝图中模板的目录

蓝图对象默认的模板目录为系统的模版目录，可以在创建蓝图对象时使用 template_folder 关键字参数设置模板目录

users_blue = Blueprint("users",__name__,static_folder='users_static',static_url_path='/libs',template_folder='users_templates')

注意:如果在 templates 中存在和 templates_users 有同名模板文件时, 则系统会优先使用 templates 中的文件

4.蓝图的运行机制

1.蓝图运行机制的简要介绍

蓝图是保存了一组将来可以在应用对象上执行的操作，注册路由就是一种操作
当在app对象上调用 route 装饰器注册路由时,这个操作将修改对象的url_map路由表
然而，蓝图对象根本没有路由表，当我们在蓝图对象上调用route装饰器注册路由时,它只是在内部的一个延迟操作记录列表defered_functions中添加了一个项
当执行app对象的 register_blueprint() 方法时，应用对象将从蓝图对象的 defered_functions 列表中取出每一项，并以自身作为参数执行该匿名函数，即调用应用对象的 add_url_rule() 方法，这将真正的修改应用对象的usr_map路由表

2.蓝图运行机制的详细介绍