使用Hutool進行文件上傳

Hutool 是一個 Java工具類庫，其中包括了大量的工具方法。它設計的宗旨是非常的簡單，專註於 Java 開發中的各種常見工具類封裝。

一、為什麼要使用Hutool進行文件上傳

在Web開發中，文件上傳是一個非常基本的功能需求。傳統的做法是使用Servlet或者框架自帶的文件上傳功能。但是，這些傳統方法存在一些問題，例如：文件命名不規範、文件大小限制不清、上傳文件內容的格式限制等等。

Hutool 提供了一種非常方便的上傳文件解決方案，可以大大提高上傳文件的便利性和性能。使用 Hutool 上傳文件，我們可以非常真實地掌控上傳流程中的各個細節。例如上傳令牌、文件命名、文件保存路徑等等。這些細節可以按需靈活配置，滿足各種不同的上傳需求和場景。

二、hutool上傳文件代碼實例

1、上傳單個文件

// 上傳文件到指定的路徑
File file = FileUtil.file("/opt/upload/demo.txt");
String result = HttpUtil.post("http://localhost:8080/upload", file);

以上代碼使用HttpUtil.upload(File, String, Map<String, Object>)方法來上傳單個文件。該方法的第一個參數是上傳的文件、第二個參數是上傳的路徑、第三個參數是上傳的其他參數。此處我們傳了一個空的參數Map。

2、上傳多個文件

// 上傳多個文件到指定路徑
List<File> fileList = CollUtil.newArrayList(
        FileUtil.file("/opt/upload/demo1.txt"),
        FileUtil.file("/opt/upload/demo2.txt")
);
HttpResponse response = HttpUtil.createPost("http://localhost:8080/upload")
        .form("username", "admin")
        .form("password", "123456")
        .form("fileList", fileList)
        .execute();

以上代碼使用HttpUtil.createPost(String)方法來創建一個POST請求對象。然後我們使用form方法來設置上傳的參數。其中，fileList使用了CollUtil.newArrayList()方法，該方法返回一個可變長度的 List 集合。我們使用List 來保存多個上傳文件。在執行 execute() 方法後，HttpUtil 會將文件和參數一起上傳到指定的路徑。

3、上傳流文件

// 使用HttpUtil上傳流文件
FileInputStream stream = FileUtil.getInputStream("/opt/upload/demo.txt");
HttpResponse response = HttpUtil.createPost("http://localhost:8080/upload")
        .form("username", "admin")
        .form("password", "123456")
        .form("file", "demo.txt", stream)
        .execute();

以上代碼使用了HTTPUtil.createPost(String)方法傳入上傳路徑。然後，我們使用 form(String key, String fileName, InputStream value) 方法上傳文件。該方法的第一個參數是指定的鍵、第二個參數是上傳文件的名稱，第三個參數是文件的輸入流。最後再使用 execute() 來進行上傳操作。

三、Hutool常用上傳文件方法

1、上傳文件到本地

// 上傳文件到本地
File file = new File("d:/config.xml");
FileUtil.writeBytes(file, bytes);

以上代碼通過構造一個 java.io.File 對象來上傳文件到本地的硬碟上。

2、上傳文件至FTP伺服器

// 上傳文件至FTP伺服器
Ftp ftp = new Ftp("127.0.0.1", "username", "password");
ftp.cd("upload");
ftp.upload("/opt/upload/test.txt", "test.txt");
ftp.close();

以上代碼使用了Hutool封裝的 FTP 類實現上傳文件至FTP伺服器。

3、上傳文件到七牛雲存儲

// 上傳文件到七牛雲存儲
QiniuConfig config = new QiniuConfig();
config.setAccessKey("***");
config.setSecretKey("***");
config.setBucketName("***");

File file = FileUtil.file("/opt/upload/demo.txt");
String url = QiniuUtil.upload(config, file, "demo.txt");
System.out.println(url);

以上代碼使用了Hutool封裝的 QiniuUtil 類上傳文件到七牛雲存儲。

4、上傳文件到阿里雲OSS存儲

// 上傳文件到阿里雲OSS存儲
OSSConfig config = new OSSConfig();
config.setEndpoint("***");
config.setAccessKeyId("***");
config.setAccessKeySecret("***");
config.setBucketName("***");

File file = FileUtil.file("/opt/upload/demo.txt");
String url = OssUtil.upload(config, file, "demo.txt");
System.out.println(url);

以上代碼使用了Hutool封裝的OssUtil類上傳文件到阿里雲OSS存儲。

四、總結

到這裡，您已經了解了如何使用 Hutool 進行文件上傳。Hutool 提供了非常簡單、方便的方法來解決Web開發中的文件上傳問題。它簡化了大量的傳統操作，讓我們可以更集中地關注業務邏輯的實現。