开发环境
jdk 1.8
Maven 3.6
Tomcat 8.5
SpringBoot 2.1.4.RELEASE
Apache-POI 3.6
Idea
注意: 我是在现有的基于SpringBoot的分模块项目中集成的文件导出功能,所以就不再从项目构建开始介绍了,如有对SpringBoot项目构建不熟悉,或对构建分模块项目感兴趣的同学,可移步[SpringBoot构建分模块项目...(还没写呢)]
Maven依赖
在pom.xml中添加依赖,一下两种方式,根据个人习惯,任选其一;
<properties> <apache.poi.version>3.6apache.poi.version> properties> <dependencies> <dependency> <groupId>org.apache.poigroupId> <artifactId>poiartifactId> <version>${apache.poi.version}version> dependency> dependencies>
<dependencies> <dependency> <groupId>org.apache.poigroupId> <artifactId>poiartifactId> <version>3.6version> dependency> dependencies>
当pom配置好之后,我们查看右侧Maven,检查是否下载成功;
有的同学可能会遇Maven中显示Apache-POI确实已经被引入了,但是仍然在项目中无法使用。其实此时jar确实已经被下载到本地仓库了,只是没有添加到我们项目中。添加方式参照[解决Idea项目启动报错:程序包javax.servlet.http不存在],只是此时的jar来源不再是Tomcat目录下,而是我们的本地仓库;
前面都做好的话,就可以编写我们的代码了;
工具类
先说下我设计这个接口之前想到的问题,以及对该接口的应用场景
该工具类设计好之后,可对本项目提供服务,也可包装成接口,对外暴露服务,调用者只需按照我们要求的参数格式给出参数即可
该项目部署之后,将来其他项目需要用到导出功能,只需调用我们的接口即可,
根据以上两点,在工具类的设计上要遵循低耦合的原则,使其高可用、高复用
package com.wayne.utils; import com.alibaba.fastjson.JSON; import com.google.common.collect.Lists; import com.wayne.common.exception.ServiceException; import org.apache.poi.hssf.usermodel.*; import java.io.File; import java.io.FileOutputStream; import java.util.List; import java.util.Map; /** * 文件导出工具类 * @author Wayne * @date 2019/5/15 */ public class ExportUtil { /** * 无模块导出Excel方法, * 参数data格式: [ * { * "姓名": "张三"; * "年龄": "23"; * "性别": "男" * }, * { * "姓名": "李四"; * "年龄": "24"; * "性别": "男" * } * ] * * @param data 需要导出的数据 * @param fileName 导出后保存到本地的文件名 * @return 创建好的Excel文件,用于前端下载 * @throws ServiceException 自定义RunTimeException子类异常 */ public static HSSFWorkbook exportExcel(List
接口层和业务层
接口为传统的接口
在业务层对查询到的data做了处理,已达到符合工具类规范
package com.wayne.impl; import com.alibaba.fastjson.JSON; import com.wayne.common.dto.ResponseBean; import com.wayne.common.entity.CmsUser; import com.wayne.mapper.CmsUserMapper; import com.wayne.service.ExportService; import com.wayne.utils.ExportUtil; import org.apache.poi.hssf.usermodel.HSSFWorkbook; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; import java.util.List; import java.util.Map; import java.util.UUID; /** * 文件导出Service实现类 * @author Wayne * @date 2019/5/15 */ @Service public class ExportServiceImpl implements ExportService { @Autowired private CmsUserMapper userMapper; /** * 无模板导出Excel * @param request 前端传来参数,格式为Json字符串的对象,因为在实际开发中可能要用到根据查询参数导出,比如: 导出年龄在18 --- 26之间的、性别为女的用户 * @return */ @Override public ResponseBean exportExcel(String request) { ResponseBean responseBean; // 将前端参数转换为对象 CmsUser user = JSON.parseObject(request, CmsUser.class); // 根据条件查询需要导出的数据(后附sql内容) List
package com.wayne.web.comtroller; import com.wayne.common.dto.ResponseBean; import com.wayne.service.ExportService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; /** * 文件导出接口 * 接口层不做业务处理 * @author Wayne * @date 2019/5/15 */ @RestController @RequestMapping("/export") public class ExportController { @Autowired private ExportService exportService; /** * 导出Excel * @param request 导出条件 */ @PostMapping("/excel") public ResponseBean exportExcel(String request) { return exportService.exportExcel(request); } }
其他区相关代码
Service
package com.wayne.service; import com.wayne.common.dto.ResponseBean; /** * @author Wayne * @date 2019/5/15 */ public interface ExportService { ResponseBean exportExcel(String request); }
Mapper
Mapper没什么好贴出来的吧~~~
Mapper.xml
<select id="selectByParams" resultType="Map"> SELECT * FROM v_user WHERE `用户名` != 'admin' <where> <if test="username != null and username != ''"> and `用户名` = #{username, jdbcType=VARCHAR} if> <if test="mobile != null and mobile != ''"> and `手机号` = #{mobile,jdbcType=VARCHAR} if> where> ORDER BY `用户名` select>
视图
SELECT `cms_user`.`USERNAME` AS `用户名`, `cms_user`.`REALNAME` AS `真实姓名`, `cms_user`.`SEX` AS `性别`, `cms_user`.`EMAIL` AS `邮箱`, `cms_user`.`MOBILE` AS `手机号`, `cms_user`.`STATUS` AS `状态`, `cms_user`.`CREATE_TIME` AS `创建时间`, `cms_user`.`CREATE_USER_ID` AS `创建者` FROM `cms_user`
其它
本项目中用到的ResponsBean为自定义返回到前端的实体类,ServiceException为自定义RunTimeException异常
前端代码就不再展示了,因为此功能在前端只是一个按钮和点击事件
效果展示
因为不确定时间在第几列,所以无法动态将时间列设置为日期格式,需要后续手动处理
预留占位
开发怎能不留扩展字段 (¬_¬)…