028-86261949

当前位置:首页 > 技术交流 > EasyPoi使用入门

EasyPoi使用入门

2018/11/07 16:06 分类: 技术交流 浏览:0

咱们在开发的时候,总会遇到需要通过代码操作办公软件的情况,而excel与word的操作最为频繁。
当然我们Java程序员可以选择JXL或者POI来完成相应的Excel操作,但是大家用过都知道,有些地方感觉还是不够简单,不那么尽如人意。
今天给大家介绍一个EasyPoi,就算我们不会底层的POI,也可以非常轻松的完成Excel的操作。EasyPoi,主打简单,不过功用依然OK(绝对够用)。现在我们就来尝试一步一步还进行它的入门学习:


基本功能搭建

(注:在使用之前,需要自己先搭建好相应的Maven环境)

1.在Maven中引入easypoi

  1. <!-- easypoi的支持 -->
  2. <dependency>
  3.   <groupId>cn.afterturn</groupId>
  4.   <artifactId>easypoi-base</artifactId>
  5.   <version>3.2.0</version>
  6. </dependency>
  7. <dependency>
  8.   <groupId>cn.afterturn</groupId>
  9.   <artifactId>easypoi-web</artifactId>
  10.   <version>3.2.0</version>
  11. </dependency>
  12. <dependency>
  13.   <groupId>cn.afterturn</groupId>
  14.   <artifactId>easypoi-annotation</artifactId>
  15.   <version>3.2.0</version>
  16. </dependency>
复制代码



2.准备一个类

@Excel:代表这个字段要生成到excel中去
  name:这个excel的表头名称
  width:这一列的宽度设置
  1. public class Employee implements Serializable {
  2.  
  3.     private Long id;
  4.     @Excel(name = "用户名称")
  5.     private String username;
  6.     @Excel(name = "邮件",width = 20)
  7.     private String email;
  8.    // 省略了getter,setter
  9. }
  10.  
复制代码


3. 功能测试

  1. @Test
  2. public void testExcel() throws Exception{
  3.     //准备员工数据
  4.     Employee e1 = new Employee();
  5.     e1.setId(1L);
  6.     e1.setUsername("张三");
  7.     e1.setEmail("zhang@qq.com");
  8.     Employee e2 = new Employee();
  9.     e2.setId(2L);
  10.     e2.setUsername("李四");
  11.     e2.setEmail("li@qq.com");
  12.  
  13.     List<Employee> list = new ArrayList<>();
  14.     list.add(e1);
  15.     list.add(e2);
  16.  
  17.     /**
  18.      * 进行相应的展出
  19.      *  参数1:一些基本配置(表头等)
  20.      *  参数2:导出的类型
  21.      *  参数3:导出的数据
  22.      */
  23.     Workbook workbook = ExcelExportUtil.exportExcel(new ExportParams(),
  24.             Employee.class, list);
  25.  
  26.     //保存数据
  27.     FileOutputStream fos = new FileOutputStream("emp.xls");
  28.     workbook.write(fos);
  29.     fos.close();
  30.  
  31. }
  32.  
复制代码


最后效果

非常简单的功能我们就可以实现相应的效果!


其它基础配置提出总题

刚才咱们只是加了两个简单的String
那么,如果我们有如下要求呢?
l sex是boolean值,我怎么让它true显示男,false展示女
l bornDate是日期类型,我怎么完成它的格式化展示
l 头像是图片,我们可以直接把图片进行导出嘛?
l 如果员工有一个对应的部门(多对一)字段,怎么怎么进行相应的展示


实体类代码展示

准备的字段与配置如下:
注意:类上面有一个@ExcelTarget("emp")的注解
 
  1. @Excel(name = "年龄_emp")
  2. private Integer age = 18;
  3. @Excel(name = "生日",format = "yyyy-MM-dd")
  4. private Date bornDate = new Date();
  5. @Excel(name = "性别",replace={"男_true","女_false"})
  6. private Boolean sex = true;
  7. @ExcelEntity
  8. private Department department;
  9. @Excel(name="头像",type = 2)
  10. private String headImage;
  11.  
复制代码

 

这里注意:我们需要加一个Department类的支持
  1. public class Department {
  2.     private Long id;
  3.     @Excel(name = "部门名称_emp")
  4.     private String name;
  5. }
复制代码


 

我们下面说一下相应的配置的含义:
年龄_emp
  必需保证类的ExcelTarget的id是emp才会展示
format = "yyyy-MM-dd":日期的格式
注:如果数据库是varchar,还需要配置databaseFormat
replace={"_true","_false"}
如果值是true,那么展示男,如果是false,则在页面展示女
@ExcelEntity(id="emp"):对应另一个关连对象
id是为这个实体取一个名称,和关连的导出对应
type = 2 :代表这个一个图片展示



代码测试

  1. Department department1 = new Department();
  2. department1.setId(1L);
  3. department1.setName("教学部");
  4. Department department2 = new Department();
  5. department2.setId(2L);
  6. department2.setName("IT部");
  7. //准备员工数据
  8. Employee e1 = new Employee();
  9. e1.setId(1L);
  10. e1.setUsername("张三");
  11. e1.setEmail("zhang@qq.com");
  12. e1.setDepartment(department1);
  13. e1.setHeadImage("user.png");
  14. Employee e2 = new Employee();
  15. e2.setId(2L);
  16. e2.setUsername("李四");
  17. e2.setEmail("li@qq.com");
  18. e2.setDepartment(department2);
  19. e2.setHeadImage("user-red.png");
  20.  
  21. List<Employee> list = new ArrayList<>();
  22. list.add(e1);
  23. list.add(e2);
  24.  
  25. /**
  26. * 进行相应的展出
  27. *  参数1:一些基本配置(表头等)
  28. *  参数2:导出的类型
  29. *  参数3:导出的数据
  30. */
  31. Workbook workbook = ExcelExportUtil.exportExcel(new ExportParams("员工信息","员工数据"),
  32.         Employee.class, list);
  33.  
  34. //保存数据
  35. FileOutputStream fos = new FileOutputStream("emp.xls");
  36. workbook.write(fos);
  37. fos.close();
  38.  
复制代码


最终效果

看到没有,我们只需要写非常简单的代码,就可以完成以后一些很麻烦的功能。当然,我们只给大家展示了easypoi通过注解的导出功能。它还有相应的导出,通过模板生成等实用的功能。另外,对于SpringMVC也有专门的支持!



 

   感谢源码时代教学讲师提供此文章!
   本文为原创文章,转载请注明出处!
 
#标签:EasyPoi,使用入门