«1. Обзор

В этом уроке мы научимся создавать PDF-файлы, используя Thymeleaf в качестве механизма шаблонов, на быстром практическом примере.

2. Зависимости Maven

Во-первых, давайте добавим нашу зависимость от Thymeleaf: 

<dependency>
    <groupId>org.thymeleaf</groupId>
    <artifactId>thymeleaf</artifactId>
    <version>3.0.11.RELEASE</version>
</dependency>

Thymeleaf сам по себе является просто механизмом шаблонов, и он не может генерировать PDF-файлы самостоятельно. Для этого мы добавим в наш файл pom.xml «летающую тарелку»: 

<dependency>
    <groupId>org.xhtmlrenderer</groupId>
    <artifactId>flying-saucer-pdf</artifactId>
    <version>9.1.20</version>
</dependency>

3. Генерация PDF-файлов

Далее давайте создадим простой HTML-шаблон Thymeleaf — thymeleaf_template.html: 

<html xmlns:th="http://www.thymeleaf.org">
  <body>
    <h3 style="text-align: center; color: green">
      <span th:text="'Welcome to ' + ${to} + '!'"></span>
    </h3>
  </body>
</html>

Затем мы создадим простую функцию – parseThymeleafTemplate – которая будет анализировать наш шаблон и возвращать строку HTML: 

private String parseThymeleafTemplate() {
    ClassLoaderTemplateResolver templateResolver = new ClassLoaderTemplateResolver();
    templateResolver.setSuffix(".html");
    templateResolver.setTemplateMode(TemplateMode.HTML);

    TemplateEngine templateEngine = new TemplateEngine();
    templateEngine.setTemplateResolver(templateResolver);

    Context context = new Context();
    context.setVariable("to", "Baeldung");

    return templateEngine.process("thymeleaf_template", context);
}

Наконец, давайте реализуем простую функцию, которая получает ранее сгенерированный HTML в качестве входных данных и записать PDF в нашу домашнюю папку: 

public void generatePdfFromHtml(String html) {
    String outputFolder = System.getProperty("user.home") + File.separator + "thymeleaf.pdf";
    OutputStream outputStream = new FileOutputStream(outputFolder);

    ITextRenderer renderer = new ITextRenderer();
    renderer.setDocumentFromString(html);
    renderer.layout();
    renderer.createPDF(outputStream);

    outputStream.close();
}

После запуска нашего кода мы заметим файл с именем thymeleaf.pdf в домашнем каталоге нашего пользователя, который выглядит следующим образом: ~~ ~ Как мы видим, текст зеленого цвета и выровнен по центру, как определено в нашем встроенном CSS. Это чрезвычайно мощный инструмент для настройки наших PDF-файлов.

Мы должны иметь в виду, что Thymeleaf полностью отделен от Flying Saucer, а это означает, что мы можем использовать любой другой механизм шаблонов для создания PDF-файлов, такой как Apache FreeMarker.

4. Заключение

В этом кратком руководстве мы узнали, как легко создавать PDF-файлы, используя Thymeleaf в качестве механизма шаблонов.

Как всегда, код доступен на GitHub.

«