EasyPOI 入门 基本使用

简单的介绍

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

开始使用

在使用之前，需要大家自己搭建好自己的Maven项目。

在maven中导入相关jar

注意 在这里如果以前导入了POI的包 需要把它删掉 以免版本不兼容 出现问题

<!-- easypoi的支持 -->
<dependency>
  <groupId>cn.afterturn</groupId>
  <artifactId>easypoi-base</artifactId>
  <version>3.2.0</version>
</dependency>
<dependency>
  <groupId>cn.afterturn</groupId>
  <artifactId>easypoi-web</artifactId>
  <version>3.2.0</version>
</dependency>
<dependency>
  <groupId>cn.afterturn</groupId>
  <artifactId>easypoi-annotation</artifactId>
  <version>3.2.0</version>
</dependency>

准备一个类

@Excel:代表这个字段要生成到excel中去
name:这个excel的表头名称
width:这一列的宽度设置

public class Employee implements Serializable {

    private Long id;
    @Excel(name = "用户名称")
    private String username;
    @Excel(name = "邮件",width = 20)
    private String email;
   // 省略了getter,setter
}

功能测试

@Test
public void testExcel() throws Exception{
    //准备员工数据
    Employee e1 = new Employee();
    e1.setId(1L);
    e1.setUsername("张三");
    e1.setEmail("zhang@qq.com");
    Employee e2 = new Employee();
    e2.setId(2L);
    e2.setUsername("李四");
    e2.setEmail("li@qq.com");

    List<Employee> list = new ArrayList<>();
    list.add(e1);
    list.add(e2);

    /**
     * 进行相应的展出
     *  参数1:一些基本配置(表头等)
     *  参数2:导出的类型
     *  参数3:导出的数据
     */
    Workbook workbook = ExcelExportUtil.exportExcel(new ExportParams(),
            Employee.class, list);

    //保存数据
    FileOutputStream fos = new FileOutputStream("emp.xls");
    workbook.write(fos);
    fos.close();

}

最后结果

到了这里 EasyPOI的入门就可以了！这里只是实现了一个非常家简单的功能
下面我们在说说其他的基础配置

其他的基础配置

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

实体类的代码

注意:类上面有一个@ExcelTarget(“emp”)的注解

@Excel(name = "年龄_emp")
private Integer age = 18;
@Excel(name = "生日",format = "yyyy-MM-dd")
private Date bornDate = new Date();
@Excel(name = "性别",replace={"男_true","女_false"})
private Boolean sex = true;
@ExcelEntity
private Department department;
@Excel(name="头像",type = 2)
private String headImage;

这里注意：我们需要加一个Department类的支持

public class Department {
    private Long id;
    @Excel(name = "部门名称_emp")
    private String name;
}

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

代码测试

Department department1 = new Department();
department1.setId(1L);
department1.setName("教学部");
Department department2 = new Department();
department2.setId(2L);
department2.setName("IT部");
//准备员工数据
Employee e1 = new Employee();
e1.setId(1L);
e1.setUsername("张三");
e1.setEmail("zhang@qq.com");
e1.setDepartment(department1);
e1.setHeadImage("user.png");
Employee e2 = new Employee();
e2.setId(2L);
e2.setUsername("李四");
e2.setEmail("li@qq.com");
e2.setDepartment(department2);
e2.setHeadImage("user-red.png");

List<Employee> list = new ArrayList<>();
list.add(e1);
list.add(e2);

/**
 * 进行相应的展出
 *  参数1:一些基本配置(表头等)
 *  参数2:导出的类型
 *  参数3:导出的数据
 */
Workbook workbook = ExcelExportUtil.exportExcel(new ExportParams("员工信息","员工数据"),
        Employee.class, list);

//保存数据
FileOutputStream fos = new FileOutputStream("emp.xls");
workbook.write(fos);
fos.close();

最终效果

总结

以上就是EasyPOI 的基本使用 但是这只是它的基本导出功能
既然有导出 那肯定就会有导入功能了。导入功能将在下一篇的EasyPOI讲，并和SpringMVC集成