package cn.iocoder.yudao.module.mes.service.pro.bagcode;

import cn.iocoder.yudao.module.mes.dal.dataobject.pro.bagcode.MesProBagCodeGenerateTaskDO;

/**
 * 袋码批量生成任务 Service
 * <p>
 * 只承担超出同步阈值的生成请求：小批量仍在请求线程内同步完成，不进任务、不排队。
 */
public interface MesProBagCodeGenerateTaskService {

    /**
     * 提交后台生成任务
     *
     * @param spec      生成参数
     * @param requestId 幂等键，可为空；非空时同一键只会创建一个任务
     * @return 已创建或已存在的任务
     */
    MesProBagCodeGenerateTaskDO submit(MesProBagCodeGenerateSpec spec, String requestId);

    /**
     * 获得生成任务
     *
     * @param id 任务编号
     * @return 任务；不存在时抛业务异常
     */
    MesProBagCodeGenerateTaskDO getTask(Long id);

    /**
     * 按幂等键获得生成任务
     *
     * @param requestId 幂等键
     * @return 任务；不存在时返回 null
     */
    MesProBagCodeGenerateTaskDO getTaskByRequestId(String requestId);

    /**
     * 取消生成任务
     * <p>
     * 任务正在本进程执行时置位取消标记，由执行线程停止并清理部分数据；
     * 已处于终态的任务不允许取消。
     *
     * @param id 任务编号
     */
    void cancel(Long id);

    /**
     * 回收因服务重启或异常中断而残留在非终态的任务
     *
     * @return 回收的任务数
     */
    int recycleStaleTasks();

}