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

guyuehhh

　　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?

• 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为例）：
　　






[java] 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[]。