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;}@Overridepublic 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