FastDFS提供的API简介

Posted 2021-08-18 Huazie

FastDFS提供的API简介

本篇文章转载于FastDFS作者 余庆 大佬的 FastDFS分享与交流 公众号。

FastDFS提供的API及简要说明如下：

API	描述
upload	上传普通文件，包括主文件
upload_appender	上传appender类型文件，后续可以对其进行append、modify和truncate操作
upload_slave	上传从文件
download	下载文件
delete	删除文件
append	在appender文件后面追加内容
modify	修改appender文件内容
truncate	设置appender文件大小
set_metadata	设置文件附加属性
get_metadata	获取文件附加属性

FastDFS 最常用的API有3个：upload、download 和 delete。

为了支持主从文件，分化出 upload_appender 和 upload_slave 这两个API。

调用delete API删除文件后该文件将不可恢复，请小心使用。

主从文件是 FastDFS 生成的文件名有直接关联的一组文件。其典型应用场景是图片缩略图，可以把原图作为主文件，其一系列缩略图作为从文件。

通过 append 方法在 appender 类型文件后面追加内容，可以用于增量上传文件，通常使用这个 API 实现大文件断点续传功能。

modify 方法在特定场合才会被使用到，比如 实现超大文件的并发上传。

使用 truncate 方法可以改变文件大小，通常用于把 文件清空 或者把 文件变小，也支持把 文件变大。

注： 使用 truncate 将文件变小时，会导致文件内容被截断，请小心使用这个功能。

FastDFS 支持存储文件附加属性，一个文件的附件属性将以一个单独的文件保存。

注： 文件附加属性保存在 KV系统 或者 数据库 中是主流做法，除非使用场合特殊，否则不建议使用 set_metadata 和 get_metadata 这两个 API。