开源工作流Fireflow源码分析之运行流程一

Netinstance.java

/* 运行流程
     * @see org.fireflow.kernel.INetInstance#run(org.fireflow.engine.IProcessInstance)
     */
    public void run(IProcessInstance processInstance) throws KernelException {
        if (startNodeInstance == null) {
            KernelException exception = new KernelException(processInstance,
                    this.getWorkflowProcess(),
                    "Error:NetInstance is illegal ，the startNodeInstance can NOT be NULL ");
            throw exception;
        }
         
        //实例化一个token
        Token token = new Token();
        //设置token的状态活动的
        token.setAlive(true); 
        //设置流程实例
        token.setProcessInstance(processInstance); 
        //设置token容量
        token.setValue(startNodeInstance.getVolume()); 
        //设置步骤号，开始节点的第一步默认为0
        token.setStepNumber(0); 
        //设置从哪个节点来 "FROM_START_NODE" 规定的节点。
        token.setFromActivityId(IToken.FROM_START_NODE); 
        //启动开始节点
        startNodeInstance.fire(token); 
}

 StartNodeInstance.java

/*
     * 开始节点触发
     * @see org.fireflow.kernel.INodeInstance#fire(org.fireflow.kernel.IToken)
     */
    public void fire(IToken tk) throws KernelException {
    	//如果token不是活动，那么直接返回,注意这个应该是不必要的，因为永远不可能是不是活动的
        if (!tk.isAlive()) {
            return;//
        }
        //检查当前token容易是不是与开始节点一致.这个是否有必要？？？？
        if (tk.getValue() != volume) {
            KernelException exception = new KernelException(tk.getProcessInstance(),
                    this.startNode,
                    "Error:Illegal StartNodeInstance,the tokenValue MUST be equal to the volume ");
            throw exception;

        }
        //在token中设置当前的节点ID
        tk.setNodeId(this.getSynchronizer().getId());
        ////从token中获得流程实例对象
        IProcessInstance processInstance = tk.getProcessInstance();

        //触发enter事件
        NodeInstanceEvent event1 = new NodeInstanceEvent(this);
        event1.setToken(tk);
        event1.setEventType(NodeInstanceEvent.NODEINSTANCE_TOKEN_ENTERED); //token进入
        fireNodeEvent(event1);

        //触发fired事件
        NodeInstanceEvent event2 = new NodeInstanceEvent(this);
        event2.setToken(tk);
        event2.setEventType(NodeInstanceEvent.NODEINSTANCE_FIRED);//token 触发
        fireNodeEvent(event2);

        //触发leaving事件
        NodeInstanceEvent event4 = new NodeInstanceEvent(this);
        event4.setToken(tk);
        event4.setEventType(NodeInstanceEvent.NODEINSTANCE_LEAVING); //token 离开
        fireNodeEvent(event4);

        //激活默认弧线的标志
        boolean activateDefaultCondition = true;
        ITransitionInstance defaultTransInst = null;
        //找到所有开始节点的输出弧 
        for (int i = 0; leavingTransitionInstances != null && i < leavingTransitionInstances.size(); i++) {
        	//开始节点的边的类型只能是transition
            ITransitionInstance transInst = leavingTransitionInstances.get(i); 
            String condition = transInst.getTransition().getCondition();
            //如果弧线的条件！=null 并且 =“default” ，那么弧线实例就是default的弧线了。
            if (condition != null && condition.equals(ConditionConstant.DEFAULT)) {
            	////记录default转移线，其他条件都未false，才执行它
                defaultTransInst = transInst;
                continue;
            }
            //产生新的token
            Token token = new Token();
            //设置状态为alive
            token.setAlive(true);
            //设置流程实例
            token.setProcessInstance(processInstance);
            //设置token的from节点ID
            token.setFromActivityId(tk.getFromActivityId());
            //步骤号+1
            token.setStepNumber(tk.getStepNumber()+1);
            //触发弧线的token,开源工作流Fireflow源码分析之运行流程二中有更详细的说明
            boolean alive = transInst.take(token);
            //如果有一个有触发，就不走default
            if (alive) {
                activateDefaultCondition = false;
            }

        }
        //如果defaultTransInst!=null ，走的是default值的弧线 
        if (defaultTransInst != null) {
        	 //产生新的token
            Token token = new Token();
            //设置alive状态
            token.setAlive(activateDefaultCondition);
            //设置流程实例
            token.setProcessInstance(processInstance);
            //设置token的from节点ID
            token.setFromActivityId(token.getFromActivityId());
            //步骤号+1
            token.setStepNumber(tk.getStepNumber()+1);
            //触发弧线的token
            defaultTransInst.take(token);
        }
        //触发completed事件
        NodeInstanceEvent event3 = new NodeInstanceEvent(this);
        event3.setToken(tk);
        event3.setEventType(NodeInstanceEvent.NODEINSTANCE_COMPLETED);
        fireNodeEvent(event3);
    }