Java如何实现用户数据的Excel导入导出_Apache POI实战讲解-java教程-PHP中文网

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

P粉602998670

发布： 2025-12-17 08:51:03

原创

283人浏览过

答案：本文介绍如何使用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：

立即学习“Java免费学习笔记（深入）”；

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

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

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

实现Excel数据导出

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

PHP5 和 MySQL 圣经

本书是全面讲述PHP与MySQL的经典之作，书中不但全面介绍了两种技术的核心特性，还讲解了如何高效地结合这两种技术构建健壮的数据驱动的应用程序。本书涵盖了两种技术新版本中出现的最新特性，书中大量实际的示例和深入的分析均来自于作者在这方面多年的专业经验，可用于解决开发者在实际中所面临的各种挑战。

485

查看详情

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等功能。

以上就是Java如何实现用户数据的Excel导入导出_Apache POI实战讲解的详细内容，更多请关注php中文网其它相关文章！