package cn.iocoder.yudao.module.system.service.storage;
|
|
import cn.iocoder.yudao.module.system.controller.admin.storage.vo.SystemStorageBlobRespVO;
|
import cn.iocoder.yudao.module.system.dal.dataobject.storage.SystemStorageBlobDO;
|
import org.springframework.web.multipart.MultipartFile;
|
|
import java.io.File;
|
import java.util.List;
|
|
/**
|
* 文件主表 Service 接口
|
*
|
* @author 超级管理员
|
*/
|
public interface SystemStorageBlobService {
|
|
/**
|
* 上传文件
|
*
|
* @param files 文件列表
|
* @param isPublic 是否公共文件（true=永久有效，false=临时token控制）
|
* @return 上传结果（含预览/下载地址）
|
*/
|
List<SystemStorageBlobRespVO> upload(List<MultipartFile> files, Boolean isPublic);
|
|
/**
|
* 保存内存中的字节内容为一个文件（后端自己生成的文件走这个入口，如打印出的 PDF）。
|
* <p>
|
* 不经过 HTTP 上传，因此不产生「上传者」概念；落盘与落库规则与 {@link #upload} 一致。
|
*
|
* @param content 文件内容，不能为空
|
* @param originalFileName 原始文件名（下载时展示）
|
* @param contentType 资源类型，如 application/pdf
|
* @param isPublic 是否公共文件（true=永久有效，false=临时token控制）
|
* @return 上传结果（含预览/下载地址）
|
*/
|
SystemStorageBlobRespVO saveBlob(byte[] content, String originalFileName, String contentType, Boolean isPublic);
|
|
/**
|
* 通过token获取文件
|
*
|
* @param fileName 唯一文件名
|
* @param token JWT token
|
* @return 文件对象
|
*/
|
File getFileByToken(String fileName, String token);
|
|
/**
|
* 通过publicKey获取公共文件
|
*
|
* @param fileName 唯一文件名
|
* @param publicKey 公共访问key
|
* @return 文件对象
|
*/
|
File getPublicFile(String fileName, String publicKey);
|
|
/**
|
* 获取下载时的原始文件名
|
*
|
* @param fileName 唯一文件名
|
* @return 原始文件名
|
*/
|
String getDownloadFileName(String fileName);
|
|
/**
|
* 获得文件
|
*
|
* @param id 编号
|
* @return 文件
|
*/
|
SystemStorageBlobDO getStorageBlob(Long id);
|
|
/**
|
* 批量删除文件
|
*
|
* @param ids 编号列表
|
*/
|
void deleteStorageBlobs(List<Long> ids);
|
|
}
|
