一.新增依賴

1.下載依賴

2.安裝依賴

將專案匯入到 IDE 中,或者直接使用 maven 指令將依賴安裝到倉庫中

3.專案中新增依賴

<dependency>
   <groupId>org.csource</groupId>
   <artifactId>fastdfs-client-java</artifactId>
   <version>1.27-SNAPSHOT</version>
</dependency>

4.配置檔案

4.1 conf 格式

connect_timeout = 2
network_timeout =
 
 30
charset = UTF-8
http.tracker_http_port = 80
http.anti_steal_token = no
http.secret_key = FastDFS1234567890
​
tracker_server = 10.0.11.247:22122
tracker_server = 10.0.11.248:22122
tracker_server = 10.0.11.249:22122
#注1：tracker_server指向您自己IP地址和埠，1-n個
#注2：除了tracker_server，其它配置項都是可選的

4.2 properties 格式

fastdfs.connect_timeout_in_seconds = 5
fastdfs.network_timeout_in_seconds = 30
fastdfs.charset = UTF-8
fastdfs.http_anti_steal_token = false
fastdfs.http_secret_key = FastDFS1234567890
fastdfs.http_tracker_http_port = 80
​
fastdfs.tracker_servers = 10.0.11.201:22122,10.0.11.202:22122,10.0.11.203:22122
#注1：properties 配置檔案中屬性名跟 conf 配置檔案不盡相同，並且統一加字首"fastdfs."，便於整合到使用者專案配置檔案
#注2：fastdfs.tracker_servers 配置項不能重複屬性名，多個 tracker_server 用逗號","隔開
#注3：除了fastdfs.tracker_servers，其它配置項都是可選的
 

5.載入配置示例(後面用)

//載入原 conf 格式檔案配置：
ClientGlobal.init("fdfs_client.conf");
ClientGlobal.init("config/fdfs_client.conf");
ClientGlobal.init("/opt/fdfs_client.conf");
ClientGlobal.init("C:\\Users\\Kam\\config\\fdfs_client.conf");

//載入 properties 格式檔案配置：
ClientGlobal.initByProperties("fastdfs-client.properties"
 
);
ClientGlobal.initByProperties("config/fastdfs-client.properties");
ClientGlobal.initByProperties("/opt/fastdfs-client.properties");
ClientGlobal.initByProperties("C:\\Users\\Kam\\config\\fastdfs-client.properties");

//載入 Properties 物件配置：
Properties props = new Properties();
props.put(ClientGlobal.PROP_KEY_TRACKER_SERVERS, "10.0.11.101:22122,10.0.11.102:22122");
ClientGlobal.initByProperties(props);
​
//載入 trackerServers 字串配置：
String trackerServers = "10.0.11.101:22122,10.0.11.102:22122";
ClientGlobal.initByTrackers(trackerServers);

6.檢查載入配置結果：

System.out.println("ClientGlobal.configInfo(): " + ClientGlobal.configInfo());
​
ClientGlobal.configInfo(): {
 g_connect_timeout(ms) = 5000
 g_network_timeout(ms) = 30000
 g_charset = UTF-8
 g_anti_steal_token = false
 g_secret_key = FastDFS1234567890
 g_tracker_http_port = 80
 trackerServers = 10.0.11.101:22122,10.0.11.102:22122
}

二. 測試方式演示

1.直接測試

@Test
public void test1() throws Exception {
//載入配置檔案,需要告訴它嚮導伺服器在哪
ClientGlobal.init("/home/Kam/workspace/testfastdfs/src/main/resources/server.conf");
//建立客戶端
TrackerClient trackerClient=new TrackerClient();
TrackerServer trackerServer = trackerClient.getConnection();
StorageServer server=null;
StorageClient storageClient=new StorageClient(trackerServer, server);
String[] strings = storageClient.upload_file("/home/img/12333.jpg", "jpg", null);//引數1 檔案路徑,引數2 檔案的副檔名,引數3檔案的元資料
for (String string : strings) {
System.err.println(string);//返回的結果就是整個地址,不包括域名 ip
}
// group1/M00/00/00/rBFdZ1oU8z2AAKfLABx_3eMqYVk200.jpg
}

2.封裝簡單工具類

/**
工具類中只封裝了部分方法,更多方法請自己封裝
*/
public class FastDFSClient {
private TrackerClient trackerClient;
private TrackerServer trackerServer;
private StorageClient1 storageClient;
private StorageServer storageServer;

public FastDFSClient(String conf) throws Exception {
if (conf.startsWith("classpath")) {//如果配置檔案是 classpath 開頭的,則代表是在類路徑中,去掉 classpath: 然後拼接類路徑
conf=conf.replace("classpath:", getClass().getResource("/").getPath());
}
ClientGlobal.init(conf);//載入路徑
trackerClient=new TrackerClient();
trackerServer=trackerClient.getConnection();
storageClient=new StorageClient1(trackerServer, storageServer);
}
/**
上傳檔案,引數是檔案的路徑,字尾名和元資料
*/
public String  upload_file(String fileName,String ext_name,NameValuePair[] pairs) throws Exception {
return storageClient.upload_file1(fileName, ext_name, pairs);
}

public String upload_file(String fileName)  throws Exception{
return upload_file(fileName, null, null);
}


public String upload_file(String fileName,String ext_name)  throws Exception{
return upload_file(fileName, ext_name, null);
}

public String upload_file(String fileName,NameValuePair[] pairs)  throws Exception{
return upload_file(fileName, null, pairs);
}
/**
上傳二進位制資料,需要將檔案先轉換為二進位制
*/
public String upload_file(byte[]source,String ext_name,NameValuePair[] pairs) throws Exception{
return storageClient.upload_file1(source, ext_name, pairs);
}
}

3. 測試工具類

@Test
public void test2()  throws Exception{
FastDFSClient fastDFSClient =new FastDFSClient("/home/Kam/workspace/testfastdfs/src/main/resources/server.conf");
String upload_file = fastDFSClient.upload_file("/home/img/12333.jpg");
System.err.println(upload_file);
}

三. SpringMvc 中使用

環境配置和前面四步一致
程式碼

@Controller
public class FileUploadController {
/**
* MultipartFile的形參的名字和form表單中檔案的域name一致
* @param file
* @return
*/
@ResponseBody
@RequestMapping(value="/upload",produces= {"text/plain;charset=utf-8"})
public String upLoad(MultipartFile file) {
String path=null;
Map<String, Object> map=new HashMap<>();//用於返回 json 資料的map 物件
try {
//file是使用者上傳的檔案
//需要將檔案轉存到檔案伺服器
//file.transferTo(dest); 儲存到本地檔案
/*file.getOriginalFilename()
file.getName()*/
FastDFSClient fastDFSClient=new FastDFSClient("classpath:server.conf");//此處應當注入物件過來
path= fastDFSClient.upload_file(file.getBytes(), "jpg", null);
map.put("error", 0);//設定返回內容
map.put("url", "http://met.onlykam.jin/"+path);
} catch (Exception e) {
map.put("error", 1);
map.put("message", "Hello Kugou");
e.printStackTrace();
}
return JsonUtils.objectToJson(map);//將資料轉成 json 資料返回,此處可以自己寫或者直接返回map
}
}