Sayi/poi-tl

O que é?

Recursos principais

• 01Renderiza texto, imagens, tabelas, listas numeradas e gráficos em templates Word.
• 02Oferece suporte a blocos condicionais e loops foreach, incluindo loops em linhas e colunas de tabelas.
• 03Preserva a formatação do template nos documentos gerados.
• 04Oferece uma interface de plugin (RenderPolicy) para adicionar lógica personalizada a qualquer tag.
• 05Oferece suporte a comentários, anexos, bookmarks, hyperlinks e subtemplates aninhados.

Casos de uso

• Gerar contratos, faturas ou relatórios em backends Java a partir de um template Word.
• Exportar documentos Word baseados em dados para download em uma aplicação web.
• Gerar arquivos Word com tabelas e gráficos dinâmicos a partir dos dados da aplicação.

Início rápido

1. 1

   Adicione a dependência Maven do poi-tl (versão 1.12.2) ao seu projeto

2. 2

   Crie um modelo do Word com a tag {{title}} e, em seguida, compile, renderize e grave o resultado em Java

Antes de usar

• !Requer JDK 1.8 ou superior e Apache POI 5.2.2 ou superior; versões anteriores do POI causam erros em tempo de execução.

Tópicos

Perguntas frequentes

O que é poi-tl?

Um mecanismo de templates para Java que gera documentos Word (.docx) a partir de templates, usando tags e Apache POI. poi-tl (poi-template-language) gera novos documentos Word a partir de um template .docx e de um modelo de dados. Tags como {{name}} são substituídas por texto, imagens, tabelas, listas ou gráficos, enquanto a formatação do template — incluindo fontes, cores e layout — é mantida no documento gerado.

poi-tl é gratuito? Qual é a licença?

poi-tl é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

poi-tl ainda é mantido?

Manutenção ativa. O último commit de poi-tl foi em 13 de out. de 2026.

Para que posso usar poi-tl?

Gerar contratos, faturas ou relatórios em backends Java a partir de um template Word. Exportar documentos Word baseados em dados para download em uma aplicação web. Gerar arquivos Word com tabelas e gráficos dinâmicos a partir dos dados da aplicação.

Como instalar poi-tl?

Adicione a dependência Maven do poi-tl (versão 1.12.2) ao seu projeto Crie um modelo do Word com a tag {{title}} e, em seguida, compile, renderize e grave o resultado em Java

Onde consigo poi-tl?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Sayi/poi-tl