Java导入、导出excel保姆级教程(附封装好的工具类)

大家好，我是小乐。

前言

我们在日常开发中，一定遇到过要将数据导出为Excel的需求，那么怎么做呢？在做之前，我们需要思考下Excel的组成。Excel是由四个元素组成的分别是：WorkBook(工作簿)、Sheet(工作表)、Row(行)、Cell(单元格)，其中包含关系是从左至右，一个WorkBook可以包含多个Sheet，一个Sheet又是由多个Row组成，一个Row是由多个Cell组成。知道这些后那么我们就使用java来将数据以Excel的方式导出。让我们一起来学习吧！

一、引入Apache POI依赖

使用Java实现将数据以Excel的方式导出，需要依赖第三方的库。我们需要再pom.xml中引入下面的依赖：

<dependency><groupId>org.apache.poi</groupId><artifactId>poi</artifactId><version>4.1.2</version></dependency><dependency><groupId>org.apache.poi</groupId><artifactId>poi-ooxml</artifactId><version>4.1.2</version></dependency>

二、用法&步骤

2.1 创建Excel的元素

1）创建WokrBook

Workbook workbook = new XSSFWorkbook();

2）创建Sheet

 Sheet sheet = workbook.createSheet();

设置sheet的名称

 Sheet sheet = workbook.createSheet("sheet名称");

3）创建行Row

Row row = sheet.createRow(0);

4）创建单元格Cell

Cell cell = row.createCell(0, CellType.STRING);

可以指定单元格的类型，支持的类型有下面7种：

_NONE(-1),NUMERIC(0),STRING(1),//公式FORMULA(2),BLANK(3),//布尔BOOLEAN(4),ERROR(5);

5） 填充数据

 cell.setCellValue("苹果");

2.3 样式和字体

如果我们需要导出的Excel美观一些，如设置字体的样式加粗、颜色、大小等等，就需要创建样式和字体。

创建样式：

CellStyle cellStyle = workbook.createCellStyle();

1）左右垂直居中

//左右居中excelTitleStyle.setAlignment(HorizontalAlignment.CENTER);// 设置垂直居中excelTitleStyle.setVerticalAlignment(VerticalAlignment.CENTER);

2）字体加粗、颜色

创建加粗样式并设置到CellStyle 中：

Font font = workbook.createFont();//字体颜色为红色font.setColor(IndexedColors.RED.getIndex());//字体加粗font.setBold(true);cellStyle.setFont(font);

指定Cell单元格使用该样式：

cell.setCellStyle(style);

3）调整列宽和高

Sheet sheet = workbook.createSheet();//自动调整列的宽度来适应内容sheet.autoSizeColumn(int column); // 设置列的宽度sheet.setColumnWidth(2, 20 * 256); 

autoSizeColumn()传递的参数就是要设置的列索引。setColumnWidth()第一个参数是要设置的列索引，第二参数是具体的宽度值，宽度 = 字符个数 * 256（例如20个字符的宽度就是20 * 256）

4）倾斜、下划线

Font font = workbook.createFont();font.setItalic(boolean italic); 设置倾斜font.setUnderline(byte underline); 设置下划线

2.4 进阶用法

1）合并单元格

Workbook workbook = new XSSFWorkbook();Sheet sheet = workbook.createSheet(fileName);sheet.addMergedRegion(new CellRangeAddress(0, 0, 0, 5));

CellRangeAddress()方法四个参数分别是fristRow：起始行、lastRow：结束行、fristCol：起始列、lastCol：结束列。

如果你想合并从第一行到第二行从一列到第十列的单元格（一共合并20格），那么就是CellRangeAddress(0,1,0,10)。

2）字段必填

//创建数据验证DataValidationHelper dvHelper = sheet.getDataValidationHelper();//创建要添加校验的单元格对象CellRangeAddressList addressList = new CellRangeAddressList(0, 0, 0, 10);//创建必填校验规则DataValidationConstraint constraint = validationHelper.createCustomConstraint("NOT(ISBLANK(A1))");//设置校验DataValidation validation = dvHelper.createValidation(constraint, addressList);//校验不通过 提示validation.setShowErrorBox(true);sheet.addValidationData(validation);

CellRangeAddressList()方法传递四个参数，分别是：fristRow：起始行、lastRow：结束行、fristCol：起始列、lastCol：结束列。CellRangeAddressList(0, 0, 0, 10)表示的就是给第一行从第一列开始到第十列一共十个单元格添加数据校验。

3）添加公式

SUM：求和函数

//创建SUM公式FormulaEvaluator evaluator = workbook.getCreationHelper().createFormulaEvaluator();Cell sumCell = row.createCell(0);sumCell.setCellFormula("SUM(A1:A10)");//计算SUM公式结果Cell sumResultCell = row.createCell(1);sumResultCell.setCellValue(evaluator.evaluate(sumCell).getNumberValue());

AVERAGE：平均数函数。另外，搜索公众号Linux就该这样学后台回复“猴子”，获取一份惊喜礼包。

//创建AVERAGE公式FormulaEvaluator evaluator = workbook.getCreationHelper().createFormulaEvaluator();Cell averageCell = row.createCell(0);averageCell.setCellFormula("AVERAGE(A1:A10)");//计算AVERAGE公式结果Cell averageResultCell = row.createCell(1);averageResultCell.setCellValue(evaluator.evaluate(averageCell).getNumberValue());

COUNT：计数函数

//创建COUNT公式FormulaEvaluator evaluator = workbook.getCreationHelper().createFormulaEvaluator();Cell countCell = row.createCell(0);countCell.setCellFormula("COUNT(A1:A10)");//计算COUNT公式结果Cell countResultCell = row.createCell(1);countResultCell.setCellValue(evaluator.evaluate(countCell).getNumberValue());

IF：条件函数

//创建IF公式FormulaEvaluator evaluator = workbook.getCreationHelper().createFormulaEvaluator();Cell ifCell = row.createCell(0);ifCell.setCellFormula("IF(A1>B1,\"Yes\",\"No\")");//计算IF公式结果Cell ifResultCell = row.createCell(1);ifResultCell.setCellValue(evaluator.evaluate(ifCell).getStringValue());

CONCATENATE：连接函数

//创建CONCATENATE公式FormulaEvaluator evaluator = workbook.getCreationHelper().createFormulaEvaluator();Cell concatenateCell = row.createCell(0);concatenateCell.setCellFormula("CONCATENATE(A1,\" \",B1)");//计算CONCATENATE公式结果Cell concatenateResultCell = row.createCell(1);concatenateResultCell.setCellValue(evaluator.evaluate(concatenateCell).getStringValue());

4）下拉选择

//下拉值private List<String> grade = Arrays.asList("高", "中", "低");(此处省略n行代码)Sheet sheet = workbook.createSheet("sheet");DataValidation dataValidation = this.addPullDownConstraint(i, sheet, grade );sheet.addValidationData(dataValidation);

5）设置单元格的数据类型

数字格式

// 设置单元格样式 - 数字格式CellStyle numberCellStyle = workbook.createCellStyle();numberCellStyle.setDataFormat(workbook.createDataFormat().getFormat("#,##0.00"));//指定单元格Row row = sheet.createRow(0);Cell cell = row.createCell(0);cell.setCellStyle(numberCellStyle);

日期格式

// 设置单元格样式 - 日期格式CellStyle dateCellStyle = workbook.createCellStyle();dateCellStyle.setDataFormat(workbook.createDataFormat().getFormat("yyyy-MM-dd"));//指定单元格Row row = sheet.createRow(0);Cell cell = row.createCell(0);cell.setCellStyle(dateCellStyle);

三、导出完整示例

下面的示例使用SpringBoot项目来演示：

pom.xml依赖：

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId><version>2.7.5</version></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter</artifactId><version>2.7.5</version></dependency><dependency><groupId>org.apache.poi</groupId><artifactId>poi</artifactId><version>4.1.2</version></dependency><!-- https://mvnrepository.com/artifact/org.apache.poi/poi-ooxml --><dependency><groupId>org.apache.poi</groupId><artifactId>poi-ooxml</artifactId><version>4.1.2</version></dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>1.16.16</version></dependency><!-- https://mvnrepository.com/artifact/com.alibaba.fastjson2/fastjson2 --><dependency><groupId>com.alibaba</groupId><artifactId>fastjson</artifactId><version>2.0.21</version></dependency><dependency><groupId>org.apache.commons</groupId><artifactId>commons-lang3</artifactId><version>3.12.0</version></dependency>

Controller层代码：

package shijiangdiya.controller;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.web.bind.annotation.PostMapping;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RestController;import shijiangdiya.utils.ExportUtils;import javax.servlet.http.HttpServletResponse;@RestController@RequestMapping("/sync")publicclassExportController{}

1）代码

@Autowiredprivate HttpServletResponse response;@PostMapping("/export")publicvoidexport(){//模拟json数据    String data = "[{\n" +"    \"studentId\": \"20210101\",\n" +"    \"name\": \"Alice\",\n" +"    \"age\": 20,\n" +"    \"credit\": 80\n" +"  },\n" +"  {\n" +"    \"studentId\": \"20210102\",\n" +"    \"name\": \"Bob\",\n" +"    \"age\": 21,\n" +"    \"credit\": 85\n" +"  },\n" +"  {\n" +"    \"studentId\": \"20210103\",\n" +"    \"name\": \"Charlie\",\n" +"    \"age\": 22,\n" +"    \"credit\": 90\n" +"  },\n" +"  {\n" +"    \"studentId\": \"20210104\",\n" +"    \"name\": \"David\",\n" +"    \"age\": 20,\n" +"    \"credit\": 75\n" +"  },\n" +"  {\n" +"    \"studentId\": \"20210105\",\n" +"    \"name\": \"Emily\",\n" +"    \"age\": 21,\n" +"    \"credit\": 82\n" +"  },\n" +"  {\n" +"    \"studentId\": \"20210106\",\n" +"    \"name\": \"Frank\",\n" +"    \"age\": 22,\n" +"    \"credit\": 88\n" +"  },\n" +"  {\n" +"    \"studentId\": \"20210107\",\n" +"    \"name\": \"Grace\",\n" +"    \"age\": 20,\n" +"    \"credit\": 81\n" +"  },\n" +"  {\n" +"    \"studentId\": \"20210108\",\n" +"    \"name\": \"Henry\",\n" +"    \"age\": 21,\n" +"    \"credit\": 89\n" +"  },\n" +"  {\n" +"    \"studentId\": \"20210109\",\n" +"    \"name\": \"Isaac\",\n" +"    \"age\": 22,\n" +"    \"credit\": 92\n" +"  },\n" +"  {\n" +"    \"studentId\": \"20210110\",\n" +"    \"name\": \"John\",\n" +"    \"age\": 20,\n" +"    \"credit\": 78\n" +"  },\n" +"  {\n" +"    \"studentId\": \"20210111\",\n" +"    \"name\": \"Kelly\",\n" +"    \"age\": 21,\n" +"    \"credit\": 84\n" +"  },\n" +"  {\n" +"    \"studentId\": \"20210112\",\n" +"    \"name\": \"Linda\",\n" +"    \"age\": 22,\n" +"    \"credit\": 87\n" +"  },\n" +"  {\n" +"    \"studentId\": \"20210113\",\n" +"    \"name\": \"Mike\",\n" +"    \"age\": 20,\n" +"    \"credit\": 77\n" +"  },\n" +"  {\n" +"    \"studentId\": \"20210114\",\n" +"    \"name\": \"Nancy\",\n" +"    \"age\": 21,\n" +"    \"credit\": 83\n" +"  },\n" +"  {\n" +"    \"studentId\": \"20210115\",\n" +"    \"name\": \"Oscar\",\n" +"    \"age\": 22,\n" +"    \"credit\": 91\n" +"  },\n" +"  {\n" +"    \"studentId\": \"20210116\",\n" +"    \"name\": \"Paul\",\n" +"    \"age\": 20,\n" +"    \"credit\": 76\n" +"  },\n" +"  {\n" +"    \"studentId\": \"20210117\",\n" +"    \"name\": \"Queen\",\n" +"    \"age\": 21,\n" +"    \"credit\": 86\n" +"  },\n" +"  {\n" +"    \"studentId\": \"20210118\",\n" +"    \"name\": \"Rachel\",\n" +"    \"age\": 22,\n" +"    \"credit\": 94\n" +"  },\n" +"  {\n" +"    \"studentId\": \"20210119\",\n" +"    \"name\": \"Sarah\",\n" +"    \"age\": 20,\n" +"    \"credit\": 79\n" +"  },\n" +"  {\n" +"    \"studentId\": \"20210120\",\n" +"    \"name\": \"Tom\",\n" +"    \"age\": 21,\n" +"    \"credit\": 80\n" +"  }\n" +"]\n";    ExportUtils.exportExcel("学生信息", data, Student.class, response);}

2）工具类

牛逼啊！接私活必备的 N 个开源项目！赶快收藏

/** * 数据导出 * @param fileName 导出excel名称 * @param data 导出的数据 * @param c 导出数据的实体class * @param response 响应 * @throws Exception */publicstaticvoidexportExcel(String fileName, String data, Class<?> c, HttpServletResponse response)throws Exception {try {// 创建表头// 创建工作薄        Workbook workbook = new XSSFWorkbook();        Sheet sheet = workbook.createSheet();// 创建表头行        Row rowHeader = sheet.createRow(0);if (c == null) {thrownew RuntimeException("Class对象不能为空!");        }        Field[] declaredFields = c.getDeclaredFields();        List<String> headerList = new ArrayList<>();if (declaredFields.length == 0) {return;        }for (int i = 0; i < declaredFields.length; i++) {            Cell cell = rowHeader.createCell(i, CellType.STRING);            String headerName = String.valueOf(declaredFields[i].getName());            cell.setCellValue(headerName);            headerList.add(i, headerName);        }// 填充数据        List<?> objects = JSONObject.parseArray(data, c);        Object obj = c.newInstance();if (!CollectionUtils.isEmpty(objects)) {for (int o = 0; o < objects.size(); o++) {                Row rowData = sheet.createRow(o + 1);for (int i = 0; i < headerList.size(); i++) {                    Cell cell = rowData.createCell(i);                    Field nameField = c.getDeclaredField(headerList.get(i));                    nameField.setAccessible(true);                    String value = String.valueOf(nameField.get(objects.get(o)));                    cell.setCellValue(value);                }            }        }        response.setContentType("application/vnd.ms-excel");        String resultFileName = URLEncoder.encode(fileName, "UTF-8");        response.setHeader("Content-disposition", "attachment;filename=" + resultFileName + ";" + "filename*=utf-8''" + resultFileName);        workbook.write(response.getOutputStream());        workbook.close();        response.flushBuffer();    } catch (Exception e) {thrownew RuntimeException(e);    }}

3）结果

四、导入完整示例

1）代码

@PostMapping("/import")publicvoidimportExcel(@RequestParam("excel") MultipartFile excel){    Workbook workbook = null;try {        workbook = WorkbookFactory.create(excel.getInputStream());        Sheet sheet = workbook.getSheetAt(0);        List<Student> students = new ArrayList<>();int i = 0;for (Row row : sheet) {            Row row1 = sheet.getRow(i + 1);if(row1 != null){                Student data = new Student();                data.setStudentId(Integer.parseInt(row1.getCell(0).getStringCellValue()));                data.setName(row1.getCell(1).getStringCellValue());                data.setAge(Integer.parseInt(row1.getCell(2).getStringCellValue()));                data.setCredit(Integer.parseInt(row1.getCell(3).getStringCellValue()));                students.add(data);            }        }        System.out.println(students);        workbook.close();    } catch (IOException e) {thrownew RuntimeException(e);    }

2）工具类

/**     * 导入     * @param workbook 工作簿     * @param c 实体类     * @return 实体类集合     */publicstatic <T> List<T> importExcel(Workbook workbook,Class<?> c){        List<T> dataList = new ArrayList<>();try {            Sheet sheet = workbook.getSheetAt(0);int i = 0;            T o = null;for (Row row : sheet) {                Row row1 = sheet.getRow(i + 1);if(row1 != null){                    o = (T) c.newInstance();                    Field[] declaredFields = c.getDeclaredFields();for (int i1 = 0; i1 < declaredFields.length; i1++) {                        String name = declaredFields[i1].getName();                        Field declaredField1 = o.getClass().getDeclaredField(name);                        declaredField1.setAccessible(true);                        Cell cell = row1.getCell(i1);                        String type = declaredFields[i1].getType().getName();                        String value = String.valueOf(cell);if(StringUtils.equals(type,"int") || StringUtils.equals(type,"Integer")){                            declaredField1.set(o,Integer.parseInt(value));                        } elseif(StringUtils.equals(type,"java.lang.String") || StringUtils.equals(type,"char") || StringUtils.equals(type,"Character") ||                                StringUtils.equals(type,"byte") || StringUtils.equals(type,"Byte")){                            declaredField1.set(o,value);                        } elseif(StringUtils.equals(type,"boolean") || StringUtils.equals(type,"Boolean")){                            declaredField1.set(o,Boolean.valueOf(value));                        } elseif(StringUtils.equals(type,"double") || StringUtils.equals(type,"Double")){                            declaredField1.set(o,Double.valueOf(value));                        } elseif (StringUtils.equals(type,"long") || StringUtils.equals(type,"Long")) {                            declaredField1.set(o,Long.valueOf(value));                        } elseif(StringUtils.equals(type,"short") || StringUtils.equals(type,"Short")){                            declaredField1.set(o,Short.valueOf(value));                        } elseif(StringUtils.equals(type,"float") || StringUtils.equals(type,"Float")){                            declaredField1.set(o,Float.valueOf(value));                        }                    }                }                dataList.add(o);            }            workbook.close();return dataList;        }catch (Exception e){            e.printStackTrace();        }return dataList;    }

注意：导入工具类仅限Java的八大基础数据类型和String类型。如果还有其他类型需要自己扩展。

3）结果

学生信息集合：

为了跟上AI时代我干了一件事儿，我创建了一个知识星球社群：ChartGPT与副业。想带着大家一起探索ChatGPT和新的AI时代。

有很多小伙伴搞不定ChatGPT账号，于是我们决定，凡是这三天之内加入ChatPGT的小伙伴，我们直接送一个正常可用的永久ChatGPT独立账户。
不光是增长速度最快，我们的星球品质也绝对经得起考验，短短一个月时间，我们的课程团队发布了8个专栏、18个副业项目：
简单说下这个星球能给大家提供什么：
1、不断分享如何使用ChatGPT来完成各种任务，让你更高效地使用ChatGPT，以及副业思考、变现思路、创业案例、落地案例分享。
2、分享ChatGPT的使用方法、最新资讯、商业价值。
3、探讨未来关于ChatGPT的机遇，共同成长。
4、帮助大家解决ChatGPT遇到的问题。
5、提供一整年的售后服务，一起搞副业
星球福利：
1、加入星球4天后，就送ChatGPT独立账号。
2、邀请你加入ChatGPT会员交流群。
3、赠送一份完整的ChatGPT手册和66个ChatGPT副业赚钱手册。
其它福利还在筹划中...不过，我给你大家保证，加入星球后，收获的价值会远远大于今天加入的门票费用 ！
本星球第一期原价399，目前属于试运营，早鸟价139，每超过50人涨价10元，星球马上要来一波大的涨价，如果你还在犹豫，可能最后就要以更高价格加入了。。
早就是优势。建议大家尽早以便宜的价格加入！