Flask AppBuilder Base Views

Base Views

所有视图都从这个类继承。它的构造函数将在Flask注册您的url作为一个蓝图，以及所有需要定义和保护的安全权限。

您可以使用这种视图来实现您自己的自定义页面，将其附加到菜单上，或者将其链接到您的站点。

使用 @expose来修饰您的url路由方法。另外，添加@hasaccess修饰器来告诉烧瓶，这是一个安全保护的方法。

使用Flask-AppBuilder-Skeleton。编辑视图。py文件并添加:

from flask_appbuilder import AppBuilder, expose, BaseView
from app import appbuilder

class MyView(BaseView):
    route_base = "/myview"

    @expose('/method1/<string:param1>')
    def method1(self, param1):
        # do something with param1
        # and return it
        return param1

    @expose('/method2/<string:param1>')
    def method2(self, param1):
        # do something with param1
        # and render it
        param1 = 'Hello %s' % (param1)
        return param1

appbuilder.add_view_no_menu(MyView())

这个简单的示例将用两个路由url来注册您的视图:

/myview/method1/<string:param1>
/myview/method2/<string:param1>

不会为此创建菜单，也不会创建安全权限。如果您想为您的方法启用详细的安全访问，请使用@hasaccess修饰器。现在运行这个例子

$ fabmanager run

您可以使用以下url来测试您的方法

http://localhost:8080/myview/method1/john

http://localhost:8080/myview/method2/john

正如您所看到的，这些方法是公开的。所以让我们保护他们。改变views.py,

 

from flask_appbuilder import AppBuilder, BaseView, expose, has_access
from app import appbuilder


class MyView(BaseView):

    default_view = 'method1'

    @expose('/method1/')
    @has_access
    def method1(self):
        # do something with param1
        # and return to previous page or index
        return 'Hello'

    @expose('/method2/<string:param1>')
    @has_access
    def method2(self, param1):
        # do something with param1
        # and render template with param
        param1 = 'Goodbye %s' % (param1)
        return param1

appbuilder.add_view(MyView, "Method1", category='My View')
appbuilder.add_link("Method2", href='/myview/method2/john', category='My View')

请注意，这些方法将使简单的页面与FAB的外观和感觉无法整合。将应用程序的外观和感觉集成到应用程序的响应中很容易，因此您必须创建自己的模板。在您的项目目录和应用程序文件夹下创建一个名为“templates”的文件夹。里面创建一个文件名'method3.html'

{ ％ extends  “appbuilder / base.html”  ％} 
{ ％ block  content  ％} 
    < h1 > {{ param1 }} </ h1 > 
{ ％ endblock  ％}

 在MyView类上添加以下方法：

from flask import render_template

@expose('/method3/<string:param1>')
@has_access
def method3(self, param1):
    # do something with param1
    # and render template with param
    param1 = 'Goodbye %s' % (param1)
    self.update_redirect()
    return self.render_template('method3.html',param1 = param1)

创建一个菜单链接到您的新方法：

appbuilder.add_link("Method3", href='/myview/method3/john', category='My View')

你可以看到你只需要在你的模板上扩展“appbuilder / base.html”，然后覆盖块内容。你有许多其他的块可以覆盖或扩展诸如css include，javascript，headers，tail等等的东西...接下来使用Flaskrender_template来渲染你的新模板。

注意

更新重定向，在版本0.10.3，重定向算法被审查，并使用会话cookie保存5个导航历史记录。这对于重定向回来，保持url参数和改进UI体验非常有用。您必须调用self.update_redirect（）将当前url插入导航历史记录。有时您可能希望跳过更新，例如表单验证错误，以便在验证错误之前，后台操作不会将您发送到同一个表单。

注意

自1.3.0版以来，您必须渲染所有的视图模板，如self.render_template，这是因为base_template（可以被覆盖）和appbuilder现在总是传递给模板。

子类SimpleFormView或PublicFormView为您的自定义窗体视图提供基础处理。

通常，您将需要这种视图来呈现不是基于数据库模型的表单，因为当它们执行时，FAB可以自动生成它们，并且可以向其添加或删除字段以及自定义验证器。为此，您可以使用ModelView。

from wtforms import Form, StringField
from wtforms.validators import DataRequired
from flask_appbuilder.fieldwidgets import BS3TextFieldWidget
from flask_appbuilder.forms import DynamicForm


class MyForm(DynamicForm):
    field1 = StringField(('Field1'),
        description=('Your field number one!'),
        validators = [DataRequired()], widget=BS3TextFieldWidget())
    field2 = StringField(('Field2'),
        description=('Your field number two!'), widget=BS3TextFieldWidget())

现在定义您的表单视图来公开url，创建一个菜单条目，创建安全访问，定义pre和post处理。

实现formget和formpost来实现表单的预处理和后处理。您可以使用formget来预先填入表单，并在应用程序中预先处理某些内容，然后使用formpost在用户提交后将表单提交给表单，您可以将数据保存到数据库、发送电子邮件或其他需要的操作。

from flask_appbuilder import SimpleFormView
from flask_babel import lazy_gettext as _


class MyFormView(SimpleFormView):
    form = MyForm
    form_title = 'This is my first form view'
    message = 'My form submitted'

    def form_get(self, form):
        form.field1.data = 'This was prefilled'

    def form_post(self, form):
        # post process form
        flash(self.message, 'info')

appbuilder.add_view(MyFormView, "My form View", icon="fa-group", label=_('My form View'),
                     category="My Forms", category_icon="fa-cogs")

 

请注意，此类派生自BaseView，因此可以覆盖父类的所有属性。还要注意标签如何使用babel的lazy_gettext作为_（'text'）功能，以便您的菜单项可以翻译。

你可以在SimpleForm上找到这个例子。