Flask AppBuilder Model Views

基本框架应用程序

<your project name>/
config.py :全部 的 应用程序的配置

__init__.py :应用程序的初始化

models.py :声明 你的 数据库 模型 在这里

views.py :实现你的视图

从盒子中建立应用程序是很是简单和快速的，而且有详细的安全性。

请看github的例子

简单的联系人应用

咱们来建立一个很简单的联系人应用程序 FAB使用优秀的SQLAlchemy ORM包及其Flask扩展。您应该熟悉其声明性语法以在FAB上定义数据库模型

注意

自1.3.0以来，MongoDB使用MongoEngine 部分支持。您能够声明任何规范化的 数据库模式，就像在SQLAlchemy同样，并使用ModelView和CharView彻底相同的方式。
下一个版本将逐渐支持MongoDB的非标准化模式。

在咱们的示例应用程序，咱们要定义两个表，一个联系表，将持有该联系人的详细信息，以及一个ContactGroup表组咱们的接触或分类。
咱们能够另外定义一个“ 性别”表，为“男性”和“女性”提供枚举值的做用。

虽然您没有义务，但我建议您从Model类继承您的模型类。模型类与Flask-SQLALchemy db.Model彻底相同，但没有底层链接。
您固然能够从db.Model正常的Flask-SQLAlchemy 继承。这样作的缘由是Model与FAB的声明空间相同，使用它将容许您定义与用户的关系。
您能够经过从AuditMixin继承本身的Audit触发的列添加到模型中。（见API参考）

定义你的模型（models.py）

该 ContactGroup 模型。

from sqlalchemy import Column, Integer, String, ForeignKey, Date
from sqlalchemy.orm import relationship
from flask_appbuilder import Model

class ContactGroup(Model):
    id = Column(Integer, primary_key=True)
    name = Column(String(50), unique = True, nullable=False)

    def __repr__(self):
        return self.name

该 Contacts  表。

class Contact(Model):
    id = Column(Integer, primary_key=True)
    name =  Column(String(150), unique = True, nullable=False)
    address =  Column(String(564), default='Street ')
    birthday = Column(Date)
    personal_phone = Column(String(20))
    personal_cellphone = Column(String(20))
    contact_group_id = Column(Integer, ForeignKey('contact_group.id'))
    contact_group = relationship("ContactGroup")

    def __repr__(self):
        return self.name

请注意，此处使用的SqlAlchemy属性如“unique”，“nullable”和“default”将具备特殊处理。在这种状况下，当添加新的联系人时，若是具备相同名称的人已经存在，
将会进行查询以进行验证。与空名称的联系人将不被容许。列类型已验证。地址字段将包含“Street”做为默认值。您也能够添加本身的自定义验证，看高级配置

定义您的Views（views.py）

如今咱们来定义咱们对ContactGroup模型的见解。此视图将为您的模型定义设置建立，删除，更新和显示原语的功能。

咱们从继承模型视图类，它继承BaseCRUDView，这自己从继承BaseModelView，这样你就能够覆盖其全部的公共属性来配置你的CRUD原语的许多细节。看高级配置。

from flask_appbuilder import ModelView
from flask_appbuilder.models.sqla.interface import SQLAInterface

class GroupModelView(ModelView):
    datamodel = SQLAInterface(ContactGroup)
    related_views = [ContactModelView]

必需属性：

datamodel：	是db抽象层。使用您的视图模型进行初始化。

可选属性：

related_views：	若是你想在显示主/详细查看和编辑。f.a.b.将涉及1 / n的关系，自动，它会显示一个选项卡显示或编辑视图（或手风琴）与列表相关的记录。你也能够联系图表。

咱们定义ContactModelView

class ContactModelView(ModelView):
    datamodel = SQLAInterface(Contact)

    label_columns = {'contact_group':'Contacts Group'}
    list_columns = ['name','personal_cellphone','birthday','contact_group']

    show_fieldsets = [
                        (
                            'Summary',
                            {'fields':['name','address','contact_group']}
                        ),
                        (
                            'Personal Info',
                            {'fields':['birthday','personal_phone','personal_cellphone'],'expanded':False}
                        ),
                     ]

label_columns：	定义您的列的标签。框架将为您定义缺乏的一个，使用漂亮版本的列名称。
show_fieldsets：	一个字段集（Django样式）。您可使用show_fieldsets，add_fieldsets，edit_fieldsets自定义节目，独立添加和编辑视图。

ModelView的基类，全部属性都是继承自定义ModelView覆盖此属性

add_columns=None
要在添加表单视图中显示的列（或模型的方法）列表。用它来控制显示的顺序

add_exclude_columns=None
要从添加表单中排除的列的列表。默认状况下，包括全部列。

edit_columns=None
要在编辑表单视图中显示的列（或模型的方法）列表。用它来控制显示的顺序 

edit_exclude_columns=None
要从编辑表单中排除的列的列表。默认状况下，包括全部列。 

list_columns=None 
要在列表视图中显示的列（或型号的方法）列表。用它来控制显示的顺序 

show_columns=None 
在显示视图中显示的列（或型号的方法）列表。用它来控制显示的顺序 

show_exclude_columns=None 
要从展现视图中排除的列的列表。默认状况下，包括全部列。 

ModelView和ChartView的基类，全部属性都是继承自定义ModelView和ChartView覆盖此属性

此类支持查询的全部基础

search_columns = None
列出容许的搜索列，若是没有提供，将使用全部可能的搜索列。若是要限制搜索（过滤器）列的可能性，请使用模型中的列名列表定义它们：

class MyView(ModelView): datamodel = SQLAInterface(MyTable) search_columns = ['name','address']

= None
列表，其列将从搜索中排除。搜索默认包含全部可能的列 您能够轻松使用内置的替代外观，使用小部件查看小部件示例。search_exclude_columns

注意

引用关系的字段将在ContactGroup Model上显示定义的相关模型表示（在这种状况下为__repr __（）方法），所以默认状况下不能排序这些字段。
要在关系字段的列表中启用排序，您能够（自1.1.1起）使用虚线符号引用它们。在这个例子中，您可使用'contact_group.name'来引用它们。

登记（views.py）
呈现模型并建立菜单。
使用create_all来建立你的模型。

db.create_all()
appbuilder.add_view(GroupModelView,
                    "List Groups",
                    icon = "fa-folder-open-o",
                    category = "Contacts",
                    category_icon = "fa-envelope")
appbuilder.add_view(ContactModelView,
                    "List Contacts",
                    icon = "fa-envelope",
                    category = "Contacts")


您能够在如下网址找到此示例：https：//github.com/dpgaspar/Flask-AppBuilder/tree/master/examples/quickhowto

注意

此示例中的菜单的图标来自于font-awesome，Checkout fontAwesome 图标 名称。Font-Awesome已经包括在内，您能够在菜单和操做中使用任何您喜欢的图标

经过这几行代码（能够减小），您如今拥有一个具备针对每一个CRUD原语和菜单选项，身份验证和表单域验证的详细安全性的Web应用程序。然而，您能够普遍地更改许多细节，在CRUD原语以前或以后添加您本身的触发器，开发本身的Web视图并进行集成。

一些图片：

 

Exposed methods

您的ModelView类将如下方法公开为Flask端点

• list
• show
• add
• edit
• delete
• download
• action
• API methods

这将暴露一个REST API(不是彻底严格的)。您还拥有一个AJAX REST API。每一个方法都有本身的安全权限，因此您能够在这个级别上控制访问。

API方法采用与列表、显示、添加、编辑和删除相同的参数，但在成功或错误时返回JSON和HTTP返回代码。有关每一个方法的描述，请参见下面的表。

URL	Description	Permission Name	HTTP
/api	返回现有的API URL	can_list	GET
/api/read	查询模型数据，接收args做为列表	can_list	GET
/api/column	相关列的返回结果	can_list	GET
/api/create	以POST形式接收表单并建立记录	can_add	POST
/api/update	接收一个表单，做为PUT和更新记录	can_edit	PUT
/api/column/add/<COL NAME/	相关字段的返回值	can_add	GET
/api/column/add/<COL NAME/	相关字段的返回值	can_edit	GET
/api/readvalues	查询模型数据，准备在select2 combo上使用	can_list	GET

 

REST API

此API仍然是测试版，将会更改。未来，FAB可能会使用AngularJS来显示使用AJAX的UI界面。

URL = / API

API的根返回有关可用方法的信息，例如使用来自Flask的url_for的URL。用户对此视图的权限，标签等...

咱们来看看这个方法返回的JSON结构。返回的对象是一个包含如下键的字典：

api_urls：	全部内置CRUD方法及其URL的字典
can_add：	用户对此视图的权限。返回true或false。
can_delete：	用户对此视图的权限。返回true或false。
can_edit：	用户对此视图的权限。返回true或false。
can_show：	用户对此视图的权限。返回true或false。
can_update：	用户对此视图的权限。返回true或false。
label_columns：	用于label_columns的字典与ModelView属性彻底相同
list_columns：	在列表中使用的列。
modelview_name：	ModelView类的名称。
modelview_urls：	使用UI的url来添加、编辑和显示
order_columns：	使用命令列出的列的列表。
PAGE_SIZE：	默认页面大小。
search_fields：	使用列名做为键的字典，并将WTForm html字段做为值。
search_filters：	用列名做为键的字典和容许过滤器做为值的操做的列表。

URL=/api/read

这是API的读取方法，将使用过滤器，排序和寻呼操做查询您的模型。

咱们来看看这个方法返回的JSON结构。返回的对象是一个包含如下键的字典：

count：	返回一个带有记录总数的Int
label_columns：	对于label_columns彻底相等的词典为模型视图属性
list_columns：	在列表中使用的列。
modelview_name：	ModelView类的名称。
order_columns：	使用命令列出的列的列表。
page：	返回一个Int，在页面大小的页面上显示结果的位置
PAGE_SIZE：	返回具备当前页面大小的Int。
PKS：	使用结果私有密匙返回一个列表。
result：	返回一个包含每一个记录的字典的列表。

 

该方法接受以下参数：

Set page size:	_psize_<YOUR MODEL VIEW>=<PAGE SIZE>
Set page:	_page_<YOUR MODEL VIEW>=<PAGE>
Order by column:	_oc_<<YOUR MODEL VIEW>=<COLUMN NAME>
Order by direction:	_od_<<YOUR MODEL VIEW>=<asc|desc>
Filters:	_flt_<INDEX of the search operations for this column>_<COLUMN NANE>=<VALUE> example: _flt_0_name=A

 

URL=/api/delete/<PK>

从模型中删除记录只接受HTTP DELETE操做。若是要删除具备8做为主键的记录，

则将HTTP DELETE发送到如下URL：htpp：// localhost：8080 / contactmodelview / delete / 8

它将返回一个字典，在成功的状况下将具备如下键（返回HTTP 200）：

{ “message”: “Deleted Row”, “severity”: “success” }

若是出现错误（返回HTTP 500）：

{ “message”: “General Error <class ‘sqlalchemy.orm.exc.UnmappedInstanceError’>”, “severity”: “danger” }

Extra Views

FAB做为一些额外的视图，如ModelView但具备不一样的行为。您能够从根本上改变ModelView的方式，使用各类方法，如更改CRUD模板或小部件，CSS，插入或注入本身的HTML等，查看模板，高级配置，自定义。

然而，框架聚集了来自BaseCRUDView 3个额外的子类（模型视图是的子类BaseCRUDView，这意味着它实现了基于模型彻底CRUD以及JSON曝光）。此视图实现了替代CRUD GUI。

为了在同一页面上渲染多个视图（BaseModelView的子类）使用MultipleView。使用咱们之前的示例，您能够在同一页面上显示“组”列表和“联系人”列表，以在GroupModelView和ContactModelView的定义后添加如下视图：

首先记得要输入:
from flask_appbuilder import MultipleView

而后定义您的视图:
class MultipleViewsExp(MultipleView):
    views = [GroupModelView, ContactModelView]

  而后用菜单注册视图:

　appbuilder.add_view(MultipleViewsExp,"Multiple Views",icon="fa-envelope",category="Contacts")

 

您能够根据须要在同一页面上呈现尽量多的视图，包括图表类型视图，还能够查看图表视图来了解图表视图。

另外一个有趣的替代视图是MasterDetailView，由于名称意味着它实现了一个主要的细节GUI，它将渲染所选模型的菜单版本，而后与以前定义的您选择的BaseModelView子类相关联。再次使用联系人应用程序示例：

class GroupMasterView(MasterDetailView):
    datamodel = SQLAInterface(ContactGroup)
    related_views = [ContactModelView]

 

数据模型是在主机和related_views属性是由用户的组的选择来过滤的意见。您能够根据须要定义尽量多的详细视图，您甚至能够包括图表类型视图（它们是BaseModelView的子类），请记住主数据和细节之间必须有模型关系，而且框架将再次了解如何经过检查后端定义的关系来关联它们。