首页 > 文章 > java教程

JavaExcel导入导出实战教程

时间：2026-01-02 11:51:07 385浏览收藏

一分耕耘，一分收获！既然打开了这篇文章《Java实现Excel导入导出，Apache POI实战教程》，就坚持看下去吧！文中内容包含等等知识点...希望你能在阅读本文后，能真真实实学到知识或者帮你解决心中的疑惑，也欢迎大佬或者新人朋友们多留言评论，多给建议！谢谢！

答案：本文介绍如何使用Apache POI在Java中实现Excel的导入导出功能。首先通过Maven引入poi-ooxml依赖，定义User实体类用于封装用户数据；接着利用XSSFWorkbook和XSSFSheet创建Excel文件并写入表头与数据，完成导出功能；导入时读取Excel首张工作表，跳过表头行，逐行解析单元格内容并转换为User对象列表，注意处理空值与日期格式；最后在Spring MVC中提供Web接口，支持浏览器下载及文件上传解析。建议对大文件采用SXSSFWorkbook优化内存使用。

Java如何实现用户数据的Excel导入导出_Apache POI实战讲解

在Java开发中，处理Excel文件是常见的业务需求，比如从Excel导入用户数据到系统，或将系统中的用户信息导出为Excel文件。Apache POI 是一个强大的开源库，专门用于操作Microsoft Office文档，尤其擅长处理Excel（.xls 和 .xlsx）格式。本文将通过实际案例，讲解如何使用 Apache POI 实现用户数据的导入与导出功能。

引入Apache POI依赖

要使用POI，首先需要在项目中添加Maven依赖。如果你使用的是Spring Boot或普通Maven项目，可以在pom.xml中加入以下内容：

  org.apache.poi
  poi-ooxml
  5.2.3

这个依赖包含了操作.xlsx格式所需的核心类，如XSSFWorkbook、XSSFSheet等。

定义用户实体类

假设我们要处理的用户数据包含ID、姓名、邮箱和注册时间。创建一个简单的Java Bean：

public class User {
  private Long id;
  private String name;
  private String email;
  private LocalDateTime registerTime;

  // 构造方法、getter/setter省略
}

该类将作为数据传输的载体，在导入导出过程中使用。

实现Excel数据导出

导出功能的目标是将List写入Excel文件并提供下载。核心步骤包括：创建工作簿、创建工作表、写入表头、遍历数据写入行。

public void exportUsers(List users, OutputStream out) throws IOException {
  XSSFWorkbook workbook = new XSSFWorkbook();
  XSSFSheet sheet = workbook.createSheet("用户列表");

  // 创建表头
  XSSFRow headerRow = sheet.createRow(0);
  headerRow.createCell(0).setCellValue("ID");
  headerRow.createCell(1).setCellValue("姓名");
  headerRow.createCell(2).setCellValue("邮箱");
  headerRow.createCell(3).setCellValue("注册时间");

  // 填充数据
  int rowNum = 1;
  for (User user : users) {
    XSSFRow row = sheet.createRow(rowNum++);
    row.createCell(0).setCellValue(user.getId());
    row.createCell(1).setCellValue(user.getName());
    row.createCell(2).setCellValue(user.getEmail());
    row.createCell(3).setCellValue(user.getRegisterTime().toString());
  }

  workbook.write(out);
  workbook.close();
}

调用此方法时，可以将response.getOutputStream()传入，实现浏览器下载。

实现Excel数据导入

导入功能是从上传的Excel文件中读取数据并转换为List。需要注意空值校验和日期格式处理。

public List importUsers(InputStream in) throws IOException {
  List userList = new ArrayList<>();
  XSSFWorkbook workbook = new XSSFWorkbook(in);
  XSSFSheet sheet = workbook.getSheetAt(0);

  int rowIndex = 0;
  for (Row row : sheet) {
    if (rowIndex == 0) {
      rowIndex++;
      continue; // 跳过表头
    }

    User user = new User();
    user.setId((long) row.getCell(0).getNumericCellValue());
    user.setName(row.getCell(1).getStringCellValue());
    user.setEmail(row.getCell(2).getStringCellValue());

    String dateStr = row.getCell(3).getStringCellValue();
    user.setRegisterTime(LocalDateTime.parse(dateStr));

    userList.add(user);
  }

  workbook.close();
  return userList;
}

实际开发中建议增加异常捕获、空值判断、类型转换容错机制，避免因脏数据导致程序崩溃。

Web层整合示例（Spring MVC）

在Controller中提供导出接口：

@GetMapping("/export")
public void export(HttpServletResponse response) throws IOException {
  List users = userService.getAllUsers();
  response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
  response.setHeader("Content-Disposition", "attachment; filename=users.xlsx");

  excelService.exportUsers(users, response.getOutputStream());
}

导入接口示例：

@PostMapping("/import")
public String importUsers(@RequestParam("file") MultipartFile file) {
  try (InputStream in = file.getInputStream()) {
    List users = excelService.importUsers(in);
    userService.saveAll(users);
    return "success";
  } catch (IOException e) {
    return "error";
  }
}

基本上就这些。Apache POI虽然功能强大，但使用时要注意内存消耗，对于超大文件建议结合SXSSFWorkbook或流式读取方式优化。掌握这些基础操作后，你可以轻松扩展支持样式、公式、多Sheet等功能。

今天关于《JavaExcel导入导出实战教程》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于java的内容请关注golang学习网公众号！

前往漫画官网入口并下载 ➜

java