EasyPOI是一款优秀的开源Java库,专为简化和优化Excel文件的导入导出操作而设计。下面,我会介绍EasyPOI在项目中使用EasyPOI,实现Excel文件的高效操作。帮助读者全面了解和掌握这一工具。
EasyPOI简介
官网:
http://www.wupaas.com/
开发指南:
http://doc.wupaas.com/docs/easypoi/easypoi-1c0u4mo8p4ro8
Gitee:
https://gitee.com/lemur/easypoi#https://gitee.com/link?target=http%3A%2F%2Fwww.wupaas.com%2F
EasyPOI的目标是做到比Apache POI更简单,降低Excel导入导出时的复杂度。其主要特点如下:
- 简洁的API:EasyPOI拥有更为简洁直观的API,使得操作Excel变得更加容易。
- 注解驱动:使用注解来配置Excel映射,减少代码量,提高开发效率。
- 模板导出支持:提供了丰富的模板导出功能,便于生成各种复杂的报表。
- 强大的导入功能:支持大数据量的导入,且可以对导入数据进行校验。
- 多样的数据处理:支持图片、公式、日期等多种类型的数据处理。
使用场景
- 数据报表生成:可以快速生成企业内部的财务、销售等报表。
- 数据汇总分析:对收集来的大量数据进行汇总和分析,生成可视化Excel报告。
- 信息管理系统:在学生、员工等信息管理系统中,进行数据的快捷导入导出。
基础用法
环境准备
使用EasyPOI之前,需要将其作为依赖加入到你的项目中。如果你使用Maven,可以在pom.xml中加入如下依赖:
主依赖
<dependency><groupId>cn.afterturn</groupId><artifactId>easypoi-base</artifactId><version>4.2.0</version></dependency><dependency><groupId>cn.afterturn</groupId><artifactId>easypoi-web</artifactId><version>4.2.0</version></dependency><dependency><groupId>cn.afterturn</groupId><artifactId>easypoi-annotation</artifactId><version>4.2.0</version></dependency>
其他依赖
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><!-- MyBatis --><dependency><groupId>org.mybatis.spring.boot</groupId><artifactId>mybatis-spring-boot-starter</artifactId><version>2.2.0</version></dependency><!-- MySQL Connector --><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>5.1.47</version></dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-thymeleaf</artifactId></dependency>
数据库
Create TableCREATE TABLE `user` (`id` int(10) NOT NULL AUTO_INCREMENT COMMENT '编号',`name` varchar(255) DEFAULT NULL COMMENT '姓名',`bir` timestamp NULL DEFAULT NULL COMMENT '出生日期',`photo` varchar(150) DEFAULT NULL COMMENT '头像',`habbys` varchar(100) DEFAULT NULL COMMENT '爱好',`cardno` varchar(18) DEFAULT NULL COMMENT '身份证号',`address` varchar(60) DEFAULT NULL COMMENT '住址',PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=6 DEFAULT CHARSET=utf8
Field | Type | Comment | |
主键 | id | int(10) NOT NULL | 编号 |
name | varchar(255) NULL | 姓名 | |
bir | timestamp NULL | 出生日期 | |
photo | varchar(150) NULL | 头像 | |
habbys | varchar(100) NULL | 爱好 | |
cardno | varchar(18) NULL | 身份证号 | |
address | varchar(60) NULL | 住址 |
配置文件
mybatis.mapper-locations=classpath:mapper/*Mapper.xml
mybatis.type-aliases-package=com.yu.pojo
server.port=8081
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
spring.datasource.password=root
spring.datasource.url=jdbc:mysql://localhost:3306/EasyPOI
spring.datasource.username=root
spring.thymeleaf.cache=false
spring.servlet.multipart.max-file-size=10MB
spring.servlet.multipart.max-request-size=10MB
数据模型
@Data
@ExcelTarget("users")
public class User implements Serializable {@Excel(name = "编号")private String id;@Excel(name = "姓名")private String name;@Excel(name = "生日", format = "yyyy年MM月dd日")private Date bir;@Excel(name = "头像信息", type = 2, savePath = "src/main/resources/static/images")private String photo;@Excel(name = "爱好", width = 12.0)private String habbys;@Excel(name = "身份证号", width = 15.0)private String cardno;@Excel(name = "家庭住址", width = 15.0)private String address;
}
DAO层
@Mapper
public interface UserMapper {//查询所有List<User> findAll();//插入记录void save(User user);
}
UserMapper.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
<mapper namespace="com.yu.dao.UserMapper"><!--查询所有--><select id="findAll" resultType="User">select id,name,bir,photo,habbys,cardno,address from user</select><!--插入记录--><insert id="save" parameterType="User" useGeneratedKeys="true" keyProperty="id">insert into user values (#{id},#{name},#{bir},#{photo},#{habbys},#{cardno},#{address})</insert>
</mapper>
Service层接口
public interface UserService {List<User> findAll();//批量保存void saveAll(List<User> users);
}
Service层服务类
@Service
@Transactional
public class UserServiceImpl implements UserService {@Autowiredprivate UserMapper userMapper;@Overridepublic List<User> findAll() {return userMapper.findAll();}@Overridepublic void saveAll(List<User> users) {users.forEach(user -> {user.setId(null);user.setPhoto(user.getPhoto().substring(user.getPhoto().lastIndexOf("\\") + 1));System.out.println(user.getPhoto());userMapper.save(user);});}
}
启动类
@SpringBootApplication
public class EasyPOIApplication {public static void main(String[] args) {SpringApplication.run(EasyPOIApplication.class, args);}
}
Thymeleaf
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head><meta charset="UTF-8"><title>导入excel的主页面</title><style>body {font-family: Arial, sans-serif;background-color: #f5f5f5;}.container-fluid {max-width: 960px;margin: 0 auto;padding: 20px;}h1 {text-align: center;margin-bottom: 30px;}form {margin-bottom: 20px;}.form-group {display: flex;justify-content: center;align-items: center;}.form-control {margin-right: 10px;}table {width: 100%;border-collapse: collapse;}th, td {padding: 10px;text-align: left;border: 1px solid #ccc;}img {max-width: 60px;max-height: 60px;}.btn {display: inline-block;padding: 10px 20px;background-color: #007bff;color: #fff;text-decoration: none;border-radius: 4px;}.btn:hover {background-color: #0056b3;}</style>
<body>
<div class="container-fluid"><div class="row"><div class="col-md-12"><h1>选择Excel文件导入到数据中</h1><form th:action="@{/user/import}" method="post" enctype="multipart/form-data" class="form-inline"><div class="form-group"><input class="form-control" type="file" name="excelFile"><input type="submit" class="btn btn-danger" value="导入数据"></div></form></div><div class="col-md-12"><h1>显示导入数据列表</h1><table class="table table-bordered" ><tr><th>编号</th><th>头像</th><th>姓名</th><th>生日</th><th>爱好</th><th>身份证号</th><th>家庭住址</th></tr><tr th:each="user : ${users}"><td th:text="${user.id}"></td><td><img th:src="${'/images/'+ user.photo}" height="60px" alt=""></td><td th:text="${user.name}"></td><td th:text="${#dates.format(user.bir,'yyyy-MM-dd')}"></td><td th:text="${user.habbys}"></td><td th:text="${user.cardno}"></td><td th:text="${user.address}"></td></tr></table><hr><a th:href="@{/user/export}" class="btn btn-info">导出excel</a></div></div>
</div></body>
</html>
Controller层
@Controller
@RequestMapping("/user")
@Slf4j
public class UserController {@Autowiredprivate UserService userService;//查询所有@RequestMapping("/findAll")public String findAll(HttpServletRequest request){List<User> users = userService.findAll();request.setAttribute("users",users);return "index";}//导入excel@RequestMapping("/import")public String importExcel(MultipartFile excelFile) throws Exception {log.info("文件名称: [{}]",excelFile.getOriginalFilename());ImportParams params = new ImportParams();params.setTitleRows(1);//设置一级标题行为1行params.setHeadRows(1);//设置header标题为1行List<User> users;try (InputStream inputStream = excelFile.getInputStream()) {users = ExcelImportUtil.importExcel(inputStream, User.class, params);}log.info("导入总数为: [{}]", users.size());userService.saveAll(users);return "redirect:/user/findAll";}//导出excel@RequestMapping("/export")public void exportExcel(HttpServletResponse response, HttpServletRequest request) throws IOException {List<User> users = userService.findAll();users.forEach(user -> {try {Excel excelAnn = user.getClass().getDeclaredField("photo").getAnnotation(Excel.class);user.setPhoto(excelAnn.savePath()+'/'+user.getPhoto());} catch (NoSuchFieldException e) {e.printStackTrace();}});Workbook workbook = ExcelExportUtil.exportExcel(new ExportParams("用户列表", "用户信息"), User.class, users);response.setHeader("content-disposition","attachment;fileName="+ URLEncoder.encode("用户信息表.xls","UTF-8"));ServletOutputStream os = response.getOutputStream();workbook.write(os);os.close();workbook.close();}}
测试
Excel导入
导入之前
导入中
导入之后
Excel导出
Excel查看
项目结构
结语
EasyPOI提供了一套非常简单而强大的解决方案,用于处理Java中Excel的导入导出。它的易用性让开发人员可以更加关注业务逻辑,而不是被繁琐的数据处理细节所困扰。无论你是需要处理简单的数据列表,还是复杂的业务报表,EasyPOI都可以帮助你高效完成任务。
希望这篇博文能够帮助你开始使用EasyPOI来提升你的工作效率。当然,实际应用中,你还需要根据自己的具体场景去深入学习和掌握更多细节和技巧。