发布时间 : 星期一 文章EasyPoi教程更新完毕开始阅读2e6f50fea300a6c30c229fec
简要教程
目录
简要教程........................................................................................................................................... 1
前面的话 ................................................................................................................................... 1 第一章 Excel篇 ................................................................................................................. 2
Excel的注解 ..................................................................................................................... 2 Excel导出 ......................................................................................................................... 6 Excel模板导出 ............................................................................................................... 11 Excel导入 ....................................................................................................................... 14 第二章 Word篇 ............................................................................................................... 18
Word模板导出 ............................................................................................................... 18 第三章PDF导出 .................................................................................................................... 19 第四章HTML导出 ................................................................................................................. 20
HTML导出 ...................................................................................................................... 20 第五章 Excel 图表 ................................................................................................................ 21 第六章缓存以及工具类 ......................................................................................................... 22
修改记录
日期 2016-1-20 2016-1-22 版本 1.1 作者 JueYue 修订类型 新建 修改 描述 导入校验,文件合法性校验 1．0 JueYue 前面的话
EasyPoi的编写其实是一次意外,之前我不太愿意写导入导出,因为代码号复杂,每次一个Excel 都要写几百行,仅有少量的复用,一次需要写许多的导入导出,又没有人手,正好看到了Jeecg对应Poi的一个封装,但是他的封装比较简单,就自己在他思想的基础上开始构建现在的项目了. EasyPoi秉承思想就是尽量简单,入库少,可以很快把简单的工作干了这是第一个版本的功能,后来慢慢用的人多了,也就功能慢慢丰富了,现在包含了Excel的导入导出,Word的导出,PDF的导出,Excel Charts的导出,Html的导出5个功能模块,重点还是Excel,毕竟Excel是最常用的. EasyPoi已经走过了3年,未来也会继续走,保持现有简单的功能继续前进. 程序员你懂得,懒得测试,目前测试覆盖率,基本功能我都写了,没有的就遇到了再说吧
第一章 Excel篇 Excel的注解
本来注解是整个模块的精髓,不过随着模板的使用,他的重要性也就不如以前了,不过还是最简单的使用方式.注解都是在easypoi-annotation这个jar,拆分开的目的就是为了让多模块的maven项目少引用,因为easypoi-annotation是没有任何依赖的,只是单纯的注解
@ExcelExcel导出基本注释
这个注解是整个的基石,简单项目只靠这一个注解就可以完成所有功能
限定符和类型
可选元素和说明
java.lang.String databaseFormat
导出时间设置,如果字段是Date类型则不需要设置数据库如果是string 类型,这个需要设置这个数据库格式
java.lang.String exportFormat
导出的时间格式,以这个是否为空来判断是否需要格式化日期
java.lang.String format
时间格式,相当于同时设置了exportFormat和importFormat
double height
导出时在excel中每个列的高度单位为字符，一个汉字=2个字符
int imageType
导出类型 1 从file读取 2 是从数据库中读取默认是文件同样导入也是一样的
java.lang.String importFormat
导入的时间格式,以这个是否为空来判断是否需要格式化日期
boolean isHyperlink
这个是不是超链接,如果是需要实现接口返回对象
java.lang.String isImportField
导入时会校验这个字段,看看这个字段是不是导入的Excel中有,如果没有说明是错误的Excel 本意是想用true的,想想还是false比较好可以使用a_id,b_id来确实是否使用
boolean isStatistics
是否自动统计数据,如果是统计,true的话在最后追加一行统计,把所有数据都和这个处理会吞没异常,请注意这一点
boolean isWrap
是否换行即支持\\n
int[] mergeRely
合并单元格依赖关系,比如第二列合并是基于第一列则{1}就可以了
boolean mergeVertical
纵向合并内容相同的单元格
boolean needMerge
是否需要纵向合并单元格(用于含有list中,单个的单元格,合并list创建的多个row)
java.lang.String orderNum
展示到第几个可以使用a_id,b_id来确定不同排序
java.lang.String[] replace
值得替换导出是{a_id,b_id} 导入反过来,所以只用写一个
java.lang.String
savePath
导入路径,如果是图片可以填写,默认是upload/className/ IconEntity这个类对应的就是upload/Icon/
java.lang.String
suffix
文字后缀,如% 90 变成90%
int
type
导出类型 1 是文本 2 是图片,3是函数默认是文本
double
width
导出时在excel中每个列的宽单位为字符，一个汉字=2个字符如以列名列内容中较合适的长度例如姓名列6 【姓名一般三个字】性别列4【男女占1，但是列标题两个汉字】限制1-255
这当中需要说明的是:
mergeVertical和mergeRely这两者是一起存在的功能,就是纵向合并单元和,mergeRely是判断和前面单元格的依赖,可用于多种集合,不太好导出情况,来合并处理
DEMO:
最简单的导出
复杂点的导出:
@ExcelTarget标记导入ID
就一个功能标记ID,用以区别多个导出对象,便于一个对象用于多个导出实例