FastDFS的配置、部署与API使用解读（8）FastDFS多种文件上传接口详解

《Poechant的FastDFS的配置、部署与API使用教程》

FastDFS的配置、部署与API使用解读——（1）入门使用教程

FastDFS的配置、部署与API使用解读——（2）Java API：根据InputStream、文件名、文件长度上传文件

FastDFS的配置、部署与API使用解读——（3）Java API：根据InputStream、文件名、文件长度，采用IO流直接转换的方式上传文件

FastDFS的配置、部署与API使用解读——（4）设置FastDFS配置参数的两种方式

FastDFS的配置、部署与API使用解读——（5）FastDFS配置详解之Tracker配置

FastDFS的配置、部署与API使用解读——（6）FastDFS配置详解之Storage配置

FastDFS的配置、部署与API使用解读——（7）关于FastDFS的Nginx的一些Q&A汇总

FastDFS的配置、部署与API使用解读——（8）FastDFS配置详解之Clinet配置及其两种初始化方式

FastDFS的配置、部署与API使用解读——（9）FastDFS多种文件上传接口详解

本文来自诗商 • 柳惊鸿 Poechant http://blog.csdn.net/poechant，转载请注明出处。

1、StorageClient与StorageClient1的区别

相信使用happy_fish的FastDFS的童鞋们，一定都熟悉StorageClient了，或者你熟悉的是StorageClient1，两者有什么区别呢？

我们在前面的几篇博文中已经知道，FastDFS存储文件时，是将FastDFS存储到某个Group的某个Storage的某个路径下。如果你在Storage Server上设置的是两层目录结构的话，则一个文件上传到FastDFS后的File ID一般形如"group1/M01/00/2A/rBAsVk8ORy2Nf9EoAAIRKo2Da7U901.jpg"形式。其中的“group1”称为Group Name，后段的“M01/00/08/rBAsVk8ORy2Nf9EoAAlRKo2Da7U901.jpg"称为File Name。

知道了这些后，我们就可以讨论StorageClient和StorageClient1的区别了。StorageClient中是将File ID用Group Name和File Name两部分来表示的，而StorageClient1中是将Group Name和File Name统一起来处理的。其实通过分析FastDFS Java Client的源码可以发现，StorageClient1是StorageClient的一个子类。

1. public class StorageClient1 extends StorageClient {  
2.       ...  
3. }  

StorageClient1中的upload_file1(...)方法的实现，都是在调用this.upload_file(...)，将返回的Group Name和File Name组合起来返回的。

2、多种文件上传接口

目前FastDFS Java Client API的最新版本是1.19，该版本中有如下这些上传API（这里以Storage Client1为例）：

1. /*方法1*/upload_file1(byte[] file_buff, String file_ext_name, NameValuePair[] meta_list);  
2. /*方法2*/upload_file1(String group_name, byte[] file_buff, String file_ext_name, NameValuePair[] meta_list);  
3. /*方法3*/upload_file1(String master_file_id, String prefix_name, byte[] file_buff, int offset, int length, String file_ext_name, NameValuePair[] meta_list);  
4. /*方法4*/upload_file1(String master_file_id, String prefix_name, byte[] file_buff, String file_ext_name, NameValuePair[] meta_list);  
5.   
6. /*方法5*/upload_file1(String group_name, long file_size, UploadCallback callback, String file_ext_name, NameValuePair[] meta_list);  
7. /*方法6*/upload_file1(String master_file_id, String prefix_name, long file_size, UploadCallback callback, String file_ext_name, NameValuePair[] meta_list);  
8.   
9. /*方法7*/upload_file1(String local_file_name, String file_ext_name, NameValuePair[] meta_list);  
10. /*方法8*/upload_file1(String group_name, String local_file_name, String file_ext_name, NameValuePair[] meta_list);  
11. /*方法9*/upload_file1(String master_file_id, String prefix_name, String local_file_name, String file_ext_name, NameValuePair[] meta_list);  

（1）多种上传格式

方法1-4是上传File Buffer（字节数组）；方法5-6是通过回调的方式上传文件流（以后的文章中会解释），方法7-9是上传本地文件。

（2）多种上传方式

下面我们把这几种上传的接口的参数总结一下，方便大家使用API。

 Group NameExtensionMeta ListMaster File IDPrefix NameOffsetLengthSizeFormatMethod 1 √√     BufferMethod 2√√√     BufferMethod 3 √√√√√√ BufferMethod 4 √√√√   BufferMethod 5√√√    √StreamMethod 6 √√√√  √StreamMethod 7 √√     LocalMethod 8√√√     LocalMethod 9 √√√√   Local

所有方式都可以携带参数extension和meta list。另外通过回调上传流的方式，必须给出文件大小的参数。

StorageClient1的上传方法，返回值是String，StorageClient的上传方法，返回值是String[]。

本文来自诗商 • 柳惊鸿 Poechant http://blog.csdn.net/poechant，转载请注明出处。

-

版权声明：本文为博主原创文章，未经博主允许不得转载。合作请联系微信 sinosuperman。