我们用pycharm去新建Flask项目的时候,会默认生成开发文件.如下,其中包括static,templates,flask1_prj.py文件
在最初开始的时候,我们的app等声明都是在flask1_prj.py中进行的,然后程序实例的运行也是在一起的.就像下面的这样
app = Flask(__name__)
bootstrap=Bootstrap(app)
app.config[‘SECRET_KEY‘]=os.urandom(20)
@app.route(‘/‘,methods=[‘GET‘,‘POST‘])
def hello_world():
form=NameForm()
if form.validate_on_submit():
session[‘name‘]=form.name.data
return redirect(url_for(‘hello_world‘))
print session.get(‘name‘)
return render_template(‘index1.html‘,form=form,name=session.get(‘name‘))
if __name__ == ‘__main__‘:
app.run(host=‘192.168.0.12‘,port=8000)
这种组织形式在单个文件中开发程序很放方便.但是有个问题是app是在全局作用域中创建.无法动态修改配置.或者我们想建立多个实例的时候,需要为每个实例配置进行不同的配置.在django中我们每创建一个应用实例的时候,相应的文件结构就已经生成好了,不需要我们做另外的配置,但是在Flask中,这些事情需要我们自己来完成.这就需要用到工厂函数了
前面介绍创建不同配置类的时候,我们就新建了一个config.py文件.然后通过配置选项做不同的配置.那么既然我们要建不同的实例,那么就采用调用一个create_app的函数来生成各个不同的实例,在各自生成的实例中再调用不同的配置.这样的结构我们就成为工厂函数,来看具体的代码实现
首先创建工程结构如下.建立一个app的程序包.里面包含__init__.py,config.py,run.py,model_sqlite.py,manger.py
三个文件的作用分别如下,
__init__.py其中就包含工厂函数,是定义工厂函数的地方
config.py 和之前的配置选项一样,定义各种的配置选项
run.py:主程序.
model_sqlite.py是定义数据模型的地方
manger.py 是配置数据迁移的文件
其中还包含main package. main package包含__init__.py和views.py文件
__init__.py是蓝本的定义文件
views.py是定义视图和路由的地方.
接下来看具体的代码实现:
app package:__init__.py
from flask import Flask,render_template
from flask_bootstrap import Bootstrap
from flask_sqlalchemy import SQLAlchemy
import config
from config import DevelopmentConfig
from .main import main as main_blueprint
bootstrap=Bootstrap()
db=SQLAlchemy()
def create_app(config_name):
app=Flask(__name__)
app.config.from_object(DevelopmentConfig)
config.config[config_name].init_app(app)
bootstrap.init_app(app)
db.init_app(app)
app.register_blueprint(main_blueprint)
return app
create_app函数接收config_name参数,然后在其中进行app的生成.生成后进行各种app的绑定.在这里绑定了bootstrap和db.最终返回app实例
app package:config.py 内容和之前一样,没有区别
import os
basedir=os.path.abspath(os.path.dirname(__file__))
class Config:
SECRET_KEY=‘hello world‘
SQLALCHEMY_COMMIT_ON_TEARDOWN=True
ITEMS_PER_PAGE=10
@staticmethod
def init_app(app):
pass
class DevelopmentConfig(Config):
DEBUG=True
SQLALCHEMY_DATABASE_URI=‘sqlite:///‘+os.path.join(basedir,‘data.sqlite‘)
class TestConfig(Config):
TESTING=True
SQLALCHEMY_DATABASE_URI = ‘sqlite:///‘ + os.path.join(basedir, ‘test.sqlite‘)
WTF_CSRF_ENABLED = False
config={
‘development‘:DevelopmentConfig,
‘testing‘:TestConfig,
‘default‘:DevelopmentConfig
}
app package:model_sqlite.py 内容也和之前一样
from app import db
class User(db.Model):
__tablename__=‘Users‘
id=db.Column(db.Integer,primary_key=True)
name=db.Column(db.String(64),unique=True,index=True)
age=db.Column(db.Integer)
address=db.Column(db.String(100))
role_id=db.Column(db.Integer,db.ForeignKey("Role.id"))
def __repr__(self):
return ‘<User %r>‘ % self.name
class Role(db.Model):
__tablename__=‘Role‘
users=db.relationship(‘User‘,backref=‘Role‘)
id = db.Column(db.Integer, primary_key=True)
name = db.Column(db.String(64), unique=True)
address = db.Column(db.String(100))
def __repr__(self):
return ‘<User %r>‘ % self.name
app package:manger.py
from app import create_app
from flask_migrate import Migrate,MigrateCommand
from flask_script import Manager
from app import db
from app.model_sqlite import User,Role
app=create_app(‘development‘)
manager=Manager(app)
migrate=Migrate(app,db)
manager.add_command(‘db‘,MigrateCommand)
if __name__=="__main__":
manager.run()
不知道大家发现一个问题,在之前单文件配置的时候.程序实例存在与全局作用域中,路由可以直接使用app.route装饰器来定义.但现在程序在运行时创建.只有调用create_app()之后才能使用app.route装饰器.这个时候定义路由就比较晚了.
Flask采用蓝本来解决这个问题,蓝本定义的路由处于休眠状态,直到蓝本注册到程序上时,路由才真正成为程序的一部分
有关于蓝本的具体介绍可以参考下面的2个帖子:
https://www.zhihu.com/question/31748237/answer/55313054
http://dormousehole.readthedocs.io/en/latest/blueprints.html
在main package中就是定义蓝本的地方.
__init__.py
from flask import Blueprint
main=Blueprint(‘main‘,__name__,template_folder=‘../template‘,static_folder=‘../static‘) #template_folder和static_folder分别指示模板文件和静态文件的地址
from . import views
views.py:
from app.main import main
@main.route(‘/‘)
def index():
return render_template(‘index.html‘)
在具体的视图函数中,就采用的是@main.route(‘/’)的方式,而不是@app.route(‘/’)的方式.
当然最后在其中其中 其中在app.__init__.py的create_app需要将蓝本注册到app当中去.app.register_blueprint(main_blueprint).这样路由就和程序实例关联起来了.
最后在run.py中 通过引用create_app的方式就可以运行整个项目了
from app import create_app
app=create_app(‘development‘)
if __name__=="__main__":
app.run(host=‘192.168.0.12‘, port=8000)