当前位置：首页 > news >正文

Java服务端使用freemarker+wkhtmltoimage生成Echart图片

news 2025/10/29 20:56:09

1.通过 freemarker 将ftl转成html

1.1 freemarker 手册:

1.2 添加freemarker maven依赖

1.3 添加 echart-test.ftl 模版文件

1.4 添加 FreemarkerTool 工具类

1.5 添加测试main方法

1.6 运行,生成echart-test-时间戳.html 文件

2. 通过wkhtmltoimage将html 转为png图片

2.1 下载 wkhtmltoimage

2.2 下载后安装(略)

2.3 添加 WkhtmltopdfTool 工具类

2.4 添加 HtmlToPdfThread 工具类

2.5 添加main方法测试

2.6 运行,生成 echart-test-时间戳.png 图片

2.7 注意

1.通过 freemarker 将ftl转成html

1.1 freemarker 手册:

FreeMarker 中文官方参考手册

Echart官网 Examples - Apache ECharts

1.2 添加freemarker maven依赖

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

1.3 添加 echart-test.ftl 模版文件

文件内容:

<html><head><meta charset="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><title>ECharts Demo</title><script src="https://cdnjs.cloudflare.com/ajax/libs/echarts/5.2.2/echarts.min.js"integrity="sha512-ivdGNkeO+FTZH5ZoVC4gS4ovGSiWc+6v60/hvHkccaMN2BXchfKdvEZtviy5L4xSpF8NPsfS0EVNSGf+EsUdxA=="crossorigin="anonymous" referrerpolicy="no-referrer"></script><style>body {margin: 0;display: flex;flex-direction: row;justify-content: center;}#display-container {width: 600px;height: 600px;border: 2px solid black;}</style>
</head><body>
<div id="container"><div id="display-container"></div>
</div><script type="text/javascript">var chart = echarts.init(document.getElementById("display-container"));var option = {"animation": false,"xAxis": {"type": "category","axisTick": {"alignWithLabel": true},"data": ${xAxisData!'[]'}},"yAxis": {"type": "value"},"tooltip": {"axisPointer": {"type": "shadow"},"trigger": "axis"},"series": [{"type": "bar","name": "Direct","data": ${yAxisData!'[]'},"barWidth": "60%"}]}chart.setOption(option);
</script>
</body></html>

1.4 添加 FreemarkerTool 工具类

package com.hanyc.demo.util;import cn.hutool.core.collection.ListUtil;
import com.alibaba.fastjson.JSON;
import freemarker.template.Configuration;
import freemarker.template.Template;
import freemarker.template.TemplateException;
import lombok.extern.slf4j.Slf4j;import java.io.File;
import java.io.FileWriter;
import java.io.IOException;
import java.io.Writer;
import java.util.HashMap;
import java.util.List;
import java.util.Map;/*** @author ：hanyc* @date ：2024/1/25 11:15* @description：*/
@Slf4j
public class FreemarkerTool {/*** 根据模板，利用提供的数据，生成文件** @param sourceFile 模板文件名* @param data       模版数据* @param destFile   最终生成的文件，需要携带路径*/public static void data2html(String sourceFile, Map<String, Object> data, String destFile) throws IOException, TemplateException {// 如果文件夹不存在 则创建FileUtil.createFile(new File(destFile));Writer out = null;try {out = new FileWriter(new File(destFile));Configuration cfg = new Configuration(Configuration.VERSION_2_3_29);// 文件所在位置目录cfg.setDirectoryForTemplateLoading(new File("D:/code/springbootdemo2/src/main/resources/template/"));Template template = cfg.getTemplate(sourceFile);template.process(data, out);} catch (Exception e) {log.error("模板生成报告html文件异常", e);throw e;} finally {try {if (out != null) {out.flush();out.close();}} catch (IOException e) {e.printStackTrace();}}}
}

1.5 添加测试main方法

public static void main(String[] args) throws IOException, InterruptedException, TemplateException {// 文件名String sourceFile = "echart-test.ftl";// 渲染存储数据Map<String, Object> datas = new HashMap<String, Object>();List<String> xAxisData = ListUtil.of("Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun");datas.put("xAxisData", JSON.toJSONString(xAxisData));List<Integer> yAxisData = ListUtil.of(10, 52, 200, 334, 390, 330, 220);datas.put("yAxisData", JSON.toJSONString(yAxisData));//最终生成的文件路径String destFile = "D:\\code\\springbootdemo2\\src\\main\\resources\\template\\echart-test-" + System.currentTimeMillis() + ".html";data2html(sourceFile, datas, destFile);}

1.6 运行,生成echart-test-时间戳.html 文件

2. 通过wkhtmltoimage将html 转为png图片

2.1 下载 wkhtmltoimage

官网地址：wkhtmltopdfhttps://wkhtmltopdf.org/
官网下载地址：wkhtmltopdfhttps://wkhtmltopdf.org/downloads.html

2.2 下载后安装(略)

2.3 添加 WkhtmltopdfTool 工具类

package com.hanyc.demo.util;import cn.hutool.core.collection.ListUtil;
import com.alibaba.fastjson.JSON;
import freemarker.template.TemplateException;
import lombok.extern.slf4j.Slf4j;import java.io.File;
import java.io.IOException;
import java.util.HashMap;
import java.util.List;
import java.util.Map;/*** @author ：hanyc* @date ：2024/1/25 9:33* @description： wkhtmltopdf 工具类*/
@Slf4j
public class WkhtmltopdfTool {private static final String WKHTMLTOPDF_PATH = "D:\\ruanjian\\wkhtmltopdf\\bin\\wkhtmltoimage.exe"; // 替换为实际路径/*** html转pdf** @param srcPath  html路径，可以是硬盘上的路径，也可以是网络路径* @param destPath 图片保存路径* @param width    宽度*/public static void convert(String srcPath, String destPath, Integer width) throws IOException, InterruptedException {File file = new File(destPath);File parent = file.getParentFile();//如果pdf保存路径不存在，则创建路径if (!parent.exists()) {parent.mkdirs();}StringBuilder cmd = new StringBuilder();cmd.append(WKHTMLTOPDF_PATH);cmd.append(" ");// 去掉左右 边距
//        cmd.append(" --margin-left 0mm --margin-right 0mm  --margin-top 0mm  --margin-bottom 5mm ");
//        cmd.append("   --enable-local-file-access ");//设置页面上边距 (default 10mm)
//        cmd.append("  --margin-top 0mm ");//设置页面下边距 (default 10mm)
//        cmd.append("  --margin-bottom 0mm ");// (设置页眉和内容的距离,默认0)
//        cmd.append(" --header-spacing 0 ");// 添加页码
//        cmd.append("  --footer-center [page]/[topage] ");//        1.--format.\<格式》:指定输出图像的格式。可以是PNG、JPEG、BMP等，默认为PNG。cmd.append(" --format png ");// 2 . –quality 75：就表示生成图片的质量为原来的 75%!cmd.append(" --quality 75 ");
//        3  --width \<宽度\>:设置输出图像的宽度。可以使用像素(如800px)或其他单位(如cm、mm等)指定，默认为 1024像素。if (width != null) {cmd.append(" --width ");cmd.append(width);cmd.append(" ");}
//        4 --height \<高度\>:设置输出图像的高度。同样可以使用像素或其他单位指定，默认为0，表示自适应高度。
//        cmd.append(" --height 600");
//        5 --crop-w \<宽度\>:将输入HI文档裁剪为指定宽度的图像。宽度单位与--width相同，默认为0，表示不进行裁剪。
//        6 --crop-h \高度\>:将输入HI文档裁剪为指定高度的图像。高度单位与--height相同，默认为0，表示不进行裁剪。
//        7 --crop-x\<x坐标\>:设置裁剪的左上角x坐标。默认为0。
//        8 --crop-y \<y坐标\>:设置裁剪的左上角y坐标。默认为0。
//        9. --no-outline:禁用轮廓线，即去掉输出图像中的边框线
//        10 .--no-background:禁用背景，即去掉输出图像中的背景色。
//        11 --disable-smart-width:禁用智能调整宽度，即不根据内容自适应调整宽度。
//        12 --transparent:将输出图像的背景色设置为透明。
//         13.--encoding<编码》>:设置HTML文档的字符编码
//        14.--quiet:静默模式，不输出任何日志信息。
//        15 --version:显示wkhtmltoimage的版本信息cmd.append(srcPath);cmd.append(" ");cmd.append(destPath);boolean result = true;try {log.info("执行命令:  {}", cmd.toString());Process proc = Runtime.getRuntime().exec(cmd.toString());HtmlToPdfThread error = new HtmlToPdfThread(proc.getErrorStream());HtmlToPdfThread output = new HtmlToPdfThread(proc.getInputStream());error.start();output.start();proc.waitFor();} catch (Exception e) {result = false;log.error("html转pdf fail:{}", e.getMessage(), e);throw e;}}}
}

2.4 添加 HtmlToPdfThread 工具类

package com.hanyc.demo.util;import cn.hutool.core.io.IoUtil;
import lombok.extern.slf4j.Slf4j;import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.nio.charset.StandardCharsets;/*** @author ：hanyc* @date ：2023/4/26 14:44* @description： 流处理日志输出工具类*/
@Slf4j
public class HtmlToPdfThread extends Thread {private InputStream is;public HtmlToPdfThread(InputStream is) {this.is = is;}@Overridepublic void run() {BufferedReader br = null;try {InputStreamReader isr = new InputStreamReader(is, StandardCharsets.UTF_8);br = new BufferedReader(isr);String line = null;while ((line = br.readLine()) != null) {//输出内容log.info(line);}} catch (IOException e) {e.printStackTrace();log.error("HtmlToPdfThread: ", e);} finally {IoUtil.close(is);IoUtil.close(br);}}
}

2.5 添加main方法测试

    public static void main(String[] args) throws IOException, InterruptedException, TemplateException {String sourceFile = "D:\\code\\springbootdemo2\\src\\main\\resources\\template\\echart-test-1706154543908.html";String destFile = "D:\\code\\springbootdemo2\\src\\main\\resources\\template\\echart-test-1706154543908.png";WkhtmltopdfTool.convert(sourceFile, destFile,550);}

2.6 运行,生成 echart-test-时间戳.png 图片

2.7 注意

wkhtmltopdf / wkhtmltoimage 官网已经不再维护,如果生成的图片和原html不一样,或转化错误,可以尝试将js或css代码改为较原始的版本.

Java服务端使用freemarker+wkhtmltoimage生成Echart图片

目录 1.通过 freemarker 将ftl转成html 1.1 freemarker 手册: 1.2 添加freemarker maven依赖 1.3 添加 echart-test.ftl 模版文件 1.4 添加 FreemarkerTool 工具类 1.5 添加测试main方法 1.6 运行,生成echart-test-时间戳.html 文件 2. 通过wkhtmltoimage将html 转为p…...

编程日记 2024/1/26 20:30:36

一款颜值与实力并存的翻页时钟(免费）

FliTik是一款颜值与实力并存的翻页时钟，安卓端是完全免费的，无任何广告，极简风 ，软件默认是12小时制，可以在设置中启用24小时制，并且还支持设置显示秒钟、日期、文案，滴答声和语音报时。支持横…...

编程日记 2024/1/26 20:28:34

Objective-C方法的声明实现及调用

1.无参数的方法 1)声明 a.位置：在interface括弧的外面 b.语法： - (返回值类型)方法名称; interface Person : NSObject -(void) run; end 2)实现 a.位置：在implementation中实现 b.语法：加大括弧将方法实现的代码写在大括孤之中 …...

编程日记 2024/1/26 20:25:31

第十四届蓝桥杯国赛 C++ B 组 C 题——班级活动（AC）

目录 1. 班级活动1. 问题描述2. 输入格式3. 输出格式4. 样例输入5. 样例输出6. 样例说明7. 评测用例规模与约定8. 原题链接 2. 解题思路3. AC_Code 1. 班级活动前置知识点：思维，分类讨论 1. 问题描述小明的老师准备组织一次班级活动。班上一共有 n…...

编程日记 2024/1/26 20:21:25

GraphQL的力量：简化复杂数据查询

1. GraphQL GraphQL 是一种由 Facebook 开发并于 2015 年公开发布的数据查询和操作语言，也是运行在服务端的运行时（runtime）用于处理 API 查询的一种规范。不同于传统的 REST API，GraphQL 允许客户端明确指定它们需要哪些数据&am…...

编程日记 2024/1/26 20:20:24

python环境安装sklearn及报错解决

安装如刚开始安装，还未遇到问题请直接从重新安装库开始看，如果遇到报错，从问题开始看问题 python安装sklearn报错 ，报错信息如下 File "<stdin>", line 1pip install scikit-learn^ SyntaxError: invalid s…...

编程日记 2024/1/26 20:19:23

log4j:WARN Please initialize the log4j system properly的解决办法

背景：很多次创建新项目log4j都出现以下2个警告： log4j:WARN No appenders could be found for logger (org.springframework.boot.ApplicationServletEnvironment).log4j:WARN Please initialize the log4j system properly 网上查询都是在说缺少以下jar…...

编程日记 2024/1/26 20:15:20

虹科分享丨汽车技术的未来：Netropy如何测试和确保汽车以太网的性能

来源：艾特保IT 虹科分享丨汽车技术的未来：Netropy如何测试和确保汽车以太网的性能原文链接：https://mp.weixin.qq.com/s/G8wihrzqpJJOx5i0o63fkA 欢迎关注虹科，为您提供最新资讯！ #汽车以太网 #车载网络 #Netropy …...

编程日记 2024/1/26 20:14:19

代码CE:reference to ‘XX‘ is ambiguous

代码CE:reference to ‘XX’ is ambiguous 今天提交代码的时候一直错误，CE，搞不明白明明在dev上成功，为什么提交失败。现在懂了，因为定义的变量和C内部函数或变量重名了。修改之后即可AC。 int data[21][21]{0}; int maxsum[21…...

编程日记 2024/1/26 20:10:15

如果想将企业微信的组织架构同步到内部知识库咋搞？方法来也！

在现代企业的运营中，内部知识库不仅储存了公司的宝贵知识资产，还充当着员工信息共享和协作的核心平台。为了保障知识库的效能最大化，使其成为支持决策、创新和培训的强大工具，企业必须拥有一套周到的权限管理机制。对此&#xff0…...

编程日记 2024/1/26 20:07:12

【c语言】扫雷

前言： 扫雷是一款经典的单人益智游戏，它的目标是在一个方格矩阵中找出所有的地雷，而不触碰到任何一颗地雷。在计算机编程领域，扫雷也是一个非常受欢迎的项目，因为它涉及到许多重要的编程概念，如数组、循环…...

编程日记 2024/1/26 20:02:07

自然语言处理的崛起：从初步分析到深度理解

自然语言处理（NLP）是计算机科学、人工智能和语言学的交叉领域，旨在让计算机能够理解和生成人类语言。随着时间的推移，NLP 经历了一系列革命性的变化，从简单的规则和模式匹配到如今的深度学习模型，它们使计算…...

编程日记 2024/1/26 20:00:06

Git学习笔记：版本回滚

文章目录回到过去：开启新时间线，时间分叉路口1. 回溯开发2. 临时恢复特性3. 实验性开发4. 分支维护和发布5. 调试历史问题类比推理： 方法：1. 临时查看旧版本2. 永久回滚到旧版本3. 创建新的分支指向旧版本回到过去：开…...

编程日记 2024/1/26 19:59:05

OpenCV图像的基本操作

图像的基本操作（Python） 素材图 P1：die.jpg P2：cool.jpg V：rabbit.mp4， 下载地址读取展示-图像 import cv2img_1 cv2.imread(./die.jpg) # default cv2.IMREAD_COLOR print("die.jpg shape(imre…...

编程日记 2024/1/26 19:55:00

小白水平理解面试经典题目LeetCode 594 Longest Harmonious Subsequence（最大和谐字符串）

594 最大和谐字符串这道题属于字符串类型题目，解决的办法还是有很多的，暴力算法，二分法，双指针等等。题目描述和谐数组是指一个数组里元素的最大值和最小值之间的差别正好是 1 。现在，给你一个整数数组 nums …...

编程日记 2024/1/26 19:51:57

Vue-35、Vue中使用ref属性

1、ref属性 2、代码 <template><div id"app"> <h1 v-text"msg" ref"title"></h1><button click"showDOM" ref&…...

编程日记 2024/1/26 19:49:55

网络通信(15)-C#TCP客户端掉线重连实例

本文上接前面的文章使用Socket在C#语言环境下完成TCP客户端的掉线重连实例。掉线重连需要使用心跳包发送测试网络的状态，进而进入重连循环线程。前面实例完成的功能：客户端与服务器连接，实现实时刷新状态。客户端接收服务器的数据。客户端发送给服务器的数据。客…...

编程日记 2024/1/26 19:48:54

React进阶 - 14（说一说”虚拟DOM“中的”Diff算法“）

本章内容目录一、了解 Diff 算法二、key 值的重要性三、为什么不建议使用 index 做 key 值上一节我们初步了解了 React中的”虚拟 DOM“ ，本节我们来说一说”虚拟DOM“中的”Diff算法“ 一、了解 Diff 算法在上一篇中，我们有讲到：当 st…...

编程日记 2024/1/26 19:47:54

#GPU|LLM|AIGC#集成显卡与独立显卡|显卡在深度学习中的选择与LLM GPU推荐

区别核心区别：显存，也被称作帧缓存。独立显卡拥有独立显存，而集成显卡通常是没有的，需要占用部分主内存来达到缓存的目的集成显卡： 是集成在主板上的，与主处理器共享系统内存。一般会在很多轻便薄型的…...

编程日记 2024/1/26 19:46:53

HCIP-IPV6实验

实验拓扑实验需求全网可达实验思路配置IP地址配置路由协议-ospf 配置R2 配置IPV6 配置R2Tunnel 将所有地址引流到Tunnel0/0/0接口 ripng配置汇总实验步骤配置IP地址以R2为例 [Huawei]sys r2 [r2]int g0/0/0 [r2-GigabitEthernet0/0/0]ip address 12.1.1…...

编程日记 2024/1/26 19:45:52

电脑插入多块移动硬盘后经常出现卡顿和蓝屏

当电脑在插入多块移动硬盘后频繁出现卡顿和蓝屏问题时，可能涉及硬件资源冲突、驱动兼容性、供电不足或系统设置等多方面原因。以下是逐步排查和解决方案： 1. 检查电源供电问题问题原因：多块移动硬盘同时运行可能导致USB接口供电不足&#x…...

编程新知 2025/10/28 15:02:57

MMaDA: Multimodal Large Diffusion Language Models

CODE ： https://github.com/Gen-Verse/MMaDA Abstract 我们介绍了一种新型的多模态扩散基础模型MMaDA，它被设计用于在文本推理、多模态理解和文本到图像生成等不同领域实现卓越的性能。该方法的特点是三个关键创新:(i) MMaDA采用统一的扩散架构&#xf…...

编程新知 2025/10/20 22:01:31

拉力测试cuda pytorch 把 4070显卡拉满

import torch import timedef stress_test_gpu(matrix_size16384, duration300):"""对GPU进行压力测试，通过持续的矩阵乘法来最大化GPU利用率参数:matrix_size: 矩阵维度大小，增大可提高计算复杂度duration: 测试持续时间（秒&…...

编程新知 2025/7/20 15:22:30

Linux --进程控制

本文从以下五个方面来初步认识进程控制： 目录进程创建进程终止进程等待进程替换模拟实现一个微型shell 进程创建在Linux系统中我们可以在一个进程使用系统调用fork()来创建子进程，创建出来的进程就是子进程，原来的进程为父进程。…...

编程新知 2025/10/27 4:49:17

Pinocchio 库详解及其在足式机器人上的应用

Pinocchio 库详解及其在足式机器人上的应用 Pinocchio (Pinocchio is not only a nose) 是一个开源的 C 库，专门用于快速计算机器人模型的正向运动学、逆向运动学、雅可比矩阵、动力学和动力学导数。它主要关注效率和准确性，并提供了一个通用的框架&…...

编程新知 2025/10/20 8:12:05

JVM虚拟机：内存结构、垃圾回收、性能优化

1、JVM虚拟机的简介 Java 虚拟机（Java Virtual Machine 简称：JVM）是运行所有 Java 程序的抽象计算机，是 Java 语言的运行环境，实现了 Java 程序的跨平台特性。JVM 屏蔽了与具体操作系统平台相关的信息，使得 Java 程序只需生成在 JVM 上运行的目标代码（字节码），就可以…...

编程新知 2025/10/25 18:03:18