记使用freemarker的坑_fsimagewriter-优快云博客

本文链接：https://blog.youkuaiyun.com/u011532911/article/details/120335175

这篇博客讲述了在使用FreeMarker模板引擎将数据填充到HTML模板并转换为图片的过程中遇到的乱码问题及其解决方案。首先，由于模板文件转html出现乱码，作者在FTL文件中添加了`<meta>`标签设置字符编码为UTF-8。接着，为了解决html转图片后的中文乱码，作者进行了字体文件的配置，包括在服务器上安装字体，更新字体缓存，并修改了配置文件。这些步骤成功解决了在图片中显示中文时的乱码问题。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

需求描述：

需要将数据转存为图片在前端展示。

查阅资料后使用ftl模板，

1. 填充数据后使用freemaker进行html转png，

2. 将png转base64字符串传给前端进行渲染。

依赖

<!-- freemarker模板引擎-->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>

数据准备

// 1.获取需要展示的数据
            List<HjtzxTemplate> templateData = null;
            String templateFileName = "";
            String generateFileName = "";
            if ("10".equals(calType)){
                templateFileName = "qd.ftl";
                templateData = mainBussinessMapper.getTemplateDataOfQd(userId,prdId,calType);
                generateFileName = userId+"-QD.png";
            } else if ("20".equals(calType)) {
                templateFileName = "zy.ftl";
                templateData = mainBussinessMapper.getTemplateDataOfZy(userId,prdId,calType);
                generateFileName = userId+"-ZY.png";
            } else {
                logger.error("生成立项表传入计算类型有误，请检查后重新输入:"+calType);
                throw new Exception("当前传入产品ID有误，请检查后重新输入");
            }
            if (templateData.size() == 0) {
                res.put("message","当前用户不存在产品数据，生成立项表失败！");
                res.put("code","40002");
                res.put("data",null);
                return res;
            }

            ModelMap modelMap = new ModelMap();

*.ftl

<html>
<head>
    <style>
    </style>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
</head>

<body>
<div align="center">
    <h4>和办公产品立项表(渠道)</h4>
</div>

<div style="text-align:center;">
    <table border="1" style="margin: auto;" width='80%' >
        <tr>
            <th>客户全称</th>
            <th>移动分公司</th>
            <th>客户经理</th>
            <th>业务支撑</th>
            <th>提报日期</th>
            <th>档位</th>
            <th>功能费</th>
            <th>合约期（月）</th>
            <th>颜色</th>
            <th>数量</th>
            <th>单台采购价</th>
            <th>采购价小计</th>
            <th>是否符合利润标准（是/否）</th>
        </tr>
        <#list templateData as item>
            <tr><td>${item.customerFullName}</td>
                <td></td>
                <td>${item.customerManager}</td>
                <td>${item.customerManager}</td>
                <td>${item.insertTime}</td>
                <td>${item.gearSecName}</td>
                <td></td>
                <td>${item.gearName}</td>
                <td></td>
                <td>${item.gearAmount}</td>
                <td>${item.singleQdPrice}</td>
                <td>${item.totalQqdPrice}</td>
                <td></td>
            </tr>
        </#list>
    </table>
</div>
</body>
</html>

工具类

package com.zhengqi.png;

import com.zhengqi.util.FileUtil;
import freemarker.template.Configuration;
import freemarker.template.Template;
import freemarker.template.TemplateException;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Value;
import org.xhtmlrenderer.swing.Java2DRenderer;
import org.xhtmlrenderer.util.FSImageWriter;

import java.awt.image.BufferedImage;
import java.io.*;
import java.util.Map;
/**
 * @author zhuling
 * @Description
 * @create 2021-07-14 15:40
 */
public class FreemarkeTools {
    private static final Logger logger = LoggerFactory.getLogger(FreemarkeTools.class);

    private static final String encoding = "UTF-8";

    /**
     * 获取模板转为html
     */
    public static String ftlToString(Map<String,Object> map, String templateName) throws IOException, TemplateException {
        String value = "";
        Configuration configuration = new Configuration();
        // linux环境用不了
//        Resource resource = new ClassPathResource("templates");
//        File sourceFile =  resource.getFile();
//        String ftlPath = sourceFile.getAbsolutePath();

        StringWriter out = new StringWriter();

        configuration.setDirectoryForTemplateLoading(new File("/opt/calculator/file/template"));
        configuration.unsetCacheStorage();
        Template template = configuration.getTemplate(templateName,encoding);
        template.setEncoding(encoding);
        template.process(map, out);
        out.flush();
        out.close();
        value = out.getBuffer().toString();

//        logger.info("模板文件html内容为：======="+value);
        return value;
    }

    /**
     * html转为图片
     * @param html
     * @param inputFileName
     * @param outputFileName
     * @param widthImage
     * @param heightImage
     * @return
     * @throws IOException
     */
    public static String turnImage(String html, String inputFileName, String outputFileName
            ,int widthImage, int heightImage) throws IOException {
        BufferedWriter bufferedWriter = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(inputFileName),encoding));
        bufferedWriter.write(html);
        bufferedWriter.newLine();
        bufferedWriter.flush();
        bufferedWriter.close();

        File f = new File(inputFileName);
        Java2DRenderer renderer = new Java2DRenderer(f, widthImage, heightImage);
        BufferedImage image = renderer.getImage();
        FSImageWriter imageWriter = new FSImageWriter();
        imageWriter.setWriteCompressionQuality(0.9f);
        File imgFile = new File(outputFileName);
        FileOutputStream fout = new FileOutputStream(imgFile);
        imageWriter.write(image, fout);
        fout.close();
        return outputFileName;
    }
}