从其他Office文档操作库迁移到Apache POI：代码示例与注意事项

在日常的开发中，我们经常需要对Office文档进行读写操作。而在Java语言中，Apache POI是一个非常流行的用于操作Microsoft Office格式文件（包括Word、Excel和PowerPoint等）的开源库。

如果你之前使用过其他的Office文档操作库，比如JExcel或者iText，现在想要迁移到Apache POI，本文将提供一些代码示例和注意事项供参考。

代码示例

读取Excel文件

首先，我们来看一个读取Excel文件的示例：

import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;

import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;

public class ExcelReader {

    public static void main(String[] args) {
        try (FileInputStream fis = new FileInputStream(new File("path/to/excel.xlsx"))) {

            Workbook workbook = new XSSFWorkbook(fis);
            Sheet sheet = workbook.getSheetAt(0);

            for (Row row : sheet) {
                for (Cell cell : row) {
                    switch (cell.getCellType()) {
                        case STRING:
                            System.out.print(cell.getStringCellValue() + "\t");
                            break;
                        case NUMERIC:
                            System.out.print(cell.getNumericCellValue() + "\t");
                            break;
                        case BOOLEAN:
                            System.out.print(cell.getBooleanCellValue() + "\t");
                            break;
                        default:
                            System.out.print("\t");
                    }
                }
                System.out.println();
            }

        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

写入Excel文件

接下来，我们来看一个写入Excel文件的示例：

import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;

import java.io.FileOutputStream;
import java.io.IOException;

public class ExcelWriter {

    public static void main(String[] args) {
        try (Workbook workbook = new XSSFWorkbook()) {
            Sheet sheet = workbook.createSheet("Sheet1");

            Row headerRow = sheet.createRow(0);
            headerRow.createCell(0).setCellValue("姓名");
            headerRow.createCell(1).setCellValue("年龄");
            headerRow.createCell(2).setCellValue("性别");

            Row dataRow = sheet.createRow(1);
            dataRow.createCell(0).setCellValue("张三");
            dataRow.createCell(1).setCellValue(25);
            dataRow.createCell(2).setCellValue("男");

            try (FileOutputStream fos = new FileOutputStream("path/to/excel.xlsx")) {
                workbook.write(fos);
            }

        } catch (IOException e) {
            e.printStackTrace();
        }

    }
}

注意事项

依赖配置

在使用Apache POI之前，你需要在你的项目中添加相关的依赖。对于Maven项目，你可以在pom.xml文件中添加以下依赖配置：

<dependencies>
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi</artifactId>
        <version>4.1.2</version>
    </dependency>
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi-ooxml</artifactId>
        <version>4.1.2</version>
    </dependency>
</dependencies>

如果你使用的是Gradle项目，则可以在build.gradle文件中添加以下依赖配置：

dependencies {
    implementation 'org.apache.poi:poi:4.1.2'
    implementation 'org.apache.poi:poi-ooxml:4.1.2'
}

文件格式

在使用Apache POI操作不同格式的Office文档时，需要使用相应的类。例如，要读取.xlsx格式的Excel文件，需要使用XSSFWorkbook和XSSFSheet等类；同样，要读取.docx格式的Word文件，需要使用XWPFDocument和XWPFParagraph等类。

版本兼容性

在迁移到Apache POI之前，你可能已经使用了其他的Office文档操作库，比如JExcel或者iText。而这些库可能使用了不同的API和文件格式。在迁移过程中，需要注意版本兼容性和API的差异。

此外，Apache POI使用了Java处理XML的API，因此在使用之前需要确保正确配置了XML解析器。

总结

本文简要介绍了如何迁移从其他Office文档操作库到Apache POI，并提供了一些代码示例和注意事项。希望通过本文的介绍，你能更好地使用Apache POI进行Office文档的读写操作。

参考链接：

• Apache POI官方网站