You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

README.md 6.7 KiB

10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178
  1. ===========================
  2. EasyPoi Excel和 Word简易工具类
  3. ===========================
  4. easypoi功能如同名字easy,主打的功能就是易容,让一个没见接触过poi的人员
  5. 就可以方便的写出Excel导出,Excel模板导出,Excel导入,Word模板导出,通过简单的注解和模板
  6. 语言(熟悉的表达式语法),完成以前复杂的写法
  7. 作者博客:http://blog.csdn.net/qjueyue
  8. 作者邮箱: qrb.jueyue@gmail.com
  9. QQ群: 364192721
  10. ---------------------------
  11. EasyPoi的主要特点
  12. --------------------------
  13. 1.设计精巧,使用简单
  14. 2.接口丰富,扩展简单
  15. 3.默认值多,write less do more
  16. 4.AbstractView 支持,web导出可以简单明了
  17. ---------------------------
  18. EasyPoi的几个入口工具类
  19. ---------------------------
  20. 1.ExcelExportUtil Excel导出(普通导出,模板导出)
  21. 2.ExcelImportUtil Excel导入
  22. 3.WordExportUtil Word导出(只支持docx ,doc版本poi存在图片的bug,暂不支持)
  23. ---------------------------
  24. 关于Excel导出XLS和XLSX区别
  25. ---------------------------
  26. 1.导出时间XLS比XLSX快2-3倍
  27. 2.导出大小XLS是XLSX的2-3倍或者更多
  28. 3.导出需要综合网速和本地速度做考虑^~^
  29. --------------------------
  30. 版本修改
  31. --------------------------
  32. - 2.0.6-release
  33. - 修复导入的自定义格式异常
  34. - 修复导入的BigDecimal不识别
  35. - 导出大数据替换为SXSSFWorkbook,提高07版本Excel导出效率
  36. - 根据sonar的提示,修复编码格式问题
  37. - 做了更加丰富的测试
  38. - word 导出的优化
  39. - 2.0.6-SNAPSHOT
  40. - 增加map的导出
  41. - 增加index 列
  42. ---------------------------
  43. EasyPoi 文档
  44. ---------------------------
  45. 这几篇是旧的教程,不过和现在大同小异
  46. [Excel 介绍篇](http://note.youdao.com/share/?id=ea5166076313d437abbfb28a18d85486&type=note)
  47. [Excel 工具类](http://note.youdao.com/share/?id=dcfef5355d1d75b718be8fd563ad5216&type=note)
  48. [Excel 注解介绍.第一篇](http://note.youdao.com/share/?id=9898d1777ca97b81d82a6e151b880dbb&type=note)
  49. [Excel 注解介绍.第二篇](http://note.youdao.com/share/?id=9898d1777ca97b81d82a6e151b880dbb&type=note)
  50. [Excel 实体类](http://note.youdao.com/share/?id=dab97eababf8e91356f87be204b581e8&type=note)
  51. [Word模板导出教程](http://note.youdao.com/share/?id=26794c8eb4a285828663178c0ae854a2&type=note)
  52. 后面都是新的了
  53. [EasyPoi-在财务报表中的应用](http://git.oschina.net/jueyue/easypoi/wikis/EasyPoi-%E5%9C%A8%E8%B4%A2%E5%8A%A1%E6%8A%A5%E8%A1%A8%E4%B8%AD%E7%9A%84%E5%BA%94%E7%94%A8)
  54. [EasyPoi-如何筛选导出属性](http://git.oschina.net/jueyue/easypoi/wikis/EasyPoi-%E5%A6%82%E4%BD%95%E7%AD%9B%E9%80%89%E5%AF%BC%E5%87%BA%E5%B1%9E%E6%80%A7)
  55. [EasyPoi 在spring mvc中简易开发方式](http://note.youdao.com/share/?id=8b04c4d88a0574a59aeaffd142c8e34b&type=note)
  56. [EasyPoi-新版自定义导出样式类型](http://note.youdao.com/share/?id=7937a9fe15f1016b8f39bf813be894f8&type=note)
  57. ---------------------------
  58. EasyPoi导出实例
  59. ---------------------------
  60. 1.注解,导入导出都是基于注解的,实体上做上注解,标示导出对象,同时可以做一些操作
  61. ```Java
  62. @ExcelTarget("courseEntity")
  63. public class CourseEntity implements java.io.Serializable {
  64. /** 主键 */
  65. private String id;
  66. /** 课程名称 */
  67. @Excel(name = "课程名称", orderNum = "1", needMerge = true)
  68. private String name;
  69. /** 老师主键 */
  70. @ExcelEntity(id = "yuwen")
  71. @ExcelVerify()
  72. private TeacherEntity teacher;
  73. /** 老师主键 */
  74. @ExcelEntity(id = "shuxue")
  75. private TeacherEntity shuxueteacher;
  76. @ExcelCollection(name = "选课学生", orderNum = "4")
  77. private List<StudentEntity> students;
  78. ```
  79. 2.基础导出
  80. 传入导出参数,导出对象,以及对象列表即可完成导出
  81. ```Java
  82. HSSFWorkbook workbook = ExcelExportUtil.exportExcel(new ExportParams(
  83. "2412312", "测试", "测试"), CourseEntity.class, list);
  84. ```
  85. 3.基础导出,带有索引
  86. 在到处参数设置一个值,就可以在导出列增加索引
  87. ```Java
  88. ExportParams params = new ExportParams("2412312", "测试", "测试");
  89. params.setAddIndex(true);
  90. HSSFWorkbook workbook = ExcelExportUtil.exportExcel(params,
  91. TeacherEntity.class, telist);
  92. ```
  93. 4.导出Map
  94. 创建类似注解的集合,即可完成Map的导出,略有麻烦
  95. ```Java
  96. List<ExcelExportEntity> entity = new ArrayList<ExcelExportEntity>();
  97. entity.add(new ExcelExportEntity("姓名", "name"));
  98. entity.add(new ExcelExportEntity("性别", "sex"));
  99. List<Map<String, String>> list = new ArrayList<Map<String, String>>();
  100. Map<String, String> map;
  101. for (int i = 0; i < 10; i++) {
  102. map = new HashMap<String, String>();
  103. map.put("name", "1" + i);
  104. map.put("sex", "2" + i);
  105. list.add(map);
  106. }
  107. HSSFWorkbook workbook = ExcelExportUtil.exportExcel(new ExportParams(
  108. "测试", "测试"), entity, list);
  109. ```
  110. 5.模板导出
  111. 根据模板配置,完成对应导出
  112. ```Java
  113. TemplateExportParams params = new TemplateExportParams();
  114. params.setHeadingRows(2);
  115. params.setHeadingStartRow(2);
  116. Map<String,Object> map = new HashMap<String, Object>();
  117. map.put("year", "2013");
  118. map.put("sunCourses", list.size());
  119. Map<String,Object> obj = new HashMap<String, Object>();
  120. map.put("obj", obj);
  121. obj.put("name", list.size());
  122. params.setTemplateUrl("org/jeecgframework/poi/excel/doc/exportTemp.xls");
  123. Workbook book = ExcelExportUtil.exportExcel(params, CourseEntity.class, list,
  124. map);
  125. ```
  126. 6.导入
  127. 设置导入参数,传入文件或者流,即可获得相应的list
  128. ```Java
  129. ImportParams params = new ImportParams();
  130. params.setTitleRows(2);
  131. params.setHeadRows(2);
  132. //params.setSheetNum(9);
  133. params.setNeedSave(true);
  134. long start = new Date().getTime();
  135. List<CourseEntity> list = ExcelImportUtil.importExcel(new File(
  136. "d:/tt.xls"), CourseEntity.class, params);
  137. ```
  138. 7.和spring mvc的无缝融合
  139. 简单几句话,Excel导出搞定
  140. ```Java
  141. @RequestMapping(params = "exportXls")
  142. public String exportXls(CourseEntity course,HttpServletRequest request,HttpServletResponse response
  143. , DataGrid dataGrid,ModelMap map) {
  144. CriteriaQuery cq = new CriteriaQuery(CourseEntity.class, dataGrid);
  145. org.jeecgframework.core.extend.hqlsearch.HqlGenerateUtil.installHql(cq, course, request.getParameterMap());
  146. List<CourseEntity> courses = this.courseService.getListByCriteriaQuery(cq,false);
  147. map.put(NormalExcelConstants.FILE_NAME,"用户信息");
  148. map.put(NormalExcelConstants.CLASS,CourseEntity.class);
  149. map.put(NormalExcelConstants.PARAMS,new ExportParams("课程列表", "导出人:Jeecg",
  150. "导出信息"));
  151. map.put(NormalExcelConstants.DATA_LIST,courses);
  152. return NormalExcelConstants.JEECG_EXCEL_VIEW;
  153. }
  154. ```