Liferay7 BPM门户开发之23: 了解内置工作流（Kaleo Workflow）

梦里梦外; 2022-03-30 06:24 133阅读 0赞

Liferay内置的工作流是企业版的功能，虽然简单粗糙，但依然不支持社区版。  
既然要用更强大的Activiti来替代它，那就非常有必要学习一下内置工作流的一些思想，以便借鉴。

它的特点：

*  实体的工作流操作可以通过service layer进行集成；
 *  需要添加4个额外的字段来跟踪流程状态；
 *  通过Service Builder来建立字段，然后更新service layer；
 *  视图层UI可以显示实体的工作流状态。

##  ##

## 实体集成逻辑 ##

比如，发布一个实体类的工作流支持，首先添加注解：

@Component(
    property = {
        "model.class.name=com.my.app.package.model.FooEntity"},
    service = WorkflowHandler.class
    )

开发XXXWorkflowHandler，实现Override 三个方法

package com.liferay.docs.foo.workflow;
    
    ...
    public class FooEntityWorkflowHandler extends BaseWorkflowHandler {
    
        public static final String CLASS_NAME = FooEntity.class.getName();
    
        @Override
        public String getClassName() {
    
            return CLASS_NAME;
        }
    
        @Override
        public String getType(Locale locale) {
            return LanguageUtil.get(locale,  "model.resource" + CLASS_NAME);
        }
    
        @Override
        public Object updateStatus(int status,
                Map<String, Serializable> workflowContext) throws PortalException,
                SystemException {
    
                long userId = GetterUtil.getLong(
                    (String)workflowContext.get(WorkflowConstants.CONTEXT_USER_ID));
                long fooEntityId = GetterUtil.getLong(
                    (String)workflowContext.get(
                        WorkflowConstants.CONTEXT_ENTRY_CLASS_PK));
    
                ServiceContext serviceContext = (ServiceContext)workflowContext.get(
                    "serviceContext");
    
                return FooEntityLocalServiceUtil.updateStatus(
                    userId, fooEntityId, status, serviceContext);
    
        }
    }

为了记录实体的当前流程状态，必须要有以下4个字段（通过Service Builder）  
service.xml中添加：

比如在更新实体时，自动通过这4个字段，把实体和流程状态相关联：

fooEntity.setStatus(status);
    fooEntity.setStatusByUserId(user.getUserId());
    fooEntity.setStatusByUserName(user.getFullName());
    fooEntity.setStatusDate(serviceContext.getModifiedDate(now));
    
    fooEntityPersistence.update(fooEntity);

启动一个和实体关联的流程：

WorkflowHandlerRegistryUtil.startWorkflowInstance(fooEntity.getCompanyId(),
    fooEntity.getGroupId(), fooEntity.getUserId(), FooEntity.class.getName(),
    fooEntity.getPrimaryKey(), fooEntity, serviceContext);

如果实体属于Assets，那在为实体设置工作流字段后，就可以添加任何附加的逻辑方法。  
例如，如果想根据其工作流状态来设置可见性（未审批就不显示）：

if (status == WorkflowConstants.STATUS_APPROVED) {
    　　assetEntryLocalService.updateEntry(
    　　　　FooEntity.class.getName(), fooEntityId, fooEntity.getDisplayDate(),
    　　　　null, true, true);
    }
    else {
    　　assetEntryLocalService.updateVisible(
    　　　　fooEntity.class.getName(), entryId, false);
    }

为了在视图中展示，需要设置finder （service.xml）

实现一个Getter：

public List<FooEntity> getFooEntities(long groupId, int status)
    throws SystemException {
    return fooEntityPersistence.findByG_S(groupId,
    WorkflowConstants.STATUS_APPROVED);
    }
    
    jsp UI：
    
    <liferay-ui:search-container-results
    results="<%=FooEntityLocalServiceUtil.getFooEntities(scopeGroupId,
    fooEntityId(), Workflowconstants.STATUS_APPROVED, searchContainer.getStart(),
    searchContainer.getEnd())%>"
    ...

## 流程设计器 ##

这个属于企业版功能，有点弱

![41852-20161110161731733-1201642867.png][]

这个有点意思：  
设置启动任务的签收者，

![41852-20161110161749014-772108047.png][]

一共有6种类型：

*  创建者
 *  某角色
 *  角色ID
 *  通过一个代码段来指定
 *  特定的用户
 *  通过资源

在Kaleo中，只有这6种节点，这实在可怜，恐怕要实现复杂的流程将依靠编写大量的代码来实现。

现在知道为啥Kaleo叫workflow而不是叫BPM了吧，因为其不能实现业务流程集成，但实现仅简单顺序流程，还是没有问题的。

*  Condition: 通过脚本来实现条件逻辑（script包含几种语言：Beanshell、Drl、Groovy、JavaScript、Python、Ruby），这有点不太友好和方便；
 *  Fork: 并行处理
 *  Join: Fork并行后的汇总，这个可以实现会签，比如说一个节点由领导A、领导B同时审核才能结束，往下走；
 *  Join XOR: 异或逻辑的汇总，通俗的说就是实现抢签，有点像Activiti的候选组的概念，比如说一个节点由领导A、领导B审核，随便一个领导先审核了，节点就结束，往下走；
 *  State: 状态节点，比如开始、结束就是属于这个类型；
 *  Task: 任务节点，比如审批、填写表单....

![41852-20161110161837827-1226788147.png][]

一个XML的描述文件：

![41852-20161110161910077-1919511319.png][]

[41852-20161110161731733-1201642867.png]: /images/20220330/a9a4109d6feb4364825716e286bb6149.png
[41852-20161110161749014-772108047.png]: /images/20220330/2e10d48a7cba4da5a797bac428deb111.png
[41852-20161110161837827-1226788147.png]: /images/20220330/5d07dc75c377490db726912cbd4b1cb2.png
[41852-20161110161910077-1919511319.png]: /images/20220330/8709061a7cde48288216365c39ffaa39.png