[java] Apache Velocity와 PDF 생성 템플릿 적용 사례

21 Dec 2023

java

Apache Velocity는 자바 어플리케이션에서 동적으로 텍스트를 생성하는데 사용되는 강력한 템플릿 엔진입니다. 특히 이 엔진을 이용하여 PDF 생성시 복잡한 템플릿을 적용할 수 있습니다. 이번 블로그에서는 Apache Velocity를 사용하여 PDF를 생성하는 방법에 대해 알아보겠습니다.

Apache Velocity란?

Apache Velocity는 자바 어플리케이션에서 템플릿 기반의 텍스트 파일을 생성할 수 있게 해주는 오픈 소스 라이브러리입니다. Velocity는 템플릿을 작성할 때 사용되는 특별한 문법을 갖고 있으며, 동적 데이터를 쉽게 삽입할 수 있습니다. Velocity는 주로 HTML, XML, JSON과 같은 텍스트 기반의 형식을 동적으로 생성하는 데 사용됩니다.

PDF 생성을 위한 Apache Velocity 템플릿

PDF 생성을 위해서는 Apache Velocity 템플릿을 사용하여 PDF가 출력될 형식을 정의해야 합니다. Velocity 템플릿에서는 PDF 문서의 각 부분을 동적으로 생성할 수 있으며, 텍스트, 테이블, 이미지 등을 포함하여 다양한 컨텐츠를 추가할 수 있습니다.

Apache Velocity 템플릿 예제

아래는 Apache Velocity 템플릿의 예제입니다.

#macro( header )
    <html>
    <head>
        <title>$title</title> 
    </head>
    <body>
#end

#macro( footer )
    </body>
    </html>
#end

#set( $title = "PDF 생성 예제" )

#header()
    <h1>Welcome to Apache Velocity PDF Generation</h1>
#footer()

위의 예제에서는 header와 footer라는 매크로를 정의하고, title 변수를 템플릿에 설정하여 PDF 문서의 헤더와 푸터를 동적으로 생성하는 방법을 보여줍니다.

PDF 생성 및 템플릿 적용

PDF 생성을 위해서는 Apache PDFBox나 iText와 같은 라이브러리를 사용할 수 있습니다. 이러한 라이브러리를 이용하여 Apache Velocity 템플릿을 해석하고, PDF 문서를 생성할 수 있습니다.

VelocityEngine ve = new VelocityEngine();
ve.init();

Template template = ve.getTemplate("template.vm");

VelocityContext context = new VelocityContext();
context.put("title", "PDF 생성 예제");

StringWriter writer = new StringWriter();
template.merge(context, writer);

PDDocument document = new PDDocument();
PDPage page = new PDPage();
document.addPage(page);

PDPageContentStream contentStream = new PDPageContentStream(document, page);
contentStream.beginText();
contentStream.setFont(PDType1Font.HELVETICA_BOLD, 12);
contentStream.newLineAtOffset(100, 700);
contentStream.showText(writer.toString());
contentStream.endText();
contentStream.close();

document.save("generated.pdf");
document.close();

위의 코드는 Apache Velocity 템플릿을 사용하여 PDF를 생성하는 간단한 예제를 보여줍니다. VelocityEngine를 초기화하고, 템플릿을 해석하여 동적인 내용을 생성한 후, PDFBox를 사용하여 PDF 문서를 만들어 저장하는 과정을 보여줍니다.

Apache Velocity를 사용하여 PDF 생성 시 템플릿을 작성하고, PDF 문서에 동적으로 내용을 추가하여 효과적으로 보고서나 문서를 생성할 수 있습니다.

Apache Velocity 및 PDF 생성 라이브러리를 효과적으로 활용하여 동적으로 생성되는 PDF 문서를 만들기 위해 더 많은 자료와 예제를 참조할 것을 권장합니다.

참고 자료

Apache Velocity 공식 웹사이트: https://velocity.apache.org/
Apache PDFBox 공식 웹사이트: https://pdfbox.apache.org/
iText 공식 웹사이트: https://itextpdf.com/

Apache Velocity 및 PDF 생성 라이브러리를 사용하여 동적으로 PDF를 생성하는 방법에 대해 더 많은 정보를 얻기 위해서는 위의 참고 자료를 확인하시기 바랍니다.