SpringBoot中配置全局文件上传路径并实现文件上传功能

前言

在后端开发中，处理文件上传是一个常见的需求。为了确保文件路径的统一和管理，通常不会随意指定路径。本文将详细介绍如何在 Spring Boot 中配置全局文件上传路径，并通过读取配置项实现文件上传。

配置全局上传路径

配置全局上传路径非常简单，只需在项目的配置文件中添加相应的配置项即可。例如：

# 文件上传路径
file.uploadFolder=D:/upload/

这里的路径可以是你本地计算机上的任意文件夹，也可以是云服务器上的路径。

读取配置项

配置完成后，需要在代码中读取该配置项。Spring Boot 提供了多种方式来读取配置项，其中最常用的是使用 @Value 注解。需要注意的是，@Value 注解来自 springframework 包，不要用错。

import org.springframework.beans.factory.annotation.Value;

&＃64;Value("${file.uploadFolder}")
private String basePath;

通过上述代码，我们可以将配置文件中的路径读取到变量 `basePath` 中，然后在文件上传逻辑中使用它。

实现文件上传

接下来，我们将在控制器中实现文件上传功能。以下是一个简单的示例：

package com.example.controller;

import cn.hutool.core.util.RandomUtil;
import com.example.common.Result;
import com.example.entity.User;
import com.example.service.IUserService;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;
import javax.annotation.Resource;
import java.io.File;
import java.io.IOException;
import java.util.Calendar;

&＃64;RestController
&＃64;RequestMapping("/user")
public class UserController {

    &＃64;Resource
    private IUserService userService;

    &＃64;Value("${file.uploadFolder}")
    private String basePath;

    &＃64;PostMapping("/upload")
    public Result upload(MultipartFile file) {
        if (file == null) {
            return Result.fail("请选择文件！");
        }

        String originalFilename = file.getOriginalFilename();
        String suffix = originalFilename.substring(originalFilename.lastIndexOf("."));
        Calendar calendar = Calendar.getInstance();
        String year = String.valueOf(calendar.get(Calendar.YEAR));
        String mOnth= String.valueOf(calendar.get(Calendar.MONTH) + 1);
        String day = String.valueOf(calendar.get(Calendar.DAY_OF_MONTH));

        String newFileName = year + "_" + month + "_" + day + "_" + RandomUtil.randomNumbers(6) + "_" + originalFilename;
        String filePath = basePath + newFileName;

        File dir = new File(basePath);
        if (!dir.exists()) {
            dir.mkdirs();
        }

        try {
            file.transferTo(new File(filePath));
        } catch (IOException e) {
            e.printStackTrace();
        }

        return Result.ok(filePath);
    }
}

测试效果

完成代码编写后，可以通过发送 POST 请求来测试文件上传功能。如果一切正常，上传的文件将被保存到指定路径。

总结

通过配置全局文件上传路径并读取配置项，可以更好地管理和维护文件路径。无论是上传到本地文件系统还是云服务器，都可以通过调整配置项来实现。这种方式不仅提高了代码的可维护性，还增强了系统的灵活性。