package com.microservices.system.api;

import com.microservices.common.core.constant.SecurityConstants;
import com.microservices.common.core.constant.ServiceNameConstants;
import com.microservices.common.core.domain.R;
import com.microservices.system.api.domain.SysFile;
import com.microservices.system.api.domain.SysFileInfo;
import com.microservices.system.api.factory.RemoteFileFallbackFactory;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.http.MediaType;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;

import java.util.List;

/**
 * 文件服务
 *
 * @author microservices
 */
@FeignClient(contextId = "remoteFileService", value = ServiceNameConstants.FILE_SERVICE, fallbackFactory = RemoteFileFallbackFactory.class)
public interface RemoteFileService {
    /**
     * 上传文件
     *
     * @param file 文件信息
     * @return 结果
     */
    @PostMapping(value = "/upload", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
    public R<SysFile> upload(@RequestPart(value = "file") MultipartFile file);

    /**
     * 根据文件Id列表获取文件列表
     *
     * @param fileIds 文件Id列表
     * @return 结果
     */
    @GetMapping("/open/getFileList/{fileIds}")
    public R<List<SysFileInfo>> getFileList(@PathVariable("fileIds") String fileIds);

    /**
     * 根据文件Id获取文件信息
     *
     * @param fileId 文件Id
     * @return 结果
     */
    @GetMapping("/open/getFile/{fileId}")
    public R<SysFileInfo> getFile(@PathVariable("fileId") Long fileId);

    /**
     * 根据文件标识列表获取文件详情列表
     *
     * @param fileIdentifiers 文件标识列表，逗号分隔
     * @return 文件详情列表
     */
    @GetMapping("/open/getFileListByIdentifier/{fileIdentifiers}")
    R<List<SysFileInfo>> getFileListByIdentifier(@PathVariable("fileIdentifiers") String fileIdentifiers);

    /**
     * 通过文件标识列表批量删除文件
     *
     * @param fileIdentifiers 文件标识列表，逗号分隔
     * @return 结果
     */
    @DeleteMapping("/common/byIdentifiers/{fileIdentifiers}")
    R<Boolean> deleteFileByIdentifiers(@PathVariable("fileIdentifiers") String fileIdentifiers,
                                       @RequestHeader(SecurityConstants.FROM_SOURCE) String source);
}
