文件内部传输
概述
Dante Cloud 默认使用 OSS 作为文件存储介质，并提供了 OSS 服务支持文件的操作和管理。但是，当前模式下，仅支持前端以接口调用的方式来实现文件管理，如果存在服务间传输文件的需求，将无法满足。
为了解决这个问题，同时便于用户使用，在最新版本的 Dante Cloud 中，新增了服务间远程文件传输支持，填补了微服务文件管理的空缺。
[一]引入依赖
自 Dante Cloud 3.3.5.0 版本起，新增了 rpc-client-oss-spring-boot-starter 模块。需要在使用服务间文件传输的服务（非 OSS 服务）中引入该模块后，才能调用文件间传输接口。
rpc-client-oss-spring-boot-starter 模块支持 Openfeign 和 GRPC 两种远程传输模式，会根据当前服务的环境自动判断使用哪种方式。
- 如果当前服务为 Reactive 环境，那么就会自动切换为使用 GPRC 进行传输
- 如果当前服务为 Servlet 环境，那么就会自动切换为使用 Openfeign 进行传输
另外，远程传输还需要服务本地文件管理的支持。利用服务本地文件管理的支持，不仅可以实现服务向 OSS 服务远程上传和下载文件，还可以实现以 OSS 服务为中转，非 OSS 服务间传递文件。
注意
目前，不支持脱离 OSS 服务，实现其它服务间点对点的文件传输。一方面，这种实现比较困难，完全类似于下载软件的需求实现较为复杂，另一方面，这种需求非常小众，应用场景非常有限，特别是在服务于服务之间。
如果确实需要这种需求，建议使用外部的文件同步或者文件共享机制实现。
[二]添加配置
因为需要服务本地文件管理的支持，所以需要添加服务本地文件管理的支持。服务本地文件管理详情参见：【服务本地文件管理】
[三]引入操作Bean
需要在你的代码中，注入 FileTransformer Bean，然后通过调用其中相应的方法就可以进行文件管理操作。
例如，新建一个 MyFileService，在这个 Service 代码中注入FileTransformer Bean，如下例所示：
@Service
public class MyFileService {
private final FileTransformer fileTransformer;
public MyFileService(FileTransformer fileTransformer) {
this.fileTransformer = FileTransformer;
}
}提示
依赖了 rpc-client-oss-spring-boot-starter 模块后，会自动将 FileTransformer 注入，在自己的代码中直接注入就可以使用。如果当前的操作不满足您的需求，FileTransformer 是一个接口定义，可以按您自己的需求进行扩展。
FileTransformer 支持的操作如下所示：
public interface FileTransformer {
/**
* 文件上传。
* <p>
* 将服务本地文件上传至对象存储服务中
*
* @param bucketName 存储桶名称
* @param directory 本地文件目录
* @param fileName 文件名
* @return true 上传成功；false 上传失败。
*/
boolean upload(String bucketName, String directory, String fileName);
/**
* 文件上传。
* <p>
* 将服务本地文件上传至对象存储服务中
*
* @param bucketName 存储桶名称
* @param fileName 文件名
* @return true 上传成功；false 上传失败。
*/
default boolean upload(String bucketName, String fileName) {
return upload(bucketName, null, fileName);
}
/**
* 文件下载。
* <p>
* 将对象存储服务中文件下载至服务本地
*
* @param bucketName 存储桶名称
* @param directory 本地文件目录
* @param fileName 文件名
* @return true 上传成功；false 上传失败。
*/
boolean download(String bucketName, String directory, String fileName);
/**
* 文件下载。
* <p>
* 将对象存储服务中文件下载至服务本地
*
* @param bucketName 存储桶名称
* @param fileName 文件名
* @return true 上传成功；false 上传失败。
*/
default boolean download(String bucketName, String fileName) {
return download(bucketName, null, fileName);
}
}
