如何通过Freemark优雅地生成那些花里胡哨的复杂样式 Excel 文件？

出处 https://www.exception.site/essay/how-to-create-complex-style-excel-with-freemark

一、背景

小哈最近这段时间开始负责一个新的产品：下载中心。啥玩意这是？

产品的目的其实就是统一管控各业务组文件下载功能（包括一些海量数据的导出，文件合并上传等），项目组不用自己再去实现各式各样的文件（PDF, Word, Excel）生成, 统一对接下载中心，由下载中心统一完成文件的生成、合并、上传、下载流程。

问题来了，这里面包括一些复杂文件的生成，如带有复杂样式的 Excel 文件，比如下面这个样子的：

这种复杂样式的 Excel, 如果说放到各个业务线去实现还是好办的，因为站在各个业务组的角度，场景变化不会太多，按照文件格式，代码写死即可。

但是站在下载中心的角度，因为需要对接各个业务中心，每个业务中心生成的样式都不一样，不可能每个业务组接进来，我都得定制的写一套生成代码吧！这显然也不合常理！

那么，有没有什么一劳永逸的办法呢？答案是肯定的！

二、实现思路

要说实现方式，你的脑海里可能第一会想到传统的 Apache poi，jxl ，亦或者是阿里出品 EasyExcel 等等。

PS: 关于阿里的 EasyExcel, 小哈之前有分享过，没看过的小伙伴们，可以看下《7 行代码优雅地实现 Excel 文件生成&下载功能》。

对于这种复杂样式，要是用 Apache poi, jxl, 阿里 EasyExcel 去实现，不可避免的，代码肯定会非常繁琐。

有没有啥优雅（偷懒的）的方式呢？

其实我们可以通过视图引擎 Freemark、Velocity 来帮我们生成复杂样式 Excel 文件，无需关心花里胡哨的复杂样式，只关注于填充数据即可。接下来，我们以 Freemark 作为示例来讲解，如何生成这个复杂样式的 Excel 文件。

拓展阅读: 什么是 Freemark ?

FreeMarker 是一款模板引擎：即一种基于模板和要改变的数据，并用来生成输出文本(HTML网页，电子邮件，配置文件，源代码等)的通用工具。它不是面向最终用户的，而是一个Java类库，是一款程序员可以嵌入他们所开发产品的组件。

其实，对于Java 后端来说，它更常被用来服务端动态渲染 html 页面返回给浏览器。前些年还比较火热，近些年因为前后端分离的火热，也开始慢慢淡出视野了。

三、快速上手

3.1 添加依赖

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>

注意: 小哈这里基于 Spring Boot 写的测试代码，版本号可以无需指定，否则，你需要手动指定好版本号。

3.2 导出 xml 模板文件

首先，将复杂样式的 Excel 文件另存为 .xml 视图模板，如下图所示：

打开 xml 模板文件，可以清晰的看到里面定义了各种节点，节点描述了整个 Excel 的样式结构, 如下图所示：

3.3 填充占位符

再回过头来看下之前那个复杂 Excel 文件，观察一下哪些单元格的值需要动态设置：

图中用红色特意标注出来了。

在刚刚另存为的 xml 模板文件中填写 freemark 表达式，考虑到这里只是个示例 Demo, 仅仅选取几个示例单元格来填写占位符，如下所示：

订单标题：

其他需要动态填充的单元格：

PS: xml 文件中，<Row> 节点代表一行，<Cell>代表一个单元格。

在需要动态填充数据的地方，加上相关 freemark 表达式，如 ${commodity.name!}，如下所示：

<Row ss:AutoFitHeight="0" ss:Height="54">
    <Cell ss:StyleID="s18"><Data ss:Type="String">1</Data></Cell>
    <Cell ss:StyleID="s18"><Data ss:Type="String">${commodity.name!}</Data></Cell>
    <Cell ss:StyleID="s18"/>
    <Cell ss:StyleID="s18"><Data ss:Type="String">${commodity.num!}</Data></Cell>
    <Cell ss:StyleID="s18"><Data ss:Type="String">${commodity.num1!}</Data></Cell>
    <Cell ss:StyleID="s18"><Data ss:Type="String">22</Data></Cell>
    <Cell ss:StyleID="s18"><Data ss:Type="String">44</Data></Cell>
    <Cell ss:StyleID="s18"><Data ss:Type="String">55</Data></Cell>
    <Cell ss:StyleID="s18"><Data ss:Type="String">盒</Data></Cell>
    <Cell ss:StyleID="s18"><Data ss:Type="String">${commodity.price!}</Data></Cell>
    <Cell ss:StyleID="s18"><Data ss:Type="String">${commodity.price2!}</Data></Cell>
    <Cell ss:StyleID="s18"><Data ss:Type="String">${commodity.price3!}</Data></Cell>
    <Cell ss:StyleID="s18"><Data ss:Type="String">${commodity.timestamp}</Data></Cell>
    <Cell ss:StyleID="s18"><Data ss:Type="String">${commodity.createTime?string('yyyy-MM-dd HH:mm:ss')}</Data></Cell>
    <Cell ss:StyleID="s18"/>
</Row>

按照服务端数据模型的定义，填写好相应的字段名称，再对照下后台 Commodity 商品类的定义：

这个商品类中，我们定义了不同类型的字段，如 String、int、Integer、Double、Float、金额类型 BigDecimal、日期类型 Date 等，用以测试对不同数据类型的兼容性。

确认相关属性字段名无误后，再来看下 freemark 生成 Excel 的核心代码：

package site.exception.springbootfreemarkexcel;

import freemarker.template.Configuration;
import freemarker.template.Template;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;
import site.exception.springbootfreemarkexcel.entity.Commodity;

import java.io.File;
import java.io.FileWriter;
import java.math.BigDecimal;
import java.util.*;
/**
 * @author 犬小哈 （微信公众号: 小哈学Java）
 * @site www.exception.site
 * @date 2019/5/21
 * @time 上午10:57
 * @discription
 **/
@RunWith(SpringRunner.class)
@SpringBootTest
public class SpringBootFreemarkExcelApplicationTests {

	@Test
	public void createExcelByFreemark() throws Exception {

		Configuration configuration = new Configuration(Configuration.VERSION_2_3_28);

		// 设置模板文件的父目录
		configuration.setDirectoryForTemplateLoading(new File("/Users/a123123/Work/tmp_files"));

		// 加载模板文件
		Template template = configuration.getTemplate("/excel_template.xml", "UTF-8");

		// 数据准备，可以是从数据库中查询，这里为了方便演示，手动 new 了
		Map<String, Object> data = new HashMap<>();
		data.put("title", "测试标题1");

		List<Commodity> commodities = new ArrayList<>();
		Commodity commodity = Commodity.builder()
				.name("name1").num(11).num1(111)
				.price(new BigDecimal(11.1)).price2(new Double(11.11))
				.price3(new Float(11.1111))
				.createTime(new Date())
				.timestamp(System.currentTimeMillis())
				.build();

		commodities.add(commodity);

		// 生成 excel 文件
		template.process(data, new FileWriter("/Users/a123123/Work/tmp_files/excelByFreemark.xls"));
	}
}

可以看到生成复杂样式的 Excel 的代码非常简洁。关于每一行代码什么意思，注释已经说得很清楚了，这里就不加以说明了。

运行单元测试，看下效果：