package org.fh.controller.act;

import java.util.Map;

import org.springframework.beans.factory.annotation.Autowired;

import org.fh.controller.base.BaseController;
import org.flowable.common.engine.impl.identity.Authentication;
import org.flowable.engine.RuntimeService;
import org.flowable.engine.runtime.ProcessInstance;

/**
 * 说明：启动流程用
 * 作者：FH Admin
 * from：fhadmin.cn
 */
public class AcStartController extends BaseController {
    
    @Autowired
    private RuntimeService runtimeService;         //与正在执行的流程实体和执行物件相关的Service(执行管理，包括启动、推进、洗掉流程实体等操作)
    
    /**通过KEY启动流程实体(不带变量)
     * @param processInstanceKey //流程定义的KEY
     * @return 回传流程实体ID
     */
    protected String startProcessInstanceByKey(String processInstanceKey){
        ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(processInstanceKey);            //用流程定义的KEY启动，会自动选择KEY相同的流程定义中最新版本的那个(KEY为模型中的流程唯一标识)
        return processInstance.getId();    //回传流程实体ID
    }
    
    /**通过KEY启动流程实体(带变量)
     * @param processInstanceKey 流程定义的KEY
     * @param map 存流程变量
     * @param USERNAME 流程发起人
     * @return 回传流程实体ID
     */
    protected String startProcessInstanceByKeyHasVariables(String processInstanceKey,Map<String,Object> map, String USERNAME){
        Authentication.setAuthenticatedUserId(USERNAME);//设定流程发起人
        ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(processInstanceKey, map);    //map存盘变量 用流程定义的KEY启动，会自动选择KEY相同的流程定义中最新版本的那个(KEY为模型中的流程唯一标识)
        Authentication.setAuthenticatedUserId(null);//这个方法最终使用一个ThreadLocal型别的变量进行存盘，也就是与当前的执行绪系结，所以流程实体启动完毕之后，需要设定为null，防止多执行绪的时候出问题，
        return processInstance.getId();    //回传流程实体ID
    }
    
    /**通过ID启动流程实体
     * @param processInstanceId //流程定义的ID
     * @return 回传流程实体ID
     */
    protected String startProcessInstanceById(String processInstanceId){
        ProcessInstance processInstance = runtimeService.startProcessInstanceById(processInstanceId);            //用流程定义的ID启动
        return processInstance.getId();    //回传流程实体ID
    }
   
}