/**
 * BladeX Commercial License Agreement
 * Copyright (c) 2018-2099, https://bladex.cn. All rights reserved.
 * <p>
 * Use of this software is governed by the Commercial License Agreement
 * obtained after purchasing a license from BladeX.
 * <p>
 * 1. This software is for development use only under a valid license
 * from BladeX.
 * <p>
 * 2. Redistribution of this software's source code to any third party
 * without a commercial license is strictly prohibited.
 * <p>
 * 3. Licensees may copyright their own code but cannot use segments
 * from this software for such purposes. Copyright of this software
 * remains with BladeX.
 * <p>
 * Using this software signifies agreement to this License, and the software
 * must not be used for illegal purposes.
 * <p>
 * THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY. The author is
 * not liable for any claims arising from secondary or illegal development.
 * <p>
 * Author: Chill Zhuang (bladejava@qq.com)
 */
package org.springblade.file.service;

import com.baomidou.mybatisplus.extension.service.IService;
import org.springblade.file.pojo.dto.FileTaskCreateDTO;
import org.springblade.file.pojo.dto.FileTaskUpdateDTO;
import org.springblade.file.pojo.entity.FileTask;
import org.springblade.file.pojo.vo.FileTaskUpdateVO;

import java.util.List;

/**
 * 服务类
 *
 * @author zhaowei
 */
public interface IFileTaskService extends IService<FileTask> {

    /**
     * 根据文件md5值查询最新一条上传任务记录
     *
     * @param id
     * @param md5
     * @return
     */
    FileTaskUpdateVO queryFileTask(Long id, String md5);

    /**
     *  创建文件任务
     * @param param
     * @return
     */
    Long createFileTask(FileTaskCreateDTO param);

    /**
     *  更新文件任务进度
     * @param param
     * @return
     */
    FileTaskUpdateVO updateFileTask(FileTaskUpdateDTO param);

    /**
     * 根据文件任务id获取上传链接
     *
     * @param id
     * @param partNumber
     * @return
     */
    String getUploadUrl(Long id, Integer partNumber);

    /**
     *  取消文件任务
     * @param taskIds
     */
    void cancelBatchByIds(List<Long> taskIds);

    /**
     *  更新文件任务状态为失败
     * @param id
     * @return
     */
    FileTaskUpdateVO updateFailed(Long id);

    /**
     *  根据id列表更新文件任务状态为暂停
     * @param param
     * @return
     */
    boolean updatePaused(List<Long> param);
}
