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

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

2024-08-05 21:09:16   219人阅读

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的一个子类。

 

[java] view plaincopyprint?
  1. public class StorageClient1 extends StorageClient { 
  2.       ... 
  3. } 
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为例）：

 

[java] view plaincopyprint?
  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*/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 NameExtensionMeta ListMaster File IDPrefix NameOffsetLengthSizeFormat
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[]。

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


联系
我们