摘要:
jeasypoi 功能如同名字 easy, 主打的功能就是容易, 让一个没见接触过 poi 的人员 就可以方便的写出 Excel 导出, Excel 模板导出, Excel 导入, Word 模板导出, 通过简单的注解和模板 语言 (熟悉的表达式语法), 完成以前复杂的写法.
主要特点:
1. 设计精巧, 使用简单
2. 接口丰富, 扩展简单
3. 默认值多, write less do more
4.AbstractView 支持, web 导出可以简单明了
一, 升级日志
Excel 和 Word 简易工具类, 可以无缝集成 springmvc, 也为 jeecg 快速开发平台提供更便捷的, 强大的导入导出.
一对多表结构导入导出 BUG 修正;
jeecg 个性化定制版;
支持配置 jeecg 字典 code 翻译导出;
支持自定义字典扩展接口, 方便用户自定义;
大数据导入导出优化;
三, JEasyPoi 集成方法
1. 采用 maven 方式
在 pom.xml 引入以下依赖. 配置私服 http://maven.jeecg.org/nexus/
- <dependency>
- <groupId>org.jeecgframework</groupId>
- <artifactId>jeasypoi-base</artifactId>
- <version>2.1.5</version>
- </dependency>
- <dependency>
- <groupId>org.jeecgframework</groupId>
- <artifactId>jeasypoi-web</artifactId>
- <version>2.1.5</version>
- </dependency>
- <dependency>
- <groupId>org.jeecgframework</groupId>
- <artifactId>jeasypoi-annotation</artifactId>
- <version>2.1.5</version>
- </dependency>
2. 非 maven 方式
直接拷贝相关 jar 进项目 Lib 中
四, 源码下载
- http://git.oschina.net/jeecg/jeasypoi
- https://github.com/zhangdaiscott/jeasypoi
五, 测试实战
1. 注解, 导入导出都是基于注解的, 实体上做上注解, 标示导出对象, 同时可以做一些操作
- @ExcelTarget("courseEntity")
- public class CourseEntity implements java.io.Serializable {
- /** 主键 */
- private String id;
- /** 课程名称 */
- @Excel(name = "课程名称", orderNum = "1", needMerge = true)
- private String name;
- /** 老师主键 */
- @ExcelEntity(id = "yuwen")
- @ExcelVerify()
- private TeacherEntity teacher;
- /** 老师主键 */
- @ExcelEntity(id = "shuxue")
- private TeacherEntity shuxueteacher;
- @ExcelCollection(name = "选课学生", orderNum = "4")
- private List<StudentEntity> students;
2. 基础导出 传入导出参数, 导出对象, 以及对象列表即可完成导出
HSSFWorkbook workbook = ExcelExportUtil.exportExcel(new ExportParams("2412312", "测试", "测试"), CourseEntity.class, list);
3. 基础导出, 带有索引 在到处参数设置一个值, 就可以在导出列增加索引
- ExportParams params = new ExportParams("2412312", "测试", "测试");
- params.setAddIndex(true);
- HSSFWorkbook workbook = ExcelExportUtil.exportExcel(params,
- TeacherEntity.class, telist);
4. 导出 Map 创建类似注解的集合, 即可完成 Map 的导出, 略有麻烦
- List<ExcelExportEntity> entity = new ArrayList<ExcelExportEntity>();
- entity.add(new ExcelExportEntity("姓名", "name"));
- entity.add(new ExcelExportEntity("性别", "sex"));
- List<Map<String, String>> list = new ArrayList<Map<String, String>>();
- Map<String, String> map;
- for (int i = 0; i <10; i++) {
- map = new HashMap<String, String>();
- map.put("name", "1" + i);
- map.put("sex", "2" + i);
- list.add(map);
- }
- HSSFWorkbook workbook = ExcelExportUtil.exportExcel(new ExportParams("测试", "测试"), entity, list);
5. 模板导出 根据模板配置, 完成对应导出
- TemplateExportParams params = new TemplateExportParams();
- params.setHeadingRows(2);
- params.setHeadingStartRow(2);
- Map<String,Object> map = new HashMap<String, Object>();
- map.put("year", "2013");
- map.put("sunCourses", list.size());
- Map<String,Object> obj = new HashMap<String, Object>();
- map.put("obj", obj);
- obj.put("name", list.size());
- params.setTemplateUrl("org/jeecgframework/poi/excel/doc/exportTemp.xls");
- Workbook book = ExcelExportUtil.exportExcel(params, CourseEntity.class, list,
- map);
6. 导入 设置导入参数, 传入文件或者流, 即可获得相应的 list
- ImportParams params = new ImportParams();
- params.setTitleRows(2);
- params.setHeadRows(2);
- //params.setSheetNum(9);
- params.setNeedSave(true);
- long start = new Date().getTime();
- List<CourseEntity> list = ExcelImportUtil.importExcel(new File(
- "d:/tt.xls"), CourseEntity.class, params);
7. 和 spring mvc 的无缝融合 简单几句话, Excel 导出搞定
- @RequestMapping(params = "exportXls")
- public String exportXls(CourseEntity course,HttpServletRequest request,HttpServletResponse response, DataGrid dataGrid,ModelMap map) {
- CriteriaQuery cq = new CriteriaQuery(CourseEntity.class, dataGrid);
- org.jeecgframework.core.extend.hqlsearch.HqlGenerateUtil.installHql(cq, course, request.getParameterMap());
- List<CourseEntity> courses = this.courseService.getListByCriteriaQuery(cq,false);
- map.put(NormalExcelConstants.FILE_NAME,"用户信息");
- map.put(NormalExcelConstants.CLASS,CourseEntity.class);
- map.put(NormalExcelConstants.PARAMS,new ExportParams("课程列表", "导出人: Jeecg",
- "导出信息"));
- map.put(NormalExcelConstants.DATA_LIST,courses);
- return NormalExcelConstants.JEECG_EXCEL_VIEW;
- }
8.Excel 导入校验, 过滤不符合规则的数据, 追加错误信息到 Excel, 提供常用的校验规则, 已经通用的校验接口
- /**
- * Email 校验
- */
- @Excel(name = "Email", width = 25)
- @ExcelVerify(isEmail = true, notNull = true)
- private String email;
- /**
- * 手机号校验
- */
- @Excel(name = "Mobile", width = 20)
- @ExcelVerify(isMobile = true, notNull = true)
- private String mobile;
- ExcelImportResult<ExcelVerifyEntity> result = ExcelImportUtil.importExcelVerify(new File(
- "d:/tt.xls"), ExcelVerifyEntity.class, params);
- for (int i = 0; i <result.getList().size(); i++) {
- System.out.println(ReflectionToStringBuilder.toString(result.getList().get(i)));
- }
9. 导入 Map 设置导入参数, 传入文件或者流, 即可获得相应的 list, 自定义 Key, 需要实现 IExcelDataHandler 接口
- ImportParams params = new ImportParams();
- List<Map<String,Object>> list = ExcelImportUtil.importExcel(new File(
- "d:/tt.xls"), Map.class, params);
来源: http://www.bubuko.com/infodetail-2560758.html