Sayi/poi-tl

Что это?

Ключевые возможности

• 01Вставляет в шаблоны Word текст, изображения, таблицы, нумерованные списки и диаграммы.
• 02Поддерживает условные блоки и циклы foreach, в том числе циклы по строкам и столбцам таблиц.
• 03Сохраняет стили шаблона в созданных документах.
• 04Предоставляет интерфейс плагинов (RenderPolicy) для пользовательской логики, привязанной к любому тегу.
• 05Поддерживает комментарии, вложения, закладки, гиперссылки и вложенные подшаблоны.

Сценарии использования

• Создание договоров, счетов или отчётов в Java-бэкендах на основе шаблона Word.
• Экспорт документов Word с данными из веб-приложения для скачивания.
• Создание файлов Word с динамическими таблицами и диаграммами на основе данных приложения.

Быстрый старт

1. 1

   Добавьте зависимость Maven poi-tl (версия 1.12.2) в проект

2. 2

   Создайте шаблон Word с тегом {{title}}, затем скомпилируйте его, выполните рендеринг и запишите результат на Java

Что важно знать

• !Требуются JDK 1.8 или новее и Apache POI 5.2.2 или новее; более старые версии POI вызывают ошибки во время выполнения.

Темы

Частые вопросы

Что такое poi-tl?

Java-движок шаблонов для создания документов Word (.docx) на основе шаблонов и Apache POI. poi-tl (poi-template-language) создаёт документы Word на основе шаблона .docx и модели данных. Теги вроде {{name}} заменяются текстом, изображениями, таблицами, списками или диаграммами, при этом в результате сохраняется оформление шаблона, включая шрифты, цвета и макет.

poi-tl можно использовать бесплатно? Какая у него лицензия?

poi-tl распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.

poi-tl всё ещё поддерживается?

Активно поддерживается. Последний коммит в poi-tl — 13 окт. 2026 г..

Для чего можно использовать poi-tl?

Создание договоров, счетов или отчётов в Java-бэкендах на основе шаблона Word. Экспорт документов Word с данными из веб-приложения для скачивания. Создание файлов Word с динамическими таблицами и диаграммами на основе данных приложения.

Как установить poi-tl?

Добавьте зависимость Maven poi-tl (версия 1.12.2) в проект Создайте шаблон Word с тегом {{title}}, затем скомпилируйте его, выполните рендеринг и запишите результат на Java

Где скачать poi-tl?

Исходный код и инструкции по установке — на GitHub: https://github.com/Sayi/poi-tl