대규모 Word 보고서나 매뉴얼을 만들 때, 사용자가 빠르게 훑어볼 수 있도록 탐색 가능한 목차를 생성하는 것이 필수적입니다. Conholdate.Total for Java은 Java 애플리케이션에서 직접 DOCX 파일을 다루는 작업을 간소화하는 강력한 SDK를 제공합니다. 이 단계별 가이드에서는 설정, 코드 설명 및 모범 사례를 포함하여 Java에서 Word 문서에 목차를 추가하는 방법을 배웁니다.

Java에서 Word 문서에 목차를 추가하기 위한 전체 작업 예제

다음 예제는 Conholdate.Total for Java를 사용하여 기존 DOCX 파일에 목차를 삽입하는 방법을 보여줍니다.

import com.groupdocs.words.Document;
import com.groupdocs.words.DocumentBuilder;
import com.groupdocs.words.TableOfContentsOptions;
import com.groupdocs.words.SaveFormat;
import com.groupdocs.words.TabLeader;

public class AddTableOfContentsExample {
    public static void main(String[] args) throws Exception {
        // Paths to the source and destination Word documents
        String inputPath = "input.docx";
        String outputPath = "output.docx";

// Load the existing document, add a TOC, and save the result
        try (Document doc = new Document(inputPath)) {
            DocumentBuilder builder = new DocumentBuilder(doc);

// Move cursor to the beginning of the document where the TOC will be inserted
            builder.moveToDocumentStart();

// Configure TOC options
            TableOfContentsOptions tocOptions = new TableOfContentsOptions();
            tocOptions.setUpperHeadingLevel(1);          // Include headings from level 1
            tocOptions.setLowerHeadingLevel(3);          // up to level 3
            tocOptions.setRightAlignPageNumbers(true);  // Align page numbers to the right
            tocOptions.setUseHyperlinks(true);           // Make entries clickable
            tocOptions.setTabLeader(TabLeader.DOTS);     // Use dotted leader

// Insert the Table of Contents
            builder.insertTableOfContents(tocOptions);

// Save the modified document
            doc.save(outputPath, SaveFormat.DOCX);
        }
    }
}

참고: 이 코드 예제는 핵심 기능을 보여줍니다. 프로젝트에서 사용하기 전에 파일 경로(input.docx, output.docx 등)를 실제 파일 위치에 맞게 업데이트하고, 모든 필수 종속성이 올바르게 설치되었는지 확인한 뒤, 개발 환경에서 충분히 테스트하십시오. 문제가 발생하면 공식 문서를 참조하거나 지원 팀에게 도움을 요청하십시오.

Java 코드에서 Word 문서에 목차 추가 이해

아래는 샘플 코드가 수행하는 주요 단계의 개요입니다:

  1. 소스 문서 로드 - Document 클래스는 기존 DOCX 파일을 읽습니다.

    try (Document doc = new Document(inputPath)) {

  2. DocumentBuilder 만들기 - DocumentBuilder는 문서 내용을 편집하는 메서드를 제공합니다.

    DocumentBuilder builder = new DocumentBuilder(doc);

  3. 커서를 위치시키기 - moveToDocumentStart()는 삽입 지점을 파일의 가장 처음으로 이동시켜, TOC가 모든 내용 앞에 표시되도록 합니다.

builder.moveToDocumentStart();
  1. TOC 옵션 구성 - TableOfContentsOptions를 사용하면 제목 수준, 페이지‑번호 정렬, 하이퍼링크 사용 및 탭 리더 스타일을 정의할 수 있습니다.
TableOfContentsOptions tocOptions = new TableOfContentsOptions();
tocOptions.setUpperHeadingLevel(1);
tocOptions.setLowerHeadingLevel(3);
tocOptions.setRightAlignPageNumbers(true);
tocOptions.setUseHyperlinks(true);
tocOptions.setTabLeader(TabLeader.DOTS);

자세한 API 참조는 API 참조 페이지에서 확인할 수 있습니다.

  1. 목차 삽입 및 저장 - insertTableOfContents는 필드를 추가하고, doc.save는 업데이트된 파일을 DOCX 형식으로 저장합니다.
builder.insertTableOfContents(tocOptions);
doc.save(outputPath, SaveFormat.DOCX);

Conholdate.Total for Java 설치 및 구성

Conholdate Maven 저장소와 SDK 종속성을 pom.xml에 추가하십시오:

<repositories>
    <repository>
        <id>conholdate-repo</id>
        <name>Conholdate Maven Repository</name>
        <url>https://repository.conholdate.com/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.conholdate</groupId>
    <artifactId>conholdate-total</artifactId>
    <version>24.9</version>
    <type>pom</type>
</dependency>

최신 SDK 패키지를 다운로드 페이지에서 다운로드하십시오. SDK는 Java 8 이상이 필요하며 표준 JVM에서 실행됩니다. 추가 런타임 구성 요소는 필요하지 않습니다.

Java로 Word TOC 생성에 대한 모범 사례

  • 일관된 헤딩 스타일 사용 - TOC는 내장된 헤딩 레벨(Heading 1, Heading 2 등)로 스타일링된 단락을 감지합니다. 신뢰할 수 있는 항목 생성을 위해 원본 문서가 이러한 스타일을 사용하도록 하세요.
  • 헤딩 깊이 제한 - 너무 많은 레벨을 포함하면 TOC가 복잡해질 수 있습니다. 일반적인 보고서는 예시와 같이 레벨 1‑3을 사용합니다.
  • 하이퍼링크 활성화 - setUseHyperlinks(true) 설정은 클릭 가능한 항목을 생성하여 최종 문서의 탐색을 개선합니다.
  • 삽입 후 검증 - 생성된 DOCX를 열고 필드를 업데이트(Ctrl +A, F9)하여 페이지 numbers가 정확한지 확인하세요, 특히 추가 편집 후에.
  • TOC 옵션 객체 재사용 - 배치에서 여러 문서를 생성하는 경우 옵션을 한 번 설정하고 재사용하여 객체 생성 오버헤드를 줄이세요.

결론

Java에서 Word 문서에 목차를 추가하는 작업은 Conholdate.Total for Java를 사용하면 간단해집니다. DOCX를 로드하고 TableOfContentsOptions를 구성한 뒤 필드를 삽입하면 전문적인 보고서와 매뉴얼을 자동으로 생성할 수 있습니다. SDK를 설치하고 모범 사례 권장 사항을 따르며 생성된 목차를 대상 환경에서 테스트하는 것을 기억하세요. 실제 배포를 위해서는 라이선스가 필요하며, 가격 정보는 가격 페이지에서 확인할 수 있고, 임시 라이선스는 임시 라이선스 페이지에서 얻을 수 있습니다.

FAQs

  • Java에서 Word 문서에 목차를 추가하는 가장 간단한 방법은 무엇인가요?
    DocumentBuilder.moveToDocumentStart()를 사용한 다음, 구성된 TableOfContentsOptions 객체와 함께 insertTableOfContents를 호출하면 코드 예제에 표시된 대로 목차를 삽입할 수 있습니다.

  • 목차에 표시되는 헤딩 수준을 어떻게 제어할 수 있나요?
    TableOfContentsOptions 인스턴스에서 setUpperHeadingLevel 및 setLowerHeadingLevel을 설정하여 원하는 수준만 포함하도록 합니다.

  • Word 템플릿에 나중에 채워질 TOC를 생성할 수 있나요?
    예. 동적 콘텐츠를 채우기 전에 템플릿 파일에 TOC를 삽입하면, 나중에 추가되는 헤딩을 자동으로 참조합니다.

  • 이 SDK를 사용하려면 인터넷 연결이 필요합니까?
    아니요. Conholdate.Total for Java는 서버나 데스크톱에서 외부 서비스 호출 없이 실행되는 로컬 라이브러리입니다.

더 읽기