iassignable.java

Fire-Workflow-Engine-All-In-One-20090208 包含全部文档

/**
 * Copyright 2007-2008 非也
 * All rights reserved. 
 * 
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation。
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program. If not, see http://www.gnu.org/licenses. *
 */
package org.fireflow.engine.ou;

import java.util.List;
import org.fireflow.engine.EngineException;
import org.fireflow.kenel.KenelException;

/**
 * TaskInstance实现了该节口，用于任务分配
 * @author 非也,[e-mail]
 */
public interface IAssignable {
    /**
     * 将TaskInstance分配给编号为actorId的操作员。即系统只创建一个WorkItem，并分配给编号为actorId的操作员
     * @param actorId 操作员Id
     * @param needSign 是否需要签收，true表示需要操作员执行签收动作,系统将WorkItem设置为INITIALIZED状态；false不需要签收，Workitem直接被设置为STARTED状态。
     * @throws org.fireflow.engine.EngineException
     * @throws org.fireflow.kenel.KenelException
     */
    public void asignToActor(String actorId, boolean needSign) throws EngineException, KenelException;

    /**
     * 将TaskInstance分配给编号为actorId的操作员。即系统只创建一个WorkItem，并分配给编号为actorId的操作员<br>
     * 该WorkItem需要签收
     * @param actorId 操作员Id
     * @throws org.fireflow.engine.EngineException
     * @throws org.fireflow.kenel.KenelException
     */
    public void asignToActor(String actorId) throws EngineException, KenelException;

    /**
     * 将TaskInstance分配给列表中的操作员。即创建N个WorkItem，每个操作员一个WorkItem，并且这些WorkItem都需要签收。<br>
     * 最终由那个操作员执行该任务实例，是由Task的分配策略决定的。<br>
     * 如果分配策略为ALL,即会签的情况，则所有的操作员都要完成相应的工单。<br>
     * 如果分配策略为ANY，则最先签收的那个操作员完成其工单和任务实例，其他操作员的工单被删除。
     * @param actorIds
     * @throws org.fireflow.engine.EngineException
     * @throws org.fireflow.kenel.KenelException
     */
    public void asignToActors(List<String> actorIds) throws EngineException, KenelException;
}