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的一個子類。

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）多種上傳格式

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

本文來自詩商 • 柳驚鴻 Poechanthttp://blog.csdn.net/poechant，轉載請註明出處。

-