一,项目介绍
此微博客叫flaskr,基本需求:
1,允许用户用配置文件里指定的凭证登入登出。只支持一个用户。
2,当用户登入后,可以向页面添加条目。条目标题是纯文本,正文可以是一些 HTML 。因信任这里的用户,这部分 HTML 不做审查。
3,页面倒序显示所有条目(后来居上),并且用户登入后可以在此添加新条目。
直接采用 SQLite3
对于更大型的应用,就有必要使用SQLAlchemy
二,步骤0:创建文件夹
$virtualenv venv
$. venv/bin/activate
$mkdir flaskr
$cd flaskr
$mkdir static
$mkdir templates
flaskr文件夹不是一个 Python 包,只是个我们放置文件的地方。
static 存放css和javascript
templates存放jinja2模板
三,步骤1:创建数据库
在flaskr文件夹下面新建schema.sql输入下面sql语句
drop table if exists entries;
create table entries(
id integer primarey key autoincrement,
title string not null,
text string not null
);
新建一个名为entries的表。
四,步骤2:应用设置代码
对于小型应用,可以直接把配置放在主模块里,正如我们现在要做的一样。但更简洁的方案是创建独立的.ini或.py文件,并载入或导入里面的值。
在flaskr目录下新建flaskr.py,输入如下:
import os
import sqlite3
from flask import Flask,request,session,g,redirect,url_for,abort,render_template,flash
数据库路径:
提供了app.root_path属性以获取应用的路径。配合os.path模块使用,轻松可达任意文件。在本例中,我们把数据库放在根目录下。
对于实际生产环境的应用,推荐使用instance folder,参考http://docs.jinkan.org/docs/flask/config.html#instance-folders
通常,加载一个单独的、环境特定的配置文件是个好主意。Flask 允许你导入多份配置,并且使用最后的导入中定义的设置。这使得配置设定过程更可靠。from_envvar()可用于达此目的。
app.config.from_envvar(‘FLASKR_SETTINGS’, silent=True)
只需设置一个名为FLASKR_SETTINGS的环境变量,指向要加载的配置文件。启用静默模式告诉 Flask 在没有设置该环境变量的情况下噤声。
此外,你可以使用配置对象上的from_object()方法,并传递一个模块的导入名作为参数。Flask 会从这个模块初始化变量。 注意,只有名称全为大写字母的变量才会被采用。
secret_key是保证客户端会话的安全的要点。正确选择一个尽可能难猜测、尽可能复杂的密钥。调试标志关系交互式调试器的开启。永远不要在生产系统中激活调试模式,因为它将允许用户在服务器上执行代码。
连接数据库:
def connect_db():
rv = sqlite3.connect(app.config['DATABASE'])
rv.row_factory= sqlite3.Row
return rv
完整代码:
import os
import sqlite3
from flask import Flask,request,session,g,redirect,url_for,abort,render_template,flash
app = Flask(__name__)
app.config.from_envvar(‘FLASKR_SETTINGS’, silent=True)
def connect_db():
rv = sqlite3.connect(app.config['DATABASE'])
rv.row_factory= sqlite3.Row
return rv
if __name__ == '__main__':
app.run()
使用python flaskr.py运行看看。
五,步骤3:数据库连接
因为数据库连接封装了事务,我们也需要确保同一时刻只有一个请求使用这个连接。
Flask 提供了两种环境(Context):应用环境(Application Context)和请求环境(Request Context)。
不同环境有不同的特殊变量。
写一个辅助函数,这个函数首次调用的时候会为当前环境创建一个数据库连接,调用成功后返回已经建立好的连接:
def get_db():
if not hasattr(g, 'sqlite_db')
g.sqlite_db=coonect_db()
return g.sqlite_db
现在我们知道如何连接到数据库,但如何妥善断开连接呢?为此, Flask 提供了teardown_appcontext()装饰器。它将在每次应用环境销毁时执行:
teardown_appcontext()标记的函数会在每次应用环境销毁时调用。这意味着什么?本质上,应用环境在请求传入前创建,每当请求结束时销毁。销毁有两种原因:一切正常(错误参数会是None)或发生异常,后者情况中,错误会被传递给销毁时函数。