1.POI说明

Apache POI是Apache软件基金会的开源代码库，
POI提供对Microsoft Office格式档案读和写的功能。

POI支持的格式：
HSSF － 提供读写Microsoft Excel格式档案的功能。
XSSF － 提供读写Microsoft Excel OOXML格式档案的功能。
HWPF － 提供读写Microsoft Word格式档案的功能。
HSLF － 提供读写Microsoft PowerPoint格式档案的功能。
HDGF － 提供读写Microsoft Visio格式档案的功能。

其中Excel支持HSSF和XSSF两种格式:
HSSF对应Excel 2003及以前版本生成的文件格式(.xls)，
XSSF对应Excel 2007及之后版本生成的文件格式(.xlsx)。
本文仅介绍Excel文件的读写，
并且使用HSSF读写.xls格式的Excel文件。

2.HSSF说明

HSSF是Horrible Spread Sheet Format的缩写，
即糟糕的表格格式。
HSSF为读取操作提供了两类API：
User Model,Event Model和Event User Model，
即"用户模型", "事件模型"和"事件-用户-模型"。

User Model是类似于Dom方式的解析，
API使用起来很简单，
但是占用内存，处理效率低。
Event Model是类似于Sax方式的解析，
比User Model更节约内存，效率更高，
但是抽象程度相比User Model更低，
相比User Model功能更少，
API使用门槛也要高一些。
Event User Model是结合了上面的两个优点，
基于Event Model的流解析方式进一步封装，
提供了类似User Model更友好的操作方式。

学过Xml的都知道，
Dom解析就是将文件全部读入内存,
对文件内部的结构进行建模成一颗Dom树的过程。
下面是POI对Excel的建模的Dom树结构：

本文下面仅介绍使用User Model方式，
操作HSSF(.xls)格式的文件，
其他方式请参考后续文章。

3.Jar包依赖

在pom.xml中添加如下依赖：

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

4.Excel文件

现在有需要导入的city_date.xls,
内容如下：

5.Area对象

根据上面的Excel文件内容，
抽象出来Area对象，
其中属性一一对应文件中列名。

package org.apache.poi;

import java.util.Date;

public class Area {

    /** 省份 */
    private String province;
    /** 城市 */
    private String city;
    /** 城市排名 */
    private Integer order;
    /** 城市纪念日 */
    private Date cityDay;
    /** 是否一线大城市 */
    private Boolean isBigCity;
    /** 城市描述 */
    private String description;

    public String getProvince() {
        return province;
    }

    public void setProvince(String province) {
        this.province = province;
    }

    public String getCity() {
        return city;
    }

    public void setCity(String city) {
        this.city = city;
    }

    public Integer getOrder() {
        return order;
    }

    public void setOrder(Integer order) {
        this.order = order;
    }

    public Date getCityDay() {
        return cityDay;
    }

    public void setCityDay(Date cityDay) {
        this.cityDay = cityDay;
    }

    public Boolean getIsBigCity() {
        return isBigCity;
    }

    public void setIsBigCity(Boolean isBigCity) {
        this.isBigCity = isBigCity;
    }

    public String getDescription() {
        return description;
    }

    public void setDescription(String description) {
        this.description = description;
    }

    @Override
    public String toString() {
        return "Area [province=" + province + ", city=" + city + ", order=" + order + ", cityDay=" + cityDay
                + ", isBigCity=" + isBigCity + ", description=" + description + "]";
    }

}

6.导入Excel

解析.xls格式文件，
转换为内存中的Java对象。

public static List<Area> importExcel() throws Exception {
    InputStream fileIn = null;
    HSSFWorkbook workbook = null;
    try {
        // 1.创建文件输入流
        fileIn = new FileInputStream("city_date.xls");
        // 2.创建Excel工作簿对象
        workbook = new HSSFWorkbook(fileIn);
        // 校验excel中的工作表是否存在
        int numberOfSheets = workbook.getNumberOfSheets();
        if (numberOfSheets <= 0) {
            return null;
        }
        // 3.获取Excel工作表对象
        HSSFSheet sheetAt = workbook.getSheetAt(0);
        ArrayList<Area> citys = new ArrayList<>();
        // 工作表中至少要有一行数据
        if (sheetAt.getLastRowNum() < 0) {
            return null;
        }

        // 4.循环读取表格数据
        for (Row row : sheetAt) {
            // 首行（即表头）不读取,后面可以校验表头
            if (row.getRowNum() == 0) {
                continue;
            }
            // 一行至少有6列信息，无法解析需要跳过
            if (row.getLastCellNum() < 5) {
                continue;
            }
            // 读取当前行中单元格数据，索引从0开始
            String province = row.getCell(0).getStringCellValue();
            String cityName = row.getCell(1).getStringCellValue();
            Integer order = (int) row.getCell(2).getNumericCellValue();
            Date cityDay = row.getCell(3).getDateCellValue();
            Boolean isBigCity = row.getCell(4).getBooleanCellValue();
            String description = row.getCell(5).getStringCellValue();

            Area city = new Area();
            city.setProvince(province);
            city.setCity(cityName);
            city.setOrder(order);
            city.setCityDay(cityDay);
            city.setIsBigCity(isBigCity);
            city.setDescription(description);
            citys.add(city);

            return citys;
        }
    } finally {
        // 5.关闭流
        if (fileIn != null) {
            fileIn.close();
        }
        if (workbook != null) {
            workbook.close();
        }
    }
    return null;
}

7.导出Excel

将内存中的Java对象，
写入到.xls格式文件。
导出后的文件即为上面第4步的city_date.xls。

public static void exportExcel() throws Exception {
    HSSFWorkbook workbook = null;
    FileOutputStream fileOut = null;
    try {
        // 1.需要导出的数据
        List<Area> citys = new ArrayList<>();
        Area changzhou = new Area();
        changzhou.setProvince("江苏省");
        changzhou.setCity("常州市");
        changzhou.setOrder(88);
        changzhou.setCityDay(new Date());
        changzhou.setIsBigCity(false);
        changzhou.setDescription("常州是个美丽的旅游和实业城市~");
        citys.add(changzhou);

        // 2.在内存中创建一个excel文件
        workbook = new HSSFWorkbook();
        // 3.创建工作簿
        HSSFSheet sheet = workbook.createSheet("city sheet");
        // 4.创建标题行
        HSSFRow titlerRow = sheet.createRow(0);
        titlerRow.createCell(0).setCellValue("省份");
        titlerRow.createCell(1).setCellValue("城市");
        titlerRow.createCell(2).setCellValue("排名");
        titlerRow.createCell(3).setCellValue("纪念日");
        titlerRow.createCell(4).setCellValue("大城市");
        titlerRow.createCell(5).setCellValue("描述");

        // 获取最后一行的行号
        int lastRowNum = sheet.getLastRowNum();
        // 5.遍历数据,创建数据行
        for (Area city : citys) {
            // 在最后一行后面添加新的一行
            lastRowNum++;
            HSSFRow dataRow = sheet.createRow(lastRowNum);
            dataRow.createCell(0).setCellValue(city.getProvince());
            dataRow.createCell(1).setCellValue(city.getCity());
            dataRow.createCell(2).setCellValue(city.getOrder());

            HSSFCell dateCell = dataRow.createCell(3);
            setDateStyle(dateCell, workbook);
            dateCell.setCellValue(city.getCityDay());

            dataRow.createCell(4).setCellValue(city.getIsBigCity());
            dataRow.createCell(5).setCellValue(city.getDescription());
        }
        for (int i = 0; i <= 5; i++) {
            // 设置自适应列宽,必须数据全部插入后才调用
            sheet.autoSizeColumn(i);
        }
        // 6.指定输出的文件名
        String fileName = "city_date.xls";
        fileOut = new FileOutputStream(fileName);
        // 7.写文件
        workbook.write(fileOut);
    } finally {
        // 8.关闭流
        if (workbook != null) {
            workbook.close();
        }
        if (fileOut != null) {
            fileOut.close();
        }
    }
}

private static void setDateStyle(HSSFCell cell, HSSFWorkbook wb) {
    HSSFDataFormat format = wb.createDataFormat();
    HSSFCellStyle style = wb.createCellStyle();
    style.setDataFormat(format.getFormat("yyyy年MM月dd日"));
    cell.setCellStyle(style);
}

8.头文件说明

上面的代码使用到的类如下：

import org.apache.poi.hssf.usermodel.HSSFCell;
import org.apache.poi.hssf.usermodel.HSSFCellStyle;
import org.apache.poi.hssf.usermodel.HSSFDataFormat;
import org.apache.poi.hssf.usermodel.HSSFRow;
import org.apache.poi.hssf.usermodel.HSSFSheet;
import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.apache.poi.ss.usermodel.Row;

9.参考文章

Busy Developers' Guide to HSSF and XSSF Features
POI操作Excel
Java POI操作Excel(User Model)
Java使用POI操作Excel