EasyPoi教程

简要教程

目录

简要教程........................................................................................................................................... 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,用以区别多个导出对象,便于一个对象用于多个导出实例