Form

概述

Form是GOT模型中用于定义画面结构的核心节点。在现代应用程序开发中，数据交互和用户界面设计的灵活性至关重要。为了有效地管理和表示数据，平台使用Form实体节点来定义数据源和用户界面组件已成为一种行之有效的方式。Form节点下包含多个关键节点，分别用于定义数据源和用户界面设计。

数据源管理

在 Form节点中，DataSources 节点作为数据源的容器，负责组织和管理与数据库交互所需的所有信息。该节点下的每个 DataSource 元素可对应数据库中的一张表，允许用户通过定义多个数据源来实现对不同表的访问和操作。为了增强数据的关联性和整合性，各个 DataSource 之间可以建立复杂的关联关系，从而支持跨表的数据操作和查询。这种设计不仅提高了数据的组织效率，还为后续的增删改查操作提供了基础。

界面设计

Form节点 下还包含一个 Design节点，负责定义用户界面的各种组件。该节点允许开发人员根据需求灵活地创建多种用户界面元素，包括但不限于表格、按钮和输入框等。在表格组件内，开发人员能够进一步定义 Editor，每个 Editor组件都可与某个特定 DataSources中的字段关联，使用户能够在表格中进行数据的新增、删除、查询和保存等操作。这种设计模式使得前端界面与后端数据之间的交互变得更加直观和高效。按钮组件的设计不仅限于用户界面的展示，它们还能够执行后台代码，从而实现复杂的逻辑处理和数据操作。通过将按钮与相应的后台服务或函数关联，开发人员可以在用户点击按钮时触发相应的数据库操作或业务逻辑处理。这一功能的实现，使得用户能够在界面上直接进行数据管理，快速响应用户操作，提高了应用的用户体验和交互效率。

Form实体支持包括：StringEditor、LongEditor、DecimalEditor、BooleanEditor、DateEditor、TimeEditor、DateTimeEditor、EnumEditor、Text、FieldGroup、Button、MenuItemButton、SubFormButton、ButtonGroup、ButtonMenu、DataGrid、Group、DividedBox、Tab、Image、Plugin共21种组件类型，这些组类型由GOT模型定义，大致分为容器和实体组件，容器下又可嵌套包含多种组件。组件与组件的嵌套融合，构造了画面结构的多样性。

每个Form实体会生成一个Form包目录，位于层节点源码的foms包目录下，命名规则为：实体名称。

每个Form包目录 包含以下内容：

• 一个实体节点命名的 Java类
• 一个base目录 base目录下 为一个FormBase_实体名称 命名的Java 类
• 一个datasource目录 目录下包含以下内容
  • 一个或者多个 FormDataSource节点关联的 Java 类 命名规则为：Form+实体名称+DataSource+数据源名称。
  • 一个base 目录 base 目录下包括 每个FormDataSource对应的base Java类

实体节点命名的 Java类

package gongqi.df.sales.layers.app.forms.SalesTable;
import gongqi.df.sales.layers.app.forms.SalesTable.base.FormBase_SalesTable;
public class Form_SalesTable extends FormBase_SalesTable {


}

FormBase_实体名称 命名的Java 类

package gongqi.df.sales.layers.app.forms.SalesTable.base;
import gongqi.erp.gotmodel.form.remote.CommandArg;
import gongqi.erp.gotmodel.form.remote.CommandResult;
public class FormBase_SalesTable extends 
            gongqi.erp.gotmodel.form.GongqiForm    
{
    //FormDataSource
    final public static String __DS_SysUser = "SysUser";
    //FormItem
    final public static String _Group2 = "Group2";
    ...

    @Override
    public CommandResult afterInit(CommandArg arg) {
        CommandResult result = super.afterInit(arg);
        result.executeQuery().setGroup("all");
        return result;
    }
}

FormDataSource节点关联的 Java 类

package gongqi.df.sales.layers.app.forms.SalesTable.datasource;
import gongqi.df.sales.layers.app.forms.SalesTable.datasource.base.Form_SalesTable_DataSourceBase_SysUser;
public class Form_SalesTable_DataSource_SysUser extends Form_SalesTable_DataSourceBase_SysUser {


}

FormDataSource节点关联的Base Java 类

package gongqi.df.sales.layers.app.forms.SalesTable.datasource.base;
public class Form_SalesTable_DataSourceBase_SysUser extends 
            gongqi.erp.gotmodel.form.datasource.FormDataSource    

{

}

实体结构

Form

Form实体节主要包含 描述数据源的 DataSources节点和 描述画面的Desgin节点

• DataSources 数据源集合 下可包含多个FormDataSource节点 每个FormDataSource对应一个Table实体节点 多个FormDataSource之间可建立关联
  • 每个FormDataSource节点下包含FormDataSourceField节点 节点对应Table实体的Fileds
  • 还包含 描述 分组的 GoupyBy 描述 聚合的Aggregation节点 用于在某些特殊数据展示的情况下去构建如 行列转置表等
  • Relation节点是用来描述 数据源之间的关联字段关系
• Desgin节点下可建立 多种组件

Form实体节点根据不同的FormTpye属性值 有不同的体现方式。

属性列表

DataSources

DataSources节点 数据源组 包含多个数据源节点

FormDataSource

FormDataSource实体节点数据源节点，每个数据源可对应一个实体Table节点

FormDataSourceField

FormDataSourceField节点是 FormDataSource节点下Fields的字节的 每个FormDataSourceField节点对应 FormDataSource关联的Table实体节点对应 的 TableFiled节点 其属性 也与TableFiled 节点类似 根据不同类型 有不同属性

公共属性列表

Long类型属性列表

Decimal类型属性列表

Date类型属性列表

Time类型属性列表

DateTime类型属性列表

Enum类型属性列表

FomDataSourceGroupBy

GourpBy节点下的子节点 当数据源是 Pivot 和 Aggregate 时 可配置 分组项

FormDataSourceAggregation

Aggregation节点下的子节点 当数据源是 Pivot 和 Aggregate 时 可配置 聚合项

FormDataSourceRelation

数据源关联关系，当前数据源关联其他数据源时 设置 数据源之间的关联关系 通常如 主数据某字段 = 当前数据源某字段

也可设置为字段等于某具体固定值

Desgin

FormItem

FormItem节点是 Form节点下Design子节点 。FormItem 主要用于作为元素支持画面的渲染效果,有多种节点类型 大致分为 Editor，容器和组件 。

公共属性列表

FormItemEditor

字段元素，主要用于画面上字段框的渲染 包含 StringEditor、LongEditor、DecimalEditor、BooleanEditor、DateEditor、TimeEditor、DateTimeEditor、EnumEditor和Text九种类型

公共属性列表

String类型属性列表

Long类型属性列表

Decimal类型属性列表

Date类型属性列表

Time类型属性列表

DateTime类型属性列表

Enum类型属性列表

DataGrid

平台界面设计核心组件之一，负责呈现和管理与数据库交互所需的信息。

属性列表

Button

平台界面设计核心组件之一，负责界面与后台业务逻辑的交互，每个Button 都可指定 buttonOk_ 二次开发方法执行后台业务逻辑

属性列表

MenuItemButton

MenuItemButton节点常用于快速配置跳转画面 结合属性MenuItem 打开的菜单受 权限控制

属性列表

SubFormButton

SubFormButton节点常用于快速配置跳转画面 结合属性SubForm 打开的画面不受权限控制

属性列表

Image

Image 节点是平台提供的一种图片展示控件，支持单图片或多图片展示，一般图片结合DataGrid时候 如 选择DataGrid内一行记录展示绑定该记录对应的图片

属性列表

Plugin

Plugin节点是平台提供的控件组件，组件类型包括 Radio、Html 和Tree

属性列表

FieldGroup

FieldGroup节点是 FormItemEditor节点的容器，即 FieldGroup节点下只允许存在FormItemEditor 常用于对画面上输入框布局调整

属性列表

Group

Group节点是 FormItem节点的容器，即 Group节点下允许建任何节点，常用于画面布局调整

属性列表

Tab

Tab节点是 平台提供的选项卡组件，Tab节点下可建立多个TabPage 每个TabPage就是一个选项，TabPage下可包含任意组件

DividedBox

DividedBox节点是 平台提供的折叠组件，DividedBox 下可包含任意组件，DividedBox下的根组件之间会渲染出折叠按钮用于折叠内容