1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
package com.vci.ubcs.resource.service;
 
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.vci.ubcs.resource.bo.FileObjectBO;
import com.vci.ubcs.resource.dto.FileObjectDTO;
import com.vci.ubcs.resource.dto.FileReleaseDTO;
import com.vci.ubcs.resource.dto.FileShareDTO;
import com.vci.ubcs.resource.entity.FileObject;
import com.vci.ubcs.resource.query.FileQuery;
import com.vci.ubcs.resource.vo.FileObjectVO;
import org.springblade.core.mp.support.Query;
import org.springblade.core.tool.api.R;
import org.springframework.transaction.annotation.Transactional;
import org.springframework.web.multipart.MultipartFile;
 
import java.util.Collection;
import java.util.List;
 
/**
 * 文件的服务
 * @author weidy
 * @date 2023/1/31
 */
public interface IFileService extends IService<FileObject> {
 
    /**
     * 下载，注意多个文件的时候，会自动下载为一个压缩包
     * @param oids 主键集合
     * @return 文件的信息
     */
    FileObjectBO downloadFileByOids(Collection<String> oids);
 
    /**
     * 删除文件
     * @param oids 主键集合
     * @return 执行结果
     */
    void deleteFiles(Collection<String> oids);
 
    /**
     * 上传文件
     * @param file 文件的信息
     * @param fileObjectDTO 文件的相关信息
     * @return 文件上传后的信息
     */
    R<FileObjectVO> uploadFile(MultipartFile file, FileObjectDTO fileObjectDTO);
 
    /**
     * 修改文件的信息（不会改objectName和filePath)
     * @param fileDTOs 文件的信息
     * @return 修改后的信息
     */
    R<List<FileObjectVO>> updateFileInfos(Collection<FileObjectDTO> fileDTOs);
 
    FileObjectVO do2Vo(FileObject fileObject);
 
    List<FileObjectVO> do2Vos(Collection<FileObject> fileObjects);
 
    /**
     * 分享文件到其他数据中
     *
     * @param shareDTO 来源业务
     * @return 分享后的文件信息
     */
    R<List<FileObjectVO>> shareFiles(FileShareDTO shareDTO);
 
    /**
     * 文件列表查询
     * @param fileQuery 文件查询
     * @param query 分页查询对象
     * @return 文件的显示信息
     */
    IPage<FileObjectVO> listFiles(FileQuery fileQuery, Query query);
 
    /**
     * 使用文件的主键批量获取对象
     * @param oids 文件的主键集合
     * @return 文件的显示信息
     */
    List<FileObjectVO> listFilesByOids(Collection<String> oids);
 
    /**
     * 文件生效
     * @param oids 主键集合
     * @return 执行结果
     */
    R releasedFiles(Collection<String> oids);
 
    /**
     * 批量指定文件业务数据后生效
     * @param releaseDTOS 生效的相关信息
     * @return 执行结果
     */
    R releasedFilesForOwn(Collection<FileReleaseDTO> releaseDTOS);
 
    /**
     * 在上传文件后，保存文件的信息
     * @param fileObjectDTO 文件信息传输对象
     * @return 文件信息显示对象
     */
    R<FileObjectVO> saveFileAfterUpload(FileObjectDTO fileObjectDTO);
 
 
    /**
     * 获取对象
     * @param oid 主键
     * @return 文件的显示对象
     */
    FileObjectVO get(String oid);
}