Python的Flask框架中Flask-Admin庫的簡單入門指引
Flask-Admin是一個功能齊全、簡單易用的Flask擴(kuò)展，讓你可以為Flask應(yīng)用程序增加管理界面。它受django-admin包的影響，但用這樣一種方式實(shí)現(xiàn)，開發(fā)者擁有最終應(yīng)用程序的外觀、感覺和功能的全部控制權(quán)。
本文是關(guān)于Flask-Admin庫的快速入門。本文假設(shè)讀者預(yù)先具有一些Flask框架的知識。
- 介紹
- 初始化
- 增加視圖
- 身份驗(yàn)證
- 生成URL
- 模型視圖
- 文件管理
介紹
這個庫打算做到盡可能的靈活。并且開發(fā)者不需要任何猴子補(bǔ)丁就可以獲得期望的功能。
這個庫使用一個簡單而強(qiáng)大的概念——管理部件（administrative pieces，不太好翻譯），是用視圖方法構(gòu)建的類。
例如，這是一個絕對有效的管理部件：
class MyView(BaseView):
@expose('/')
def index(self):
return self.render('admin/myindex.html')
@expose('/test/')
def test(self):
return self.render('admin/test.html')
如果用戶訪問index視圖，模板文件admin/myindex.html會被渲染。同樣的，訪問test視圖的結(jié)果是admin/test.html被渲染。
那么，這個方法怎樣幫助管理界面的結(jié)構(gòu)化？使用這些已建立的部件，你可以實(shí)施高度定制化的可重復(fù)使用的功能。
例如，F(xiàn)lask-Admin提供一個現(xiàn)成的SQLAlchemy模型接口。它以類執(zhí)行并接受2個參數(shù)：模型類和數(shù)據(jù)庫會話。當(dāng)它顯示一些改變接口的行為的類級變量（有點(diǎn)像django.contrib.admin），沒有任何東西阻止你繼承它并覆蓋表單創(chuàng)建邏輯、數(shù)據(jù)庫存儲方法或者通過增加更多的視圖擴(kuò)展現(xiàn)有的功能。
初始化
要開始使用Flask-Admin，你需要創(chuàng)建一個Admin類實(shí)例并和Flask應(yīng)用程序?qū)嵗P(guān)聯(lián)。
from flask import Flask from flask.ext.admin import Admin app = Flask(__name__) admin = Admin(app) # Add administrative views here app.run()
如果你運(yùn)行這個程序并訪問http://localhost:5000/admin/，你會看到一個頂部有導(dǎo)航欄的空的“Home”頁面：
你可以更換應(yīng)用程序名稱通過傳值給Admin類構(gòu)造函數(shù)的name參數(shù)：
admin = Admin(app, name='My App')
作為一個選擇方案，在Admin實(shí)例初始化之后，你可以調(diào)用init_app()函數(shù)把Flask應(yīng)用程序?qū)ο髠鹘oAdmin構(gòu)造函數(shù)：
admin = Admin(name='My App') # Add views here admin.init_app(app)
增加視圖
現(xiàn)在，讓我們增加一個管理視圖。下面的例子會致使兩個項(xiàng)目出現(xiàn)在導(dǎo)航菜單：Home和Hello。為此，你需要衍生于BaseView類：
from flask import Flask
from flask.ext.admin import Admin, BaseView, expose
class MyView(BaseView):
@expose('/')
def index(self):
return self.render('index.html')
app = Flask(__name__)
admin = Admin(app)
admin.add_view(MyView(name='Hello'))
app.run()
一個關(guān)于管理視圖的重要約束是每個視圖類應(yīng)該擁有一個默認(rèn)的以根URL/開頭的頁面視圖方法。下面的例子是正確的：
class MyView(BaseView):
@expose('/')
def index(self):
return self.render('index.html')
可是，這個不工作：
class MyView(BaseView):
@expose('/index/')
def index(self):
return self.render('index.html')
現(xiàn)在，創(chuàng)建一個新的index.html文件并寫入如下內(nèi)容：
{% extends 'admin/master.html' %}
{% block body %}
Hello World from MyView!
{% endblock %}
然后把它放到templates目錄。為維持一致的外觀和感覺，所有管理頁面應(yīng)該延伸于admin/master.html模板。
你現(xiàn)在應(yīng)該看到Hello頁面的新的管理頁面起作用了。
要增加另一個級別的菜單項(xiàng)目，你可以指定category參數(shù)的值當(dāng)傳送管理視圖給Admin實(shí)例時。category指定頂級菜單項(xiàng)目的名字，并且所有與之關(guān)聯(lián)的視圖，都會通過下拉菜單進(jìn)入。例如：
from flask import Flask
from flask.ext.admin import Admin, BaseView, expose
class MyView(BaseView):
@expose('/')
def index(self):
return self.render('index.html')
app = Flask(__name__)
admin = Admin(app)
admin.add_view(MyView(name='Hello 1', endpoint='test1', category='Test'))
admin.add_view(MyView(name='Hello 2', endpoint='test2', category='Test'))
admin.add_view(MyView(name='Hello 3', endpoint='test3', category='Test'))
app.run()
看起來是這樣的：
要增加另一個級別的菜單項(xiàng)目，你可以指定category參數(shù)的值當(dāng)傳送管理視圖給Admin實(shí)例時。category指定頂級菜單項(xiàng)目的名字，并且所有與之關(guān)聯(lián)的視圖，都會通過下拉菜單進(jìn)入。例如：
from flask import Flask
from flask.ext.admin import Admin, BaseView, expose
class MyView(BaseView):
@expose('/')
def index(self):
return self.render('index.html')
app = Flask(__name__)
admin = Admin(app)
admin.add_view(MyView(name='Hello 1', endpoint='test1', category='Test'))
admin.add_view(MyView(name='Hello 2', endpoint='test2', category='Test'))
admin.add_view(MyView(name='Hello 3', endpoint='test3', category='Test'))
app.run()
看起來是這樣的：
身份驗(yàn)證
Flask-Admin沒有設(shè)想任何你可以使用的身份驗(yàn)證系統(tǒng)。因此，默認(rèn)的，管理界面是完全開放的。
要控制使用管理界面，你可以指定is_accessible方法當(dāng)擴(kuò)展BaseView類時。那么，舉例，如果你使用Flask-Login做身份驗(yàn)證，下面的代碼確保只有已登入的用戶能訪問視圖：
class MyView(BaseView):
def is_accessible(self):
return login.current_user.is_authenticated()
你也可以實(shí)施基于策略的保密，有條件的允許或不允許使用管理界面的某些部分。如果一個用戶無權(quán)使用某個特定視圖，則菜單項(xiàng)目不可見。
生成URL
在內(nèi)部，視圖類工作于Flask藍(lán)圖的頂部，因此你可以使用url_for附帶一個.前綴來獲得局部視圖的URL：
from flask import url_for
class MyView(BaseView):
@expose('/')
def index(self)
# Get URL for the test view method
url = url_for('.test')
return self.render('index.html', url=url)
@expose('/test/')
def test(self):
return self.render('test.html')
如果你要在外部生成一個特定視圖的URL，應(yīng)用下面的規(guī)則：
你可以覆蓋endpoint名稱通過傳送endpoint參數(shù)給視圖類構(gòu)造函數(shù)：
admin = Admin(app)
admin.add_view(MyView(endpoint='testadmin'))
# In this case, you can generate links by concatenating the view method name with an endpoint:
url_for('testadmin.index')
如果你不覆蓋endpoint名稱，類名的小寫形式會用于生成URL，像這樣：
url_for('myview.index')
對基于模型的視圖規(guī)則不一樣——模型類名稱會被使用如果沒有提供endpoint名稱?；谀Ｐ偷囊晥D下一節(jié)解釋。
模型視圖
模型視圖允許你為數(shù)據(jù)庫中的每個模型增加專用的管理頁面。通過創(chuàng)建ModelView類實(shí)例做這個，ModelView類可從Flask-Admin內(nèi)置的ORM后端引入。一個SQLAlchemy后端的例子，你可以這樣使用：
from flask.ext.admin.contrib.sqla import ModelView # Flask and Flask-SQLAlchemy initialization here admin = Admin(app) admin.add_view(ModelView(User, db.session))
這創(chuàng)建一個User模型的管理界面。默認(rèn)的，列表視圖看起來是這樣的：
要定制這些模型視圖，你有兩個選擇：一是覆蓋ModelView類的公有屬性，二是覆蓋它的方法。
例如，假如你要禁用模型創(chuàng)建功能并且只在列表視力顯示某些列，你可以這樣做：
from flask.ext.admin.contrib.sqla import ModelView
# Flask and Flask-SQLAlchemy initialization here
class MyView(ModelView):
# Disable model creation
can_create = False
# Override displayed fields
column_list = ('login', 'email')
def __init__(self, session, **kwargs):
# You can pass name and other parameters if you want to
super(MyView, self).__init__(User, session, **kwargs)
admin = Admin(app)
admin.add_view(MyView(db.session))
覆蓋表單元素有些棘手，但還是可能的。這個例子是關(guān)于如何建立一個包含有只允許使用預(yù)定義值的名為status的列的表單，并使用SelectField：
from wtforms.fields import SelectField
class MyView(ModelView):
form_overrides = dict(status=SelectField)
form_args = dict(
# Pass the choices to the `SelectField`
status=dict(
choices=[(0, 'waiting'), (1, 'in_progress'), (2, 'finished')]
))
通過繼承BaseModelView類和實(shí)現(xiàn)數(shù)據(jù)庫相關(guān)的方法為不同的數(shù)據(jù)庫后端（比如Mongo等）增加支持是相對容易的。
關(guān)于如何定制基于模型的管理視圖的行為請參考flask.ext.admin.contrib.sqla文檔。
文件管理
Flask-Admin擁有另一個便利的特性——文件管理。它給予你管理服務(wù)器文件的能力（上傳、刪除、重命名等）。
這是一個簡單的例子：
from flask.ext.admin.contrib.fileadmin import FileAdmin import os.path as op # Flask setup here admin = Admin(app) path = op.join(op.dirname(__file__), 'static') admin.add_view(FileAdmin(path, '/static/', name='Static Files'))
例子截圖：
你可以禁用上傳、禁用文件或目錄刪除、限制文件上傳類型等等。關(guān)于怎么做這些請查看flask.ext.admin.contrib.fileadmin文檔。
相關(guān)文章
解決python3 Pycharm上連接數(shù)據(jù)庫時報錯的問題
今天小編就為大家分享一篇解決python3 Pycharm上連接數(shù)據(jù)庫時報錯的問題，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2018-12-12
今天小編就為大家分享一篇pandas每次多Sheet寫入文件的方法，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2018-12-12
Python使用Chrome插件實(shí)現(xiàn)爬蟲過程圖解
這篇文章主要介紹了Python使用Chrome插件實(shí)現(xiàn)爬蟲,文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友可以參考下2020-06-06
python抓取豆瓣圖片并自動保存示例學(xué)習(xí)
python抓取豆瓣圖片并自動保存示例學(xué)習(xí)，示例使用了beautifulsoup庫分析HTML代碼，beautifulsoup是一個HTML/XML解析器，可以用來做網(wǎng)頁爬蟲2014-01-01
Python統(tǒng)計可散列的對象之容器Counter詳解
Counter是一個容器,可以跟蹤等效值增加的次數(shù).這個類可以用來實(shí)現(xiàn)其他語言中常用包或多集合數(shù)據(jù)結(jié)構(gòu)實(shí)現(xiàn)的算法.本篇文章非常詳細(xì)的介紹了容器Counter的使用方式,需要的朋友可以參考下2021-05-05
這篇文章主要介紹了python文件操作之目錄遍歷的方法,以實(shí)例形式較為詳細(xì)的分析了目錄遍歷所需要用到的相關(guān)函數(shù)與使用技巧,需要的朋友可以參考下2015-05-05
Python 多模式字符串搜索 Aho-Corasick詳解
Aho-Corasick 算法是一種用于精確或近似多模式字符串搜索的高效算法,本文給大家介紹Python 多模式字符串搜索 Aho-Corasick的相關(guān)知識,感興趣的朋友跟隨小編一起看看吧2025-01-01
這篇文章主要為大家詳細(xì)介紹了python語音識別實(shí)踐之百度語音API，具有一定的參考價值，感興趣的小伙伴們可以參考一下2018-08-08
python數(shù)據(jù)處理67個pandas函數(shù)總結(jié)看完就用
這篇文章主要介紹了python數(shù)據(jù)處理67個pandas函數(shù)的梳理總結(jié)，看完就可以去用了，有需要的朋友可以借鑒參考下，希望能夠有所幫助2021-11-11
已解決不小心卸載pip后怎么處理(重新安裝pip的兩種方式)
這篇文章主要介紹了已解決不小心卸載pip后怎么處理（重新安裝pip的兩種方式）,本文給大家介紹的非常詳細(xì)，對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值，需要的朋友可以參考下2023-04-04