一文教你轻松掌握Apache POI的基本使用

一、Apache POI介绍

开发中经常会设计到excel的处理，如导出Excel，导入Excel到数据库中，几年前操作Excel常用的有两个框架，一个是apache 的poi， 另一个是 Java Excel，不过现在又出现了EasyPoi和阿里开源的EasyExcel，这两个后面再进行整理

• Apache POI 是用Java编写的免费开源的跨平台的 Java API，Apache POI提供API给Java程式对Microsoft Office（Excel、WORD、PowerPoint、Visio等）格式档案读和写的功能。POI为“Poor Obfuscation Implementation”的首字母缩写，意为“可怜的模糊实现”。

  官方文档：http://poi.apache.org/apidocs/index.html

• Java Excel是一开放源码项目，通过它Java开发人员可以读取Excel文件的内容、创建新的Excel文件、更新已经存在的Excel文件。jxl 由于其小巧 易用的特点, 逐渐已经取代了 POI-excel的地位, 成为了越来越多的java开发人员生成excel文件的首选。

二：Apache POI常用的类

• HSSF － 提供读写Microsoft Excel XLS格式档案的功能。【03版本】
• XSSF － 提供读写Microsoft Excel OOXML XLSX格式档案的功能。【07版本】
• HWPF － 提供读写Microsoft Word DOC97格式档案的功能。
• XWPF － 提供读写Microsoft Word DOC2003格式档案的功能。
• HSLF － 提供读写Microsoft PowerPoint格式档案的功能。
• HDGF － 提供读Microsoft Visio格式档案的功能。
• HPBF － 提供读Microsoft Publisher格式档案的功能。
• HSMF － 提供读Microsoft Outlook格式档案的功能。

常用的类和方法

HSSFWorkbook ：工作簿，代表一个excel的整个文档

• HSSFWorkbook(); // 创建一个新的工作簿
• HSSFWorkbook(InputStream inputStream); // 创建一个关联输入流的工作簿，可以将一个excel文件封装成工作簿
• HSSFSheet createSheet(String sheetname); 创建一个新的Sheet
• HSSFSheet getSheet(String sheetName); 通过名称获取Sheet
• HSSFSheet getSheetAt(int index); // 通过索引获取Sheet，索引从0开始
• HSSFCellStyle createCellStyle()； 创建单元格样式
• int getNumberOfSheets(); 获取sheet的个数
• setActiveSheet(int index); 设置默认选中的工作表
• write(); //写入数据
• write(File newFile); //往指定文件写入数据
• write(OutputStream stream);

HSSFSheet：工作表

• HSSFRow createRow(int rownum); 创建新行，需要指定行号，行号从0开始
• HSSFRow getRow(int index); 根据索引获取指定的行
• int addMergedRegion(CellRangeAddress region); 合并单元格
• CellRangeAddress(int firstRow, int lastRow, int firstCol, int lastCol); 单元格范围, 用于合并单元格，需要指定要合并的首行、最后一行、首列、最后一列。
• autoSizeColumn(int column); 自动调整列的宽度来适应内容
• getLastRowNum();获取最后的行的索引，没有行或者只有一行的时候返回0
• setColumnWidth(int columnIndex, int width); 设置某一列的宽度，width=字符个数 * 256，例如20个字符的宽度就是20 * 256

HSSFRow ：行

• HSSFCell createCell(int column); 创建新的单元格
• HSSFCell setCell(shot index);
• HSSFCell getCell(shot index);
• setRowStyle(HSSFCellStyle style); 设置行样式
• short getLastCellNum(); 获取最后的单元格号，如果单元格有第一个开始算，lastCellNum就是列的个数
• setHeightInPoints(float height); 设置行的高度

HSSFCell：单元格

• setCellValue(String value);设置单元格的值
• setCellType(); 设置单元格类型，如 字符串、数字、布尔等
• setCellStyle(); 设置单元格样式
• String getStringCellValue(); 获取单元格中的字符串值
• setCellStyle(HSSFCellStyle style); 设置单元格样式，例如字体、加粗、格式化
• setCellFormula(String formula); 设置计算公式，计算的结果作为单元格的值，也提供了异常常用的函数，如求和"sum(A1,C1)"、日期函数、字符串相关函数、CountIf和SumIf函数、随机数函数等
• HSSFCellStyle ：单元格样式
• setFont(Font font); 为单元格设置字体样式
• setAlignment(HorizontalAlignment align); // 设置水平对齐方式
• setVerticalAlignment(VerticalAlignment align); // 设置垂直对齐方式
• setFillPattern(FillPatternType fp);
• setFillForegroundColor(short bg); 设置前景色
• setFillBackgroundColor(short bg); 设置背景颜色

HSSFFont：字体，

• setColor(short color); // 设置字体颜色
• setBold(boolean bold); // 设置是否粗体
• setItalic(boolean italic); 设置倾斜
• setUnderline(byte underline); 设置下划线

HSSFName：名称

• HSSFDataFormat ：日期格式化
• HSSFHeader ： Sheet的头部
• HSSFFooter ：Sheet的尾部
• HSSFDateUtil ：日期工具
• HSSFPrintSetup ：打印设置
• HSSFErrorConstants：错误信息表

Excel中的工作簿、工作表、行、单元格中的关系：

一个Excel文件对应于一个workbook(HSSFWorkbook)，
一个workbook可以有多个sheet（HSSFSheet）组成， 一个sheet是由多个row（HSSFRow）组成，
一个row是由多个cell（HSSFCell）组成

三、实例演示

1.创建一个普通的maven项目
2.引入Apache poi的依赖

		<!--xLs(03版本)-->
        <dependency>
            <groupId>org.apache.poi</groupId>
            <artifactId>poi</artifactId>
            <version >3.9</version>
        </dependency>
        <!--xLsx(07版本)-->
        <dependency>
            <groupId>org.apache.poi</groupId>
            <artifactId>poi-ooxml</artifactId>
            <version>3.9</version>
        </dependency>

示例一：在桌面生成一个Excel文件【03版本】

@Test
    public void createExcel() throws IOException{
   
        // 获取桌面路径
        FileSystemView fsv = FileSystemView.getFileSystemView();
        String desktop = fsv.getHomeDirectory().getPath();
        System.out.println("桌面路径："+desktop);
        String filePath = desktop + "/test.xls";

        File file = new File(filePath);
        OutputStream outputStream = new FileOutputStream(file);
        //1.创建一个工作簿
        HSSFWorkbook workbook = new HSSFWorkbook();
        //2.创建一个名叫test1的工作表
        HSSFSheet sheet = workbook.createSheet("test1");
        //3.创建第一行并设置值
        HSSFRow row = sheet.createRow(0);
        row.createCell(0).setCellValue("id");
        row.createCell(1).setCellValue("订单号");
        row.createCell(2).setCellValue("下单时间");
        row.createCell(3).setCellValue("个数");
        row.createCell(4).setCellValue("单价");
        row.createCell(5).setCellValue("订单金额");
        row.setHeightInPoints(30); // 设置行的高度
        //4.创建第二行并设置值
        HSSFRow row1 = sheet.createRow(1);
        row1.createCell(0).setCellValue("1");
        row1.createCell(1).setCellValue("NO00001");

        //4.1设置第三列值，并做日期格式化
        HSSFCellStyle cellStyle2 = workbook.createCellStyle();
        HSSFCreationHelper creationHelper = workbook.getCreationHelper();
        cellStyle2.setDataFormat(creationHelper.createDataFormat().getFormat("yyyy-MM-dd HH:mm:ss"));
        sheet.setColumnWidth(2, 20 * 256); // 设置列的宽度

        HSSFCell cell2 = row1.createCell(2);
        cell2.setCellStyle(cellStyle2);
        cell2.setCellValue(new Date());
        //4.2设置第四列值
        row1.createCell(3).setCellValue(2);


        //4.3设置第五列值 保留两位小数
        HSSFCellStyle cellStyle3 = workbook.createCellStyle();
        cellStyle3.setDataFormat(HSSFDataFormat.getBuiltinFormat("0.00"));
        HSSFCell cell4 = row1.createCell(4);
        cell4.setCellStyle(cellStyle3);
        cell4.setCellValue(29.5);


        //4.3设置第六列值 货币格式化
        HSSFCellStyle cellStyle4 = workbook.createCellStyle();
        HSSFFont font = workbook.createFont();
        font.setFontName("华文行楷");
        font.setFontHeightInPoints((short)15);
        font.setColor(HSSFColor.RED.index);
        cellStyle4.setFont(font);

        HSSFCell cell5 = row1.createCell(5