昨天写了一篇flask开发环境搭建,今天继续,进行一个实战小项目-blog系统。
blog系统很简单,只有一个页面,然而麻雀虽小五脏俱全。这里目的不是为了做项目而做项目,这篇文章本意是通过这次练习传达以下几个知识点:
1、从全局上了解flask项目的目录结构
2、flask项目的运行机制
3、flask框架实现MVC架构
4、flask-sqlalchemy 操作mysql数据库
一、新建项目:blog系统
在pycharm中,新建flask项目,如下图:
完成后的目录结构是这样的:非常简单,一个static文件夹,一个templates文件夹,一个py文件
以上的目录结构是flask初始时的结构,这个只能应对很小的项目,对于大型复杂的项目,我们需要引入包的管理,MVC架构设计。
二、目录结构重构,引入包管理
针对上面的结构,在最上层blog2目录下,
1、新建一个runserver.py文件,作为项目统一入口文件
2、新建blog2文件夹,把已存在的static,templates,blog2.py移到blog2文件夹下,然后分别建controller、model包(右击blog2,选择python package)。把blog2.py改名为__init__.py,新建setting.py 文件。
现在目录如下所示:
这样就相当于一个大工程结构了:
1)最上层blog2目录是项目名称,一个项目下可以包括多个模块,也就是应用,每个应用下有自己的配置文件,初始化文件,MVC架构。
2)runserver.py:与应用模块平级,作为项目启动文件
3)第二级blog2目录:模块名称
controller目录:MVC中的C,主要存放视图函数
model目录:MVC中的M,主要存放实体类文件,映射数据库中表
templates:MVC中的V,存放html文件
static:静态文件,主要存放css,js等文件
__init__.py:模块初始化文件,Flask 程序对象的创建必须在 __init__.py 文件里完成, 然后我们就可以安全的导入引用每个包。
setting.py:配置文件,数据库用户名密码等等
三、开发代码
1、先把项目运行起来:
1) 编写__init__.py文件,创建项目对象,代码如下:
#-*- coding: utf-8 -*-
from flask importFlask#创建项目对象
app = Flask(__name__)
2) 在runserver.py文件中添加如下代码:
from blog2 importapp
@app.route('/')defhello_world():return 'Hello World!'
if __name__ == '__main__':
app.run(debug=True)
3)运行runserver.py文件:
然后在浏览器中输入:http://127.0.0.1:5000/,会显示helloworld字样
到这里,项目雏形就可以正常运行了,下面的事情就简单了,添加内容,让项目有血有肉吧。
2、修改配置文件
2.1)修改setting.py文件,添加配置数据库连接信息,如下:
#_*_ coding: utf-8 _*_
#调试模式是否开启
DEBUG =True
SQLALCHEMY_TRACK_MODIFICATIONS =False
#session必须要设置key
SECRET_KEY='A0Zr98j/3yX R~XHH!jmN]LWX/,?RT'
#mysql数据库连接信息,这里改为自己的账号
SQLALCHEMY_DATABASE_URI = "mysql+pymysql://username:password@ip:port/dbname"
2.2)让项目读取配置文件
修改__init__.py:添加如下内容(红色部分):
#-*- coding: utf-8 -*-
from flask importFlask
from flask_sqlalchemy import SQLAlchemy
app = Flask(__name__)
#import os
#print os.environ.keys()
#print os.environ.get('FLASKR_SETTINGS')
#加载配置文件内容
app.config.from_object('blog2.setting') #模块下的setting文件名,不用加py后缀
#创建数据库对象
db = SQLAlchemy(app)
3、设计数据库
本次练习比较简单,就两个表,一个user表,一个文章表。我们采用python的orm框架flask-sqlalchemy实现表的创建、增删改查功能。
在model文件夹中添加User.py和Category.py文件,内容如下:
1) User.py:
from blog2 importdbclassUser(db.Model):__tablename__ = 'b_user'id= db.Column(db.Integer,primary_key=True)
username= db.Column(db.String(10),unique=True)
password= db.Column(db.String(16))def __init__(self,username,password):
self.username=username
self.password=passworddef __repr__(self):return '' % self.username
2) Category.py
from blog2 importdbclassCategory(db.Model):__tablename__ = 'b_category'id= db.Column(db.Integer,primary_key=True)
title= db.Column(db.String(20),unique=True)
content= db.Column(db.String(100))def __init__(self,title,content):
self.title=title
self.content=contentdef __repr__(self):return '' % self.title
3)创建数据库和表
windows命令行模式下,cd到项目runserver.py那个目录下,进入python shell下:
输入红色部分:
E:\workdir\blog2>python
Python2.7.10 (default, May 23 2015, 09:44:00) [MSC v.1500 64bit (AMD64)] on wi
n32
Type"help", "copyright", "credits" or "license" for moreinformation.>>> from blog2 import db
>>> db.create_all()>>>
>>>
如果没有任何错误输出代表创建数据库和表成功了。这时我们到数据库中去查看:
数据库已经存在了,再看看表情况:发现没有对应的b_user和b_category表。这是为什么呢?是不是没有找到model目录下的两个类呢。问题在于:__init__.py文件没有引入model包,导致__init__.py无法找到实体类。记住:一切模块对象的创建都在__init__.py中完成
在blog2目录下的__init__.py添加如下代码:
#只有在app和db对象之后声明,用于导入model否则无法创建表
# -*- coding: utf-8 -*-
from flask import Flask
from flask_sqlalchemy import SQLAlchemy
# create project object
app = Flask(__name__)
#加载配置文件内容
app.config.from_object('blog2.setting') #模块下的setting文件名,不用加py后缀
app.config.from_envvar('FLASKR_SETTINGS') #环境变量,指向配置文件setting的路径
#创建数据库对象
db = SQLAlchemy(app)
from blog.model import User, Category
再次运行上面命令:db.create_all()方法。这时表已经创建成功了。
3、添加界面模板:如登陆页面,显示blog文章页面,添加blog页面
在templates目录下添加三个html文件:
layout.html:
1
2
Flaskr3
4
5
Flaskr
6
7 {% if not session.logged_in %}8 log in
9 {% else %}10 log out
11 {% endif %}12