SpringBoot实现文件上传

• 表示文件上传后，对外访问的基础 URL。
• 例如，保存的文件本地路径是 D:/community/upload/face/abc.jpg，访问 URL 就可以是：

http://localhost:8080/face/abc.jpg

package com.qcby.config;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class WebMVCConfiguration implements WebMvcConfigurer {
    @Value("${upload-path.face}")
    private String face;
    @Value("${upload-path.file}")
    private String file;
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/community/upload/face/**")
                .addResourceLocations("file:"+face);
        registry.addResourceHandler("/community/upload/file/**")
                .addResourceLocations("file:"+file);
    }
}

GET http://localhost:8080/community/upload/face/123.jpg

D:/community/upload/face/123.jpg

@Autowired
private ICommunityService communityService;
@Autowired
private IPersonService personService;
@Value("${upload-path.url}")
private String uploadUrlPath;
@Value("${upload-path.face}")
private String faceLocalPath;
@Autowired
private ApiConfiguration apiConfiguration;
/**
 * 录入居民人脸信息
 * @return
 */
@PostMapping("/addPerson")
public Result addPersonImg(@RequestBody FaceForm faceForm){
    System.out.println("进入到addPerson");
    System.out.println(faceForm.getExtName());
    Person person = personService.getById(faceForm.getPersonId());
    // 严谨性判断，参数是否为空
    if(faceForm.getFileBase64()== null || faceForm.getFileBase64().equals("")){
        return Result.error("请上传人脸图片");
    }
    // 判断是否是人脸，如果不是，直接返回
    if(apiConfiguration.isUsed()){
        String faceId = newPerson(faceForm,person.getUserName());
        if(faceId == null){
            return Result.error("人脸识别失败");
        }else{
            String fileName = faceId + "." + faceForm.getExtName();
            String faceUrl = uploadUrlPath + faceLocalPath.substring(3) + fileName;
            person.setFaceUrl(faceUrl);
            person.setState(2);
            personService.updateById(person);
            return Result.ok();
        }
    }else{
        return Result.error("人脸识别开启失败");
    }
}

/**
 * 创建人脸信息，调用人脸识别API，进行人脸比对
 * @param faceForm
 * @param userName
 * @return
 */
private String newPerson(FaceForm faceForm, String userName) {
    String faceId = null;
    String fileBase64 = faceForm.getFileBase64();
    String extName = faceForm.getExtName();
    String personId = faceForm.getPersonId()+"";
    String savePath = faceLocalPath;
    if(fileBase64 != null && !fileBase64.equals("")){
        FaceApi faceApi = new FaceApi();
        RootResp newperson = faceApi.newperson(apiConfiguration, personId, userName, fileBase64);
        if(newperson.getRet()==0){
            JSONObject jsonObject = JSON.parseObject(newperson.getData().toString());
            faceId = jsonObject.getString("FaceId");
            if(faceId!=null){
                savePath = savePath + faceId + "."+extName;
                try {
                    Base64Util.decoderBase64File(fileBase64,savePath);
                } catch (Exception e) {
                    e.printStackTrace();
                }
            }
        } else{
            return faceId;
        }
    }
    return faceId;
}

1. 接收请求（/addPerson）取到 FaceForm（里有 fileBase64, extName, personId）。
2. 校验 fileBase64 为空就直接报错返回。
3. 开关检测apiConfiguration.isUsed() 控制是否启用人脸识别。
4. 调用识别并保存文件（newPerson()）

   1. 把 Base64 发给第三方人脸 API（faceApi.newperson(...)）

   2. 成功返回后从响应里拿到 FaceId

   3. 用 FaceId + "." + extName 作为文件名，拼成：savePath = faceLocalPath + faceId + "." + extName比如：D:/community/upload/face/ab12cd34.jpg

   4. 用 Base64Util.decoderBase64File(fileBase64, savePath) 把 Base64 解码写入磁盘

5. 生成可访问 URL + 更新库

   1. 构造 fileName = faceId + "." + extName

   2. 组装 faceUrl，然后 person.setFaceUrl(faceUrl)，并 updateById

4、EXCEL表的导入和导出

/**
     * 数据的导出功能实现
     * @param personListForm
     * @return
     */
    @GetMapping("/exportExcel")
    public Result exportExcel(PersonListForm personListForm){
       //1.获取满足条件的数据
        PageVO pageVO = personService.personList(personListForm);
       //2.只需要满足条件的数据即可
        List list = pageVO.getList();
       //3.处理数据放入到EXcel表格当中
        String path = excel;
        path=ExcelUtil.ExpPersonInfo(list, path);
        return Result.ok().put("data", path);
    }

    /**
     * 文件上传
     * @param file
     * @return
     * @throws Exception
     */
    @PostMapping("/excelUpload")
    public Result excelUpload(@RequestParam("uploadExcel") MultipartFile file) throws Exception {
        if(file.getOriginalFilename().equals("")){
            return Result.error("没有选中要上传的文件");
        }else {
            String picName = UUID.randomUUID().toString();
            String oriName = file.getOriginalFilename();
            String extName = oriName.substring(oriName.lastIndexOf("."));
            String newFileName = picName + extName;
            File targetFile = new File(excel, newFileName);
            // 保存文件
            file.transferTo(targetFile);
            return Result.ok().put("data",newFileName);
        }
    }



    /**
     * 实现数据库新增表中数据
     * 数据导入操作
     * @param fileName
     * @param session
     * @return
     */
    @PostMapping("/parsefile/{fileName}")
    public Result parsefile(@PathVariable("fileName") String fileName,HttpSession session){
        User user = (User) session.getAttribute("user");
        //POIFSFileSystem 是 Apache POI 库中的核心类
        //专门用于处理 OLE 2 Compound Document Format（微软复合文档格式）
        //是 Java 开发中处理传统 Microsoft Office 文档（如 .xls, .doc, .ppt）的基础组件
        POIFSFileSystem fs = null;
        //HSSFWorkbook 是 Apache POI 库中处理 Microsoft Excel 格式（.xls 文件）的核心类
        // 作为 Horrible SpreadSheet Format 的缩写，它提供了完整的 API 来创建、读取和修改传统 Excel
        // 二进制文件。
        HSSFWorkbook wb = null;
        try {
            String basePath = excel + fileName;
            fs = new POIFSFileSystem(new FileInputStream(basePath));
            wb = new HSSFWorkbook(fs);
        } catch (Exception e) {
            e.printStackTrace();
        }
        //这段代码的核心功能是从Excel中提取数据到二维数组，特别处理了第一列的数值转换。
        HSSFSheet sheet = wb.getSheetAt(0);// 获取工作簿中的第一个工作表
        Object[][] data = null;// 声明二维数组用于存储数据
        int r = sheet.getLastRowNum()+1;// 获取总行数（索引从0开始）
        int c = sheet.getRow(0).getLastCellNum();// 获取第一行的列数
        int headRow = 2;// 表头行数（跳过前2行）
        data = new Object[r - headRow][c];// 创建二维数组（行数=总行数-表头行）
        for (int i = headRow; i < r; i++) {// 从第3行开始（跳过表头）
            HSSFRow row = sheet.getRow(i); // 获取当前行
            for (int j = 0; j < c; j++) {// 遍历每列
                HSSFCell cell = null;
                try {
                    cell = row.getCell(j); // 获取单元格
                    try {
                        cell = row.getCell(j);
                        DataFormatter dataFormater = new DataFormatter();//使用DataFormatter将单元格值统一转为字符串
                        String a = dataFormater.formatCellValue(cell); // 格式化单元格值为字符串
                        data[i - headRow][j] = a;// 存储到数组
                    } catch (Exception e) {
                        // 异常处理：当单元格读取失败时
                        data[i-headRow][j] = ""; // 先设置为空字符串
                        // 特殊处理第一列（索引0）
                        if(j==0){
                            try {
                                double d = cell.getNumericCellValue();// 尝试获取数值
                                data[i - headRow][j] = (int)d + "";// 转换为整数后存储为字符串
                            }catch(Exception ex){
                                data[i-headRow][j] = "";// 如果转换失败，保持为空
                            }
                        }
                    }
                } catch (Exception e) {
                    System.out.println("i="+i+";j="+j+":"+e.getMessage());
                }
            }
        }

        int row = data.length;
        int col = 0;
        String errinfo = "";
        headRow = 3;
        //String[] stitle={"ID","小区名称","所属楼栋","房号","姓名","性别","手机号码","居住性质","状态","备注"};
        errinfo = "";
        for (int i = 0; i < row; i++) {
            Person single = new Person();
            single.setPersonId(0);
            single.setState(1);
            single.setFaceUrl("");
            try {
                col=1;
                String communityName = data[i][col++].toString();
                QueryWrapper<Community> queryWrapper = new QueryWrapper<>();
                queryWrapper.eq("community_name", communityName);
                Community community = this.communityService.getOne(queryWrapper);
                if( community == null){
                    errinfo += "Excel文件第" + (i + headRow) + "行小区名称不存在！";
                    return Result.ok().put("status", "fail").put("data", errinfo);
                }
                single.setCommunityId(community.getCommunityId());
                single.setTermName(data[i][col++].toString());
                single.setHouseNo(data[i][col++].toString());
                single.setUserName(data[i][col++].toString());
                single.setSex(data[i][col++].toString());
                single.setMobile(data[i][col++].toString());
                single.setPersonType(data[i][col++].toString());
                single.setRemark(data[i][col++].toString());
                single.setCreater(user.getUsername());
                this.personService.save(single);
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
        return Result.ok().put("status", "success").put("data","数据导入完成！");
    }

1. 导出数据到 Excel

@GetMapping("/exportExcel")
public Result exportExcel(PersonListForm personListForm)

执行流程：

1.获取数据

调用 personService.personList(personListForm) 按条件分页查询数据，得到 PageVO。

从 PageVO 中取出 list（这就是符合条件的人员数据）。

2.生成 Excel 文件

ExcelUtil.ExpPersonInfo(list, path) 将数据写入 Excel，并返回 Excel 文件的保存路径。

3.返回结果

Result.ok().put("data", path) 把文件路径返回给前端。前端可以用这个路径下载 Excel 文件。

2. 上传 Excel 文件

@PostMapping("/excelUpload")
public Result excelUpload(@RequestParam("uploadExcel") MultipartFile file)

执行流程：

1.检查文件是否选择

如果 file.getOriginalFilename() 是空字符串，就直接返回 "没有选中要上传的文件"。

2.生成新文件名

用 UUID.randomUUID().toString() 生成一个不重复的文件名。获取原文件后缀（比如 .xls / .xlsx），拼接成新的文件名。

3.保存文件到服务器

File targetFile = new File(excel, newFileName) 创建目标文件对象（excel 是存放目录）。file.transferTo(targetFile) 把上传的文件保存到指定目录。

4.返回结果

把新文件名返回给前端，用于后续解析。

3. 从 Excel 导入数据到数据库

@PostMapping("/parsefile/{fileName}")
public Result parsefile(@PathVariable("fileName") String fileName,HttpSession session)

执行流程：

步骤 1：准备文件读取

1. 从 session 获取当前登录用户。
2. 组合文件路径 basePath = excel + fileName。
3. 用 Apache POI 打开 .xls 文件：
   1. POIFSFileSystem → 处理 Excel 二进制流。
   2. HSSFWorkbook → 代表 Excel 工作簿对象。

步骤 2：把 Excel 转成二维数组

{
  "status": "success",
  "data": "数据导入完成！"
}