Excel和Word 简易工具类，JEasyPoi 2.1.5 版本发布

Excel和Word 简易工具类，JEasyPoi 2.1.5 版本发布 

摘要：

     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 翻译导出；
• 支持自定义字典扩展接口，方便用户自定义；
• 大数据导入导出优化；

二、在线WIKI文档

        这几篇是旧的教程,不过和现在大同小异

           Excel 介绍篇 Excel 工具类 Excel 注解介绍.第一篇 Excel 注解介绍.第二篇 Excel 实体类 Word模板导出教程

        后面都是新的了

               JEasyPoi 在spring mvc中简易开发方式

               JEasyPoi-新版自定义导出样式类型

               JEasyPoi-标签-模板导出的语法介绍

               JEasyPoi-Excel预览

三、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

五、技术交流

•  技术论坛：www.jeecg.org
•  QQ交流群： ⑥190866569、⑤ 293658367、④176031980(满)、②106838471(满)
•  在线体验：   http://demo.jeecg.org

六、测试实战

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);