[java] PDF 파일에 책갈피 추가하기(Java Apache PDFBox 사용)

17 Nov 2023

java

PDF 파일에 책갈피를 추가하는 방법은 Java Apache PDFBox 라이브러리를 사용하여 간단하게 수행할 수 있습니다. 이 블로그 포스트에서는 PDF 파일에 책갈피를 추가하는 방법을 소개합니다.

필요한 준비물

Java 개발 환경
Apache PDFBox 라이브러리 (버전 2.0 이상)

Apache PDFBox 라이브러리 추가하기

Maven을 사용하는 경우, pom.xml 파일에 다음 종속성을 추가하여 Apache PDFBox를 프로젝트에 추가할 수 있습니다.

<dependency>
    <groupId>org.apache.pdfbox</groupId>
    <artifactId>pdfbox</artifactId>
    <version>2.0.0</version>
</dependency>

직접 다운로드하여 사용하는 경우, Apache PDFBox 라이브러리를 공식 웹사이트에서 다운로드하여 프로젝트에 추가합니다.

PDF 파일에 책갈피 추가하기

다음은 PDF 파일에 책갈피를 추가하는 간단한 예제 코드입니다.

import java.io.File;
import java.io.IOException;
import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDPage;
import org.apache.pdfbox.pdmodel.common.PDRectangle;
import org.apache.pdfbox.pdmodel.interactive.documentnavigation.outline.PDDocumentOutline;
import org.apache.pdfbox.pdmodel.interactive.documentnavigation.outline.PDOutlineItem;

public class AddBookmarkToPDF {
    public static void main(String[] args) {
        try {
            // 책갈피를 추가할 PDF 파일 경로
            String filePath = "example.pdf";
            
            // PDDocument 객체 생성
            PDDocument document = new PDDocument();
            
            // 첫 번째 페이지 생성
            PDPage firstPage = new PDPage(PDRectangle.A4);
            document.addPage(firstPage);
            
            // 책갈피 생성
            PDDocumentOutline bookmarks = new PDDocumentOutline();
            PDOutlineItem bookmark = new PDOutlineItem();
            bookmark.setTitle("Example Bookmark");
            bookmark.setDestination(firstPage);
            
            // 책갈피를 책갈피 목록에 추가
            bookmarks.addLast(bookmark);
            
            // 책갈피 목록을 문서에 설정
            document.getDocumentCatalog().setDocumentOutline(bookmarks);
            
            // PDF 파일로 저장
            document.save(filePath);
            
            // PDDocument 닫기
            document.close();
            
            System.out.println("책갈피가 추가된 PDF 파일이 생성되었습니다: " + filePath);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

위의 코드는 example.pdf라는 이름의 PDF 파일을 생성하고, 첫 번째 페이지에 “Example Bookmark”라는 책갈피를 추가하는 예제입니다. 필요에 따라 코드를 수정하여 다른 책갈피를 추가할 수도 있습니다.

결론

Java Apache PDFBox 라이브러리를 사용하여 PDF 파일에 책갈피를 추가하는 방법을 알아보았습니다. 책갈피를 추가하면 사용자가 PDF 파일 내에서 쉽게 이동할 수 있으며, 더 효율적인 문서 탐색이 가능해집니다.

더 자세한 내용은 Apache PDFBox 공식 문서를 참고하시기 바랍니다.