在follow官方文档学习的过程中,感觉有一些描述不是很懂,而且中途多多少少会有一些报错。在这里重新梳理一下创建flaskr这个项目的步骤。
我的环境:windows
前提:安装sqlite3
一,创建文件夹:在flaskr项目下创建static和templates文件夹
用户通过 HTTP 访问 static 文件夹中的文件,也即存放 css 和 javascript 文件的地方。
Flask 会在 templates 文件夹里寻找 Jinja2 模板,官网教程中创建的模板将会放在这个文件夹里。
二,数据库模式
在flaskr项目下创建schema.sql的文件,放入下面的内容:
drop table if exists entries;
create table entries (
id integer primary key autoincrement,
title string not null,
text string not null
);
这个文件的用途是:在应用运行前初始化数据库。创建名为entries的表。
三,应用设置代码
在flaskr项目下创建flaskr.py作为应用的主模块。首先在flaskr.py里导入:
# all the imports
import os
import sqlite3
from flask import Flask, request, session, g, redirect, url_for, abort, \
render_template, flash
然后加载配置。
官方文档是直接把配置放在了主模块,用app.config.from_envvar(‘FLASKR_SETTINGS’, silent=True)去拿配置,需要设置名为FLASKR_SETTINGS的环境变量。我不是很明白from_envvar的含义,而且官方的页面上没找到配置是怎么样子的=。=
于是我用的另一种方法from_pyfile,也就是从python文件读取配置。
在flaskr项目下创建FLASKR_SETTINGS.py文件,并导入:
# configuration
DATABASE = 'flaskr.db'
DEBUG = True
SECRET_KEY = 'development key'
USERNAME = 'admin'
PASSWORD = 'default'
配置中表明,数据库名称为flaskr.db。但现在还不存在这个数据库,会在后续初始化时创建。
配置中username和password是用于应用中登录时用到的用户名密码。
在主模块flaskr.py中继续加入如下代码,使用from_pyfile去读取配置:
# create application
app = Flask(__name__)
app.config.from_pyfile('FLASKR_SETTINGS.py')
添加如下代码,去连接数据库。
def connect_db():
"""Connects to the specific database."""
rv = sqlite3.connect(app.config['DATABASE'])
rv.row_factory = sqlite3.Row
return rv
添加如下代码,可以运行这个应用。
if __name__ == '__main__':
app.run()
现在运行会得到404的错误。因为还没有任何视图,且数据库还没有创建。
四,创建数据库
在flaskr.py中connect_db后面添加如下代码:
def init_db():
with app.app_context():
db = connect_db() (官网这里是get_db(),会报错找不到这个方法的=。=)
with app.open_resource('schema.sql', mode='r') as f:
db.cursor().executescript(f.read())
db.commit()
然后在python shell中导入并调用这个函数来创建数据库。
运行后,就会在flaskr项目下看到多出个名为flaskr.db的文件啦。
五,视图函数
也就是在主模块flaskr.py中表明,这个应用中各路径下显示什么。
这里按照官网上的,在flaskr.py中添加几个视图函数的内容:
@app.route('/')
def show_entries():
cur = g.db.execute('select title, text from entries order by id desc')
entries = [dict(title=row[0], text=row[1]) for row in cur.fetchall()]
return render_template('show_entries.html', entries=entries)
@app.route('/add', methods=['POST'])
def add_entry():
if not session.get('logged_in'):
abort(401)
g.db.execute('insert into entries (title, text) values (?, ?)',
[request.form['title'], request.form['text']])
g.db.commit()
flash('New entry was successfully posted')
return redirect(url_for('show_entries'))
@app.route('/login', methods=['GET', 'POST'])
def login():
error = None
if request.method == 'POST':
if request.form['username'] != app.config['USERNAME']:
error = 'Invalid username'
elif request.form['password'] != app.config['PASSWORD']:
error = 'Invalid password'
else:
session['logged_in'] = True
flash('You were logged in')
return redirect(url_for('show_entries'))
return render_template('login.html', error=error)
@app.route('/logout')
def logout():
session.pop('logged_in', None)
flash('You were logged out')
return redirect(url_for('show_entries'))
六,模板 & 添加样式
在flaskr.py中用到的几个html页面,其实是还没有定义的。
按照官网,将几个模板放在templates里即可。
http://docs.jinkan.org/docs/flask/tutorial/templates.html#tutorial-templates
添加样式:在static下创建名为style.css的样式表
http://docs.jinkan.org/docs/flask/tutorial/css.html#tutorial-css
七,运行应用
这时运行应用后,打开地址会发现以下报错......
AttributeError: '_AppCtxGlobals' object has no attribute 'db'
意思也就是globals对象没有db,也就是g.db没有赋值。
在flaskr.py中添加如下代码即可:(官网也是没有讲!=。=!)
@app.before_request
def before_request():
g.db = connect_db()
添加完后,就可以正常打开http://127.0.0.1:5000/ 啦!
最终项目的文件结构目录如下: