Activiti Model Editor

简介:

Activiti Model Editor组件

我的 了解Activiti Explorer及其Vaadin实现方式博文里提到Activiti Explorer使用的是Vaadin架构,但是Activiti  模型编辑器组件却没用使用Vaadin架构,而是采用Angular.JS的MVC模式。Activiti 模型编辑器组件的客户端代码位于Activiti\modules\activiti-webapp-explorer2\src\main\webapp\editor-app\。

该目录下的editor.html是Activiti Modeler Editor的主界面HTML代码
粗览Activiti <wbr>Modeler操作和源代码
其中palette区是通过Angular.JS使用stencilsets\bpmn2.0\icons下多个子目录内的PNG图像形成的多组列表。其节点层次关系获取相关代码为:
  1. stencil-controller.js
  2. Activiti\modules\activiti-modeler\src\main\java\org\activiti\rest\editor\main\StencilsetRestResource.java
  3. Activiti\modules\activiti-webapp-explorer2\src\main\resources\stencilset.json
粗览Activiti <wbr>Modeler操作和源代码
editor.html中的视图与两个控制器进行了绑定:
  • stencil-controller.js:处理对canvas中BPMN元素的操作,很多处理是通过editor目录下的QRYX库完成的
  • toolbar-controller.js:处理对工具栏的操作,很多处理由configuration\toolbar-default-actions.js完成

保存模型操作

保存模型操作,是通过toolbar-default-actions.js中的SaveModel方法完成的,它需要将三部分信息传给服务器:
  • 模型的元数据:例如模型名称、分类、创建时间、最后一次更新时间等等
  • 模型JSON数据:将canvas内的图像数据转换成JSON数据UTF8字符串
    {
     "resourceId": 53,
     "properties": {
      "process_id": "process",
      "name": "",
      "documentation": "",
      "process_author": "",
      "process_version": "",
      "process_namespace": "http://www.activiti.org/processdef",
      "executionlisteners": "",
      "eventlisteners": ""
     },
     "stencil": {
      "id": "BPMNDiagram"
     },
     "childShapes": [
      {
       "resourceId": "sid-4F7484B9-11EC-4FCE-8950-FEFFB723D88B",
       "properties": {
        "overrideid": "",
        "name": "",
        "documentation": "",
        "executionlisteners": "",
        "initiator": "",
        "formkeydefinition": "",
        "formproperties": ""
       },
       "stencil": {
        "id": "StartNoneEvent"
       },
       "childShapes": [],
       "outgoing": [
        {
         "resourceId": "sid-B589A0D9-FA79-4C12-95B7-253E72480384"
        }
       ],
       "bounds": {
        "lowerRight": {
         "x": 259,
         "y": 139
        },
        "upperLeft": {
         "x": 229,
         "y": 109
        }
       },
       "dockers": []
      },
      {
       "resourceId": "sid-1A762474-62B9-4F3D-A81C-1ADD46AF7D2F",
       "properties": {
        "overrideid": "",
        "name": "",
        "documentation": "",
        "asynchronousdefinition": "false",
        "exclusivedefinition": "false",
        "executionlisteners": "",
        "multiinstance_type": "None",
        "multiinstance_cardinality": "",
        "multiinstance_collection": "",
        "multiinstance_variable": "",
        "multiinstance_condition": "",
        "isforcompensation": "false",
        "usertaskassignment": "",
        "formkeydefinition": "",
        "duedatedefinition": "",
        "prioritydefinition": "",
        "formproperties": "",
        "tasklisteners": ""
       },
       "stencil": {
        "id": "UserTask"
       },
       "childShapes": [],
       "outgoing": [
        {
         "resourceId": "sid-4134C10E-B589-42FF-AACC-463D35D52016"
        }
       ],
       "bounds": {
        "lowerRight": {
         "x": 746,
         "y": 172
        },
        "upperLeft": {
         "x": 646,
         "y": 92
        }
       },
       "dockers": []
      },
      {
       "resourceId": "sid-B22A5CAB-94D0-419E-BB1E-E8538C6A7283",
       "properties": {
        "overrideid": "",
        "name": "",
        "documentation": "",
        "executionlisteners": ""
       },
       "stencil": {
        "id": "EndNoneEvent"
       },
       "childShapes": [],
       "outgoing": [],
       "bounds": {
        "lowerRight": {
         "x": 1089,
         "y": 138
        },
        "upperLeft": {
         "x": 1061,
         "y": 110
        }
       },
       "dockers": []
      },
      {
       "resourceId": "sid-B589A0D9-FA79-4C12-95B7-253E72480384",
       "properties": {
        "overrideid": "",
        "name": "",
        "documentation": "",
        "conditionsequenceflow": "",
        "executionlisteners": "",
        "defaultflow": "false"
       },
       "stencil": {
        "id": "SequenceFlow"
       },
       "childShapes": [],
       "outgoing": [
        {
         "resourceId": "sid-1A762474-62B9-4F3D-A81C-1ADD46AF7D2F"
        }
       ],
       "bounds": {
        "lowerRight": {
         "x": 645.5626565925471,
         "y": 131.10730365650525
        },
        "upperLeft": {
         "x": 259.12484340745283,
         "y": 124.26769634349473
        }
       },
       "dockers": [
        {
         "x": 15,
         "y": 15
        },
        {
         "x": 50,
         "y": 40
        }
       ],
       "target": {
        "resourceId": "sid-1A762474-62B9-4F3D-A81C-1ADD46AF7D2F"
       }
      },
      {
       "resourceId": "sid-4134C10E-B589-42FF-AACC-463D35D52016",
       "properties": {
        "overrideid": "",
        "name": "",
        "documentation": "",
        "conditionsequenceflow": "",
        "executionlisteners": "",
        "defaultflow": "false"
       },
       "stencil": {
        "id": "SequenceFlow"
       },
       "childShapes": [],
       "outgoing": [
        {
         "resourceId": "sid-B22A5CAB-94D0-419E-BB1E-E8538C6A7283"
        }
       ],
       "bounds": {
        "lowerRight": {
         "x": 1060.676003953202,
         "y": 130.93202152143962
        },
        "upperLeft": {
         "x": 746.595480421798,
         "y": 124.30235347856038
        }
       },
       "dockers": [
        {
         "x": 50,
         "y": 40
        },
        {
         "x": 14,
         "y": 14
        }
       ],
       "target": {
        "resourceId": "sid-B22A5CAB-94D0-419E-BB1E-E8538C6A7283"
       }
      }
     ],
     "bounds": {
      "lowerRight": {
       "x": 1200,
       "y": 1050
      },
      "upperLeft": {
       "x": 0,
       "y": 0
      }
     },
     "stencilset": {
      "url": "stencilsets/bpmn2.0/bpmn2.0.json",
      "namespace": "http://b3mn.org/stencilset/bpmn2.0#"
     },
     "ssextensions": []
    }
  • 模型的SVG图像数据:将canvas中的SVG图像数据经过过滤处理而得
服务器侧保存模型的代码位于Activiti\modules\activiti-modeler\src\main\java\org\activiti\rest\editor\model\ModelSaveRestResource.java。
  • 通过RepositoryService的saveModel方法将模型的元数据存入数据库的ACT_RE_MODEL表
  • 通过RepositoryService的addModelEditorSource方法将模型JSON数据UTF8字符串存入数据库的ACT_GE_BYTEARRAY表
  • 通过Apache™ Batik SVG Toolkit将模型的SVG图像数据转换成PNG格式,通过RepositoryService的addModelEditorSourceExtra方法将PNG图像存入数据库的ACT_GE_BYTEARRAY表

Activiti Explorer操作已保存模型

对模型的编辑操作是在Activiti Model Editor组件里实现的,对已保存模型的其他操作还是在Activiti Explorer里基于Vaadin架构实现的。
客户端代码位于:Activiti\modules\activiti-explorer\src\main\java\org\activiti\editor\ui\。
下图的HTML界面由EditorProcessDefinitionD etailPanel.java实现。  粗览Activiti <wbr>Modeler操作和源代码

显示已保存模型


  1. 选择模型,会调用EditorProcessDefinitionPage类的showProcessDefinitionDetail方法
  2. EditorProcessDefinitionDetailPanel类的initUI方法调用initProcessDefinitionInfo方法,它会加入EditorProcessDefinitionInfoComponent实例
  3. 在构造EditorProcessDefinitionInfoComponent实例时,其initImage方法会被调用,通过RepositoryService的getModelEditorSourceExtra方法获得PNG格式图像,最终被显示到浏览器界面上。

部署已保存模型


EditorProcessDefinitionD etailPanel类的deployModel方法处理部署已保存模型的操作。
  1. 通过RepositoryService的getModelEditorSource方法获得模型JSON数据的UTF8字符串
  2. 通过FasterXML/jackson-databind转换成Java对象树
  3. 通过Activiti\modules\activiti-json-converter\src\main\java\org\activiti\editor\language\json\converter\BpmnJsonConverter.java将模型JSON数据的Java对象树转换成BpmnModel实例
  4. 通过Activiti\modules\activiti-bpmn-converter\src\main\java\org\activiti\bpmn\converter\BpmnXMLConverter.java 将BpmnModel实例转成BPMN XML数据
  5. 通过RepositoryService的createDeployment方法将BPMN XML数据进行部署

导出已保存模型


EditorProcessDefinitionD etailPanel类的exportModel方法处理导出已保存模型的操作。
  1. 通过RepositoryService的getModelEditorSource方法获得模型数据的JSON字符串
  2. 通过FasterXML/jackson-databind转换成Java对象树
  3. 通过Activiti\modules\activiti-json-converter\src\main\java\org\activiti\editor\language\json\converter\BpmnJsonConverter.java将模型JSON数据的Java对象树转换成BpmnModel实例
  4. 通过Activiti\modules\activiti-bpmn-converter\src\main\java\org\activiti\bpmn\converter\BpmnXMLConverter.java 将BpmnModel实例转成BPMN XML数据

编辑已保存模型


EditorProcessDefinitionD etailPanel类内注册了EditModelClickListener监听器用于处理导入BPMN模型操作。
EditModelClickListener的showModeler会生成访问模型编辑器组件的URL地址,打开指定的模型。
  1. Activiti\modules\activiti-webapp-explorer2\src\main\webapp\editor-app\app.js中的监听器处理$includeContentLoaded事件,调用了fetchModel方法
  2. Activiti\modules\activiti-modeler\src\main\java\org\activiti\rest\editor\model\ModelEditorJsonRestResource.java处理该REST请求,返回由RepositoryService的getModel和getModelEditorSource方法获得Activiti模型元数据和JSON数据

导入BPMN模型


EditorProcessDefinitionD etailPanel类内注册了ImportModelClickListener 监听器用于处理导入BPMN模型操作。
ImportPopupWindow界面完成BPMN模型操作后,ImportUploadReceiver类的deployUploadedFile方法处理上传的BPMN XML数据。
  1. 通过Activiti\modules\activiti-bpmn-converter\src\main\java\org\activiti\bpmn\converter\BpmnXMLConverter.java 将BPMN XML数据转换成BpmnModel实例
  2. 通过BpmnModel实例生成模型的元数据,通过RepositoryService的saveModel方法将模型的元数据存入数据库的ACT_RE_MODEL表
  3. 通过Activiti\modules\activiti-json-converter\src\main\java\org\activiti\editor\language\json\converter\BpmnJsonConverter.java将BpmnModel实例转换成模型JSON数据的Java对象树,通过RepositoryService的addModelEditorSource方法将模型JSON数据UTF8字符串存入数据库的ACT_GE_BYTEARRAY表



一些疑惑和想法:
  • 这里BpmnXMLConverter和BpmnJsonConverter用的比较频繁,而且成对出现。为什么不跳过中间的BpmnModel?
  • 导入BPMN模型为什么不生成PNG图像?
  • 数据库存储的模型数据不采用BPMN XML格式而是采用JSON格式,很灵活,可以随意添加Activiti扩展内容。但是如果没有现成的JSON schema,分析起来够麻烦。
目录
相关文章
|
人机交互 图形学
Implementation Model Editor of AVEVA in OpenSceneGraph
Implementation Model Editor of AVEVA in OpenSceneGraph eryar@163.com 摘要Abstract:本文主要对工厂和海工设计软件AVEVA的交互方式进行详细介绍,对OpenSceneGraph中的人机交互工具拖拽器进行说明,并在其中实现了模型直接交互操作。
1681 0
|
7月前
|
存储 Linux 编译器
vim编辑器和gcc/g++编辑器的使用讲解
vim编辑器和gcc/g++编辑器的使用讲解
164 2
|
7月前
|
Linux 编译器 开发工具
Linux:详解(yum的使用、vim编辑器命令集合以及gcc/g++编译器的使用)
Linux:详解(yum的使用、vim编辑器命令集合以及gcc/g++编译器的使用)
197 1
|
7月前
|
Linux Shell 开发工具
【linux】Linux编辑器-vim
【linux】Linux编辑器-vim
111 0
|
5月前
|
开发工具
vi编辑器,现在vi\vim是文本文件进行编辑的最佳选择,Vim是vi的加强的版本,兼容vi的所有指令,vim编辑器有三种工作模式,一开始进入的是命令模式,命令模式i是插入的意思,两下y+p复制内容
vi编辑器,现在vi\vim是文本文件进行编辑的最佳选择,Vim是vi的加强的版本,兼容vi的所有指令,vim编辑器有三种工作模式,一开始进入的是命令模式,命令模式i是插入的意思,两下y+p复制内容
|
6月前
|
开发工具
Vim 编辑器:高效文本编辑的瑞士军刀
**Vim 概览:** Vim 是一个功能丰富的文本编辑器,以其高度可定制性著称。文章介绍了 Vim 的高效使用技巧,包括快捷打开文件、命令行模式下的常用命令、查找与替换、删除和复制文本。还讨论了配置 `.vimrc` 文件以自定义设置,如改变 leader 键、设置缩进和高亮,并展示了安装插件如 vim-airline 和 vim-snazzy 的方法。通过这些技巧,用户能提升 Vim 使用效率。
78 5
|
6月前
|
Ubuntu 搜索推荐 Linux
Linux的Vim编辑器详解
Linux的Vim编辑器详解
|
5月前
|
Linux 开发工具 数据安全/隐私保护
【linux】如何优雅的使用vim编辑器
【linux】如何优雅的使用vim编辑器
|
6月前
|
缓存 人工智能 Linux
【Linux】--- 详解Linux软件包管理器yum和编辑器vim
【Linux】--- 详解Linux软件包管理器yum和编辑器vim
103 0
|
6月前
|
程序员 Linux 开发工具
Vi和Vim编辑器
Vi和Vim编辑器