package cn.iocoder.yudao.module.system.service.storage;

import cn.iocoder.yudao.module.system.controller.admin.storage.vo.SystemStorageAttachmentListReqVO;
import cn.iocoder.yudao.module.system.controller.admin.storage.vo.SystemStorageAttachmentSaveReqVO;
import cn.iocoder.yudao.module.system.controller.admin.storage.vo.SystemStorageBlobRespVO;

import java.util.List;

/**
 * 文件关联表 Service 接口
 *
 * @author 芋道源码
 */
public interface SystemStorageAttachmentService {

    /**
     * 保存附件关联信息
     */
    void bindAttachments(SystemStorageAttachmentSaveReqVO reqVO);

    /**
     * 查询附件列表
     *
     * @param reqVO 查询条件
     * @return 文件列表（含预览/下载地址）
     */
    List<SystemStorageBlobRespVO> listAttachments(SystemStorageAttachmentListReqVO reqVO);

    /**
     * 批量删除附件
     *
     * @param ids 附件ID列表
     */
    void deleteAttachments(List<Long> ids);

    /**
     * 删除指定用途、指定业务记录下的附件关系
     */
    void deleteAttachmentsByApplicationAndRecordTypeAndRecordId(String application, String recordType, Long recordId);

    /**
     * 删除指定业务记录下全部附件关系，不区分用途
     */
    void deleteAttachmentsByRecordTypeAndRecordId(String recordType, Long recordId);

    /**
     * 按多个业务id批量删除附件关系
     */
    void deleteAttachmentsByApplicationAndRecordTypeAndRecordIds(String application, String recordType, List<Long> recordIds);

}