Sayi/poi-tl

これは何？

主な機能

• 01Wordテンプレートにテキスト、画像、表、番号付きリスト、グラフを挿入できます。
• 02条件分岐とforeachループに対応し、表の行や列のループも処理できます。
• 03生成した文書でもテンプレートの書式を保持します。
• 04任意のタグにカスタムロジックを適用できるプラグインインターフェース（RenderPolicy）を提供します。
• 05コメント、添付ファイル、ブックマーク、ハイパーリンク、ネストしたサブテンプレートに対応しています。

ユースケース

• Wordテンプレートから、Javaバックエンドで契約書、請求書、レポートを生成する。
• Webアプリケーションでデータに基づくWord文書を生成し、ダウンロードできるようにする。
• アプリケーションのデータから、動的な表やグラフを含むWordファイルを作成する。

クイックスタート

1. 1

   poi-tl Maven 依存関係（バージョン 1.12.2）をプロジェクトに追加します

2. 2

   {{title}} タグを含む Word テンプレートを作成し、Java でコンパイル、レンダリングして出力を書き込みます

使う前に知っておきたいこと

• !JDK 1.8 以降と Apache POI 5.2.2 以降が必要です。古い POI バージョンでは実行時エラーが発生します。

トピック

よくある質問

poi-tl とは？

Apache POIを基盤とする、タグ付きテンプレートからWord（.docx）文書を生成するJavaテンプレートエンジン。 poi-tl（poi-template-language）は、.docxテンプレートとデータモデルから新しいWord文書を生成します。{{name}}のようなタグをテキスト、画像、表、リスト、グラフに置き換え、フォント、色、レイアウトなどテンプレートの書式を出力にも保持します。

poi-tl は無料で使えますか？ライセンスは？

poi-tl は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

poi-tl は今もメンテナンスされていますか？

活発にメンテナンス中。poi-tl の最終コミットは 2026年10月13日 です。

poi-tl は何に使えますか？

Wordテンプレートから、Javaバックエンドで契約書、請求書、レポートを生成する。 Webアプリケーションでデータに基づくWord文書を生成し、ダウンロードできるようにする。 アプリケーションのデータから、動的な表やグラフを含むWordファイルを作成する。

poi-tl のインストール方法は？

poi-tl Maven 依存関係（バージョン 1.12.2）をプロジェクトに追加します {{title}} タグを含む Word テンプレートを作成し、Java でコンパイル、レンダリングして出力を書き込みます

poi-tl はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/Sayi/poi-tl