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
    }
   
}