摘要：一般印象，項(xiàng)目適合做一些短小精悍的項(xiàng)目，特別是與等數(shù)據(jù)庫結(jié)合很是般配。生成報(bào)表，不同的查詢結(jié)果生成不同的報(bào)表。配置從下載客戶端，然后解壓后放入自己指定的目錄。指定數(shù)據(jù)庫連接池的超時(shí)時(shí)間。

一般印象，flask 項(xiàng)目適合做一些短小精悍的項(xiàng)目，特別是與 sqlite、mysql 等數(shù)據(jù)庫結(jié)合很是般配。但是在一些大公司，特別是一些金融行業(yè)等國企公司，還是以 oracle 居多，那么，這個(gè)小辣椒（flask）就無用武之地了嗎？No, No, No... 
下面將以 flask_oracle 項(xiàng)目為例，對(duì) flask 的功能進(jìn)行一個(gè)詳細(xì)的講解。

實(shí)現(xiàn)登錄功能，基于 flask-login。

不同的權(quán)限管理，管理員能看到本部門所有人的信息。

查詢功能，日期查詢。

生成報(bào)表，不同的查詢結(jié)果生成不同的報(bào)表。

項(xiàng)目實(shí)例系統(tǒng)是 ubuntu 17.04， python是 3.6.3 版本

$ virtualenv -p /usr/bin/python3 env
$ source env/bin/activate
(env)$ pip install flask # 在虛擬環(huán)境中安裝 flask 及插件
(env)$ pip install flask-login
(env)$ pip install flask-script
(env)$ pip install flask-wtf
(env)$ pip install flask-sqlalchemy
(env)$ pip install pyexcel
(env)$ pip install pyexcel-xls
(env)$ pip install cx-Oracle

提示： 其它的插件，如有需要，請(qǐng)自行安裝，該處沒有安裝 flask-migrate 插件，因?yàn)樵趯?shí)際項(xiàng)目中，oracle 數(shù)據(jù)庫是共用的，用 flask-migrate 創(chuàng)建及升級(jí)數(shù)據(jù)庫會(huì)導(dǎo)致很多不必要的麻煩，極端情況會(huì)刪除在 models.py 中未進(jìn)行類定義的表，請(qǐng)慎用。

從https://oracle.github.io/odpi/doc/installation.html#linux下載 oracle 客戶端，然后解壓后放入自己指定的目錄。

sudo apt-get install libaio1 # ubuntu 中使用該命令安裝，如果是 centos， 請(qǐng)使用 yum install libaio

export LD_LIBRARY_PATH=/home/ousikongjian/software/oracle/instantclient_12_2:$LD_LIBRARY_PATH # 該條命令重啟后會(huì)不起作用，請(qǐng)使用下面的命令，兩條命令二選一即可。

sudo sh -c "echo /home/ousikongjian/software/oracle/instantclient_12_2 > /etc/ld.so.conf.d/oracle-instantclient.conf" #  請(qǐng)注意 oracle 客戶端的路徑問題。

sudo ldconfig

該方法不在贅述，請(qǐng)參看本人的博客文章——使用 pycharm deployment 功能遠(yuǎn)程調(diào)試代碼

盡管該項(xiàng)目是一個(gè)展示項(xiàng)目，但是為了更貼近實(shí)際，還是使用了藍(lán)圖的功能。

flask_oracle
    |-- app
        |-- show # 藍(lán)圖文件夾
            |-- __init__.py
            |-- views.py
            |-- forms.py
        |-- templates # 模板文件夾
            |-- show # 藍(lán)圖的模板文件夾
            |-- ... # 其它藍(lán)圖的模板文件夾
        |-- __init__.py
    |-- config.py
    |-- manage.py

涉及到 config.py 的主要內(nèi)容如下：

import os
import hashlib


class Config(object):
    os.environ["NLS_LANG"] = "SIMPLIFIED CHINESE_CHINA.UTF8"
    SQLALCHEMY_POOL_SIZE = 20 #數(shù)據(jù)庫連接池的大小。默認(rèn)是引擎默認(rèn)值（通常 是 5 ），此處最重要。
    SQLALCHEMY_POOL_TIMEOUT = 5 # 指定數(shù)據(jù)庫連接池的超時(shí)時(shí)間。默認(rèn)是10s。
    SQLALCHEMY_POOL_RECYCLE = 3000 # 配置連接池的 recyle 時(shí)間。默認(rèn)是7200s。
    SECRET_KEY = os.environ.get("SECRET_KEY") or hashlib.new(name="md5", string="ousi keji hawk@#").hexdigest()
    SQLALCHEMY_TRACK_MODIFICATIONS = True
    SQLALCHEMY_COMMIT_ON_TEARDOWN = True
    OUSI_POSTS_PER_PAGE = 100


    @staticmethod
    def init_app(app):
        pass

問題描述參見： flask_sqlalchemy 使用 cx_oralce 連接數(shù)據(jù)超時(shí)的問題？

主要涉及到 models.py 的內(nèi)容如下：

# -*- coding:utf-8 -*-
__author__ = "東方鶚"
__blog__ = u"http://www.os373.cn"


from . import db
from flask_login import UserMixin, AnonymousUserMixin, current_user
from . import login_manager


@login_manager.user_loader
def load_user(user_id):
    return OusiStaff.query.get(int(user_id))


class OusiStaff(UserMixin, db.Model):
    __tablename__ = "ousi_staff"
    sid = db.Column(db.Integer, primary_key=True)
    department = db.Column(db.String(8))
    name = db.Column(db.String(8))
    password = db.Column(db.String(8))
    phone = db.Column(db.String(11))
    role = db.Column(db.String(8))

    def is_admin(self):
        return self.role == "admin"


class AnonymousUser(AnonymousUserMixin):
    def is_admin(self):
        return False


login_manager.anonymous_user = AnonymousUser


class OusiGuest(db.Model):
    __tablename__ = "ousi_guest"
    id = db.Column(db.Integer, primary_key=True)
    staff_phone = db.Column(db.String(11))
    name = db.Column(db.String(8))
    month = db.Column(db.String(8))
    balance = db.Column(db.Integer)

1、 創(chuàng)建表 —— ousi_staff （用戶表），并實(shí)現(xiàn) sid 的序列化自增功能，自增的階梯為 1，因?yàn)?sqlalchemy 要求必須得有主鍵。

---------------------------create ousi_staff-------------

-- 創(chuàng)建 ousi_staff 表
create table ousi_staff(
       sid number primary key,  
       department varchar2(8),
       name varchar2(8),
       password varchar2(8),
       phone varchar2(11),
       role varchar2(8)
)
-- 創(chuàng)建 seq_ousi_staff 序列
create sequence seq_ousi_staff
-- 創(chuàng)建 tg_ousi_staff 觸發(fā)器
create or replace trigger tg_ousi_staff before
  INSERT ON ousi_staff FOR EACH row
DECLARE integrity_error EXCEPTION;
  errno  INTEGER;
  errmsg CHAR(200);
  dummy  INTEGER;
  found  BOOLEAN;
BEGIN
  --  Column sid uses sequence seq_ousi_staff
  SELECT seq_ousi_staff.NEXTVAL
  INTO :new.sid -- 注意 id 的名稱
  FROM dual;
  --  Errors handling

EXCEPTION
WHEN integrity_error THEN
  raise_application_error(errno, errmsg);
END;

2、 創(chuàng)建表 —— ousi_guest （客戶表），并實(shí)現(xiàn) id 的序列化自增功能，自增的階梯為 1，因?yàn)?sqlalchemy 要求必須得有主鍵。

---------------------------create ousi_guest-------------

-- 創(chuàng)建 ousi_guest 表
create table ousi_guest(
       id number primary key,  
       staff_phone varchar2(11),
       name varchar2(8),
       month varchar2(8),
       balance number
)
-- 創(chuàng)建 seq_ousi_guest 序列
create sequence seq_ousi_guest
-- 創(chuàng)建 tg_ousi_guest 觸發(fā)器
create or replace trigger tg_ousi_guest before
  INSERT ON ousi_guest FOR EACH row
DECLARE integrity_error EXCEPTION;
  errno  INTEGER;
  errmsg CHAR(200);
  dummy  INTEGER;
  found  BOOLEAN;
BEGIN
  --  Column id uses sequence seq_ousi_guest
  SELECT seq_ousi_guest.NEXTVAL
  INTO :new.id
  FROM dual;
  --  Errors handling

EXCEPTION
WHEN integrity_error THEN
  raise_application_error(errno, errmsg);
END;

提示： 建立的數(shù)據(jù)庫有坑，對(duì) flask-login 有影響，彩蛋將在以后的章節(jié)中揭曉。

其它配置內(nèi)容（如模板，試圖函數(shù)等）不在贅述，請(qǐng)查看 源碼01。表中的數(shù)據(jù)，請(qǐng)參見源碼里的 database.xlsx。

如下圖所示，上傳本地文件到遠(yuǎn)程主機(jī)。

配置啟動(dòng)項(xiàng)。

啟動(dòng)項(xiàng)目，你將看到如圖所示內(nèi)容。

源碼下載