Java操作FastDFS

1、創建 Springboot 工程

此處省略

2、引入 pom依賴

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

<dependency>
    <groupId>net.oschina.zcx7878</groupId>
    <artifactId>fastdfs-client-java</artifactId>
    <version>1.27.0.0</version>
</dependency>

3、在 Resource 下創建 FastDFS配置文件

fdfs_client.conf

connect_timeout = 60 # 連接超時時間，單位為秒
network_timeout = 60 # 通信超時時間，單位為秒。發送或接收數據時。假設在超時時間后還不能發送或接收數據，則本次網絡通信失敗
charset = UTF-8 # 字符集
http.tracker_http_port = 8080 # .tracker的http端口
tracker_server = FastDFS的ip地址:22122 #  tracker服務器IP和端口設置

4、在 Resource 下創建 application.yml

spring:
  servlet:
    multipart:
      max-request-size: 10MB
      max-file-size: 10MB
server:
  port: 9008

5、工具類

5.1 文件實體類

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

/**
 * description
 * author Admin
 * date 2021/11/27
 */
@Data
@NoArgsConstructor
@AllArgsConstructor
public class FastDFSFile {

    /**
     * 文件名字
     */
    private String name;

    /**
     * 文件內容
     */
    private byte[] content;

    /**
     * 文件擴展名
     */
    private String ext;

    /**
     * 文件MD5摘要值
     */
    private String md5;

    /**
     * 文件創建作者
     */
    private String author;

    public FastDFSFile(String name, byte[] content, String ext, String height, String width, String author) {
        super();
        this.name = name;
        this.content = content;
        this.ext = ext;
        this.author = author;
    }

    public FastDFSFile(String name, byte[] content, String ext) {
        super();
        this.name = name;
        this.content = content;
        this.ext =ext;
    }
}

5.2 文件工具類，封裝底層方法

import org.csource.common.NameValuePair;
import org.csource.fastdfs.*;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.core.io.ClassPathResource;

import java.io.ByteArrayInputStream;
import java.io.InputStream;

/**
 * description FastDFS客戶端工具類
 * author Admin
 * date 2021/11/27
 */
public class FastDFSClient {
    private static Logger logger = LoggerFactory.getLogger(FastDFSFile.class);

    /**
     * 初始化加載 FastDFS的TrackerServer配置
     */
    static {
        try {
            String filePath = new ClassPathResource("fdfs_client.conf").getFile().getAbsolutePath();
            ClientGlobal.init(filePath);
        } catch (Exception e) {
            logger.error("FastDFS 初始化失敗", e);
        }
    }

    /**
     * 文件上傳
     * @param file
     * @return
     */
    public static String[] upload(FastDFSFile file) {
        // 獲取文件的作者
        NameValuePair[] meta_list = new NameValuePair[1];
        meta_list[0] = new NameValuePair("author", file.getAuthor());

        // 接收返回數據
        String[] uploadResults = null;
        StorageClient storageClient = null;

        try {
            // 創建 StorageClient 客戶端對象
            storageClient = getTrackerClient();

            /**
             * 文件上傳
             * 1) 文件字節數組
             * 2) 文件擴展名
             * 3) 文件作者
             */
            uploadResults = storageClient.upload_file(file.getContent(), file.getExt(), meta_list);
        } catch (Exception e) {
            logger.error("上傳文件失敗: " + file.getName(), e);
        }

        if (uploadResults ==null && storageClient != null) {
            logger.error("上傳文件錯誤，錯誤碼: " + storageClient.getErrorCode());
        }
        // 獲取組名
        String groupName = uploadResults[0];
        // 獲取文件存儲路徑
        String remoteFileName = uploadResults[1];
        return uploadResults;
    }

    /**
     * 獲取文件信息
     * @param groupName 組名
     * @param remoteFileName 文件存儲完整名
     * @return
     */
    public static FileInfo getFile(String groupName, String remoteFileName) {
        try {
            StorageClient storageClient = getTrackerClient();
            return storageClient.get_file_info(groupName, remoteFileName);
        } catch (Exception e) {
            logger.error("從FastDFS中獲取文件錯誤", e);
        }
        return null;
    }

    /**
     * 文件下載
     * @param groupName
     * @param remoteFileName
     * @return
     */
    public static InputStream downFile(String groupName, String remoteFileName) {
        try {
            // 創建 StorageClient
            StorageClient storageClient = getTrackerClient();
            // 下載文件
            byte[] fileByte = storageClient.download_file(groupName, remoteFileName);
            ByteArrayInputStream ins = new ByteArrayInputStream(fileByte);
            return ins;
        } catch (Exception e) {
            logger.error("從FastDFS獲取文件失敗", e);
        }
        return null;
    }

    /**
     * 文件刪除
     * @param groupName
     * @param remoteFileName
     */
    public static  void deleteFile(String groupName, String remoteFileName) {
        try {
            // 創建 StorageClient
            StorageClient storageClient = getTrackerClient();
            // 刪除文件
            int i = storageClient.delete_file(groupName, remoteFileName);
        } catch (Exception e) {
            logger.error("從FastDFS中文件刪除失敗", e);
        }
    }

    /**
     * 獲取Storage組
     * @param groupName 組名
     * @return
     */
    public static StorageServer[] getStoreStorages(String groupName) {
        try {
            // 創建 TrackerClient
            TrackerClient trackerClient = new TrackerClient();
            // 獲取 TrackerServer
            TrackerServer trackerServer = trackerClient.getConnection();
            //獲取 Storage 組
            return trackerClient.getStoreStorages(trackerServer, groupName);
        } catch (Exception e) {
            logger.error("從FastDFS獲取Storage 組失敗", e);
        }
        return null;
    }

    /**
     * 獲取 Storage 信息,IP和端口
     * @param groupName
     * @param remoteFileName
     * @return
     */
    public static ServerInfo[] getFetchStoages(String groupName, String remoteFileName) {
        try {
            TrackerClient trackerClient = new TrackerClient();
            TrackerServer trackerServer = trackerClient.getConnection();
            return trackerClient.getFetchStorages(trackerServer, groupName, remoteFileName);
        } catch (Exception e) {
           logger.error("獲取Storage信息，IP 和端口失敗", e);
        }
        return null;
    }

    /**
     * 獲取 Tracker 服務地址
     * @return
     */
    public static String getTrackerUrl() {
        return "http://" + getTrackerServer().getInetSocketAddress().getHostString()+":"+ClientGlobal.getG_tracker_http_port()+ "/";
    }

    /**
     * 獲取Storage 客戶端
     * @return
     */
    private static StorageClient getTrackerClient() {
        TrackerServer trackerServer = getTrackerServer();
        StorageClient storageClient = new StorageClient(trackerServer, null);
        return storageClient;
    }

    /**
     * 獲取 Tracker
     * @return
     */
    private static TrackerServer getTrackerServer() {
        try {
            TrackerClient trackerClient = new TrackerClient();
            TrackerServer trackerServer = trackerClient.getConnection();
            return trackerServer;
        } catch (Exception e) {
            logger.error("獲取Tracker 失敗", e);
        }
        return null;
    }
}

6、文件上傳

@PostMapping("upload")
public Result upload(MultipartFile file) {
    try {
        // 文件上傳
        // 1. 獲取文件屬性
        // 1.1. 原始文件名
        String originalFilename = file.getOriginalFilename();
        // 1.2. 文件內容
        byte[] fileBytes = file.getBytes();
        // 1.3 文件擴展名  test.jpg -> jpg
        String ext = originalFilename.substring(originalFilename.lastIndexOf(".") + 1);

        // 2. 創建 FastDFSFile
        FastDFSFile fastDFSFile = new FastDFSFile(originalFilename, fileBytes, ext);
        // 3. 調用工具類上傳
        // uploadResult 第一個只是 group 第二個值是：物理路徑
        String[] uploadResult = FastDFSClient.upload(fastDFSFile);

        // 預覽url
        String url = FastDFSClient.getTrackerUrl() + uploadResult[0] + "/" + uploadResult[1];

        return new Result(true, StatusCode.OK, "上傳成功",url);
    } catch (Exception e) {
        return new Result(false, StatusCode.ERROR, "上傳失敗" + e.getMessage());
    }
}