在实际项目中，用到的导入导出excel太多了，而且对于web管理系统更为常见，因此封装了导入导出的工具类。代码中依赖了slf4j日志包，commons-io包的IOUtils关闭流，commons-lang和commons-collections包等包。
1. 导出Excel封装的工具类:ExcelExporter
在实际中导出excel非常常见,于是自己封装了一个导出数据到excel的工具类，先附上代码，最后会写出实例和解释。支持03和07两个版本的 excel。
HSSF导出的是xls的excel，XSSF导出的是xlsx的excel，SXSSF导出的也是xlsx的excel，只不过这个用于处理数据量大的情况，生成文件之后数据不会留在内存中。
package cn.qs.utils.export; import java.io.File; import java.io.FileNotFoundException; import java.io.FileOutputStream; import java.io.IOException; import java.io.OutputStream; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; import org.apache.commons.collections.MapUtils; import org.apache.commons.io.IOUtils; import org.apache.commons.lang.ArrayUtils; import org.apache.poi.hssf.usermodel.HSSFCell; import org.apache.poi.hssf.usermodel.HSSFCellStyle; import org.apache.poi.hssf.usermodel.HSSFFont; import org.apache.poi.hssf.usermodel.HSSFWorkbook; import org.apache.poi.ss.usermodel.Cell; import org.apache.poi.ss.usermodel.CellStyle; import org.apache.poi.ss.usermodel.Font; import org.apache.poi.ss.usermodel.Row; import org.apache.poi.ss.usermodel.Sheet; import org.apache.poi.ss.usermodel.Workbook; import org.apache.poi.ss.util.CellRangeAddress; import org.apache.poi.xssf.streaming.SXSSFSheet; import org.apache.poi.xssf.streaming.SXSSFWorkbook; import org.slf4j.Logger; import org.slf4j.LoggerFactory; public class ExcelExporter { public static enum OfficeVersion { OFFICE_03, OFFICE_07; } private static final Logger LOGGER = LoggerFactory.getLogger(ExcelExporter.class); private String[] headerNames; private Workbook workBook; private Sheet sheet; /** * * @param headerNames * 表头 * @param sheetName * sheet的名称 * @param excelVerson * excel的版本 */ public ExcelExporter(String[] headerNames, String sheetName, OfficeVersion officeVersion) { this.headerNames = headerNames; // 创建一个工作簿 if (OfficeVersion.OFFICE_07.equals(officeVersion)) { // workBook = new XSSFWorkbook();//处理07版本excel workBook = new SXSSFWorkbook();// 处理07版本，但是适用于大数据量，导出之后数据不会占用内存 } else if (OfficeVersion.OFFICE_03.equals(officeVersion)) { workBook = new HSSFWorkbook(); } // 创建一个工作表sheet sheet = workBook.createSheet(sheetName); initHeader(); } /** * 初始化表头信息 */ private void initHeader() { // 创建第一行 Row row = sheet.createRow(0); Cell cell = null; // 创建表头 for (int i = 0; i < headerNames.length; i++) { cell = row.createCell(i); cell.setCellValue(headerNames[i]); setCellStyle(cell); } } /** * 设置单元格样式 * * @param cell * 单元格 */ public void setCellStyle(Cell cell) { // 设置样式 CellStyle cellStyle = workBook.createCellStyle(); cellStyle.setAlignment(HSSFCellStyle.ALIGN_CENTER); // 设置字体居中 // 设置字体 Font font = workBook.createFont(); font.setFontName("宋体"); font.setBoldweight(HSSFFont.BOLDWEIGHT_BOLD);// 字体加粗 font.setFontHeightInPoints((short) 13); cellStyle.setFont(font); cell.setCellStyle(cellStyle); } /** * 创建行内容(每一行的数据装在list中) * * @param datas * 每一行的数据 * @param rowIndex * 行号(从1开始) */ public void createTableRow(List<String> datas, int rowIndex) { // 创建第i行 Row row = sheet.createRow(rowIndex); Cell cell = null; // 写入数据 for (int index = 0, length = datas.size(); index < length; index++) { // 参数代表第几列 cell = row.createCell(index); cell.setCellType(HSSFCell.CELL_TYPE_STRING); cell.setCellValue(datas.get(index)); } } /** * * @param datas * 数据,每一个map都是一行 * @param keys * key[i]代表从map中获取keys[i]的值作为第i列的值,如果传的是null默认取表头 */ public void createTableRows(List<Map<String, Object>> datas, String[] keys) { for (int i = 0, length_1 = datas.size(); i < length_1; i++) { if (ArrayUtils.isEmpty(keys)) { keys = headerNames; } // 创建行(从第二行开始) Map<String, Object> data = datas.get(i); Row row = sheet.createRow(i + 1); Cell cell = null; for (int j = 0, length_2 = keys.length; j < length_2; j++) { // 单元格获取map中的key String key = keys[j]; String value = MapUtils.getString(data, key, ""); cell = row.createCell(j); cell.setCellType(HSSFCell.CELL_TYPE_STRING); cell.setCellValue(value); } } } /** * 根据表头自动调整列宽度 */ public void autoAllSizeColumn() { if (sheet instanceof SXSSFSheet) {// 如果是SXSSFSheet，需要调用trackAllColumnsForAutoSizing方法一次 SXSSFSheet tmpSheet = (SXSSFSheet) sheet; tmpSheet.trackAllColumnsForAutoSizing(); } for (int i = 0, length = headerNames.length; i < length; i++) { sheet.autoSizeColumn(i); } } /** * 将数据写出到excel中 * * @param outputStream */ public void exportExcel(OutputStream outputStream) { // 导出之前先自动设置列宽 this.autoAllSizeColumn(); try { workBook.write(outputStream); } catch (IOException e) { LOGGER.error(" exportExcel error", e); } finally { IOUtils.closeQuietly(outputStream); } } /** * 合并单元格(起始行列都包括在里面) * * @param startRow * 起始行 * @param endRow * 结束行 * @param startCol * 起始列 * @param endCol * 结束列 */ public void mergeCell(int startRow, int endRow, int startCol, int endCol) { CellRangeAddress region = new CellRangeAddress(startRow, endRow, startCol, endCol); sheet.addMergedRegion(region); } /** * 将数据写出到excel中 * * @param outputFilePath */ public void exportExcel(String outputFilePath) { // 导出之前先自动设置列宽 this.autoAllSizeColumn(); FileOutputStream outputStream = null; try { outputStream = new FileOutputStream(outputFilePath); workBook.write(outputStream); } catch (IOException e) { LOGGER.error(" exportExcel error", e); } finally { IOUtils.closeQuietly(outputStream); } } public static void main(String[] args) { test2(); } private static void test2() { ExcelExporter hssfWorkExcel = new ExcelExporter(new String[] { "姓名", "年龄" }, "人员基本信息", OfficeVersion.OFFICE_03); List<Map<String, Object>> datas = new ArrayList<>(); for (int i = 0; i < 10; i++) { Map data = new HashMap<>(); data.put("name", "tttttttttttttt" + i); data.put("age", "age" + i); datas.add(data); } hssfWorkExcel.createTableRows(datas, new String[] { "name", "age" }); hssfWorkExcel.mergeCell(1, 2, 0, 1); try { hssfWorkExcel.exportExcel(new FileOutputStream(new File("e:/test1.xls"))); } catch (FileNotFoundException e) { e.printStackTrace(); } } }
上面的代码逻辑非常简单,创建实例的时候就初始化表头信息和创建sheet。
向excel中填充数据的方式有两种，就是上面的createTableRow方法和createTableRows方法。
createTableRow(List,int)方法就是多次调用此方法，list中数据，int是行号。list中数据依次作为第i行的列数据。
createTableRows(List<Map>,String[])这个方法应该是非常常用的一种方式。我们从数据库查询到的数据大多数映射为Map放入list中，因此上面的方法就比较常用。List<Map>参数就是所有的数据，一个Map代表一行，String[]是Map中的key，也就是数组的第一个元素对应的key作为第一列，第二个元素是作为第二列。如果map数据的key正好与表头一致我们可以传一个null。(因为Map是基于数组+链表，且存入的是无序的,所以无法直接通过map中的key确定列。除非传的数据是LinkedHashMap)。这个方法封装的比较好,如果一条数据中没有对应的值会将此单元格设为空。
下面是自己测试代码:
（1）测试List<String>写入数据，导出03版本的excel
package cn.qs.utils.export; import java.io.File; import java.io.FileNotFoundException; import java.io.FileOutputStream; import java.util.ArrayList; import java.util.List; public class FileTest { public static void main(String[] args) { ExcelExporter hssfWorkExcel = new ExcelExporter(new String[] { "姓名", "年龄" }, "人员基本信息", ExcelExporter.OfficeVersion.OFFICE_03); for (int i = 0; i < 10; i++) { List<String> data = new ArrayList<>(); data.add("namesssssssssssssss水水水水水水水水水水水水水水水水水水水ssssssssssssssss" + i); data.add("" + (i + 20)); hssfWorkExcel.createTableRow(data, i + 1); } try { hssfWorkExcel.exportExcel(new FileOutputStream(new File("e:/test.xls"))); } catch (FileNotFoundException e) { e.printStackTrace(); } } }
结果:
(2)测试List<Map>写入数据，导出07版本的excel
package cn.qs.utils.export; import java.io.File; import java.io.FileNotFoundException; import java.io.FileOutputStream; import java.util.ArrayList; import java.util.List; public class FileTest { public static void main(String[] args) { ExcelExporter hssfWorkExcel = new ExcelExporter(new String[] { "姓名", "年龄" }, "人员基本信息", ExcelExporter.OfficeVersion.OFFICE_07); for (int i = 0; i < 10; i++) { List<String> data = new ArrayList<>(); data.add("namesssssssssssssss水水水水水水水水水水水水水水水水水水水ssssssssssssssss" + i); data.add("" + (i + 20)); hssfWorkExcel.createTableRow(data, i + 1); } try { hssfWorkExcel.exportExcel(new FileOutputStream(new File("e:/test.xlsx"))); } catch (FileNotFoundException e) { e.printStackTrace(); } } }
结果:
2.读取Excel封装的工具类:ExcelReader
此工具类可以读取指定sheet的数据，可以指定每一列对应的header，如果不传默认以第一行作为head；也可以读取所有sheet的数据，以所有sheet的第一行作为head。最终的返回值是List<Map>类型，map的key是表头header。
代码:
package cn.qs.utils.export; import java.io.File; import java.io.FileInputStream; import java.io.InputStream; import java.text.NumberFormat; import java.util.LinkedHashMap; import java.util.LinkedList; import java.util.List; import java.util.Map; import org.apache.commons.collections.CollectionUtils; import org.apache.commons.lang.ArrayUtils; import org.apache.commons.lang.time.DateFormatUtils; import org.apache.commons.lang3.StringUtils; import org.apache.poi.hssf.usermodel.HSSFDateUtil; import org.apache.poi.hssf.usermodel.HSSFWorkbook; import org.apache.poi.ss.usermodel.Cell; import org.apache.poi.ss.usermodel.CellType; import org.apache.poi.ss.usermodel.Row; import org.apache.poi.ss.usermodel.Sheet; import org.apache.poi.ss.usermodel.Workbook; import org.apache.poi.xssf.usermodel.XSSFWorkbook; import org.slf4j.Logger; import org.slf4j.LoggerFactory; public class ExcelReader { private static final Logger LOGGER = LoggerFactory.getLogger(ExcelReader.class); private Workbook workBook; private Map<Sheet, String[]> sheetHeaders; public ExcelReader(String filePath) { this(new File(filePath)); } public ExcelReader(File file) { // 解决版本问题，HSSFWorkbook是97-03版本的xls版本，XSSFWorkbook是07版本的xlsx try { workBook = new XSSFWorkbook(new FileInputStream(file)); LOGGER.debug("是03版本的excel，采用XSSFWorkbook读取"); } catch (Exception e) { try { workBook = new HSSFWorkbook(new FileInputStream(file)); LOGGER.debug("是07版本的excel，采用HSSFWorkbook读取"); } catch (Exception e1) { LOGGER.error("Excel格式不正确", e1); throw new RuntimeException(e1); } } } public ExcelReader(InputStream inputStream) { // 解决版本问题，HSSFWorkbook是97-03版本的xls版本，XSSFWorkbook是07版本的xlsx try { workBook = new XSSFWorkbook(inputStream); LOGGER.debug("是03版本的excel，采用XSSFWorkbook读取"); } catch (Exception e) { try { workBook = new HSSFWorkbook(inputStream); LOGGER.debug("是07版本的excel，采用HSSFWorkbook读取"); } catch (Exception e1) { LOGGER.error("Excel格式不正确", e1); throw new RuntimeException(e1); } } } /** * 初始化sheet和表头信息，默认以每个sheet的第一行作为表头 */ private void initDefaultSheetHeaders() { sheetHeaders = new LinkedHashMap<>(); if (workBook == null) { return; } int numberOfSheets = workBook.getNumberOfSheets(); for (int i = 0; i < numberOfSheets; i++) { Sheet sheet = workBook.getSheetAt(i); String sheetName = workBook.getSheetName(i); LOGGER.debug("sheetName[{}]: {}", i, sheetName); // 默认以第一行作为表头 Row row = sheet.getRow(0); if (row == null) { sheetHeaders.put(sheet, new String[] {}); continue; } String[] headers = new String[] {}; short lastCellNum = row.getLastCellNum(); for (int j = 0; j < lastCellNum; j++) { String cellValue = getCellValue(row.getCell(j)); headers = (String[]) ArrayUtils.add(headers, cellValue); } sheetHeaders.put(sheet, headers); } } public List<Map<String, Object>> readAllSheetDatas() { List<Map<String, Object>> result = new LinkedList<>(); int numberOfSheets = workBook.getNumberOfSheets(); for (int i = 0; i < numberOfSheets; i++) { List<Map<String, Object>> datas = readSheetDatas(i); if (CollectionUtils.isNotEmpty(datas)) { result.addAll(datas); } } return result; } public List<Map<String, Object>> readSheetDatas(int sheetIndex) { if (sheetHeaders == null) { initDefaultSheetHeaders(); } Sheet sheet = workBook.getSheetAt(sheetIndex); return readSheetDatas(sheetIndex, sheetHeaders.get(sheet), 1); } public List<Map<String, Object>> readSheetDatas(int sheetIndex, String[] headers) { return readSheetDatas(sheetIndex, headers, 0); } /** * 读取指定sheet数据 * * @param sheetIndex * sheet的下标 * @param headers * 表头 * @param startRow * 起始行数 * @return */ public List<Map<String, Object>> readSheetDatas(int sheetIndex, String[] headers, int startRow) { List<Map<String, Object>> result = new LinkedList<>(); if (ArrayUtils.isEmpty(headers)) { return result; } Sheet sheet = workBook.getSheetAt(sheetIndex); if (sheet == null) { return result; } int lastRowNum = sheet.getLastRowNum(); for (int i = startRow; i <= lastRowNum; i++) { Row row = sheet.getRow(i); if (row == null) { continue; } Map<String, Object> rowMap = new LinkedHashMap<>(); result.add(rowMap); for (int j = 0, length_1 = headers.length; j < length_1; j++) { String cellValue = getCellStringValue(row.getCell(j)); String header = headers[j]; rowMap.put(header, cellValue); } } return result; } /** * 读取cell的值 * * @param cell * 需要读取的cell * @param defaultValue * 默认值 * @return */ private String getCellValue(Cell cell) { if (cell == null) { return ""; } cell.setCellType(CellType.STRING); return StringUtils.defaultIfBlank(cell.getStringCellValue(), ""); } /** * POI3.15之后的读取方法(建议用这个) * * @param cell * @return */ private String getCellStringValue(Cell cell) { if (cell == null) { return ""; } String cellValue = null; if (cell.getCellTypeEnum() == CellType.NUMERIC) { if (HSSFDateUtil.isCellDateFormatted(cell)) { cellValue = DateFormatUtils.format(cell.getDateCellValue(), "yyyy-MM-dd"); } else { NumberFormat nf = NumberFormat.getInstance(); cellValue = String.valueOf(nf.format(cell.getNumericCellValue())).replace(",", ""); } } else if (cell.getCellTypeEnum() == CellType.STRING) { cellValue = cell.getStringCellValue(); } else if (cell.getCellTypeEnum() == CellType.BOOLEAN) { cellValue = String.valueOf(cell.getBooleanCellValue()); } else if (cell.getCellTypeEnum() == CellType.ERROR) { cellValue = "错误类型"; } else { cellValue = ""; } return cellValue; } }
测试代码:
package cn.qs.utils.export; import java.util.List; import java.util.Map; public class FileTest { public static void main(String[] args) { ExcelReader excelExporter = new ExcelReader("e:/test.xls"); System.out.println("==========读取所有sheet数据，默认以第一行作为header=========="); List<Map<String, Object>> readAllSheetDatas2 = excelExporter.readAllSheetDatas(); System.out.println(readAllSheetDatas2); } }
结果:
19:44:44.003 [main] DEBUG cn.qs.utils.export.ExcelReader - 是07版本的excel，采用HSSFWorkbook读取
==========读取第一个sheet(指定表头和起始行)==========
[{name=namesssssssssssssss水水水水水水水水水水水水水水水水水水水ssssssssssssssss0, age=20}, {name=namesssssssssssssss水水水水水水水水水水水水水水水水水水水ssssssssssssssss1, age=21}, {name=namesssssssssssssss水水水水水水水水水水水水水水水水水水水ssssssssssssssss2, age=22}, {name=namesssssssssssssss水水水水水水水水水水水水水水水水水水水ssssssssssssssss3, age=23}, {name=namesssssssssssssss水水水水水水水水水水水水水水水水水水水ssssssssssssssss4, age=24}, {name=namesssssssssssssss水水水水水水水水水水水水水水水水水水水ssssssssssssssss5, age=25}, {name=namesssssssssssssss水水水水水水水水水水水水水水水水水水水ssssssssssssssss6, age=26}, {name=namesssssssssssssss水水水水水水水水水水水水水水水水水水水ssssssssssssssss7, age=27}, {name=namesssssssssssssss水水水水水水水水水水水水水水水水水水水ssssssssssssssss8, age=28}]
==========读取所有sheet数据，默认以第一行作为header==========
19:44:44.013 [main] DEBUG cn.qs.utils.export.ExcelReader - sheetName[0]: 人员基本信息
[{姓名=namesssssssssssssss水水水水水水水水水水水水水水水水水水水ssssssssssssssss0, 年龄=20}, {姓名=namesssssssssssssss水水水水水水水水水水水水水水水水水水水ssssssssssssssss1, 年龄=21}, {姓名=namesssssssssssssss水水水水水水水水水水水水水水水水水水水ssssssssssssssss2, 年龄=22}, {姓名=namesssssssssssssss水水水水水水水水水水水水水水水水水水水ssssssssssssssss3, 年龄=23}, {姓名=namesssssssssssssss水水水水水水水水水水水水水水水水水水水ssssssssssssssss4, 年龄=24}, {姓名=namesssssssssssssss水水水水水水水水水水水水水水水水水水水ssssssssssssssss5, 年龄=25}, {姓名=namesssssssssssssss水水水水水水水水水水水水水水水水水水水ssssssssssssssss6, 年龄=26}, {姓名=namesssssssssssssss水水水水水水水水水水水水水水水水水水水ssssssssssssssss7, 年龄=27}, {姓名=namesssssssssssssss水水水水水水水水水水水水水水水水水水水ssssssssssssssss8, 年龄=28}]