当前位置:   article > 正文

Flask AppBuilder Model Views

flask appbuilder教学

基本框架应用程序

<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']

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

引用关系的字段将在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视图并进行集成。

一些图片:

_images / login_db.png_images / group_list.png_images / contact_list.png

 

Exposed methods

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

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

这将暴露一个REST API(不是完全严格的)。您还拥有一个AJAX REST API。每个方法都有自己的安全权限,所以您可以在这个级别上控制访问。

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

URLDescriptionPermission NameHTTP
/api返回现有的API URLcan_listGET
/api/read查询模型数据,接收args作为列表can_listGET
/api/column相关列的返回结果can_listGET
/api/create以POST形式接收表单并创建记录can_addPOST
/api/update接收一个表单,作为PUT和更新记录can_editPUT
/api/column/add/<COL NAME/相关字段的返回值can_addGET
/api/column/add/<COL NAME/相关字段的返回值can_editGET
/api/readvalues查询模型数据,准备在select2 combo上使用can_listGET

 

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。使用我们以前的示例,您可以在同一页面上显示“组”列表和“联系人”列表,以在GroupModelViewContactModelView的定义后添加以下视图:

首先记得要输入:
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的子类),请记住主数据和细节之间必须有模型关系,并且框架将再次了解如何通过检查后端定义的关系来关联它们。

转载于:https://www.cnblogs.com/Jonecmnn/p/7610734.html

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/天景科技苑/article/detail/857232
推荐阅读
相关标签
  

闽ICP备14008679号