Activiti 6研究01 - 流程文件的手动导入

本文详细介绍了如何手动导入Activiti流程定义文件的步骤,包括读取XML文件、转换为BpmnModel、建立Model、发布流程等关键操作。特别提醒,在发布时原始文件名必须以.bpmn20.xml结尾,否则可能导致发布失败。同时提供了完整的导入流程代码段,有助于读者理解和避免潜在问题。
摘要由CSDN通过智能技术生成

在某些场景下,需要进行流程定义文件的手动导入,此处分享一下我的大致流程及踩过的坑,希望对大家有所帮助。

  1. 读入文件(此处以上传文件为例)
            InputStream fileInputStream = file.getInputStream();
            XMLInputFactory xif = XMLInputFactory.newInstance();
            InputStreamReader in = new InputStreamReader(fileInputStream, "UTF-8");
            XMLStreamReader xtr = xif.createXMLStreamReader(in);
  1. 通过BpmnXMLConverter将xml内容转换为BpmnModel对象
            // 转为bpmnModel
            BpmnModel bpmnModel = new BpmnXMLConverter().convertToBpmnModel(xtr);
  1. 建立Model,通过BpmnJsonConverter将BpmnXML对象转成Json对象并保存入仓库(若不需要建立Model,此步可跳过)
            Model model = createNewModel();
            ObjectNode objectNode = new BpmnJsonConverter().convertToJson(bpmnModel);
            repositoryService.addModelEditorSource(model.getId(), objectNode.toString().getBytes("utf-8"));
    /**
     * 创建新的模型
     *
     * @return
     */
    private Model createNewModel() {
        Model model = repositoryService.newModel();
        String modelKey = String.valueOf(CommonFunc.genID());
        ObjectNode modelNode = objectMapper.createObjectNode();
        modelNode.put(ModelDataJsonConstants.MODEL_NAME, modelKey);
        modelNode.put(ModelDataJsonConstants.MODEL_REVISION, 1);
        model.setName(modelKey);
        model.setKey(modelKey);
        model.setMetaInfo(modelNode.toString());
        repositoryService.saveModel(model);

        return model;
    }

  1. 将BpmnModel发布。
    此处需特别注意:如果希望记录下原始文件名,切记以.bpmn20.xml为后缀,否则发布不成功(数据库中会发现act_re_deployment表中已有数据,对应的act_ge_bytearray表中,xml文件记录也已插入,但是act_re_procdef表中却没有数据。关键是还没有异常)。
            String srcFileName = file.getOriginalFilename();
            // 此处保存上传文件的原始文件名,但必须是以.bpmn20.xml结尾,否则无法产生流程数据且不报错。
            if (!srcFileName.endsWith(".bpmn20.xml"))
                srcFileName += ".bpmn20.xml";
            Deployment deployment = repositoryService.createDeployment()
                    .name(String.valueOf(userID))	// deployment名称,此处用于保存导入用户ID
                    .addBpmnModel(srcFileName, bpmnModel)
                    .enableDuplicateFiltering()
                    .deploy();
  1. 若做了第3步,建议将DeploymentID与Model关联保存起来
            model = repositoryService.getModel(model.getId());
            model.setDeploymentId(deployment.getId());
            repositoryService.saveModel(model);

附导入流程文件完整代码段:

    @PostMapping("/ImportProcess")
    public void ImportProcess(@RequestAttribute("UserID") long userID, MultipartFile file) {
        if (file == null) {
            logger.error("No file upload.");
            throw new GlobalRuntimeException(ErrorInfo.NO_FILE_UPLOAD);
        }

        try {
            InputStream fileInputStream = file.getInputStream();
            XMLInputFactory xif = XMLInputFactory.newInstance();
            InputStreamReader in = new InputStreamReader(fileInputStream, "UTF-8");
            XMLStreamReader xtr = xif.createXMLStreamReader(in);
            // 转为bpmnModel
            BpmnModel bpmnModel = new BpmnXMLConverter().convertToBpmnModel(xtr);

            Model model = createNewModel();
            ObjectNode objectNode = new BpmnJsonConverter().convertToJson(bpmnModel);
            repositoryService.addModelEditorSource(model.getId(), objectNode.toString().getBytes("utf-8"));

            String srcFileName = file.getOriginalFilename();
            // 此处保存上传文件的原始文件名,但必须是以.bpmn20.xml结尾,否则无法产生流程数据且不报错。
            if (!srcFileName.endsWith(".bpmn20.xml"))
                srcFileName += ".bpmn20.xml";
            Deployment deployment = repositoryService.createDeployment()
                    .name(String.valueOf(userID))           // deployment名称,此处用于保存导入用户ID
                    .addBpmnModel(srcFileName, bpmnModel)
                    .enableDuplicateFiltering()
                    .deploy();

            model = repositoryService.getModel(model.getId());
            model.setDeploymentId(deployment.getId());
            repositoryService.saveModel(model);

            ProcessDefinition define = repositoryService.createProcessDefinitionQuery()
                    .deploymentId(deployment.getId())
                    .singleResult();
            logger.debug("Import process: {} - {}, deploy id: {}", define.getId(), define.getKey(), define.getDeploymentId());
        } catch (Exception ex) {
            logger.error("Import process has exception.\n", ex);
            throw new GlobalRuntimeException(ErrorInfo.IMPORT_PROCESS);
        }
    }
  • 2
    点赞
  • 4
    收藏
    觉得还不错? 一键收藏
  • 2
    评论
1. 初识Activiti 1.1. 工作流与工作流引擎 工作流(workflow)就是工作流程的计算模型,即将工作流程中的工作如何前后组织在一起的逻辑和规则在计算机中以恰当的模型进行表示并对其实施计算。它主要解决的是“使在多个参与者之间按照某种预定义的规则传递文档、信息或任务的过程自动进行,从而实现某个预期的业务目标,或者促使此目标的实现”。(我的理解就是:将部分或者全部的工作流程、逻辑让计算机帮你来处理,实现自动化) 所谓工作流引擎是指workflow作为应用系统的一部分,并为之提供对各应用系统有决定作用的根据角色、分工和条件的不同决定信息传递路由、内容等级等核心解决方案。 例如开发一个系统最关键的部分不是系统的界面,也不是和数据库之间的信息交换,而是如何根据业务逻辑开发出符合实际需要的程序逻辑并确保其稳定性、易维护性和弹性。 比如你的系统中有一个任务流程,一般情况下这个任务的代码逻辑、流程你都要自己来编写。实现它是没有问题的。但是谁能保证逻辑编写的毫无纰漏?经过无数次的测试与改进,这个流程没有任何漏洞也是可以实现的,但是明显就会拖慢整个项目的进度。 工作流引擎解决的就是这个问题:如果应用程序缺乏强大的逻辑层,势必变得容易出错(信息的路由错误、死循环等等)。 1.2. BPMN2.0规范 BPMN(Business Process Model and Notation)--业务流程模型与符号。 BPMN是一套流程建模的标准,主要目标是被所有业务用户容易理解的符号,支持从创建流程轮廓的业务分析到这些流程的最终实现,知道最终用户的管理监控。 通俗一点其实就是一套规范,画流程模型的规范。流程模型包括:流程、协作、编排、会话。详细信息请google。 1.3. Activiti概述 1.3.1. Activiti由来 学习过Activiti的朋友都知道,Activiti的创始人也就是JBPM(也是一个优秀的BPM引擎)的创始人,从Jboss离职后开发了一个新的BPM引擎:Activiti。所以,Activiti有很多地方都有JBPM的影子。所以,据说学习过JBPM的朋友学起Activiti来非常顺手。 由于本人之前没有工作流及JBPM的相关基础,刚开始学习Activiti的时候可以说是无比痛苦的,根本不知道从何下手,这里也建议大家先进行工作流及BPMN2.0规范的学习,有了一定的基础后,再着手学习Activiti。 1.3.2. Activiti简介 Activiti是一个开源的工作流引擎,它实现了BPMN 2.0规范,可以发布设计好的流程定义,并通过api进行流程调度。 Activiti 作为一个遵从 Apache 许可的工作流和业务流程管理开源平台,其核心是基于 Java 的超快速、超稳定的 BPMN2.0 流程引擎,强调流程服务的可嵌入性和可扩展性,同时更加强调面向业务人员。 Activiti 流程引擎重点关注在系统开发的易用性和轻量性上。每一项 BPM 业务功能 Activiti 流程引擎都以服务的形式提供给开发人员。通过使用这些服务,开发人员能够构建出功能丰富、轻便且高效的 BPM 应用程序。 1.4. 文档说明 以上部分对工作流、BPMN、Activiti的概念做了一个简单的介绍,目的是了解Activiti究竟是什么,能做些什么…及在学习Activiti之前需要了解的知识与技术。其中大部分文字来自Copy网上的各种资料与文档,通过总结而来的。具体的更详细的内容需自己google,参考一些官方的文档与手册。 本文档之后内容如下: 1) 下载与使用 2) 核心组件与说明 3) 入门示例 4) Eclipse中的Activiti插件的使用 本文档旨在为初学Activiti的朋友提供入门级别的参考,不会对其原理及其结构进行深层次的探究(更多是因为目前自身理解还不是很透彻),只是为大家理清思路,方便以后更深层次的学习。本文档还有一个重要的特点,那就是根据自己看官方手册的经验,教大家如何看手册从而更有效率!由于是初学,很多术语或解释难免理解有偏差,所以一定要看官方提供的文档与手册,那才是学习的最佳途径! 2. 开始学习 2.1. 必要的准备 2.1.1. 下载与了解目录 下载Activiti:下载路径,也就是官方网站的地址:http://activiti.org/download.html。下载后解压(我所使用的是5.12版本的,Activiti更新速度飞快,几乎每两个月就会有一个更新的小版本),看到如下目录: 1) database:里面存放的是Activiti使用到的数据库信息的sql文件,它支持的数据库类型如下,使用时只需执行你自己的数据库类型
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值