Java使用POI导入excel教程

客官°小女子只卖身不卖艺 2023-01-11 09:09 133阅读 0赞

### 文章目录 ###

*  前言
 *  1、工作准备
 *  2、小试牛刀
 *  3、小结
 *  写在最后

# 前言 #

实习期间遇到一个业务需求，要求具有excel导入和导出功能。由于公司框架的数据表格自带了excel导出功能，所以只需excel导入即可，流程是这样的：选择excel →文件上传→处理数据。

项目使用的Jar包是Apache POI，关于Apache POI，简单介绍一下：

> Apache POI是基于Office Open XML标准（OOXML）和Microsoft的OLE2复合文档格式（OLE2）处理各种文件格式的开源项目。简言之，就是用来操作office的工具箱。

其中操作Excel的模块有两个：

*  HSSF - 操作xls格式excel（低版本），有数据量限制
 *  XSSF - 操作xlsx格式excel（高版本），支持百万级数据量

# 1、工作准备 #

打开maven仓库：[https://mvnrepository.com/][https_mvnrepository.com]，输入POI，如下图：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyMTEwOTg1_size_16_color_FFFFFF_t_70]  
点进去，推荐选择的版本特点——时间不早不晚，多人使用的（遇到问题降低了解决难度），如下图：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyMTEwOTg1_size_16_color_FFFFFF_t_70 1]  
这里选择3.17版本（beta可以理解为测试、抢先，通常是有新功能或大的调整），点击，复制maven坐标，如下图：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyMTEwOTg1_size_16_color_FFFFFF_t_70 2]  
poi-ooxml如是，然后把它们贴入pom.xml，如下图：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyMTEwOTg1_size_16_color_FFFFFF_t_70 3]  
然后在idea中右键选中：Maven→Reimport，或者点击enable auto import，让maven把jar包接入项目即可。

# 2、小试牛刀 #

由于excel存在版本区别，需要分别处理xls和xlsx格式，分别对应HSSF、XSSF开头的API，按住CTRL + SHIFT + ALT + U，查看继承关系图，可以发现它们有相同的接口：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyMTEwOTg1_size_16_color_FFFFFF_t_70 4]![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyMTEwOTg1_size_16_color_FFFFFF_t_70 5]  
其它类，如：HSSFSheet、XSSFSheet也可以通过Sheet接口引用（里式替换法则），测试代码如下（xlxs）：

private static void parseXlsxDemo() throws Exception { 
            // File类：以抽象的方式代表文件名和目录路径名
            File file = new File("d:\\good.xls");
            // 建立文件输入流
            FileInputStream fis = new FileInputStream(file);
            // 声明并创建一个工作簿
            HSSFWorkbook workbook = new HSSFWorkbook(fis);
            // sheet表示文件页，下标从0开始，表示第一页
            HSSFSheet sheet = workbook.getSheetAt(0);
            // 获取总行数（第一页）
            int rows = sheet.getPhysicalNumberOfRows();
            for (int i = 0; i < rows; i++) { 
                // 先获取行对象，再操作列
                Row row = sheet.getRow(i);
                // 获取每一行的格子数（列数）
                int cols = row.getPhysicalNumberOfCells();
                for (int j = 0; j < cols; j++) { 
                    // 获取格子对象
                    Cell cell = row.getCell(j);
                    // 输出格子对象
                    System.out.printf("%s\t", cell.toString());
                }
                // 换行输出
                System.out.println();
            }
        }

文件截图+运行效果：  
![在这里插入图片描述][20210126162110625.png]![在这里插入图片描述][20210126162130746.png]  
细心的朋友会发现，0变成了0.0，1变成了1.0，这是因为POI默认数字为浮点数。数据类型稍微有点复杂，此处不深究，下面是修改后的完整代码：

package ltd.newson.poi;
    
    import org.apache.poi.hssf.usermodel.HSSFWorkbook;
    import org.apache.poi.ss.usermodel.*;
    import org.apache.poi.xssf.usermodel.XSSFWorkbook;
    
    import java.io.File;
    import java.io.FileInputStream;
    
    /** * @Title: ReadExcel * @Author: newson.ltd * @Date: 2021-01-26 下午 12:01 * @Version: 1.0 * @Description: excel demo */
    public class ReadExcel { 
    
        public static void main(String[] args) throws Exception { 
            String fileName1 = "d:\\good.xls";
            String fileName2 = "d:\\good.xlsx";
            parseXls(fileName1);
            parseXlsx(fileName2);
        }
    
        /** * 读取xls格式excel * @param fileName * @throws Exception */
        private static void parseXls(String fileName) throws Exception { 
            // 1、读取文件（逐层包装，装饰器模式）
            FileInputStream fis = new FileInputStream(new File(fileName));
            Workbook workbook = new HSSFWorkbook(fis);
            // 2、获取要处理的页面
            Sheet sheet = workbook.getSheetAt(0);
            // 3、处理单元格
            printCell(sheet);
    
        }
    
        /** * 读取xlsx格式excel * @param fileName * @throws Exception */
        private static void parseXlsx(String fileName) throws Exception { 
            FileInputStream fis = new FileInputStream(new File(fileName));
            Workbook workbook = new XSSFWorkbook(fis);
            Sheet sheet = workbook.getSheetAt(0);
            printCell(sheet);
    
        }
    
        /** * 打印单元格 * @param sheet */
        private static void printCell(Sheet sheet) { 
            // 获取当前页的总行数
            int totalRowNums = sheet.getPhysicalNumberOfRows();
            for (int i = 0; i < totalRowNums; i++) { 
                // 获取行
                Row row = sheet.getRow(i);
                // 获取列数（格子数）
                int cells = row.getPhysicalNumberOfCells();
                StringBuilder builder = new StringBuilder();
                for (int j = 0; j < cells; j++) { 
                    Cell cell = row.getCell(j);
                    builder.append(getCellValue(cell)).append("\t");
                }
                System.out.print(builder.append("\n").toString());
            }
        }
    
        /** * 获取单元格的值，此处做简单处理 * @param cell * @return */
        private static String getCellValue(Cell cell) { 
            // 部分API已过时，此处是更新后的
            CellType cellType = cell.getCellTypeEnum();
            if (cellType == CellType.BOOLEAN) { 
                return String.valueOf(cell.getBooleanCellValue());
            }
            if (cellType == CellType.NUMERIC) { 
                return cell.getNumericCellValue() + "";
            }
            return cell.getStringCellValue();
        }
    
    }

运行截图：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyMTEwOTg1_size_16_color_FFFFFF_t_70 6]  
补充：注意getCellValue()中的API，有些教程可能会使用cell.getCellType()和Cell.CELL\_TYPE\_XXX（XXX表示数据类型），这些方法在新的POI中被标记为@deprecated（过时的），建议换成上述方法内的API。

# 3、小结 #

通过代码＋注释的解读，会发现excel的读取是这么的简单，归纳一下操作步骤：

*  输入目标文件，获取wordbook对象（工作簿）
 *  通过workbook对象获取sheet对象（要操作的页面）
 *  通过sheet对象获取当前页的总行数
 *  开循环，获取行对象，并通过行获取每一行的列数（格子数）
 *  再开个循环，通过行对象获取每一个格子对象
 *  操作格子对象（注意数据类型）

最后一步也是比较复杂的一步，需要具体情况具体分析。本示例操作单页，多页同理。最后扩展一下excel单元格的数据类型：

<table> 
 <thead> 
  <tr> 
   <th>CellType</th> 
   <th>含义</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>_NONE</td> 
   <td>未知类型</td> 
  </tr> 
  <tr> 
   <td>NUMERIC</td> 
   <td>数值类型（整数、小数、日期）</td> 
  </tr> 
  <tr> 
   <td>STRING</td> 
   <td>字符串</td> 
  </tr> 
  <tr> 
   <td>FORMULA</td> 
   <td>公式</td> 
  </tr> 
  <tr> 
   <td>BLANK</td> 
   <td>空白格（有样式）</td> 
  </tr> 
  <tr> 
   <td>BOOLEAN</td> 
   <td>布尔值</td> 
  </tr> 
  <tr> 
   <td>ERROR</td> 
   <td>错误单元格</td> 
  </tr> 
 </tbody> 
</table>

--------------------

# 写在最后 #

本次Java读取excel就介绍到这里啦，我是严光君，咱们下文再见~  
  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyMTEwOTg1_size_16_color_FFFFFF_t_70_pic_center]  
`创造不易，少侠请留步…… 动起可爱的双手，点个赞再走呗~ ٩(๑>◡<๑)۶`

[https_mvnrepository.com]: https://mvnrepository.com/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyMTEwOTg1_size_16_color_FFFFFF_t_70]: /images/20221119/52f660c6df414fb7b8ebc9ed4d5a308a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyMTEwOTg1_size_16_color_FFFFFF_t_70 1]: /images/20221119/e697eed2184b4f839b507cef9df62f9c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyMTEwOTg1_size_16_color_FFFFFF_t_70 2]: /images/20221119/0799c70faf5c47ee97c6ab62b31e56bc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyMTEwOTg1_size_16_color_FFFFFF_t_70 3]: /images/20221119/7caa4793f5be44dc9e763a322d5f4c20.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyMTEwOTg1_size_16_color_FFFFFF_t_70 4]: https://img-blog.csdnimg.cn/20210126160118662.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyMTEwOTg1,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyMTEwOTg1_size_16_color_FFFFFF_t_70 5]: /images/20221119/db67e3161c294312a578700c5140257c.png
[20210126162110625.png]: https://img-blog.csdnimg.cn/20210126162110625.png
[20210126162130746.png]: /images/20221119/42fa110188f74d3bbd2c9572dfd29455.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyMTEwOTg1_size_16_color_FFFFFF_t_70 6]: /images/20221119/4d8c605e283946d280bf2c9b3d7ee98d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyMTEwOTg1_size_16_color_FFFFFF_t_70_pic_center]: /images/20221119/b6ef8af0e6fa49f1b25d57bf1f39d38e.png