Apache POI是一套基于 OOXML 标准(Office Open XML)和 OLE2 标准来读写各类格式文件的 Java API,也就是说只要是遵循以上标准的文件,POI 都可以进行读写,而不只仅只能操做咱们熟知的办公程序文件。本文只会涉及到 excel 相关内容,其余文件的操做能够参考poi官方网站。html
这里先总结下 POI 的使用体验。POI 面向接口的设计很是巧妙,使用 ss.usermodel
包读写 xls 和 xlsx 时,可使用同一套代码,即便这两种文件格式采用的是彻底不一样的标准。POI 提供了SXSSFWorkbook
用于解决 xlsx 写大文件时容易出现的 OOM 问题。可是,仍是存在如下不足(都只针对读场景):java
针对以上问题,阿里的 easyexcel 对 POI 进行高级封装,提供了一套很是简便的 API,其中,读部分只封装了 SAX 部分 API,事实上,使用 easyexcel 读 excel 只会采用 SAX 方式,另外,easyexcel 重写了 POI 对 xlsx 的解析,可以本来一个3M的 excel 用 POI SAX 依然须要100M左右内存下降到几M,easyexcel 的内容本文也会涉及到。mysql
OLE2 和 OOXML 本质上都是一种文件格式规范或标准,平时看到的 excel 中,有字体、公式、颜色、图片等等,看起来很是复杂,可是在文件结构上都遵循着固定的格式。git
OLE2 文件通常包括 xls、doc、ppt 等,是二进制格式的文件。 相关内容能够参考:复合文档Ole对象二进制储存格式。github
OOXML文件通常包括 xlsx、docx、pptx 等。该类文件以指定格式的 xml 为基础并以 zip 格式压缩,这里我利用解压工具解压本地的一个 xml 文件,能够看到如下文件结构,在本文例子中,咱们会重点关注 sharedStrings.xml 和 sheet1.xml 的内容,由于使用 SAX API 时必须用到:sql
针对不一样应用的文件,使用时须要引入对应的 maven 依赖,这里给出官方给出的指引。若是咱们不使用 SAX API 方式读写 excel,通常只会用到这个 org.apache.poi.ss 中的 API,具体的实现类放在 org.apache.poi.hssf 或 org.apache.poi.xssf 。数据库
组件 | 做用 | Maven依赖 |
---|---|---|
POIFS | OLE2 Filesystem | poi |
HPSF | OLE2 Property Sets | poi |
HSSF | Excel XLS | poi |
HSLF | PowerPoint PPT | poi-scratchpad |
HWPF | Word DOC | poi-scratchpad |
HDGF | Visio VSD | poi-scratchpad |
HPBF | Publisher PUB | poi-scratchpad |
HSMF | Outlook MSG | poi-scratchpad |
DDF | Escher common drawings | poi |
HWMF | WMF drawings | poi-scratchpad |
OpenXML4J | OOXML | poi-ooxml plus either poi-ooxml-schemas or ooxml-schemas and ooxml-security |
XSSF | Excel XLSX | poi-ooxml |
XSLF | PowerPoint PPTX | poi-ooxml |
XWPF | Word DOCX | poi-ooxml |
XDGF | Visio VSDX | poi-ooxml |
Common SL | PowerPoint PPT 和 PPTX 共用组件 | poi-scratchpad and poi-ooxml |
Common SS | Excel XLS 和 XLSX 共用组件 | poi-ooxml |
JDK:1.8.0_201apache
maven:3.6.1xss
IDE:Spring Tool Suite 4.3.2.RELEASEmaven
POI:4.1.2
easyexcel:2.1.6
mysql:5.7.28
项目类型Maven Project,打包方式 jar。
<!-- junit --> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.12</version> <scope>test</scope> </dependency> <!-- poi-ooxml --> <dependency> <groupId>org.apache.poi</groupId> <artifactId>poi-ooxml</artifactId> <version>4.1.2</version> </dependency> <!-- easyexcel --> <dependency> <groupId>com.alibaba</groupId> <artifactId>easyexcel</artifactId> <version>2.1.6</version> </dependency> <!-- hikari --> <dependency> <groupId>com.zaxxer</groupId> <artifactId>HikariCP</artifactId> <version>2.6.1</version> </dependency> <!-- mysql驱动 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.15</version> </dependency>
读取指定 excel 第一个单元格的内容。该指定文件第一个单元格内容为“测试”。
建议采用WorkbookFactory
来获取Workbook
实例,而不是根据文件类型写死具体的实现类。另外,获取单元格对象时建议采用 SheetUtil
获取,里面会对行对象进行判空操做。
@Test public void test01() throws IOException { // 处理XSSF String path = "extend\\file\\poi_test_01.xlsx"; // 处理HSSF //String path = "extend\\file\\poi_test_01.xls"; // 建立工做簿,会根据excel命名选择不一样的Workbook实现类 Workbook wb = WorkbookFactory.create(new File(path)); // 获取工做表 Sheet sheet = wb.getSheetAt(0); // 获取行 Row row = sheet.getRow(0); // 获取单元格 Cell cell = row.getCell(0); // 也能够采用如下方式获取单元格 // Cell cell = SheetUtil.getCell(sheet, 0, 0); // 获取单元格内容 String value = cell.getStringCellValue(); System.err.println("第一个单元格字符:" + value); // 释放资源 wb.close(); }
运行以上方法,控制台打印出第一个单元格的内容:
生成一个 excel 文件,并给第一个单元格赋值为"测试",并设置列宽 26,行高 20.25,内容居中,下框线,单元格橙色填充。
CellUtil
是 POI 自带的工具类,这里简化了三句代码(建立单元格,设置样式,赋值)。注意,当写入 xlsx 的大文件时,能够考虑使用SXSSFWorkbook
来避免 OOM。
@Test public void test01() throws FileNotFoundException, IOException { // 处理XSSF String path = "extend\\file\\poi_test_01.xlsx"; // 处理HSSF // String path = "extend\\file\\poi_test_01.xls"; // 建立工做簿 boolean flag = path.endsWith(".xlsx"); Workbook wb = WorkbookFactory.create(flag ? true : false); // Workbook wb = new SXSSFWorkbook(100);//内存仅保留100行数据,可避免OOM // 建立工做表 Sheet sheet = wb.createSheet(WorkbookUtil.createSafeSheetName("MySheet001")); // 设置列宽 sheet.setColumnWidth(0, 26 * 256); // 建立行(索引从0开始) Row row = sheet.createRow(0); // 设置行高 row.setHeightInPoints(20.25f); // 建立单元格样式对象 CellStyle style = wb.createCellStyle(); // 设置样式 style.setAlignment(HorizontalAlignment.CENTER); // 横向居中 style.setVerticalAlignment(VerticalAlignment.CENTER);// 纵向居中 style.setBorderBottom(BorderStyle.THIN); style.setFillForegroundColor(IndexedColors.ORANGE.getIndex()); style.setFillPattern(FillPatternType.SOLID_FOREGROUND); // 建立单元格、设置样式和内容 CellUtil.createCell(row, 0, "测试", style); // 保存到本地目录 OutputStream out = new FileOutputStream(new File(path)); wb.write(out); // 释放资源 out.close(); wb.close(); }
运行以上方法,指定路径下生成了 excel 文件,并填充了第一个单元格:
将 excel 中的用户数据导入到数据库(sql 已提供,在当前项目的 extend/sql 下),数据格式以下:
该文件总计1000条数据,xls 大小 128 KB,xlsx 大小 40 KB,两种类型文件内容一致。
通常 excel 的内容格式是提早约定好的,咱们知道用户数据哪一列是用户名,哪一列是电话号码,因此,在获取单元格数据后能够准确地转换,但这种方式须要针对不一样的对象分别定义一个转换方法。
@Test public void test02() throws SQLException, IOException { // 处理XSSF String path = "extend\\file\\user_data.xlsx"; // 处理HSSF //String path = "extend\\file\\user_data.xls"; // 定义集合,用于存放excel中的用户数据 List<UserDTO> list = new ArrayList<>(); InputStream in = new FileInputStream(path); // 建立工做簿 Workbook wb = WorkbookFactory.create(in); // 获取工做表 Sheet sheet = wb.getSheetAt(0); // 获取全部行 Iterator<Row> iterator = sheet.iterator(); int rowNum = 0; // 遍历行 while(iterator.hasNext()) { Row row = iterator.next(); // 跳过标题行 if(rowNum == 0 || rowNum == 1) { rowNum++; continue; } // 将用户对象保存到集合中 list.add(constructUserByRow(row)); } // 批量保存 new UserService().save(list); // 释放资源 in.close(); wb.close(); } /** * <p>经过行数据构造用户对象</p> */ private UserDTO constructUserByRow(Row row) { UserDTO userDTO = new UserDTO(); Cell cell = null; // 用户名 cell = row.getCell(1); userDTO.setName(cell.getStringCellValue()); // 性别 cell = row.getCell(2); userDTO.setGenderStr(cell.getStringCellValue()); // 年龄 cell = row.getCell(3); userDTO.setAge(((Double)cell.getNumericCellValue()).intValue()); // 电话 cell = row.getCell(4); userDTO.setPhone(cell.getStringCellValue()); return userDTO; }
运行以上方法,能够在数据库看到导入的数据:
将数据库的用户数据导出到excel中。这个例子使用模板进行导出,模板以下(若是是 xlsx 的大文件,为了可以使用SXSSFWorkbook
最好不要用模板)。
写入的时候使用样式仍是比较繁琐,实际开发能不使用尽可能不要用,或者也能够单独封装成一个方法。注意,构造Workbook
时不要使用WorkbookFactory.create(file)
方式,不然,模板也会被修改。
@Test public void test02() throws SQLException, IOException { // 处理XSSF String templatePath = "extend\\file\\user_data_template.xlsx"; String outpath = "extend\\file\\user_data.xlsx"; // 处理HSSF // String templatePath = "extend\\file\\user_data_template.xls"; // String path = "extend\\file\\user_data.xls"; InputStream in = new FileInputStream(templatePath); // 建立工做簿,注意,这里若是传入File对象,模板也会被改写 Workbook wb = WorkbookFactory.create(in); // 读取工做表 Sheet sheet = wb.getSheetAt(0); // 定义复用变量 int rowIndex = 0; // 行的索引 int cellIndex = 1; // 单元格的索引 Row nRow = null; Cell nCell = null; // 读取大标题行 nRow = sheet.getRow(rowIndex++); // 使用后 +1 // 读取大标题的单元格 nCell = nRow.getCell(cellIndex); // 设置大标题的内容 nCell.setCellValue("2020年2月用户表"); // 跳过第二行(模板的小标题) rowIndex++; // 读取第三行,获取它的样式 nRow = sheet.getRow(rowIndex); // 读取行高 float lineHeight = nRow.getHeightInPoints(); // 获取第三行的4个单元格中的样式 CellStyle cs1 = nRow.getCell(cellIndex++).getCellStyle(); CellStyle cs2 = nRow.getCell(cellIndex++).getCellStyle(); CellStyle cs3 = nRow.getCell(cellIndex++).getCellStyle(); CellStyle cs4 = nRow.getCell(cellIndex++).getCellStyle(); // 查询用户列表 List<UserDTO> userList = new UserService().findAll().stream().map((x) -> new UserDTO(x)).collect(Collectors.toList()); // 遍历数据 for(UserDTO user : userList) { // 建立数据行 nRow = sheet.createRow(rowIndex++); // 设置数据行高 nRow.setHeightInPoints(lineHeight); // 重置cellIndex,从第一列开始写数据 cellIndex = 1; // 建立数据单元格,设置单元格内容和样式 // 用户名 nCell = nRow.createCell(cellIndex++); nCell.setCellStyle(cs1); nCell.setCellValue(user.getName()); // 性别 nCell = nRow.createCell(cellIndex++); nCell.setCellStyle(cs2); nCell.setCellValue(user.getGenderStr()); // 年龄 nCell = nRow.createCell(cellIndex++); nCell.setCellStyle(cs3); nCell.setCellValue(user.getAge()); // 手机号 nCell = nRow.createCell(cellIndex++); nCell.setCellStyle(cs4); nCell.setCellValue(user.getPhone()); } // 保存到本地目录 OutputStream out = new FileOutputStream(new File(outpath)); wb.write(out); // 释放资源 out.close(); wb.close(); }
运行以上方法,在指定文件夹能够看到生成的文件:
使用 SAX 的方式将 xls 中的用户数据导入到数据库,数据与以上例子同样。
相比前面的例子,使用 SAX 方式内存占用小,效率高,可是 POI 提供的这套 API 用起来很是繁琐,使用时不得没必要须去了解 xls 文件的结构。我这里只是简单展现,监听器部分的代码不太严谨,实际项目仍是用 easyexcel 来操做吧。
@Test public void test02() throws Exception { // 建立POIFSFileSystem String filename = "extend\\file\\user_data.xls"; POIFSFileSystem poifs = new POIFSFileSystem(new File(filename)); // 建立HSSFRequest,并添加自定义监听器 HSSFRequest req = new HSSFRequest(); EventExample listener = new EventExample(); req.addListenerForAllRecords(listener); // 解析和触发事件 HSSFEventFactory factory = new HSSFEventFactory(); factory.processWorkbookEvents(req, poifs); // 保存用户到数据库 new UserService().save(listener.getList()); poifs.close(); } private static class EventExample implements HSSFListener { private SSTRecord sstrec; private int lastCellRow = -1; private int lastCellColumn = -1; private List<UserDTO> list = new ArrayList<UserDTO>(); private UserDTO user; @Override public void processRecord(Record record) { switch(record.getSid()) { // 进入新的sheet case BoundSheetRecord.sid: lastCellRow = -1; lastCellColumn = -1; break; // excel中的数值类型和字符存放在不一样的位置 case NumberRecord.sid: NumberRecord numrec = (NumberRecord)record; // 用户年龄 user.setAge(Double.valueOf(numrec.getValue()).intValue()); lastCellRow = numrec.getRow(); lastCellColumn = numrec.getColumn(); break; // SSTRecords中存储着excel中使用的字符,重复的会合并为一个 case SSTRecord.sid: sstrec = (SSTRecord)record; break; // 读取到单元格的字符 case LabelSSTRecord.sid: LabelSSTRecord lrec = (LabelSSTRecord)record; int thisRow = lrec.getRow(); // 用户数据从第三行开始 if(thisRow >= 2) { // 进入新行时,原对象放入集合,并建立新对象 if(thisRow != lastCellRow) { if(user != null) { list.add(user); } user = new UserDTO(); } // 根据列数为用户对象设置属性 switch(lrec.getColumn()) { case 1: // 用户名 user.setName(sstrec.getString(lrec.getSSTIndex()).getString()); break; case 2: // 用户性别 user.setGenderStr(sstrec.getString(lrec.getSSTIndex()).getString()); break; case 4: // 用户电话 user.setPhone(sstrec.getString(lrec.getSSTIndex()).getString()); break; default: break; } lastCellRow = thisRow; lastCellColumn = lrec.getColumn(); } break; case EOFRecord.sid: // 最后一行读取完后直接放入集合 if(lastCellRow != -1 && user != null && lastCellColumn == 4) { list.add(user); } break; default: break; } } public List<UserDTO> getList() { return list; } }
运行以上方法,能够在数据库看到导入的数据:
使用 SAX 的方式将 xlsx 中的用户数据导入到数据库,数据与以上例子同样。
POI 针对 xlsx 的 SAX API 也是很是繁琐,属于很是低级的封装,这里居然须要使用 JDK 原生的 SAX 解析来处理事件,定义事件处理器时,我必须去了解 xml 的节点结构。和上面例子同样,这里也只是简单地演示这套 API 的使用,具体代码不太严谨,固然,实际开发咱们不会采用这种方式,建议仍是使用 easyexcel 吧。
@Test public void test01() throws Exception { String filename = "extend\\file\\user_data.xlsx"; OPCPackage pkg = OPCPackage.open(filename); XSSFReader r = new XSSFReader(pkg); // 获取sharedStrings.xml的内容,这里存放着excel中的字符 SharedStringsTable sst = r.getSharedStringsTable(); // 接下来就是采用SAX方式解析xml的过程 // 构造解析器,这里会设置自定义的处理器 XMLReader parser = XMLHelper.newXMLReader(); SheetHandler handler = new SheetHandler(sst); parser.setContentHandler(handler); // 解析指定的sheet InputStream sheet2 = r.getSheet("rId1"); parser.parse(new InputSource(sheet2)); // 保存用户到数据库 new UserService().save(handler.getList()); // handler.getList().forEach(System.err::println); sheet2.close(); } private static class SheetHandler extends DefaultHandler { private SharedStringsTable sst; private String cellContents; private boolean cellContentsIsString; private int cellColumn = -1; private int cellRow = -1; List<UserDTO> list = new ArrayList<>(); UserDTO user; private SheetHandler(SharedStringsTable sst) { this.sst = sst; } @Override public void startElement(String uri, String localName, String name, Attributes attributes) throws SAXException { // 读取到行 if("row".equals(name)) { cellRow++; if(cellRow >= 2) { // 换行时从新建立用户实例 user = new UserDTO(); } } // 读取到列 c => cell if("c".equals(name) && cellRow >= 2) { // 设置当前读取到哪一列 char columnChar = attributes.getValue("r").charAt(0); switch(columnChar) { case 'B': cellColumn = 1; break; case 'C': cellColumn = 2; break; case 'D': cellColumn = 3; break; case 'E': cellColumn = 4; break; default: cellColumn = -1; break; } // 当前单元格中的值是否为字符,是的话对应的值被放在SharedStringsTable中 if("s".equals(attributes.getValue("t"))) { cellContentsIsString = true; } } // Clear contents cache cellContents = ""; } @Override public void endElement(String uri, String localName, String name) throws SAXException { // 跳过标题 if(cellRow < 2) { return; } // v节点是c的子节点,表示单元格的值 if(name.equals("v")) { int idx; if(cellContentsIsString) { idx = Integer.parseInt(cellContents); } else { idx = Double.valueOf(cellContents).intValue(); } switch(cellColumn) { case 1: user.setName(sst.getItemAt(idx).getString()); break; case 2: user.setGenderStr(sst.getItemAt(idx).getString()); break; case 3: // 年龄的值是数值类型,不在SharedStringsTable中 user.setAge(idx); break; case 4: user.setPhone(sst.getItemAt(idx).getString()); break; default: break; } } // 读取完一行,将用户对象放入集合中 if("row".equals(name) && user != null) { list.add(user); } // 重置参数 if("c".equals(name)) { cellColumn = -1; cellContentsIsString = false; } } @Override public void characters(char[] ch, int start, int length) { cellContents += new String(ch, start, length); } public List<UserDTO> getList() { return list; } }
运行以上方法,能够在数据库看到导入的数据:
经过以上例子,咱们会发现,POI SAX 方式的 API 确实很是繁琐,使用时我必须熟悉地掌握 OLE2 或 OOXML 的规范,才可以使用。这是比较低层级的封装。相比之下,ss.usermodel 的 API 要好用不少,可是这套 API 底层解析 方式有点相似 DOM,效率较低,且内存占用较大。
前面已经讲过,easyexcel 对 POI 进行了高级封装,极大地方便了咱们读写 excel,并且只会采用 SAX 这种更快的方式来读取,下面补充下如何使用 easyexcel 读写 excel。
使用 easyexcel 读写 excel 时,咱们不须要本身写 row => entity 或者 entity => row 的方法,只要按照如下注解好就行。被@ExcelProperty
注解的属性对应 row 中的具体内容,而被@ExcelIgnore
注解表示不须要与 row 进行转换。
@ContentRowHeight(16) public class UserDTO implements Serializable { private static final long serialVersionUID = 1L; @ExcelIgnore private String id; /** * <p>用户名</p> */ @ExcelProperty(value = { "用户名" }, index = 1) private String name; /** * <p>性别</p> */ @ExcelProperty(value = { "性别" }, index = 2) private String genderStr; /** * <p>年龄</p> */ @ExcelProperty(value = { "年龄" }, index = 3) private Integer age; /** * <p>电话号码</p> */ @ExcelProperty(value = { "手机号" }, index = 4) @ColumnWidth(14) private String phone; @ExcelIgnore private Integer gender = 0; // 如下省略setter/getter方法 }
easyexcel 封装或重写了 POI SAX 部分的 API,因此也是须要设置回调的监听器,如下方式会采用默认的监听器,并返回封装好的对象。
@Test public void test02() throws SQLException, IOException { // XSSF String path = "D:\\growUp\\git_repository\\09-poi-demo\\extend\\file\\user_data.xlsx"; // HSSF // String path = "D:\\growUp\\git_repository\\09-poi-demo\\extend\\file\\user_data.xls"; // 读取excel List<UserDTO> list = EasyExcel.read(path).head(UserDTO.class).sheet(0).headRowNumber(2).doReadSync(); // 保存 new UserService().save(list); }
固然,咱们也能够采用自定义的监听器,以下:
@Test public void test01() throws SQLException, IOException { // XSSF String path = "D:\\growUp\\git_repository\\09-poi-demo\\extend\\file\\user_data.xlsx"; // HSSF // String path = "D:\\growUp\\git_repository\\09-poi-demo\\extend\\file\\user_data.xls"; List<UserDTO> list = new ArrayList<UserDTO>(); // 定义回调监听器 ReadListener<UserDTO> syncReadListener = new AnalysisEventListener<UserDTO>() { @Override public void invoke(UserDTO data, AnalysisContext context) { list.add(data); } @Override public void doAfterAllAnalysed(AnalysisContext context) { // TODO Auto-generated method stub } }; // 读取excel EasyExcel.read(path, UserDTO.class, syncReadListener).sheet(0).headRowNumber(2).doRead(); // 保存 new UserService().save(list); }
和读同样,这里也只用了一行代码就完成了对 excel 的操做。
@Test public void test01() throws SQLException, IOException { // XSSF String path = "D:\\growUp\\git_repository\\09-poi-demo\\extend\\file\\user_data.xlsx"; // HSSF // String path = "D:\\growUp\\git_repository\\09-poi-demo\\extend\\file\\user_data.xls"; // 获取用户数据 List<UserDTO> list = new UserService().findAll().stream().map((x) -> new UserDTO(x)).collect(Collectors.toList()); // 写入excel EasyExcel.write(path, UserDTO.class).sheet(0).relativeHeadRowIndex(1).doWrite(list); }
Apache POI - the Java API for Microsoft Documents
本文为原创文章,转载请附上原文出处连接: http://www.javashuo.com/article/p-flxvizqo-v.html