|
|
@@ -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 也可以不关闭
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|