itextpdf freemarker渲染-linux运维-PHP中文网

itextpdf freemarker渲染

雪夜

发布： 2025-07-14 09:36:43

原创

433人浏览过

关于打印pdf操作的需求，经过研究，发现以下两种方法：

在现有的模板上进行编辑，这种方法操作难度较大。而通过FreeMarker生成静态页面，然后转换为HTML，操作更为顺畅。动态生成PDF的方法在网上参考较多，经过对比，我认为使用FreeMarker结合IText生成PDF最为简单。参考链接为https://www.cnblogs.com/yunfeiyang-88/p/10984740.html，GitHub示例代码地址为https://github.com/chywx/spring-boot-pdf/blob/freemarker-print/src/main/java/cn/chendahai/html2pdf/JavaToPdfHtmlFreeMarkerBet.java。

开始实现这个功能，首先需要建立一个Spring Boot项目，并添加必要的Maven依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>
<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>itextpdf</artifactId>
    <version>5.5.13.2</version>
</dependency>
<dependency>
    <groupId>org.xhtmlrenderer</groupId>
    <artifactId>flying-saucer-pdf</artifactId>
    <version>9.1.20</version>
</dependency>

登录后复制

接下来，在application.properties中配置FreeMarker的默认设置：

spring.freemarker.charset=UTF-8
spring.freemarker.suffix=.ftl
spring.freemarker.content-type=text/html; charset=utf-8
spring.freemarker.template-loader-path=classpath:/templates
spring.mvc.static-path-pattern=/static/**

登录后复制

测试代码如下：

public class JavaToPdfHtmlFreeMarkerBet {
    private static final String DEST = "target/bet-gg.pdf";
    private static final String HTML = "index7.html";
    private static final String IMG_PATH = "file:///D:/project/javaproject/spring-boot-pdf/src/main/resources/static/";
    private static Configuration freemarkerCfg;
<pre class="brush:php;toolbar:false;"><code>static {
    freemarkerCfg = new Configuration();
    //freemarker的模板目录
    try {
        freemarkerCfg.setDirectoryForTemplateLoading(new File("src/main/resources/templates/betPrint"));
    } catch (IOException e) {
        e.printStackTrace();
    }
}

public static void main(String[] args) throws IOException, DocumentException, com.lowagie.text.DocumentException {
    Map<String, Object> data = new HashMap();
    data.put("name", "dahai");
    String content = JavaToPdfHtmlFreeMarkerBet.freeMarkerRender(data, HTML);
    JavaToPdfHtmlFreeMarkerBet.createPdf(content, DEST);
}

/**
 * freemarker渲染html
 */
public static String freeMarkerRender(Map<String, Object> data, String htmlTmp) {
    Writer out = new StringWriter();
    try {
        // 获取模板,并设置编码方式
        Template template = freemarkerCfg.getTemplate(htmlTmp);
        template.setEncoding("UTF-8");
        // 合并数据模型与模板
        template.process(data, out); //将合并后的数据和模板写入到流中，这里使用的字符流
        out.flush();
        return out.toString();
    } catch (Exception e) {
        e.printStackTrace();
    } finally {
        try {
            out.close();
        } catch (IOException ex) {
            ex.printStackTrace();
        }
    }
    return null;
}

public static void createPdf(String content, String dest) throws IOException, com.lowagie.text.DocumentException {
    ITextRenderer render = new ITextRenderer();
    // 解析html生成pdf
    render.setDocumentFromString(content);
    //解决图片相对路径的问题
    render.getSharedContext().setBaseURL(IMG_PATH);
    render.layout();
    render.createPDF(new FileOutputStream(dest));
}

登录后复制

}

在Web环境下获取模板，可以直接通过注入FreeMarkerConfigurer来实现：

自渲染键盘插件keyboard.js

查看详情

@Autowired
FreeMarkerConfigurer freeMarkerConfigurer;
Template template = freeMarkerConfigurer.getConfiguration().getTemplate("betPrint/print_match.ftl");

登录后复制

设置边距需要在前端通过模板进行控制：

@page {
margin: 0in 0.1in 0in 0.1in;
mso-header-margin: .5in;
mso-footer-margin: .5in;
mso-page-orientation: landscape;
}

登录后复制

然而，如果在打印时选择实际大小，前面的配置可能会失效。

itextpdf freemarker渲染

如果是在Web环境下，可以通过生成流的方式返回PDF给客户端，避免磁盘IO操作。方法是将render.createPDF(new FileOutputStream(dest));修改为：

ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
render.createPDF(outputStream);

登录后复制

总结：HTML格式需要符合XML标准，必须有闭合标签。例如<br>应写成<br/>。由于PDF是服务端生成的，与客户端无关，这一点很好。但在Windows和Linux系统上可能存在细微差异，例如Linux上的最小字体大小为12px。CSS中有些语法可能不支持，如C3不支持。加载图片可以使用file://协议，Linux也支持。为了简单起见，可以直接使用HTTP加载网络图片。由于通过模板渲染，边距和分页等设置需要前端处理，例如通过height: 100%;box-sizing: border-box;来实现。

以上就是itextpdf freemarker渲染的详细内容，更多请关注php中文网其它相关文章！