Java를 사용하여 PDF 책갈피 및 개요를 추가하는 방법

시작하기 전에 무엇이 필요합니까?

PDF 북마크를 구현하기 전에 IronPDF가 Java 프로젝트에 구성되어 있는지 확인하세요. 라이브러리는 Java 8 이상이 필요하며, Maven 또는 Gradle을 통해 통합됩니다. 프로젝트의 빌드 파일에 IronPDF 종속성을 추가하세요. 자세한 설정 지침은 시작 개요를 참조하세요.

개발 및 생산 사용을 위해 유효한 라이선스 키가 필요합니다. 응용 프로그램의 시작 부분에서 라이선스 키를 설정하고 IronPDF 메서드를 호출하기 전에 설정하세요. 라이선싱 옵션에 대한 정보는 라이선싱 가이드를 방문하세요.

PDF에 아웃라인과 북마크를 추가하려면 어떻게 해야 하나요?

아래 예제는 이 샘플 PDF를 사용하여 아웃라인 및 북마크 생성을 시연합니다. 이 과정은 기존 PDF 문서를 로드하고 IronPDF의 BookmarkManager를 사용하여 문서 전체에 탐색 지점을 추가하는 것을 포함합니다.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/single-layer.java
import java.io.IOException;
import java.nio.file.Path;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key for IronPDF
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF file
        PdfDocument pdf = PdfDocument.fromFile(Path.of("NovelSample.pdf"));

        // Get BookmarkManager object to manage bookmarks
        BookmarkManager bookmarks = pdf.getBookmark();

        // Add bookmarks at the end of the bookmark collection
        bookmarks.addBookMarkAtEnd("Title Page", 0);
        bookmarks.addBookMarkAtEnd("Table of Contents", 1);
        bookmarks.addBookMarkAtEnd("Dedication Page", 2);
        bookmarks.addBookMarkAtEnd("First Page", 3);
        bookmarks.addBookMarkAtStart("Page 4", 6);

        // Save the modified PDF with bookmarks
        pdf.saveAs(Path.of("bookmarked.pdf"));
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/single-layer.java
import java.io.IOException;
import java.nio.file.Path;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key for IronPDF
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF file
        PdfDocument pdf = PdfDocument.fromFile(Path.of("NovelSample.pdf"));

        // Get BookmarkManager object to manage bookmarks
        BookmarkManager bookmarks = pdf.getBookmark();

        // Add bookmarks at the end of the bookmark collection
        bookmarks.addBookMarkAtEnd("Title Page", 0);
        bookmarks.addBookMarkAtEnd("Table of Contents", 1);
        bookmarks.addBookMarkAtEnd("Dedication Page", 2);
        bookmarks.addBookMarkAtEnd("First Page", 3);
        bookmarks.addBookMarkAtStart("Page 4", 6);

        // Save the modified PDF with bookmarks
        pdf.saveAs(Path.of("bookmarked.pdf"));
    }
}

책갈피를 여러 겹으로 만드는 방법은 무엇인가요?

중첩 북마크는 독자가 챕터로뿐만 아니라 챕터 내의 하위 섹션으로 탐색해야 하는 다장문서나 리서치 보고서에 적합한 선택입니다. 이전 섹션에서 생성된 동일한 평면 책갈피로 시작한 후 insertBookmark을 사용하여 새로운 레이어에 항목을 추가합니다.

insertBookmark 메서드는 4개의 매개변수를 수락합니다: 책갈피 이름, 대상 페이지 인덱스, 상위 책갈피 이름 및 이전 형제 책갈피 이름. 상위 북마크 이름을 전달하면 그 아래에 중첩된 자식 항목을 생성합니다. 형제 매개변수를 null로 설정하면 새 항목이 해당 상위의 첫 번째 자식으로 배치됩니다.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/multi-layer.java
import java.io.IOException;
import java.nio.file.Path;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF file
        PdfDocument pdf = PdfDocument.fromFile(Path.of("NovelSample.pdf"));

        // Get BookmarkManager object
        BookmarkManager bookmarks = pdf.getBookmark();

        // Add top-level bookmarks at the end
        bookmarks.addBookMarkAtEnd("Title Page", 0);
        bookmarks.addBookMarkAtEnd("Table of Contents", 1);
        bookmarks.addBookMarkAtEnd("Dedication", 2);

        // Insert second-layer bookmarks as children of existing entries
        bookmarks.insertBookmark("First Page", 3, "Table of Contents", null);
        bookmarks.insertBookmark("Second Page", 4, "Table of Contents", "First Page");
        bookmarks.insertBookmark("End of Sample", 7, "Title Page", null);
        bookmarks.insertBookmark("Fourth page", 6, "Table of Contents", "Second Page");

        // Save the modified PDF with nested bookmarks
        pdf.saveAs(Path.of("multiLayer.pdf"));
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/multi-layer.java
import java.io.IOException;
import java.nio.file.Path;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF file
        PdfDocument pdf = PdfDocument.fromFile(Path.of("NovelSample.pdf"));

        // Get BookmarkManager object
        BookmarkManager bookmarks = pdf.getBookmark();

        // Add top-level bookmarks at the end
        bookmarks.addBookMarkAtEnd("Title Page", 0);
        bookmarks.addBookMarkAtEnd("Table of Contents", 1);
        bookmarks.addBookMarkAtEnd("Dedication", 2);

        // Insert second-layer bookmarks as children of existing entries
        bookmarks.insertBookmark("First Page", 3, "Table of Contents", null);
        bookmarks.insertBookmark("Second Page", 4, "Table of Contents", "First Page");
        bookmarks.insertBookmark("End of Sample", 7, "Title Page", null);
        bookmarks.insertBookmark("Fourth page", 6, "Table of Contents", "Second Page");

        // Save the modified PDF with nested bookmarks
        pdf.saveAs(Path.of("multiLayer.pdf"));
    }
}

JAVA

위의 PDF는 insertBookmark에 의해 생성된 책갈피의 트리 구조를 보여줍니다. 아웃라인 패널을 확장하여 각 자식 항목이 상위 아래에 어떻게 중첩되는지 확인하세요. 이 레이어드 접근 방식은 챕터, 하위 챕터 및 부록이 있는 보고서에 적합합니다.

---

이 종류의 라이브러리 중 가장 좋아하는 것은 IronPDF입니다. PDF 파일을 빠르고 효율적으로 조작할 수 있습니다. 또한 PDF/A 형식으로 내보내기 및 PDF 문서의 디지털 서명과 같은 많은 유용한 기능을 가지고 있습니다.

Milan Jovanovic

마이크로소프트 MVP

사례 연구 보기

IronOCR 덕분에 연간 $40,000를 수동 프로세싱에서 절약하고 생산성을 높이며 고부가가치 작업에 자원을 활용할 수 있습니다. 강력히 추천합니다.

브렌트 마첼

최고 기술 책임자, OPYN

사례 연구 보기

IronSuite는 우리의 운영에서 중요한 역할을 합니다. 이것들은 사업 전반에 걸쳐 효율성을 높이는 도구로, 평면도 생성 및 재고 관리 개선을 포함합니다.

데이비드 존스

리드 소프트웨어 엔지니어, Agorus Build

사례 연구 보기

PDF 파일에서 기존 책갈피를 어떻게 복구할 수 있나요?

PDF에서 북마크 데이터를 읽어 들이는 것은 전체 탐색 구조를 다시 빌드하지 않고 문서를 업데이트할 때 필수 사항입니다. IronPDF는 동일한 BookmarkManager 인터페이스를 통해 접근 가능한 상태로 만듭니다. PdfDocument.fromFile()로 PDF를 로드하고, BookmarkManager에 액세스한 후, 모든 최상위 책갈피를 검색하기 위해 getBookmarks()를 호출합니다.

목록에서 위치로 특정 책갈피에 액세스하려면 get(index)을 사용하십시오. getText() 메서드는 책갈피의 표시 라벨을 반환하고, getPageIndex()는 포함된 준비되지 않은 페이지 번호를 반환합니다. 하위 책갈피는 getBookmarks()가 반환하는 평면 목록에 포함되지 않습니다; 각 상위 책갈피의 getChildren() 메서드를 통해 액세스하십시오.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/retrieve-bookmarks.java
import java.io.IOException;
import java.nio.file.Path;
import java.util.List;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.Bookmark;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF file with bookmarks
        PdfDocument pdf = PdfDocument.fromFile(Path.of("bookmarked.pdf"));

        // Retrieve the bookmark manager
        BookmarkManager bookmarks = pdf.getBookmark();

        // Retrieve list of all bookmarks (includes child bookmarks)
        List<Bookmark> bookmarkList = bookmarks.getBookmarks();

        // Access a specific bookmark by zero-based index
        Bookmark bookmark = bookmarkList.get(2);

        // Print bookmark details
        System.out.println("Bookmark Title: " + bookmark.getText());
        System.out.println("Page Number: " + bookmark.getPageIndex());

        // Check if bookmark has children
        if (bookmark.getChildren() != null && !bookmark.getChildren().isEmpty()) {
            System.out.println("Number of child bookmarks: " + bookmark.getChildren().size());
        }
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/retrieve-bookmarks.java
import java.io.IOException;
import java.nio.file.Path;
import java.util.List;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.Bookmark;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF file with bookmarks
        PdfDocument pdf = PdfDocument.fromFile(Path.of("bookmarked.pdf"));

        // Retrieve the bookmark manager
        BookmarkManager bookmarks = pdf.getBookmark();

        // Retrieve list of all bookmarks (includes child bookmarks)
        List<Bookmark> bookmarkList = bookmarks.getBookmarks();

        // Access a specific bookmark by zero-based index
        Bookmark bookmark = bookmarkList.get(2);

        // Print bookmark details
        System.out.println("Bookmark Title: " + bookmark.getText());
        System.out.println("Page Number: " + bookmark.getPageIndex());

        // Check if bookmark has children
        if (bookmark.getChildren() != null && !bookmark.getChildren().isEmpty()) {
            System.out.println("Number of child bookmarks: " + bookmark.getChildren().size());
        }
    }
}

이 검색 패턴은 배포 전에 기존 PDF의 탐색 구조를 감사하거나, 게시 전에 필수 섹션이 올바르게 북마크됐는지 확인해야 하는 도구 빌딩에 유용합니다.

특정 목차에 책갈피를 삽입하려면 어떻게 해야 하나요?

특정 포지션에 북마크를 삽입하여 전체 아웃라인을 처음부터 다시 빌드하지 않고도 기존 PDF를 점진적으로 업데이트할 수 있습니다. 이는 PDF가 파이프라인에서 생성되거나 수정되며, 새로운 콘텐츠가 다운스트림으로 추가될 때 특히 유용합니다.

getBookmarks()를 사용하여 평면 책갈피 목록을 검색하고, 목록 인덱스로 대상 책갈피를 선택한 다음 addNextBookmark을 호출하여 해당 바로 뒤에 새 형제를 삽입합니다. 하위에서 선택된 책갈피 아래에 중첩된 새 항목을 배치하려면 addChildBookmark를 사용하십시오. 두 메서드는 제목 문자열과 0 기반 페이지 인덱스를 수용합니다.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/insert-at-index.java
import java.io.IOException;
import java.nio.file.Path;
import java.util.List;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.Bookmark;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF modified in the multi-layer example
        PdfDocument pdf = PdfDocument.fromFile(Path.of("multiLayer.pdf"));

        // Get the BookmarkManager
        BookmarkManager bookmarks = pdf.getBookmark();

        // Retrieve the flat bookmark list
        List<Bookmark> bookmarkList = bookmarks.getBookmarks();

        // Select a bookmark at a specific index
        Bookmark bookmark = bookmarkList.get(5);

        // Insert a new bookmark after the selected entry
        bookmark.addNextBookmark("Fourth Page", 6);

        // Add a child bookmark under the selected entry
        bookmark.addChildBookmark("Section 1", 7);

        // Save the updated PDF
        pdf.saveAs(Path.of("specificIndex.pdf"));
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/bookmarks/insert-at-index.java
import java.io.IOException;
import java.nio.file.Path;
import java.util.List;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.Bookmark;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF modified in the multi-layer example
        PdfDocument pdf = PdfDocument.fromFile(Path.of("multiLayer.pdf"));

        // Get the BookmarkManager
        BookmarkManager bookmarks = pdf.getBookmark();

        // Retrieve the flat bookmark list
        List<Bookmark> bookmarkList = bookmarks.getBookmarks();

        // Select a bookmark at a specific index
        Bookmark bookmark = bookmarkList.get(5);

        // Insert a new bookmark after the selected entry
        bookmark.addNextBookmark("Fourth Page", 6);

        // Add a child bookmark under the selected entry
        bookmark.addChildBookmark("Section 1", 7);

        // Save the updated PDF
        pdf.saveAs(Path.of("specificIndex.pdf"));
    }
}

addNextBookmark 메서드는 목록에서 선택된 책갈피의 형제로 새 항목을 삽입합니다. addChildBookmark 메서드는 선택된 책갈피 아래에 중첩된 새 항목을 배치합니다. 두 메서드는 제목 문자열과 0 기반 페이지 인덱스를 수용합니다.

Java에서 PDF 북마크를 위한 다음 단계는 무엇인가요?

PDF 북마크는 복잡한 문서를 스크롤 없이 직접 탐색 경로를 사용자에게 제공합니다. IronPDF의 BookmarkManager는 평면 항목 목록 추가, 깊이 있는 다중 레벨 개요 빌드, 기존 항목 검색 및 특정 위치에 삽입을 포함한 전체 책갈피 작업 범위를 처리합니다.

문서 구조와 탐색 기능 작업을 계속하려면 관련 리소스를 탐색하세요:

• Java에서 PDF 분할: 각자 자신의 북마크 구조를 지닌 더 작고 자급자족적인 문서를 작성하세요
• Java에서 PDF 인쇄: 북마크된 문서를 탐색을 유지한 채로 프린터에 보냅니다
• Java PDF 튜토리얼: 일반 PDF 워크플로우에 대한 추가 끝에서 끝 예제
• Java에서 PDF에 주석 추가: 특정 페이지 위치에 주석과 마크업을 첨부합니다
• Java IronPDF 예제: 전체 IronPDF Java API에 대한 코드 샘플을 복사-붙여넣기하세요

무료 체험을 시작하여 Java PDF 워크플로우에 북마크, 아웃라인 및 다른 탐색 기능을 추가하세요. 생산용으로 라이선스를 구매하려면, 라이선싱 옵션 보기를 클릭하세요.