package com.cm.common.plugin.dao.file;

import com.cm.common.exception.RemoveException;
import com.cm.common.exception.SaveException;
import com.cm.common.exception.SearchException;
import com.cm.common.plugin.pojo.dtos.file.FileInfoDTO;
import com.cm.common.plugin.pojo.dtos.file.FileInfoWithPathDTO;
import com.cm.common.pojo.dtos.FileDTO;
import com.cm.common.pojo.pos.FilePO;
import org.springframework.stereotype.Repository;

import java.util.List;
import java.util.Map;

/**
 * @ClassName: IFileDao
 * @Description: 文件
 * @Author: wenc
 * @Date: 2019/1/3 4:36 PM
 * @Version: 1.0
 **/
@Repository
public interface IFileDao {

    /**
     * 保存文件
     *
     * @param params
     * @throws SaveException
     */
    void saveFile(Map<String, Object> params) throws SaveException;

    /**
     * 删除文件
     *
     * @param params
     * @throws RemoveException
     */
    void removeFile(Map<String, Object> params) throws RemoveException;

    /**
     * 删除文件(物理删除)
     *
     * @param params
     * @throws RemoveException
     */
    void deleteFile(Map<String, Object> params) throws RemoveException;

    /**
     * 更新文件描述
     *
     * @param fileParams
     * @throws SearchException
     */
    void updateFileSummary(Map<String, Object> fileParams) throws SearchException;

    /**
     * 获取文件详情
     *
     * @param params
     * @return
     * @throws SearchException
     */
    FilePO getFile(Map<String, Object> params) throws SearchException;

    /**
     * 获取文件列表
     *
     * @param params
     * @return
     * @throws SearchException
     */
    List<FileDTO> listFile(Map<String, Object> params) throws SearchException;

    /**
     * 获取文件列表
     *
     * @param params
     * @return
     * @throws SearchException
     */
    List<FileInfoDTO> listFileInfo(Map<String, Object> params) throws SearchException;

    /**
     * 获取文件列表(带路径)
     *
     * @return
     * @throws SearchException
     */
    List<FileInfoWithPathDTO> listFileInfoWithPath(Map<String, Object> params) throws SearchException;

    /**
     * 文件列表
     *
     * @param fileMd5 文件MD5值
     * @return
     * @throws SearchException
     */
    List<FileInfoDTO> listFileByMd5(String fileMd5) throws SearchException;


}
