自定义表单引擎

先总体介绍一下大概的架构和核心模块设计。先上一张整体设计图

 

概念还是有点多，有一些概念可能比较新，如果熟悉K2自定义表单，可能比较好理解一些。

　　对核心的一些功能模块进行总体介绍如下(用.net core实现，其他语言整体设计思路相差不大)

基础设施：

自定义表单主要涉及到数据存储，包括表单定义信息和真实的业务表存储管理，可支持不同的数据库存储，Redis主要用在缓存更新通知上，Redis不存储表单定义缓存

基础组件：

表单基础框架，.net core实现，用Dapper做ORM存储，封装了UnitOfWork，另外还包括了模块管理、租户/应用管理等基础功能，不包括权限相关功能。

• 表单定义本地缓存：

表单定义信息对于自定义表单来说，访问特别的频繁，真实业务变更极少，需要不少的过滤查询，如果存储到Redis，涉及到频繁的访问以及数据过滤，对整体性能影响也比较大，所以这里考虑把表单定义信息存储到每一个应用程序内存中，直接从内存中访问表单定义信息，表单定义信息改变时，通知所有应用表单定义对应的数据已经更新，应用程序读取数据时，会从数据库读取最新的数据存储到内存中。表单定义信息还会存储到浏览器Indexdb中，一条总的原则就是访问自定义表单定义信息一定要快，就近获取。

• 基础数据本地缓存：

数据字典(用户信息)也可以存储到本地缓存，管理方式同表单定义本地缓存，数据字典变更极少，访问大；业务表往往只存储用户Id，展示需要用户名称，所以也存储到本地缓存中。

• 缓存变更通知：

修改了表单定义信息或者数据字典等，通过Redis通知所有应用程序清空本地缓存，再次读取数据时，应用程序从数据库或者接口读取数据再填充到内存中。如果检测到Redis断开连接，则直接从数据库或者接口读取数据，待Redis恢复，再从内存读取数据。Redis可由其他有发布订阅中间件服务替换。

• CurrentUser：

只提供接口定义，对接具体的框架实现具体的逻辑，比如框架使用Abp框架，则从Abp的ICurrentUser读取用户当前用户信息。

• 微服务调用组件：

暂时未迁移，见作者其他博客描述。

• 租户/应用配置管理：

对自定义表单数据在租户和应用级别进行隔离，以支持Saas服务。

Sprite Comon：

自定义表单公共组件/模块

• 动态Sql：

自定义表单比较核心的内容之一，所有对业务表的常规CRUD，都是通过动态拼接Sql语句完成以及动态参数，这里面涉及到大量的JObject操作，也就是开发者用得比较多的Newtonsoft.Json组件部分内容。

• 动态查询条件：

对Sql的参数查询，查询条件定义为一棵查询树，然后根据树完成Sql查询条件Where子句的字符串拼接。

• 动态表达式：

也是一棵树，每一个节点为一种函数或者取值，比如逻辑表达式、日期转换函数、从方法获取值、固定值等，根据根节点类型返回对应动态值

• 表单规则：

自定义表单灵魂所在，有了表单规则定义，才能称之为表单引擎，可定义视图或者表单规则；

• 表单规则事件：

比如用户列表视图新增按钮点击事件，部门树用户列表表单部门树视图树节点选中节点变化事件，用户列表视图弹出对话框保存事件等，可以是视图/表单本身或者控件触发，也可以是子表单/子视图本身或者控件触发

• 表单规则执行：

当某一个规则定义的事件被触发，可定义执行一系列执行动作，比如"用户列表视图新增按钮点击事件"触发时，定义执行设置用户列表选中部门参数、获取用户列表查询参数定义、执行后端获取用户分页数据方法、将执行结果传递给用户列表等一系列动作。再比如"用户列表视图弹出对话框保存事件"事件触发,验证用户Item视图、验证通过

• 定义时和运行时验证：

自定义表单不需要写代码，则验证就显得非常的重要了，定义时各个模型之前数据是否正确，规则定义是否正确，运行时参数等是否正确等

• 序列化：

表单定义存储往往是结构化的数据，很多定义信息可能以字符串的方式存储，但JS前端往往需要Json数据，则需要进行序列化与反序列化操作。

Sprite Object：

自定义表单对象管理，包括对象、属性、方法

• Object管理：

Object管理与业务表需要完全同步，添加Object时，需要动态生成业务表的创建Sql语句，并在业务库中创建具体业务表，业务表名称与Object的Name字段对应，动态Sql是根据Object定义信息拼接Sql语句并在真实业务库中执行Sql语句。

• Property管理：

Object定义表，Property定义字段，自定义表单定义一些审计相关的字段并进行维护，包括Creator,CreationTime,IsDeleted等

• Method管理:

定义方法，可以是执行Sql语句、调用微服务、反射调用，并包括方法能够成功执行的附加信息定义，并对执行参数进行验证，对业务表常规的操作已经定义到了自定义表单中，比如Create,Update,Get,List,PageList,TreeList等，不需要格外定义方法

• 业务表管理：

对Object和Property的管理，同步更新业务表表结构，他们之间需要完全的对应。

Sprite View and Form:

• 视图管理：

自定义表单最小功能单元定义，比如用户Item，用户列表视图，部门树视图等，抽离出Item视图、列表视图、树视图等各个单元视图。

• 表单管理：

自定义表单视图容器，表单不处理任何具体业务，只是将各种视图聚合起来统一管理，可以对视图进行布局，可以定义规则在视图与视图之间传递数据等。

• 视图/表单控件：

统一定义不同视图/表单固定区域的控件，比如列表视图查询区域控件，列表功能控件，新增，刷新，批量删除等，或者列表行控件等，再或者表单流程相关控制按钮

• 视图/表单Wrap管理：

视图或者表单只定义自身需要的功能，但用到哪些地方自身是不知道的，比如用户Item视图放入用户列表弹出框中，部门树表单用Card布局等

• 视图/表单行列管理：

按照Grid布局，定义常规的行列布局管理

• 子视图/子表单：

表单列或者视图列的内容可以是子表单或者子视图，运行时当发现是子视图或者子表单，则动态再加载配置的视图或者表单。

• 视图/表单版本管理：

视图或者表单本身或者任何关联数据改变，都会重新生成版本号，并通知所有应用对应缓存变更并删除应用本地缓存，浏览器每请求一个页面，发现视图或者表单版本号改变了也会更新浏览器本地存储数据。

• 视图/表单规则管理：

视图和表单都可以定义自身规则，规则见上文描述。

宿主框架：

计划将自定义表单宿主到Abp Vnext框架中，Abp框架负责登录认证，用户角色管理，菜单操作权限管理等，自定义表单公开Api供使用端调用，当然，使用其他框架做为宿主也是一样的。另外，工作流引擎这块，之前是用WWF研发的一套产品，但是微软没有计划将其迁移到.net core，基本就宣告了死刑，所以之前的文章也就停止了；流程引擎这块后续是会重新编写，流程引擎+表单引擎，这块自定义表单最终的形态，不过不都是后话了，自定义表单完全可以独立存在。

前端(个人是做后端的，前端水平有限)：

　　前端的复杂程度不亚于后端，很多东西是需要配合后端一起定义的，前端+后端，才能形成一个整体。

　　前端可以是不同的架构，不同的应用，可以是浏览器，winform等，都是调用Api，这里选择的是浏览器，技术选择的是vue，框架选择的是and design for vue

• Ant Design for Vue:

使用此框架，可替换其他框架，但各个控件需要做相应的修改。

• 视图：

定义视图Layout、Item、列表、Tree等视图。

• 表单：

定义普通表单、Div表单等

• Wrap管理：

对视图或表单进行包装，包括Div、对话框、Card布局等各种包装。

• 视图/表单控件：

对前端各种控件进行二次封装，注入规则，允许触发事件和执行规则。

• 浏览器数据缓存：

比较核心的内容，自定义表单内容设计变更，需要即使的通知前端，同是自定义表单定义信息访问又必须快速，不能有明显的性能损失。IndexedDb存储视图/表单定义等信息，每次打开一个页面时，遍历所有关联的视图和表单Id和版本信息，与后端缓存数据进行比较，不同则更新本地缓存。

• 表单规则注册与执行：

前端灵魂所在，视图、表单、控件在创建的时候，都会注入规则，用户进行某个操作时，如果有对应的事件定义，则找到规则定义，进而找到一系列视图/表单/空间执行一系列规定。

• 动态表达式：

为一棵树，同后端动态表达式比较类似。

自定义功能：

自定义表单也不可能抽象出所有的数据模型，特殊的业务可编写代码，完全自定义功能实现。后端一些报表或者某些业务模块，开发人员自己写业务逻辑，通过微服务或者反射配置方法，执行具体的自定义功能。前端则可编写不同的自定义控件，并注册到Vue框架中，自定义表单在某个功能上配置自定义控件名称即可。

　　前端技术选型不要选择angular，angular的动态控件比较死板，动态控件不能动态添加指令，还有其他很多限制，基本上断了自定义表单的路了。

 

wike文档地址：
https://gitee.com/kuangqifu/sprite/wikis/pages
后端开源地址：
https://gitee.com/kuangqifu/sprite

前端开源地址：
https://gitee.com/kuangqifu/spritefronts
体验地址：
http://47.108.141.193:8031 （首次加载可能有点慢，用的阿里云最差的服务器）
自定义表单文章地址：
https://www.cnblogs.com/spritekuang/
流程引擎文章地址：
https://www.cnblogs.com/spritekuang/category/834975.html （https://www.cnblogs.com/spritekuang/p/14970992.html ）