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

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

/*方法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[]。