FastDFS的配置、部署与API使用解读（8）FastDFS多种文件上传接口详解
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的一个子类。
view plaincopyprint?
[*]public class StorageClient1 extends StorageClient {
[*] ...
[*]}
public class StorageClient1 extends StorageClient {
...
}
StorageClient1中的upload_file1(...)方法的实现，都是在调用this.upload_file(...)，将返回的Group Name和File Name组合起来返回的。
2、多种文件上传接口
目前FastDFS Java Client API的最新版本是1.19，该版本中有如下这些上传API（这里以Storage Client1为例）：
view plaincopyprint?
[*]/*方法1*/upload_file1(byte[] file_buff, String file_ext_name, NameValuePair[] meta_list);
[*]/*方法2*/upload_file1(String group_name, byte[] file_buff, String file_ext_name, NameValuePair[] meta_list);
[*]/*方法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*/upload_file1(String master_file_id, String prefix_name, byte[] file_buff, String file_ext_name, NameValuePair[] meta_list);
[*]
[*]/*方法5*/upload_file1(String group_name, long file_size, UploadCallback callback, String file_ext_name, NameValuePair[] meta_list);
[*]/*方法6*/upload_file1(String master_file_id, String prefix_name, long file_size, UploadCallback callback, String file_ext_name, NameValuePair[] meta_list);
[*]
[*]/*方法7*/upload_file1(String local_file_name, String file_ext_name, NameValuePair[] meta_list);
[*]/*方法8*/upload_file1(String group_name, String local_file_name, String file_ext_name, NameValuePair[] meta_list);
[*]/*方法9*/upload_file1(String master_file_id, String prefix_name, String local_file_name, String file_ext_name, NameValuePair[] meta_list);
/*方法1*/upload_file1(byte[] file_buff, String file_ext_name, NameValuePair[] meta_list);
/*方法2*/upload_file1(String group_name, byte[] file_buff, String file_ext_name, NameValuePair[] meta_list);
/*方法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*/upload_file1(String master_file_id, String prefix_name, byte[] file_buff, String file_ext_name, NameValuePair[] meta_list);
/*方法5*/upload_file1(String group_name, long file_size, UploadCallback callback, String file_ext_name, NameValuePair[] meta_list);
/*方法6*/upload_file1(String master_file_id, String prefix_name, long file_size, UploadCallback callback, String file_ext_name, NameValuePair[] meta_list);
/*方法7*/upload_file1(String local_file_name, String file_ext_name, NameValuePair[] meta_list);
/*方法8*/upload_file1(String group_name, String local_file_name, String file_ext_name, NameValuePair[] meta_list);
/*方法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 Name
Extension
Meta List
Master File ID
Prefix Name
Offset
Length
Size
Format
Method 1
√
√
Buffer
Method 2
√
√
√
Buffer
Method 3
√
√
√
√
√
√
Buffer
Method 4
√
√
√
√
Buffer
Method 5
√
√
√
√
Stream
Method 6
√
√
√
√
√
Stream
Method 7
√
√
Local
Method 8
√
√
√
Local
Method 9
√
√
√
√
Local
所有方式都可以携带参数extension和meta list。另外通过回调上传流的方式，必须给出文件大小的参数。
StorageClient1的上传方法，返回值是String，StorageClient的上传方法，返回值是String[]。
页:
[1]