使用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开发中的文件上传问题。它简化了大量的传统操作，让我们可以更集中地关注业务逻辑的实现。