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

/**
 * 文件（blob）API 接口
 * <p>
 * 供业务模块存放「后端自己生成」的文件（打印出的 PDF、导出的报表等）。
 * 前端上传仍走 {@code /system/storage-blob/upload}，本接口只解决服务端没有字节入参入口的问题。
 */
public interface StorageBlobApi {

    /**
     * 保存内存中的字节内容为一个文件
     *
     * @param content          文件内容，不能为空
     * @param originalFileName 原始文件名（下载时展示）
     * @param contentType      资源类型，如 application/pdf
     * @return 文件编号（system_storage_blob 主键），拿到后还需自行与业务记录建立附件关联
     */
    Long saveBlob(byte[] content, String originalFileName, String contentType);

}