1. 概述
Apache POI 是Java社区中处理Microsoft Office文档的流行开源库。它使得开发者能够轻松地程序化操作Word文档和Excel电子表格。
在处理大型Excel电子表格时，锁定表头行是一种常见做法。这有助于提升用户体验，便于数据浏览和分析。
本教程将指导您如何使用Apache POI来锁定Excel电子表格的表头行。
2. 依赖
首先，我们需要在pom.xml文件中添加以下Maven依赖：
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi</artifactId>
<version>5.2.5</version>
</dependency>
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-ooxml</artifactId>
<version>5.2.5</version>
</dependency>
<dependency>
poi库是处理旧版二进制Excel文件（xls）的基础。如果我们需要处理基于XML的Excel文件（xlsx），则还需要额外的poi-ooxml库。
3. 工作簿创建
在深入学习锁定表头行之前，让我们快速了解如何使用Apache POI创建Excel工作表并填充数据。
首先，我们需要设置Workbook和Sheet实例：
Workbook workbook = new XSSFWorkbook();
Sheet sheet = workbook.createSheet("MySheet");
如果希望创建二进制Excel文件而不是XML基础的，可以将XSSFWorkbook替换为HSSFWorkbook。
接下来，我们将创建表头行并添加表头单元格的值：
Row headerRow = sheet.createRow(0);
Cell headerCell1 = headerRow.createCell(0);
headerCell1.setCellValue("Header 1");
Cell headerCell2 = headerRow.createCell(1);
headerCell2.setCellValue("Header 2");
设置好表头行后，我们将在工作表中添加更多数据：
Row dataRow = sheet.createRow(1);
Cell dataCell1 = dataRow.createCell(0);
dataCell1.setCellValue("Data 1");
Cell dataCell2 = dataRow.createCell(1);
dataCell2.setCellValue("Data 2");
4. 锁定
现在，我们将进入关键部分。Apache POI提供了一个名为createFreezePane()的简单方法，用于锁定行和列。
createFreezePane()方法接受两个参数：colSplit和rowSplit。colSplit参数表示将保留不锁定的列索引，而rowSplit参数表示锁定到哪一行的行索引。
4.1. 锁定单行
通常情况下，我们会锁定第一行以确保表头始终可见，当我们滚动查看数据时：
sheet.createFreezePane(0, 1);
当我们向下滚动时，会注意到第一行始终保持锁定且固定在顶部：
4.2. 锁定多行
在某些场景下，可能需要锁定多行，以便用户在探索数据时获得更多上下文。为此，我们可以相应地调整rowSplit参数：
sheet.createFreezePane(0, 2);
在这个例子中，前两行在滚动时始终保持可见。
4.3. 锁定列
除了锁定行，Apache POI还允许我们锁定列。这对于拥有大量列并希望保持特定列作为参考的情况非常有用：
sheet.createFreezePane(1, 0);
在这种情况下，第一列在工作表中被锁定。
5. 总结
本文介绍了如何使用Apache POI来锁定Excel电子表格的表头行，这是一款强大的处理Microsoft Office文档的Java库。
通过使用createFreezePane()方法，我们可以根据具体需求定制锁定行为，如固定表头、锁定多行以提供上下文或锁定列。这提高了数据浏览和分析的用户体验。
如往常一样，本文的源代码可在GitHub上找到。