@@ -11,13 +11,21 @@ EasyPoi Excel和 Word简易工具类 | |||||
开发者:魔幻之翼 xf.key@163.com | 开发者:魔幻之翼 xf.key@163.com | ||||
[测试项目](http://git.oschina.net/jueyue/easypoi-test): http://git.oschina.net/jueyue/easypoi-test | |||||
[开发文档请查看DOC下面的EasyPoi教程](http://git.oschina.net/jueyue/easypoi/blob/master/doc/EasyPoi%E6%95%99%E7%A8%8B.docx?dir=0&filepath=doc%2FEasyPoi%E6%95%99%E7%A8%8B.docx&oid=133ebde5641f128420023dbdc2533ab4b53c7792&sha=4c8d94c80544811e2e358518bad6c689a63c13e9) | [开发文档请查看DOC下面的EasyPoi教程](http://git.oschina.net/jueyue/easypoi/blob/master/doc/EasyPoi%E6%95%99%E7%A8%8B.docx?dir=0&filepath=doc%2FEasyPoi%E6%95%99%E7%A8%8B.docx&oid=133ebde5641f128420023dbdc2533ab4b53c7792&sha=4c8d94c80544811e2e358518bad6c689a63c13e9) | ||||
!!!2.1.6 版本开始和之前的版本校验不兼用,使用JSR303的校验,删除了之前的注解,请注意 | !!!2.1.6 版本开始和之前的版本校验不兼用,使用JSR303的校验,删除了之前的注解,请注意 | ||||
!!! 2.3.0 模板导出有问题,请使用2.3.0.1修复版本 | !!! 2.3.0 模板导出有问题,请使用2.3.0.1修复版本 | ||||
版本介绍 | |||||
history.md | |||||
基础示例 | |||||
basedemo.md | |||||
[测试项目](http://git.oschina.net/jueyue/easypoi-test): http://git.oschina.net/jueyue/easypoi-test | |||||
--------------------------- | --------------------------- | ||||
EasyPoi的主要特点 | EasyPoi的主要特点 | ||||
-------------------------- | -------------------------- | ||||
@@ -75,54 +83,6 @@ https://oss.sonatype.org/content/repositories/snapshots/ | |||||
</dependency> | </dependency> | ||||
``` | ``` | ||||
--------------------------- | |||||
EasyPoi 文档 | |||||
--------------------------- | |||||
这几篇是旧的教程,不过和现在大同小异 | |||||
[Excel 介绍篇](http://note.youdao.com/share/?id=ea5166076313d437abbfb28a18d85486&type=note) | |||||
[Excel 工具类](http://note.youdao.com/share/?id=dcfef5355d1d75b718be8fd563ad5216&type=note) | |||||
[Excel 注解介绍.第一篇](http://note.youdao.com/share/?id=9898d1777ca97b81d82a6e151b880dbb&type=note) | |||||
[Excel 注解介绍.第二篇](http://note.youdao.com/share/?id=9898d1777ca97b81d82a6e151b880dbb&type=note) | |||||
[Excel 实体类](http://note.youdao.com/share/?id=dab97eababf8e91356f87be204b581e8&type=note) | |||||
[Word模板导出教程](http://note.youdao.com/share/?id=26794c8eb4a285828663178c0ae854a2&type=note) | |||||
后面都是新的了 | |||||
[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) | |||||
[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) | |||||
[EasyPoi 在spring mvc中简易开发方式](http://note.youdao.com/share/?id=8b04c4d88a0574a59aeaffd142c8e34b&type=note) | |||||
[EasyPoi-新版自定义导出样式类型](http://note.youdao.com/share/?id=7937a9fe15f1016b8f39bf813be894f8&type=note) | |||||
[EasyPoi-标签-模板导出的语法介绍](http://blog.csdn.net/qjueyue/article/details/45231801) | |||||
[EasyPoi-Excel预览(New)](http://blog.afterturn.cn/?p=34) | |||||
[EasyPoi-多行模板输出(New)](http://blog.afterturn.cn/?p=40) | |||||
[EasyPoi-校验集成](http://blog.afterturn.cn/?p=65) | |||||
-------------------------- | |||||
EasyPoi 模板 表达式支持 | |||||
-------------------------- | |||||
- 空格分割 | |||||
- 三目运算 {{test ? obj:obj2}} | |||||
- n: 表示 这个cell是数值类型 {{n:}} | |||||
- le: 代表长度{{le:()}} 在if/else 运用{{le:() > 8 ? obj1 : obj2}} | |||||
- fd: 格式化时间 {{fd:(obj;yyyy-MM-dd)}} | |||||
- fn: 格式化数字 {{fn:(obj;###.00)}} | |||||
- fe: 遍历数据,创建row | |||||
- !fe: 遍历数据不创建row | |||||
- $fe: 下移插入,把当前行,下面的行全部下移.size()行,然后插入 | |||||
- !if: 删除当前列 {{!if:(test)}} | |||||
- 单引号表示常量值 '' 比如'1' 那么输出的就是 1 | |||||
- &NULL& 控制 | |||||
- ]] 换行符 | |||||
-------------------------- | -------------------------- | ||||
pom说明 | pom说明 | ||||
@@ -173,240 +133,3 @@ word和sax读取的时候才使用,就不是必须的了,请手动引用,JSR303 | |||||
</dependency> | </dependency> | ||||
``` | ``` | ||||
-------------------------- | |||||
版本修改 | |||||
-------------------------- | |||||
- 2.3.1 修复bug,推荐更新 | |||||
- 支持三目运算嵌套 | |||||
- 提供大量导出功能,分批插入数据 | |||||
- 勉强支持模板统计了 | |||||
- 把最大值设置成参数 | |||||
- 2.3.0.1 修复bug,推荐更新 | |||||
- 提供的PDF基础的Excel导出支持 | |||||
- 提供了Excel Charts的导出支持 | |||||
- 升级了POI | |||||
- 提供了Word换行支持 | |||||
- 图片提供统一缓存 | |||||
- 增加Cell取值工具,自动分辨合并单元格和独立单元格 | |||||
- 修复合并单元格,获取cell改为递归,之前判断有问题 | |||||
- 修改了下,el表达式的==判断,给fe加上了样式自定义方法 | |||||
- 修复if(),单字段的判断 | |||||
- 修复其他一些bug | |||||
- 2.1.6 校验规则不向下兼容,升级请自行考虑 | |||||
- 其实不想升的,不过有必要的bug要修复,所以就先生上来吧 | |||||
- 升级交易为hibernate校验,hibernate的maven自己配置可选 | |||||
- WORD的Excel遍历 的Row,改为Insert Row | |||||
- 修复了font的数组越界 | |||||
- 修复targetId的数组越界 | |||||
- 修复多行模板导出的bug | |||||
- 增加了验证Excel的功能 | |||||
- 2.1.5 bug修复,建议升级 | |||||
- fix指定sheetNum导入的bug | |||||
- add导入时候setIndex(null) 可以防止识别为集合的问题 | |||||
- fix导入excel列数量判断有bug,导致有些列数漏掉校验 | |||||
- update修改了getValue的方式,减少导入cell value识别错误 | |||||
- 2.1.4 | |||||
- 模板输出自动合并单元格功能 | |||||
- 多行模板数据导出 | |||||
- 导出链接功能 | |||||
- 把反射加入了缓存 | |||||
- word和Excel语法保持了统一 | |||||
- Excel to Html 增加了图片显示和缓存功能 | |||||
- 导入增加一个参数startSheetIndex 用以指定sheet位置 | |||||
- 2.1.3 | |||||
- 屏蔽了科学计数法的问题 | |||||
- 修复了多模版记得清空记录信息 | |||||
- 加入了map setValue的接口,用以自定义setValue,主要是可以自定义key | |||||
- 把合并单元格的数据提起出来,让大家都可以复用 | |||||
- 多个sheet导出问题 | |||||
- 2.1.2 | |||||
- groupId 改成org.jeecg,为了以后可以直接提交到中央库了 | |||||
- 把test 那个模块删除了 | |||||
- 提供了Excel 预览的功能 | |||||
- type 新增一个 4类型,用于Excel是数字,但是java 是String,防止科学计数法 | |||||
- 修复一些bug | |||||
- 2.1.1-release -小更新/防止下一个预览功能太久不能发布更新 | |||||
- $fe标签 | |||||
- 几个可能影响使用的bug | |||||
- 导入Map的支持 | |||||
- 2.0.9-release--模板功能更新 | |||||
- 修复了中文路径,float类型导入等bug | |||||
- 增加了根据CellStyler判断cell类型的功能 | |||||
- 优化了一下代码,sort 的compare 改为类实现接口,getValue统一由public处理 | |||||
- height和width 都改成double 可能更加准确的调整 | |||||
- 升级到common-lang3 | |||||
- 可以循环解析多个模板 | |||||
- !!模板增加了多个标签功能 | |||||
- 2.0.8-release--小版本更新 | |||||
- 分开了基础注解和base包,编译maven多模块集成 | |||||
- 加强了Excel导入的校验功能,可以追加错误信息,过滤不合格数据 | |||||
- 修复了spring mvc下的07版本不支持的问题 | |||||
- 添加了@ Controller 注解,扫描org.jeecgframework.poi.excel.view路径就可以了,不用写bean了 | |||||
- 加强了styler的自定义功能,参数改为entity,自由控制 | |||||
- test包下面增加了几个demo | |||||
- 导出添加了一个冰冻列属性,可以简单执行 | |||||
- PS: 经过这段时间项目中的测试,模板导出Excel复杂报表可以省5倍以上的时间,特别是样式复杂的完全可以在Excel中完成,不是在代码中完成了 | |||||
- 2.0.7-release--推荐更新 | |||||
- 增加了合计的参数,便于统计合计信息 | |||||
- 修改了样式设置,使用默认设置,提供其他设置,和样式接口 | |||||
- 模板导出增加了插入导出的功能 | |||||
- 模板导出重用了Excel导出的代码功能更加强劲 | |||||
- 新增了Sax导入方式,大数据导入提供接口操作 | |||||
- Word修改了页眉页脚不替换的bug | |||||
- 修改了捕获异常日志的bug | |||||
- 修复了模板导出,Spring View没识别版本的bug | |||||
- 修复了其他一些小bug | |||||
- 2.0.6-release | |||||
- 修复导入的自定义格式异常 | |||||
- 修复导入的BigDecimal不识别 | |||||
- 导出大数据替换为SXSSFWorkbook,提高07版本Excel导出效率 | |||||
- 根据sonar的提示,修复编码格式问题 | |||||
- 做了更加丰富的测试 | |||||
- word 导出的优化 | |||||
- 2.0.6-SNAPSHOT | |||||
- 增加map的导出 | |||||
- 增加index 列 | |||||
--------------------------- | |||||
EasyPoi导出实例 | |||||
--------------------------- | |||||
1.注解,导入导出都是基于注解的,实体上做上注解,标示导出对象,同时可以做一些操作 | |||||
```Java | |||||
@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.基础导出 | |||||
传入导出参数,导出对象,以及对象列表即可完成导出 | |||||
```Java | |||||
HSSFWorkbook workbook = ExcelExportUtil.exportExcel(new ExportParams( | |||||
"2412312", "测试", "测试"), CourseEntity.class, list); | |||||
``` | |||||
3.基础导出,带有索引 | |||||
在到处参数设置一个值,就可以在导出列增加索引 | |||||
```Java | |||||
ExportParams params = new ExportParams("2412312", "测试", "测试"); | |||||
params.setAddIndex(true); | |||||
HSSFWorkbook workbook = ExcelExportUtil.exportExcel(params, | |||||
TeacherEntity.class, telist); | |||||
``` | |||||
4.导出Map | |||||
创建类似注解的集合,即可完成Map的导出,略有麻烦 | |||||
```Java | |||||
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.模板导出 | |||||
根据模板配置,完成对应导出 | |||||
```Java | |||||
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 | |||||
```Java | |||||
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导出搞定 | |||||
```Java | |||||
@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,提供常用的校验规则,已经通用的校验接口 | |||||
```Java | |||||
@Excel(name = "Email", width = 25) | |||||
@Max(value = 15,message = "max 最大值不能超过15") | |||||
private int email; | |||||
/** | |||||
* 手机号 | |||||
*/ | |||||
@Excel(name = "Mobile", width = 20) | |||||
@NotNull | |||||
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接口 | |||||
```Java | |||||
ImportParams params = new ImportParams(); | |||||
List<Map<String,Object>> list = ExcelImportUtil.importExcel(new File( | |||||
"d:/tt.xls"), Map.class, params); | |||||
``` | |||||
10.大数据量Excel导出 | |||||
exportBigExcel 的方法 ,最后可以关闭closeExportBigExcel 也可以不关闭 | |||||
@@ -0,0 +1,210 @@ | |||||
--------------------------- | |||||
EasyPoi 文档 | |||||
--------------------------- | |||||
这几篇是旧的教程,不过和现在大同小异 | |||||
[Excel 介绍篇](http://note.youdao.com/share/?id=ea5166076313d437abbfb28a18d85486&type=note) | |||||
[Excel 工具类](http://note.youdao.com/share/?id=dcfef5355d1d75b718be8fd563ad5216&type=note) | |||||
[Excel 注解介绍.第一篇](http://note.youdao.com/share/?id=9898d1777ca97b81d82a6e151b880dbb&type=note) | |||||
[Excel 注解介绍.第二篇](http://note.youdao.com/share/?id=9898d1777ca97b81d82a6e151b880dbb&type=note) | |||||
[Excel 实体类](http://note.youdao.com/share/?id=dab97eababf8e91356f87be204b581e8&type=note) | |||||
[Word模板导出教程](http://note.youdao.com/share/?id=26794c8eb4a285828663178c0ae854a2&type=note) | |||||
后面都是新的了 | |||||
[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) | |||||
[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) | |||||
[EasyPoi 在spring mvc中简易开发方式](http://note.youdao.com/share/?id=8b04c4d88a0574a59aeaffd142c8e34b&type=note) | |||||
[EasyPoi-新版自定义导出样式类型](http://note.youdao.com/share/?id=7937a9fe15f1016b8f39bf813be894f8&type=note) | |||||
[EasyPoi-标签-模板导出的语法介绍](http://blog.csdn.net/qjueyue/article/details/45231801) | |||||
[EasyPoi-Excel预览(New)](http://blog.afterturn.cn/?p=34) | |||||
[EasyPoi-多行模板输出(New)](http://blog.afterturn.cn/?p=40) | |||||
[EasyPoi-校验集成](http://blog.afterturn.cn/?p=65) | |||||
-------------------------- | |||||
EasyPoi 模板 表达式支持 | |||||
-------------------------- | |||||
- 空格分割 | |||||
- 三目运算 {{test ? obj:obj2}} | |||||
- n: 表示 这个cell是数值类型 {{n:}} | |||||
- le: 代表长度{{le:()}} 在if/else 运用{{le:() > 8 ? obj1 : obj2}} | |||||
- fd: 格式化时间 {{fd:(obj;yyyy-MM-dd)}} | |||||
- fn: 格式化数字 {{fn:(obj;###.00)}} | |||||
- fe: 遍历数据,创建row | |||||
- !fe: 遍历数据不创建row | |||||
- $fe: 下移插入,把当前行,下面的行全部下移.size()行,然后插入 | |||||
- !if: 删除当前列 {{!if:(test)}} | |||||
- 单引号表示常量值 '' 比如'1' 那么输出的就是 1 | |||||
- &NULL& 控制 | |||||
- ]] 换行符 | |||||
--------------------------- | |||||
EasyPoi导出实例 | |||||
--------------------------- | |||||
1.注解,导入导出都是基于注解的,实体上做上注解,标示导出对象,同时可以做一些操作 | |||||
```Java | |||||
@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.基础导出 | |||||
传入导出参数,导出对象,以及对象列表即可完成导出 | |||||
```Java | |||||
HSSFWorkbook workbook = ExcelExportUtil.exportExcel(new ExportParams( | |||||
"2412312", "测试", "测试"), CourseEntity.class, list); | |||||
``` | |||||
3.基础导出,带有索引 | |||||
在到处参数设置一个值,就可以在导出列增加索引 | |||||
```Java | |||||
ExportParams params = new ExportParams("2412312", "测试", "测试"); | |||||
params.setAddIndex(true); | |||||
HSSFWorkbook workbook = ExcelExportUtil.exportExcel(params, | |||||
TeacherEntity.class, telist); | |||||
``` | |||||
4.导出Map | |||||
创建类似注解的集合,即可完成Map的导出,略有麻烦 | |||||
```Java | |||||
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.模板导出 | |||||
根据模板配置,完成对应导出 | |||||
```Java | |||||
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 | |||||
```Java | |||||
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导出搞定 | |||||
```Java | |||||
@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,提供常用的校验规则,已经通用的校验接口 | |||||
```Java | |||||
@Excel(name = "Email", width = 25) | |||||
@Max(value = 15,message = "max 最大值不能超过15") | |||||
private int email; | |||||
/** | |||||
* 手机号 | |||||
*/ | |||||
@Excel(name = "Mobile", width = 20) | |||||
@NotNull | |||||
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接口 | |||||
```Java | |||||
ImportParams params = new ImportParams(); | |||||
List<Map<String,Object>> list = ExcelImportUtil.importExcel(new File( | |||||
"d:/tt.xls"), Map.class, params); | |||||
``` | |||||
10.大数据量Excel导出 | |||||
exportBigExcel 的方法 ,最后可以关闭closeExportBigExcel 也可以不关闭 | |||||
11.如果View不起作用,已经发现被其他View处理掉的情况,使用下面这个,进行了统一封装,相同的效果 | |||||
```Java | |||||
PoiBaseView | |||||
public static void render(Map<String, Object> model, HttpServletRequest request, | |||||
HttpServletResponse response, String viewName) { | |||||
PoiBaseView view = null; | |||||
if (BigExcelConstants.BIG_EXCEL_VIEW.equals(viewName)) { | |||||
view = new BigExcelExportView(); | |||||
} else if (MapExcelConstants.JEECG_MAP_EXCEL_VIEW.equals(viewName)) { | |||||
view = new JeecgMapExcelView(); | |||||
} else if (NormalExcelConstants.JEECG_EXCEL_VIEW.equals(viewName)) { | |||||
view = new JeecgSingleExcelView(); | |||||
} else if (TemplateExcelConstants.JEECG_TEMPLATE_EXCEL_VIEW.equals(viewName)) { | |||||
view = new JeecgTemplateExcelView(); | |||||
} else if (MapExcelGraphConstants.MAP_GRAPH_EXCEL_VIEW.equals(viewName)) { | |||||
view = new MapGraphExcelView(); | |||||
} | |||||
try { | |||||
view.renderMergedOutputModel(model, request, response); | |||||
} catch (Exception e) { | |||||
LOGGER.error(e.getMessage(), e); | |||||
} | |||||
} | |||||
``` |
@@ -0,0 +1,99 @@ | |||||
-------------------------- | |||||
版本修改 | |||||
-------------------------- | |||||
- 2.3.1 修复bug,推荐更新 | |||||
- 支持三目运算嵌套 | |||||
- 提供大量导出功能,分批插入数据 | |||||
- 勉强支持模板统计了 | |||||
- 把最大值设置成参数 | |||||
- 2.3.0.1 修复bug,推荐更新 | |||||
- 提供的PDF基础的Excel导出支持 | |||||
- 提供了Excel Charts的导出支持 | |||||
- 升级了POI | |||||
- 提供了Word换行支持 | |||||
- 图片提供统一缓存 | |||||
- 增加Cell取值工具,自动分辨合并单元格和独立单元格 | |||||
- 修复合并单元格,获取cell改为递归,之前判断有问题 | |||||
- 修改了下,el表达式的==判断,给fe加上了样式自定义方法 | |||||
- 修复if(),单字段的判断 | |||||
- 修复其他一些bug | |||||
- 2.1.6 校验规则不向下兼容,升级请自行考虑 | |||||
- 其实不想升的,不过有必要的bug要修复,所以就先生上来吧 | |||||
- 升级交易为hibernate校验,hibernate的maven自己配置可选 | |||||
- WORD的Excel遍历 的Row,改为Insert Row | |||||
- 修复了font的数组越界 | |||||
- 修复targetId的数组越界 | |||||
- 修复多行模板导出的bug | |||||
- 增加了验证Excel的功能 | |||||
- 2.1.5 bug修复,建议升级 | |||||
- fix指定sheetNum导入的bug | |||||
- add导入时候setIndex(null) 可以防止识别为集合的问题 | |||||
- fix导入excel列数量判断有bug,导致有些列数漏掉校验 | |||||
- update修改了getValue的方式,减少导入cell value识别错误 | |||||
- 2.1.4 | |||||
- 模板输出自动合并单元格功能 | |||||
- 多行模板数据导出 | |||||
- 导出链接功能 | |||||
- 把反射加入了缓存 | |||||
- word和Excel语法保持了统一 | |||||
- Excel to Html 增加了图片显示和缓存功能 | |||||
- 导入增加一个参数startSheetIndex 用以指定sheet位置 | |||||
- 2.1.3 | |||||
- 屏蔽了科学计数法的问题 | |||||
- 修复了多模版记得清空记录信息 | |||||
- 加入了map setValue的接口,用以自定义setValue,主要是可以自定义key | |||||
- 把合并单元格的数据提起出来,让大家都可以复用 | |||||
- 多个sheet导出问题 | |||||
- 2.1.2 | |||||
- groupId 改成org.jeecg,为了以后可以直接提交到中央库了 | |||||
- 把test 那个模块删除了 | |||||
- 提供了Excel 预览的功能 | |||||
- type 新增一个 4类型,用于Excel是数字,但是java 是String,防止科学计数法 | |||||
- 修复一些bug | |||||
- 2.1.1-release -小更新/防止下一个预览功能太久不能发布更新 | |||||
- $fe标签 | |||||
- 几个可能影响使用的bug | |||||
- 导入Map的支持 | |||||
- 2.0.9-release--模板功能更新 | |||||
- 修复了中文路径,float类型导入等bug | |||||
- 增加了根据CellStyler判断cell类型的功能 | |||||
- 优化了一下代码,sort 的compare 改为类实现接口,getValue统一由public处理 | |||||
- height和width 都改成double 可能更加准确的调整 | |||||
- 升级到common-lang3 | |||||
- 可以循环解析多个模板 | |||||
- !!模板增加了多个标签功能 | |||||
- 2.0.8-release--小版本更新 | |||||
- 分开了基础注解和base包,编译maven多模块集成 | |||||
- 加强了Excel导入的校验功能,可以追加错误信息,过滤不合格数据 | |||||
- 修复了spring mvc下的07版本不支持的问题 | |||||
- 添加了@ Controller 注解,扫描org.jeecgframework.poi.excel.view路径就可以了,不用写bean了 | |||||
- 加强了styler的自定义功能,参数改为entity,自由控制 | |||||
- test包下面增加了几个demo | |||||
- 导出添加了一个冰冻列属性,可以简单执行 | |||||
- PS: 经过这段时间项目中的测试,模板导出Excel复杂报表可以省5倍以上的时间,特别是样式复杂的完全可以在Excel中完成,不是在代码中完成了 | |||||
- 2.0.7-release--推荐更新 | |||||
- 增加了合计的参数,便于统计合计信息 | |||||
- 修改了样式设置,使用默认设置,提供其他设置,和样式接口 | |||||
- 模板导出增加了插入导出的功能 | |||||
- 模板导出重用了Excel导出的代码功能更加强劲 | |||||
- 新增了Sax导入方式,大数据导入提供接口操作 | |||||
- Word修改了页眉页脚不替换的bug | |||||
- 修改了捕获异常日志的bug | |||||
- 修复了模板导出,Spring View没识别版本的bug | |||||
- 修复了其他一些小bug | |||||
- 2.0.6-release | |||||
- 修复导入的自定义格式异常 | |||||
- 修复导入的BigDecimal不识别 | |||||
- 导出大数据替换为SXSSFWorkbook,提高07版本Excel导出效率 | |||||
- 根据sonar的提示,修复编码格式问题 | |||||
- 做了更加丰富的测试 | |||||
- word 导出的优化 | |||||
- 2.0.6-SNAPSHOT | |||||
- 增加map的导出 | |||||
- 增加index 列 | |||||