一、配置第三方库

查阅了网上的资料后，发现Java程序操作Excel表格的库中使用的比较多的是这个叫Apache POI API的库：

对应的maven依赖为：

<!-- https://mvnrepository.com/artifact/org.apache.poi/poi-ooxml -->

<dependency>

    <groupId>org.apache.poi</groupId>

    <artifactId>poi-ooxml</artifactId>

    <version>5.0.0</version>

</dependency>

二、使用`Apache POI API`

1. 打开Excel文件

这一步相当于读取excel文件中的信息到对象中，方便我们进一步对数据进行操作（比较像Java程序中数据库映射的POJO对象）。当前我使用的文件是2007以上的，即后缀名为xlxs，此时创建对象的语句为：

Workbook book = new XSSFWorkbook("xxx.xlxs");

即在构造函数中填入对应的路径即可。当然，此外还有其他的构造函数，如下图所示：

但个人觉得最为常用的应该是填入路径和File类型的对象了。

2. 选择对应的sheet

当我们使用Excel时可以发现左下角会有标注各个Sheet，即一个Excel文件像是一本书一样，里面有很多个表格，当我们需要操作一个表格时需要先切换到对应的表格页，如下图所示：

在程序中我们可以使用WorkBook的接口函数获取到一个表格页（即Sheet）：

一共两种获取方式：

根据Sheet的名称获取：book.getSheet("Sheet1")
根据Sheet的索引获取：book.getSheetAt(0);

这两个方法的返回值都是Sheet接口类型。

3. Sheet接口的基本使用

3.1 获取开头行和结束行

在这个系统中，行号是从0开始数的，也就是说在程序中用到的行号是excel表格中显示的行号-1。

这里的测试表格采用数据库课程使用到的数据库表（即一个简单的员工数据表），如下图所示：

获取开头行和结束行：

// public interface Sheet

int getFirstRowNum();

int getLastRowNum();

示例程序：

@Test

public void t1() throws IOException {

    Workbook book = new XSSFWorkbook("excel/test.xlsx");

    Sheet table = book.getSheet("Sheet1");

    System.out.println(table.getFirstRowNum());

    System.out.println(table.getLastRowNum());

}

测试结果：

即开头行为第1行，在Java中为0，结束行为第18行，在Java程序中得到17。

3.2 获取Row对象

Row对象表示的是数据表中某一行的数据，可以通过以下方式获取一个Row对象：

// interface Sheet

Row getRow(int var1);

示例（获取包含所有第一行的数据的Row对象）：

Row row = table.getRow(0);

4. Row对象的使用

4.1 获取本行的头尾索引

① 获取当前行第一个Cell对象的索引：row.getFirstCellNum()

tips: Cell对象为包含一个单元格所有信息的对象，这里即为获取本行第一个非空的单元格的下标

② 获取当前行最后一个Cell对象的索引+1：row.getLastCellNum()

注意这里并不是最后一个Cell对象的索引，而是该值+1（和前面的Sheet.getLastCellNum()有所不同），例如我们用程序打印出上面员工表第一行的firstCellNum和lastCellNum：

@Test

public void t1() throws IOException {

    Workbook book = new XSSFWorkbook("excel/test.xlsx");

    Sheet table = book.getSheet("Sheet1");

    Row row = table.getRow(0);

    System.out.println(row.getFirstCellNum());

    System.out.println(row.getLastCellNum());

}

运行结果：

而员工表最后一列的索引为6，这说明了getLastCellNum()这个函数得到的是最后一个Cell的索引+1

对比sheet.getLastRowNum()和 row.getLastCellNum()也能发现不同之处（一个是获取索引，一个是获取索引+1）：

// sheet.getLastRowNum()

public int getLastRowNum() {

    return this._rows.isEmpty() ? -1 : (Integer)this._rows.lastKey();

}

// row.getLastCellNum()

public short getLastCellNum() {

    return (short)(this._cells.size() == 0 ? -1 : (Integer)this._cells.lastKey() + 1);

}

4.2 获取Cell对象

一行中有多个Cell对象（即单元格对象），我们可以通过row.getCell(int index)获取Cell对象，例如我们这里循环获取第2行的每一个Cell对象，并且将它们分别打印出来：

Row row = table.getRow(1);

for (int i = 0; i < row.getLastCellNum(); i++) {

    Cell cell = row.getCell(i);

    System.out.println(cell);

}

Excel第2行：

运行结果：

此外，我们还可以通过迭代器的方式获取该行的每个Cell对象，获取迭代器的的方法为row.cellIterator()，最后将它们打印出来：

Row row = table.getRow(1);

Iterator<Cell> cellIterator = row.cellIterator();

while (cellIterator.hasNext()) {

    Cell cell = cellIterator.next();

    System.out.println(cell);

}

运行结果与上同。

阅读源码后发现在JDK1.8之后，当一个对象实现了Iterable接口之后，就已经实现了forEach方法，因此我们也可以使用这个方法来遍历Row对象中的Cell：

Row row = table.getRow(1);

row.forEach(cell -> {

    System.out.print(cell+", ");

    System.out.println(cell.getCellType());

});

同理，Sheet对象也可以使用forEach进行遍历。

5. Cell对象的使用

5.1 获取单元格值的类型

使用方法：

// public interface Cell

CellType getCellType();

返回类型为CellType，它是一个枚举类型，源码如下：

public enum CellType {

    _NONE(-1),

    NUMERIC(0),

    STRING(1),

    FORMULA(2),

    BLANK(3),

    BOOLEAN(4),

    ERROR(5);

}

一般Excel中填写的内容对应的类型：

没有填值（空单元格）：BLANK
数字（整数或小数）：NUMERIC
字符串：STRING
公式：FORMULA
TRUE或FALSE：BOOLEAN

准备如下的测试行：

执行以下代码（即将上面这行单元格的值和类型都打印出来）：

Row row = table.getRow(18);

Iterator<Cell> cellIterator = row.cellIterator();

while (cellIterator.hasNext()) {

    Cell cell = cellIterator.next();

    System.out.print(cell+", ");

    System.out.println(cell.getCellType());

}

运行结果：

5.2 获取单元格的值

方法：cell.getXXXValue()

例如如果这个单元格是数字类型的，就使用getNumericCellValue()即可

需求，获取所有SALESMAN员工的工资和：

5.3 设置单元格的值

和前面获取值类似地，可以使用：cell.setValue(Object value)的方法设置单元格的值：

但需要注意的是，这里仅是对存在于内存中的对象进行属性的设置，并不会直接影响到Excel表格中实际的内容，如果需要用book对象来修改表格内容则还需要使用保存功能来执行。（和POJO是类似的，需要先修改对象的值，然后再用整个对象去修改数据库中实际的值）

6. 保存表格

步骤如下：

新建一个FileOutputStream对象，相当于是一个文件，如果是已存在的文件则进行覆盖操作
使用Workbook对象的void write(OutputStream var1)方法，填入的参数为前面的FileOutputStream对象

这样表格就保存完成了。

示例：

@Test

public void t() throws IOException {

    Workbook book = new XSSFWorkbook();

    Sheet table = book.createSheet();

    Row row = table.createRow(0);

    Cell firstCell = row.createCell(0);

    firstCell.setCellValue("Hello");

    Cell secondCell = row.createCell(1);

    secondCell.setCellValue("World");

    FileOutputStream fos = new FileOutputStream("excel/output.xlsx");

    book.write(fos);

    book.close();

}

运行效果：

如果希望修改原表格只需在fos的路径上填原表格就可以进行覆盖了

巴特西

使用Java操作Excel表格

一、配置第三方库

二、使用`Apache POI API`

1. 打开Excel文件

2. 选择对应的sheet

3. Sheet接口的基本使用

3.1 获取开头行和结束行

3.2 获取Row对象

4. Row对象的使用

4.1 获取本行的头尾索引

4.2 获取Cell对象

5. Cell对象的使用

5.1 获取单元格值的类型

5.2 获取单元格的值

5.3 设置单元格的值

6. 保存表格

最新文章

热门文章

巴特西

使用Java操作Excel表格

一、配置第三方库

二、使用Apache POI API

1. 打开Excel文件

2. 选择对应的sheet

3. Sheet接口的基本使用

3.1 获取开头行和结束行

3.2 获取Row对象

4. Row对象的使用

4.1 获取本行的头尾索引

4.2 获取Cell对象

5. Cell对象的使用

5.1 获取单元格值的类型

5.2 获取单元格的值

5.3 设置单元格的值

6. 保存表格

最新文章

热门文章

二、使用`Apache POI API`