Sayi/poi-tl

어떤 프로젝트인가요?

핵심 기능

• 01Word 템플릿에 텍스트, 그림, 표, 번호 매기기 목록 및 차트를 렌더링합니다.
• 02조건부 블록과 foreach 반복을 지원하며, 표의 행과 열 반복도 가능합니다.
• 03생성된 문서에 템플릿의 서식을 유지합니다.
• 04모든 태그에 사용자 정의 로직을 적용할 수 있는 플러그인 인터페이스(RenderPolicy)를 제공합니다.
• 05주석, 첨부 파일, 북마크, 하이퍼링크 및 중첩된 하위 템플릿을 지원합니다.

활용 사례

• Word 템플릿을 사용해 Java 백엔드에서 계약서, 청구서 또는 보고서를 생성합니다.
• 웹 애플리케이션에서 데이터 기반 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 기반의 Java 템플릿 엔진으로, 태그가 포함된 템플릿에서 Word(.docx) 문서를 생성합니다. 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 백엔드에서 계약서, 청구서 또는 보고서를 생성합니다. 웹 애플리케이션에서 데이터 기반 Word 문서를 생성해 다운로드할 수 있도록 제공합니다. 애플리케이션 데이터로 동적 표와 차트가 포함된 Word 파일을 생성합니다.

poi-tl는 어떻게 설치하나요?

poi-tl Maven 의존성(버전 1.12.2)을 프로젝트에 추가합니다 {{title}} 태그가 포함된 Word 템플릿을 만든 다음 Java에서 컴파일하고 렌더링한 후 결과를 기록합니다

poi-tl은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Sayi/poi-tl