使用Hutool生成Excel工作日报文件

本文介绍了如何使用Hutool工具库生成Excel和CSV文件,包括字体设置、单元格样式、合并单元格等操作,并展示了通过代码自动生成工作日报的示例。此外,文章探讨了现有功能的不足,提出利用ChatGPT增强自动化生成和编辑日报的可能性。
摘要由CSDN通过智能技术生成

前言

当今互联网时代,数据处理已成为我们工作中的重要一环。无论是在企业管理中,还是在个人日常生活中,数据的管理和分析都至关重要。在数据处理中,导出数据到Excel或CSV文件成为一种非常普遍的需求。例如我们需要将数据导出到Excel文件供运营或者财务人员分析使用,数据导出到CSV文件提供CRM系统导入。本篇技术博客将介绍使用Hutool工具生成Excel和CSV文件的基本流程,并演示如何在一个接口中通过将Excel和CSV文件压缩到Zip压缩包中且不生成本地文件。

Hutool工具简介

Hutool是一个小而全的Java工具类库。它包含了一系列的工具类,如字符串分割、替换、格式化等的字符串处理工具、文件读取、写入、复制、移动等文件操作工具、日期格式化、计算、转换等功能的日期时间处理工具等等可以帮助Java开发者提高开发效率,满足大多数的Java开发中的工具类的需求,减少重复劳动。Hutool官网地址

Hutool提供了如下工具组件:

模块介绍
hutool-aopJDK动态代理封装,提供非IOC下的切面支持
hutool-bloomFilter布隆过滤,提供一些Hash算法的布隆过滤
hutool-cache简单缓存实现
hutool-core核心,包括Bean操作、日期、各种Util等
hutool-cron定时任务模块,提供类Crontab表达式的定时任务
hutool-crypto加密解密模块,提供对称、非对称和摘要算法封装
hutool-dbJDBC封装后的数据操作,基于ActiveRecord思想
hutool-dfa基于DFA模型的多关键字查找
hutool-extra扩展模块,对第三方封装(模板引擎、邮件、Servlet、二维码、Emoji、FTP、分词等)
hutool-http基于HttpUrlConnection的Http客户端封装
hutool-log自动识别日志实现的日志门面
hutool-script脚本执行封装,例如Javascript
hutool-setting功能更强大的Setting配置文件和Properties封装
hutool-system系统参数调用封装(JVM信息等)
hutool-jsonJSON实现
hutool-captcha图片验证码实现
hutool-poi针对POI中Excel和Word的封装
hutool-socket基于Java的NIO和AIO的Socket封装
hutool-jwtJSON Web Token (JWT)封装实现

使用方式如下:

🍊Maven

在项目的pom.xml的dependencies中加入以下内容:

<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-all</artifactId>
    <version>5.8.16</version>
</dependency>

🍐Gradle

implementation 'cn.hutool:hutool-all:5.8.16'

因为小编的工作岗位每天都要都要写日报,疫情期间由直接文字提交变为了使用Excel制式文件(加剧内卷???),在写了几个月以后终于借助某个需要导出Excel文件的需求顺势来生成Excel工作日报,本文借助我的工作日报演示生成Excel文件,主要包含了Excel单元格字体设置、合并单元格合、自动换行、设置背景颜色等主要Excel操作。整体的设想为通过代码生成Excel日志制式文件,在输入给ChatGPT本周的工作目标借助ChatGPT的废话文学特点自动填充日报,达到自动写日报的目的。目前实现了生成日报制式文件功能,先记录下来。工作日报Excel制式主要包含今日复盘和明日工作计划文件如下:

  1. 今日复盘如下:
    在这里插入图片描述
  2. 明天规划如下:
    在这里插入图片描述

Excel的字体和样式

分析上面的工作日报文件每天都包含一个今日工作复盘和明日工作规划,同时TODO List 字体大小与其它内容的字体不一样,且有不同的背景颜色, 字体加粗,内容自动换行。

  1. 添加Hutool依赖

    <dependency>
        <groupId>cn.hutool</groupId>
        <artifactId>hutool-all</artifactId>
        <version>5.8.15</version>
    </dependency>
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi-ooxml</artifactId>
        <version>5.2.2</version>
    </dependency>
    

    Hutool-all中包含了Hutool的所有工具类,由于需要生成Excel文件需要依赖poi(ps:许多人诟病Hutool的原因之一?)

  2. Excel文件Cell字体设置

    ​ 主要设置Excel字体名称、字体大小、字体颜色、下划线、是否加粗、是否斜体、是否有删除线等常用的字体设置方法,代码如下:

    	/**
         * 单元格字体常用设置基础方法
         *
         * @param writer    ExcelWriter
         * @param fontName  字体名称(ex:微软雅黑、宋体、仿宋,需要底层操作系统支持)
         * @param fontSize  字体大小
         * @param color     字体颜色
         * @param underline 下划线样式
         * @param bold      是否加粗
         * @param strikeout 是否有删除线
         * @param italic    是否斜体
         * @return Font
         */
        public static Font createCellBaseFont(ExcelWriter writer, String fontName, short fontSize, short color,
                byte underline, boolean bold, boolean strikeout, boolean italic) {
            // 创建单元格Cell字体
            Font font = writer.createFont();
            // 设置字体名称(ex:微软雅黑、宋体、仿宋)
            font.setFontName(fontName);
            // 设置字体大小
            font.setFontHeightInPoints(fontSize);
            // 设置字体颜色
            font.setColor(color);
            // 设置字体是否加粗
            font.setBold(bold);
            // 设置字体下划线样式
            font.setUnderline(underline);
            // 设置是否有删除线
            font.setStrikeout(strikeout);
            // 设置是否斜体
            font.setItalic(italic);
            return font;
        }
    
  3. Excel单元格样式设置

    ​ Excel单元格样式设置主要包括单元格水平方向对齐方式、垂直方向对齐方式、单元格内容字体样式、单元格背景颜色、单元格边框等常用设置,代码如下:

    	/**
         * 设置单元格的基础常用样式
         *
         * @param writer              Excel
         * @param font                字体
         * @param fillForegroundColor 是否填充背景
         * @param color               背景颜色 fillForegroundColor为true时生效
         * @param hAlign              水平对齐样式
         * @param vAlign              垂直对齐样式
         * @param wrapText            是否自动换行
         * @return CellStyle
         */
        public static CellStyle createCellBaseStyle(ExcelWriter writer, Font font, boolean fillForegroundColor,
                short color, HorizontalAlignment hAlign, VerticalAlignment vAlign, boolean wrapText) {
            // 创建单元格样式
            CellStyle style = writer.getWorkbook().createCellStyle();
            // 设置单元格内容的水平对齐方式,如左对齐、居中对齐、右对齐等。
            style.setAlignment(hAlign);
            // 设置单元格内容的垂直对齐方式,如上对齐、居中对齐、下对齐等。
            style.setVerticalAlignment(vAlign);
            // 设置字体
            style.setFont(font);
            // 是否设置背景色
            if (fillForegroundColor) {
                // style.setFillForegroundColor(IndexedColors.PALE_BLUE.getIndex());
                // 设置单元格背景颜色
                style.setFillForegroundColor(color);
                // 设置填充模式
                style.setFillPattern(FillPatternType.SOLID_FOREGROUND);
            }
            // 设置边框
            style.setBorderTop(BorderStyle.THIN);
            style.setBorderBottom(BorderStyle.THIN);
            style.setBorderLeft(BorderStyle.THIN);
            style.setBorderRight(BorderStyle.THIN);
            style.setWrapText(wrapText);
            return style;
        }
    
  4. 合并单元格操作

    样例文件中包含了很多单元格合并操作,其中第一行合并,第一列合并,第二行从第二列合并到第七列并且有填充内容 To Do List 复盘总结 — 03月20日(星期一),第三列需要从第6行到第十三行竖着合并单元格并且填充项目名称等等。在Hutool中提供了merge方法来进行单元格的合并操作,Hutool中的ExcelWiter中的merge方法如下所示:

    	/**
    	 * 合并当前行的单元格<br>
    	 * 样式为默认标题样式,可使用{@link #getHeadCellStyle()}方法调用后自定义默认样式
    	 *
    	 * @param lastColumn 合并到的最后一个列号
    	 * @return this
    	 */
    	public ExcelWriter merge(int lastColumn) {
    		return merge(lastColumn, null);
    	}
    
    	/**
    	 * 合并当前行的单元格,并写入对象到单元格<br>
    	 * 如果写到单元格中的内容非null,行号自动+1,否则当前行号不变<br>
    	 * 样式为默认标题样式,可使用{@link #getHeadCellStyle()}方法调用后自定义默认样式
    	 *
    	 * @param lastColumn 合并到的最后一个列号
    	 * @param content    合并单元格后的内容
    	 * @return this
    	 */
    	public ExcelWriter merge(int lastColumn, Object content) {
    		return merge(lastColumn, content, true);
    	}
    
    	/**
    	 * 合并某行的单元格,并写入对象到单元格<br>
    	 * 如果写到单元格中的内容非null,行号自动+1,否则当前行号不变<br>
    	 * 样式为默认标题样式,可使用{@link #getHeadCellStyle()}方法调用后自定义默认样式
    	 *
    	 * @param lastColumn       合并到的最后一个列号
    	 * @param content          合并单元格后的内容
    	 * @param isSetHeaderStyle 是否为合并后的单元格设置默认标题样式,只提取边框样式
    	 * @return this
    	 * @since 4.0.10
    	 */
    	public ExcelWriter merge(int lastColumn, Object content, boolean isSetHeaderStyle) {
    		Assert.isFalse(this.isClosed, "ExcelWriter has been closed!");
    
    		final int rowIndex = this.currentRow.get();
    		merge(rowIndex, rowIndex, 0, lastColumn, content, isSetHeaderStyle);
    
    		// 设置内容后跳到下一行
    		if (null != content) {
    			this.currentRow.incrementAndGet();
    		}
    		return this;
    	}
    
    	/**
    	 * 合并某行的单元格,并写入对象到单元格<br>
    	 * 如果写到单元格中的内容非null,行号自动+1,否则当前行号不变<br>
    	 * 样式为默认标题样式,可使用{@link #getHeadCellStyle()}方法调用后自定义默认样式
    	 *
    	 * @param firstRow         起始行,0开始
    	 * @param lastRow          结束行,0开始
    	 * @param firstColumn      起始列,0开始
    	 * @param lastColumn       结束列,0开始
    	 * @param content          合并单元格后的内容
    	 * @param isSetHeaderStyle 是否为合并后的单元格设置默认标题样式,只提取边框样式
    	 * @return this
    	 * @since 4.0.10
    	 */
    	public ExcelWriter merge(int firstRow, int lastRow, int firstColumn, int lastColumn, Object content, boolean isSetHeaderStyle) {
    		Assert.isFalse(this.isClosed, "ExcelWriter has been closed!");
    
    		CellStyle style = null;
    		if (null != this.styleSet) {
    			style = styleSet.getStyleByValueType(content, isSetHeaderStyle);
    		}
    
    		return merge(firstRow, lastRow, firstColumn, lastColumn, content, style);
    	}
    
    	/**
    	 * 合并单元格,并写入对象到单元格,使用指定的样式<br>
    	 * 指定样式传入null,则不使用任何样式
    	 *
    	 * @param firstRow    起始行,0开始
    	 * @param lastRow     结束行,0开始
    	 * @param firstColumn 起始列,0开始
    	 * @param lastColumn  结束列,0开始
    	 * @param content     合并单元格后的内容
    	 * @param cellStyle   合并后单元格使用的样式,可以为null
    	 * @return this
    	 * @since 5.6.5
    	 */
    	public ExcelWriter merge(int firstRow, int lastRow, int firstColumn, int lastColumn, Object content, CellStyle cellStyle) {
    		Assert.isFalse(this.isClosed, "ExcelWriter has been closed!");
    
    		CellUtil.mergingCells(this.getSheet(), firstRow, lastRow, firstColumn, lastColumn, cellStyle);
    
    		// 设置内容
    		if (null != content) {
    			final Cell cell = getOrCreateCell(firstColumn, firstRow);
    			CellUtil.setCellValue(cell, content, cellStyle);
    		}
    		return this;
        }
    

    日报中合并单元格操作代码如下:

    // 创建一个ExcelWriter 用来写Excel文件,如果为xlsx
    ExcelWriter writer = new ExcelWriter(true);
    // 第一个Sheet名称
    writer.renameSheet(0, "test");
    // 合并第0列
    writer.merge(0);
    // 合并第0列(0到30行,不填充内容)
    writer.merge(0, 30, 0, 0, "", null);
    
  5. 跳过N行

    // 跳过两行
    writer.passRows(2);
    
  6. 获取某个单元格填充内容并设置样式

    由于日志中包含了一些固定字段设置,如果每日复盘中的序号、项目归属、任务归属、完成情况、协调资源等,所以写了一个方法,通过获取固定的单元格填充内容并设置单元格样式

    	/**
         * 今日复盘中的固定表头
         */
        private static final String[] REPLAY_TITLE = { "序号", "项目归属", "任务", "完成情况", "资源协助", "原因分析(未完成工作需写原因)" };
    
    	/**
         * 设置复盘总结表头并设置样式
         *
         * @param writer ExcelWriter
         * @param fields 表头固定字段名称
         * @param y 列
         */
        public static void createReplayTitleAndStyle(ExcelWriter writer, String[] fields, int y) {
            for (int i = 0; i < fields.length; i++) {
                // 获取单元格 第一个参数为列号,第二个参数为行号
                Cell cell = writer.getCell(i + 1, y, true);
                // 设置单元格样式
                cell.setCellStyle(ExcelCellStyleUtil.createSimpleCellStyle(writer, (short) 12));
                // 填充单元格内容
                cell.setCellValue(fields[i]);
            }
        }
    
  7. 设置行高

    writer.setRowHeight(0, 10);
    writer.setRowHeight(1, 30);
    
  8. 设置列宽

    writer.setColumnWidth(0, 2);
    writer.setColumnWidth(1, 15);
    
  9. 设置自动列宽

    // 设置自动换行(如果指定了想要保持设定好的列宽和行高,则需要将此设置提前)
    writer.autoSizeColumnAll();
    // 设置列宽行高
    setJobLogRowHeight(writer);
    setJobLogColumnWidth(writer);
    
  10. 设置特殊单元格

    StyleSet styleSet = writer.getStyleSet();
    CellStyle cellStyle = styleSet.getCellStyle();
    // 数字保留小数 例:保留两位小数
    CellStyle cellStyleForNumber = styleSet.getCellStyleForNumber();
    cellStyleForNumber.setDataFormat((short) 2);
    // 时间格式化 例如格式为:YYYY/MM/dd 格式
    CellStyle cellStyleForDate = styleSet.getCellStyleForDate();
    // 代表的时间格式是 yyyy/MM/dd
    cellStyleForDate.setDataFormat((short) 14);
    

生成效果

在对生成Excel日志文件进行分析后分为将每天的日志分为三个大的部分:工作信息、今日复盘和明日计划,其中工作信息中包含了例如:部门、岗位、姓名等属性;今日复盘包含了本周目标信息列表、今日工作列表以及个人总结成长部分;明日计划中包含了明日工作任务。将这些整理为Java的对象,方便使用,由于篇幅有限,将代码放置在了git仓库中。

写一个单元测试,检查一下效果

@Test
void testGenerateJobLogSheet(){
    // 工作日志
    JobLog jobLog = new JobLog();
    // 工作信息
    JobInfo jobInfo = new JobInfo();
    jobInfo.setDepartment("创新部");
    jobInfo.setPost("Java开发工程师");
    jobInfo.setName("小赵小赵");
    jobInfo.setProject("XX(8)");
    jobLog.setJobInfo(jobInfo);
    // 今日复盘
    Replay replay = new Replay();
    List<Goal> goals = new ArrayList<>();
    for (int i = 1; i < 4; i++) {
        Goal goal = new Goal("今日目标" + i);
        goals.add(goal);
    }
    replay.setGoals(goals);
    List<Task> tasks = new ArrayList<>();
    for (int i = 1; i < 9; i++) {
        Task task = new Task();
        task.setTask("今日任务" + i);
        task.setCompletion(100);
        tasks.add(task);
    }
    replay.setTasks(tasks);
    Extend extend = new Extend();
    replay.setExtend(extend);
    jobLog.setReplay(replay);

    Plan plan = new Plan(tasks);
    jobLog.setPlan(plan);
    ExcelWriter writer = GenerateJobLog.generateSheet(LocalDate.now(), jobLog);
    DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd");
    String today = LocalDate.now().format(formatter);
    String excelName = "日报-TDL-" + jobLog.getJobInfo().getDepartment() + "-" + jobLog.getJobInfo().getName() + "-" + today + ".xlsx";
    File excelFile = new File(excelName);
    writer.flush(excelFile);
    writer.close();
}

通过代码生成的日志Excel文件效果如下:
在这里插入图片描述
在这里插入图片描述

不足与改善

存在的不足还有很多,例如没有判断节假日和调休以及每日自动生成日志并提交;后期愿景就是借助ChatGPT的废话文学特色进行给定每周的目标,自动填充每日的任务复盘和明日的工作复盘或者是对目标、每日任务等进行润色,同时还可以将这些工作日报信息进行存储,通过这些日报生成周报、月报以及年度总结等。

本文首发于香菜喵,打开微信随时随地读,文章下方 ↓ ↓ ↓

使用Hutool生成Excel文件到指定目录的代码如下: ```java import cn.hutool.poi.excel.ExcelUtil; import cn.hutool.poi.excel.ExcelWriter; import cn.hutool.poi.excel.cell.CellStyleBuilder; import cn.hutool.poi.excel.cell.CellUtil; import cn.hutool.poi.excel.style.Align; import java.util.List; public class ExcelUtilDemo { public static void main(String[] args) { List<User> userList = getUserList(); // 创建Excel写入器 ExcelWriter writer = ExcelUtil.getWriter("D:\\test.xlsx"); // 自定义标题样式 CellStyleBuilder titleStyleBuilder = writer.getCellStyleBuilder(); titleStyleBuilder.bgColor(Color.LIGHT_GRAY); titleStyleBuilder.align(Align.CENTER); titleStyleBuilder.borderBottom(BorderStyle.THIN); CellStyle titleStyle = titleStyleBuilder.build(); // 写入标题行 writer.merge(3, "用户列表"); // 合并单元格 CellUtil.createCell(writer.getRow(0), 0, "姓名", titleStyle); CellUtil.createCell(writer.getRow(0), 1, "年龄", titleStyle); CellUtil.createCell(writer.getRow(0), 2, "性别", titleStyle); CellUtil.createCell(writer.getRow(0), 3, "地址", titleStyle); // 写入数据行 for (int i = 0; i < userList.size(); i++) { User user = userList.get(i); CellUtil.createCell(writer.getRow(i + 1), 0, user.getName()); CellUtil.createCell(writer.getRow(i + 1), 1, user.getAge()); CellUtil.createCell(writer.getRow(i + 1), 2, user.getGender()); CellUtil.createCell(writer.getRow(i + 1), 3, user.getAddress()); } // 关闭Excel写入器 writer.close(); } private static List<User> getUserList() { // TODO: 返回用户列表 return null; } private static class User { private String name; private int age; private String gender; private String address; public User(String name, int age, String gender, String address) { this.name = name; this.age = age; this.gender = gender; this.address = address; } public String getName() { return name; } public void setName(String name) { this.name = name; } public int getAge() { return age; } public void setAge(int age) { this.age = age; } public String getGender() { return gender; } public void setGender(String gender) { this.gender = gender; } public String getAddress() { return address; } public void setAddress(String address) { this.address = address; } } } ``` 上面的代码中,我们使用`ExcelWriter`类来创建Excel文件,并将其保存到指定目录。通过`CellStyleBuilder`类可以自定义单元格样式,例如设置背景颜色、对齐方式、边框等。`CellUtil`类可以操作单元格,例如合并单元格、创建单元格等。最后,通过`ExcelWriter`的`close`方法关闭文件流。
评论 4
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

喵喵@香菜

感谢观众老爷送的一发火箭!

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值