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