package driver import ( "context" "fmt" model "github.com/cloudreve/Cloudreve/v3/models" "github.com/cloudreve/Cloudreve/v3/pkg/filesystem/fsctx" "github.com/cloudreve/Cloudreve/v3/pkg/filesystem/response" "github.com/cloudreve/Cloudreve/v3/pkg/serializer" "net/url" ) var ( ErrorThumbNotExist = fmt.Errorf("thumb not exist") ErrorThumbNotSupported = fmt.Errorf("thumb not supported") ) // Handler 存储策略适配器 type Handler interface { // 上传文件, dst为文件存储路径,size 为文件大小。上下文关闭 // 时,应取消上传并清理临时文件 Put(ctx context.Context, file fsctx.FileHeader) error // 删除一个或多个给定路径的文件,返回删除失败的文件路径列表及错误 Delete(ctx context.Context, files []string) ([]string, error) // 获取文件内容 Get(ctx context.Context, path string) (response.RSCloser, error) // 获取缩略图,可直接在ContentResponse中返回文件数据流,也可指 // 定为重定向 // 如果缩略图不存在, 且需要 Cloudreve 代理生成并上传,应返回 ErrorThumbNotExist,生 // 成的缩略图文件存储规则与本机策略一致。 // 如果不支持此文件的缩略图,并且不希望后续继续请求此缩略图,应返回 ErrorThumbNotSupported Thumb(ctx context.Context, file *model.File) (*response.ContentResponse, error) // 获取外链/下载地址, // url - 站点本身地址, // isDownload - 是否直接下载 Source(ctx context.Context, path string, url url.URL, ttl int64, isDownload bool, speed int) (string, error) // Token 获取有效期为ttl的上传凭证和签名 Token(ctx context.Context, ttl int64, uploadSession *serializer.UploadSession, file fsctx.FileHeader) (*serializer.UploadCredential, error) // CancelToken 取消已经创建的有状态上传凭证 CancelToken(ctx context.Context, uploadSession *serializer.UploadSession) error // List 递归列取远程端path路径下文件、目录,不包含path本身, // 返回的对象路径以path作为起始根目录. // recursive - 是否递归列出 List(ctx context.Context, path string, recursive bool) ([]response.Object, error) }