Flask框架的學習與實戰(二):實戰小項目

昨天寫了一篇flask開發環境搭建,今天繼續,進行一個實戰小項目-blog系統。css

blog系統很簡單,只有一個頁面,然而麻雀雖小五臟俱全。這裏目的不是爲了作項目而作項目,這篇文章本意是經過此次練習傳達如下幾個知識點:html

一、從全局上了解flask項目的目錄結構python

二、flask項目的運行機制mysql

三、flask框架實現MVC架構sql

四、flask-sqlalchemy 操做mysql數據庫shell

1、新建項目:blog系統數據庫

在pycharm中,新建flask項目,以下圖:flask

 

完成後的目錄結構是這樣的:很是簡單,一個static文件夾,一個templates文件夾,一個py文件windows

以上的目錄結構是flask初始時的結構,這個只能應對很小的項目,對於大型複雜的項目,咱們須要引入包的管理,MVC架構設計。瀏覽器

2、目錄結構重構,引入包管理

針對上面的結構,在最上層blog2目錄下,

   一、新建一個runserver.py文件,做爲項目統一入口文件

   二、新建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:配置文件,數據庫用戶名密碼等等

3、開發代碼

一、先把項目運行起來:

1) 編寫__init__.py文件,建立項目對象,代碼以下:

# -*- coding: utf-8 -*-
from flask import Flask

#建立項目對象
app = Flask(__name__)

2) 在runserver.py文件中添加以下代碼:

from blog2 import app

@app.route('/')
def hello_world():
    return 'Hello World!'
if __name__ == '__main__': app.run(debug=True)

3)運行runserver.py文件:

而後在瀏覽器中輸入:http://127.0.0.1:5000/,會顯示helloworld字樣

到這裏,項目雛形就能夠正常運行了,下面的事情就簡單了,添加內容,讓項目有血有肉吧。

二、修改配置文件

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://username:password@ip:port/dbname"

2.2)讓項目讀取配置文件

修改__init__.py:添加以下內容(紅色部分):

# -*- coding: utf-8 -*- from flask import Flask 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後綴
app.config.from_envvar('FLASKR_SETTINGS') #環境變量,指向配置文件setting的路徑

#建立數據庫對象
db = SQLAlchemy(app)

注意:FLASKR_SETTINGS環境變量須要手工單獨設置,window下能夠在命令行中輸入:

E:\workdir\blog2> set FLASKR_SETTINGS=E:\workdir\blog2\blog2\setting.py

或者點擊個人電腦-->高級-->環境變量,新建一個。

三、設計數據庫

本次練習比較簡單,就兩個表,一個user表,一個文章表。咱們採用python的orm框架flask-sqlalchemy實現表的建立、增刪改查功能。

在model文件夾中添加User.py和Category.py文件,內容以下:

1) User.py:

from blog2 import db

class User(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 = password
    def __repr__(self):
        return '<User %r>' % self.username

2) Category.py

from blog2 import db

class Category(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 = content
    def __repr__(self):
        return '<Category %r>' % self.title

3)建立數據庫和表

windows命令行模式下,cd到項目runserver.py那個目錄下,進入python shell下:

輸入紅色部分:

E:\workdir\blog2>python
Python 2.7.10 (default, May 23 2015, 09:44:00) [MSC v.1500 64 bit (AMD64)] on wi
n32
Type "help", "copyright", "credits" or "license" for more information.
>>> from blog2 import db
>>> db.create_all()
>>>
>>>

若是沒有任何錯誤輸出表明建立數據庫和表成功了。這時咱們到數據庫中去查看:

數據庫已經存在了,再看看錶狀況:發現沒有對應的b_user和b_category表。這是爲何呢?是否是沒有找到model目錄下的兩個類呢。問題在於:__init__.py文件沒有引入model包,致使__init__.py沒法找到實體類。記住:一切模塊對象的建立都在__init__.py中完成

在blog2目錄下的__init__.py添加以下代碼:

#只有在app對象以後聲明,用於導入model不然沒法建立表
from blog2.model import User,Category

再次運行上面命令:db.create_all()方法。這時表已經建立成功了。

三、添加界面模板:如登錄頁面,顯示blog文章頁面,添加blog頁面

在templates目錄下添加三個html文件:

layout.html:

 1 <!doctype html>
 2 <title>Flaskr</title>
 3 <link rel=stylesheet type=text/css href="{{ url_for('static', filename='style.css') }}">
 4 <div class=page>
 5   <h1>Flaskr</h1>
 6   <div class=metanav>
 7   {% if not session.logged_in %}
 8     <a href="{{ url_for('login') }}">log in</a>
 9   {% else %}
10     <a href="{{ url_for('logout') }}">log out</a>
11   {% endif %}
12   </div>
13   {% for message in get_flashed_messages() %}
14     <div class=flash>{{ message }}</div>
15   {% endfor %}
16   {% block body %}{% endblock %}
17 </div>

login.html:

{% extends "layout.html" %}
{% block body %}
  <h2>Login</h2>
  {% if error %}<p class=error><strong>Error:</strong> {{ error }}{% endif %}
  <form action="{{ url_for('login') }}" method=post>
    <dl>
      <dt>Username:
      <dd><input type=text name=username>
      <dt>Password:
      <dd><input type=password name=password>
      <dd><input type=submit value=Login>
    </dl>
  </form>
{% endblock %}

show_entries.html:

{% extends "layout.html" %}
{% block body %}
  {% if session.logged_in %}
    <form action="{{ url_for('add_entry') }}" method='POST' class=add-entry>
      <dl>
        <dt>Title:
        <dd><input type=text size=30 name=title>
        <dt>Text:
        <dd><textarea name=text rows=5 cols=40></textarea>
        <dd><input type=submit value=Share>
      </dl>
    </form>
  {% endif %}
  <ul class=entries>
  {% for entry in entries %}
    <li><h2>{{ entry.title }}</h2>{{ entry.content|safe }}
  {% else %}
    <li><em>Unbelievable.  No entries here so far</em>
  {% endfor %}
  </ul>
{% endblock %}

對應static中添加css文件:style.css

body            { font-family: sans-serif; background: #eee; }
a, h1, h2       { color: #377BA8; }
h1, h2          { font-family: 'Georgia', serif; margin: 0; }
h1              { border-bottom: 2px solid #eee; }
h2              { font-size: 1.2em; }

.page           { margin: 2em auto; width: 35em; border: 5px solid #ccc;
                  padding: 0.8em; background: white; }
.entries        { list-style: none; margin: 0; padding: 0; }
.entries li     { margin: 0.8em 1.2em; }
.entries li h2  { margin-left: -1em; }
.add-entry      { font-size: 0.9em; border-bottom: 1px solid #ccc; }
.add-entry dl   { font-weight: bold; }
.metanav        { text-align: right; font-size: 0.8em; padding: 0.3em;
                  margin-bottom: 1em; background: #fafafa; }
.flash          { background: #CEE5F5; padding: 0.5em;
                  border: 1px solid #AACBE2; }
.error          { background: #F0D6D6; padding: 0.5em; }

四、添加業務邏輯

在controller目錄下新建blog_message.py文件:

 1 from blog2.model.User import  User
 2 from blog2.model.Category import Category
 3 import os
 4 
 5 from blog2 import app,db
 6 from flask import request,render_template,flash,abort,url_for,redirect,session,Flask,g
 7 
 8 @app.route('/')
 9 def show_entries():
10     categorys = Category.query.all()
11     return render_template('show_entries.html',entries=categorys)
12 
13 @app.route('/add',methods=['POST'])
14 def add_entry():
15     if not session.get('logged_in'):
16         abort(401)
17     title = request.form['title']
18     content = request.form['text']
19     category = Category(title,content)
20     db.session.add(category)
21     db.session.commit()
22     flash('New entry was successfully posted')
23     return redirect(url_for('show_entries'))
24 
25 @app.route('/login',methods=['GET','POST'])
26 def login():
27     error = None
28     if request.method == 'POST':
29         username = request.form['username']
30         password = request.form['password']
31         user = User.query.filter_by(username=request.form['username']).first()
32         passwd = User.query.filter_by(password=request.form['password']).first()
33 
34         if user is None:
35             error = 'Invalid username'
36         elif passwd is None:
37             error = 'Invalid password'
38         else:
39             session['logged_in'] = True
40             flash('You were logged in')
41             return redirect(url_for('show_entries'))
42     return render_template('login.html', error=error)
43 
44 
45 @app.route('/logout')
46 def logout():
47     session.pop('logged_in', None)
48     flash('You were logged out')
49     return redirect(url_for('show_entries'))

千萬不要忘了在模塊級目錄下(blog2目錄)的__init__.py文件引入視圖模塊,代碼以下:

#只有在app對象以後聲明,用於導入view模塊
from blog2.controller import blog_manage

五、運行項目,效果以下:

1)輸入http://127.0.0.1:5000/,正常狀況下你的應該是空白的,由於尚未任何數據。

2)點擊log in

忘了告訴你了,你要事先在b_user表中添加一個用戶喔,由於登錄要驗證用戶的,不然你是沒法登錄成功的。

3) 添加條目

 

以上就是這個小項目的全部頁面,很簡單吧。你必定能搞定!!!

 

【總結】:經過本次練習,是否對flask框架運行機制有所瞭解呢,是否是已經有了全局的認識了,若是ok,那麼這個小練習就有存在價值了。

 

源碼下載:https://pan.baidu.com/s/1jHI64FO

 

參考文獻:

         【flask快速入門中文版】http://docs.jinkan.org/docs/flask/

         【flask快速入門英文版】http://flask.pocoo.org/docs/0.11/

         【flask-sqlalchemy中文版】http://www.pythondoc.com/flask-sqlalchemy/index.html

         【flask-sqlalchemy英文版】http://flask-sqlalchemy.pocoo.org/2.1/

相關文章
相關標籤/搜索