[java] Apache FOP의 웹 애플리케이션 통합 방법

21 Dec 2023

java

Apache FOP(Formatting Objects Processor)은 XML 기반의 포맷을 PDF, PNG, TIFF 등의 출력 형식으로 변환해주는 오픈 소스 프로젝트입니다. 이번 글에서는 Apache FOP을 웹 애플리케이션에 통합하는 방법에 대해 알아보겠습니다.

Apache FOP 소개

Apache FOP은 XSL-FO(Extensible Stylesheet Language Formatting Objects) 포맷을 PDF나 그 외의 출력 형식으로 변환하는 기능을 제공합니다. XML 형식으로 구성된 데이터와 스타일을 연결하여 원하는 형식의 문서로 출력할 수 있습니다.

Apache FOP 웹 애플리케이션 통합

Apache FOP을 웹 애플리케이션에 통합하기 위해서는 먼저 FOP 라이브러리를 프로젝트에 추가해야 합니다. Maven을 사용하는 경우, pom.xml 파일에 다음과 같이 의존성을 추가할 수 있습니다:

<dependency>
    <groupId>org.apache.xmlgraphics</groupId>
    <artifactId>fop</artifactId>
    <version>2.6</version>
</dependency>

웹 애플리케이션에서 Apache FOP을 사용하기 위해선 Fop 클래스를 활용하여 XSL-FO를 입력으로 받고, PDF나 그 외의 출력 형식으로 변환하는 기능을 구현할 수 있습니다.

PDF 변환 예제

다음은 Apache FOP을 사용하여 XML과 XSL-FO를 입력으로 받아 PDF로 변환하는 예제 코드입니다.

import org.apache.fop.apps.Fop;
import org.apache.fop.apps.FopFactory;
import org.apache.fop.apps.MimeConstants;
import org.apache.xmlgraphics.util.MimeConstants;

import javax.xml.transform.Transformer;
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.stream.StreamSource;
import javax.xml.transform.stream.StreamResult;

public class PDFGenerator {

    public void convertToPDF(String xmlFilePath, String xsltFilePath, String pdfOutputPath) {
        try {
            FopFactory fopFactory = FopFactory.newInstance(new File(".").toURI());
            FOUserAgent foUserAgent = fopFactory.newFOUserAgent();

            OutputStream out = new BufferedOutputStream(new FileOutputStream(new File(pdfOutputPath)));
            Fop fop = fopFactory.newFop(MimeConstants.MIME_PDF, foUserAgent, out);

            TransformerFactory factory = TransformerFactory.newInstance();
            Transformer transformer = factory.newTransformer(new StreamSource(new File(xsltFilePath)));

            Source src = new StreamSource(new File(xmlFilePath));
            Result res = new SAXResult(fop.getDefaultHandler());

            transformer.transform(src, res);
            out.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

위의 예제는 XML 파일과 XSL-FO 스타일시트를 입력으로 받아 PDF 파일로 변환하는 메서드를 보여줍니다.

마치며

Apache FOP을 웹 애플리케이션에 통합하면 서버 측에서 동적으로 PDF나 그 외의 출력 형식을 생성하여 사용자에게 제공할 수 있습니다. 이를 통해 사용자 경험을 향상시킬 수 있으며, 데이터를 효과적으로 공유할 수 있습니다.

Apache FOP에 관련된 더 많은 정보는 Apache FOP 공식 웹사이트를 참고하시기 바랍니다.