SpringBoot下载freemarker转换的图片（高清不模糊）

最新推荐文章于 2025-10-20 15:38:35 发布

原创

最新推荐文章于 2025-10-20 15:38:35 发布 · 1.3k 阅读

4 ·

CC 4.0 BY-SA版权

文章标签：

#java #spring #freemarker #xhtmlrenderer

该博客介绍了一个使用Freemarker模板生成不同图片的Java项目，通过调整参数避免图片模糊。项目依赖于flying-saucer库，并在Controller中实现了从HTML到BufferedImage的转换，最后输出高质量的JPEG图片。提供了完整的代码示例和Git项目链接。

一、背景

需要根据不同的参数将freemarker的模板转成不同的图片返回给前端下载。

注意：想要图片不模糊，请调整如下参数

sharedContext.setDotsPerPixel(3);
sharedContext.setDPI(523);

二、效果预览

三、项目

1.maven

        <dependency>
            <groupId>org.xhtmlrenderer</groupId>
            <artifactId>flying-saucer-core</artifactId>
            <version>9.1.22</version>
        </dependency>

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

2.FreemarkerUtil

package com.asyf.freemarkerdemo.util;

import freemarker.template.Configuration;
import freemarker.template.Template;
import lombok.extern.slf4j.Slf4j;
import org.springframework.util.ResourceUtils;
import org.w3c.dom.Document;
import org.xhtmlrenderer.layout.SharedContext;
import org.xhtmlrenderer.swing.Java2DRenderer;

import javax.imageio.ImageIO;
import javax.xml.parsers.DocumentBuilder;
import java