GroupDocs.Comparison API를 사용하여 Java에서 문서 비교 마스터하기

소개

문서를 수동으로 비교하는 데 지치셨나요? 머리글, 바닥글 또는 콘텐츠의 변경 사항을 파악하는 등 문서 비교는 까다로운 작업일 수 있습니다. Java용 GroupDocs.Comparison 라이브러리는 이 프로세스를 정확하고 간편하게 자동화하고 향상시켜 줍니다.

이 포괄적인 튜토리얼은 Java에서 GroupDocs.Comparison을 활용하여 문서 비교 스타일을 사용자 지정하고, 민감도 설정을 조정하고, 머리글/바닥글 비교를 무시하고, 출력 용지 크기를 설정하는 등의 방법을 안내합니다. 이 가이드를 마치면 워크플로를 효율적으로 간소화할 수 있을 것입니다.

배울 내용:

  • 문서 비교 중 머리글과 바닥글을 무시합니다.
  • 스타일 조정을 통해 변경 사항을 사용자 정의합니다.
  • 자세한 분석을 위해 비교 민감도를 조정하세요.
  • Java 애플리케이션에서 출력 용지 크기를 설정합니다.
  • 이러한 기능을 실제 시나리오에 구현합니다.

실제적인 측면에 들어가기 전에 필요한 전제 조건을 갖추고 있는지 확인하세요.

필수 조건

Java용 GroupDocs.Comparison을 시작하려면 다음 사항이 있는지 확인하세요.

  1. 자바 개발 키트(JDK): 컴퓨터에 JDK가 설치되어 있는지 확인하세요. 8 이상 버전이면 충분합니다.
  2. 메이븐: 이 튜토리얼에서는 Maven을 사용하여 프로젝트 종속성을 관리한다고 가정합니다.
  3. GroupDocs.Comparison 라이브러리:
    • 다음 종속성을 추가하세요. pom.xml:
<repositories>
    <repository>
        <id>repository.groupdocs.com</id>
        <name>GroupDocs Repository</name>
        <url>https://releases.groupdocs.com/comparison/java/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-comparison</artifactId>
        <version>25.2</version>
    </dependency>
</dependencies>
  1. 특허: GroupDocs에서 무료 평가판이나 임시 라이선스를 받거나 정식 버전을 구매하세요.

이러한 설정을 완료하면 Java 애플리케이션에서 문서 비교 기능을 구현할 준비가 된 것입니다.

Java용 GroupDocs.Comparison 설정

환경이 올바르게 구성되었는지 확인하세요.

Maven을 통한 설치

위의 XML 스니펫을 프로젝트에 추가하세요. pom.xml이 단계에서는 Maven이 필요한 저장소와 종속성을 인식하는지 확인합니다.

라이센스 취득

GroupDocs 설명서에 따라 라이선스 파일을 얻고 설정한 후 다음과 같이 GroupDocs.Comparison을 초기화합니다.

// 기본 초기화 예제
com.groupdocs.comparison.License license = new com.groupdocs.comparison.License();
license.setLicense("path/to/your/license/file.lic");

구현 가이드

기능 1: 헤더/푸터 비교 무시

개요: 머리글과 바닥글에는 페이지 번호나 문서 제목과 같은 정보가 포함되는 경우가 많은데, 이러한 정보는 콘텐츠 변경 비교에 적합하지 않을 수 있습니다.

옵션 설정

import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;
import java.io.FileOutputStream;

public class IgnoreHeaderFooterExample {
    public static void main(String[] args) throws Exception {
        String outputFileName = "YOUR_OUTPUT_DIRECTORY/IgnoreHeaderFooter_result.docx";

        try (OutputStream resultStream = new FileOutputStream(outputFileName);
             Comparer comparer = new Comparer("YOUR_DOCUMENT_DIRECTORY/source_with_footer.docx")) {

            comparer.add("YOUR_DOCUMENT_DIRECTORY/target_with_footer.docx");

            // 헤더와 푸터 무시를 위한 비교 옵션 설정
            CompareOptions compareOptions = new CompareOptions.Builder()
                    .setHeaderFootersComparison(false)
                    .build();

            final Path resultPath = comparer.compare(resultStream, new SaveOptions(), compareOptions);
        }
    }
}

설명

  • CompareOptions.Builder().setHeaderFootersComparison(false): 이 설정은 라이브러리가 헤더와 푸터 비교를 건너뛰도록 지시합니다.
  • try-with-resources: 사용 후 모든 흐름이 제대로 닫혔는지 확인합니다.

기능 2: 출력 용지 크기 설정

개요: 인쇄에 적합한 문서를 만들려면 출력 용지 크기를 사용자 지정하는 것이 중요합니다. 문서 비교 중에 용지 크기를 조정하는 방법은 다음과 같습니다.

구현 단계

import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;
import com.groupdocs.comparison.options.enums.PaperSize;

public class SetOutputPaperSizeExample {
    public static void main(String[] args) throws Exception {
        String outputFileName = "YOUR_OUTPUT_DIRECTORY/SetOutputPaperSize_result.docx";

        try (OutputStream resultStream = new FileOutputStream(outputFileName);
             Comparer comparer = new Comparer("YOUR_DOCUMENT_DIRECTORY/source_word.docx")) {

            comparer.add("YOUR_DOCUMENT_DIRECTORY/target1_word.docx");

            // 용지 크기를 A6로 설정하세요
            CompareOptions compareOptions = new CompareOptions.Builder()
                    .setPaperSize(PaperSize.A6)
                    .build();

            final Path resultPath = comparer.compare(resultStream, compareOptions);
        }
    }
}

설명

  • CompareOptions.Builder().setPaperSize(PaperSize.A6): 출력 용지 크기를 A6로 설정합니다.

기능 3: 비교 민감도 조정

개요: 비교 민감도를 미세 조정하면 사소한 변화도 식별하는 데 도움이 됩니다. 조정 방법은 다음과 같습니다.

import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;

public class AdjustComparisonSensitivityExample {
    public static void main(String[] args) throws Exception {
        String outputFileName = "YOUR_OUTPUT_DIRECTORY/AdjustComparisonSensitivity_result.docx";

        try (OutputStream resultStream = new FileOutputStream(outputFileName);
             Comparer comparer = new Comparer("YOUR_DOCUMENT_DIRECTORY/source_word.docx")) {

            comparer.add("YOUR_DOCUMENT_DIRECTORY/target1_word.docx");

            // 감도를 100으로 설정하세요
            CompareOptions compareOptions = new CompareOptions.Builder()
                    .setSensitivityOfComparison(100)
                    .build();

            final Path resultPath = comparer.compare(resultStream, compareOptions);
        }
    }
}

설명

  • CompareOptions.Builder().setSensitivityOfComparison(100): 변화를 감지하기 위한 민감도 수준을 조절합니다.

기능 4: 스트림을 사용하여 변경 스타일 사용자 정의

개요: 삽입된 텍스트, 삭제된 텍스트, 변경된 텍스트를 구분하면 비교가 더욱 직관적입니다. 스트림을 사용하여 스타일을 사용자 지정하는 방법은 다음과 같습니다.

import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;
import com.groupdocs.comparison.options.save.SaveOptions;
import com.groupdocs.comparison.options.style.StyleSettings;

import java.awt.Color;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.InputStream;
import java.io.OutputStream;

public class CustomizeChangesStylesStreamExample {
    public static void main(String[] args) throws Exception {
        String outputFileName = "YOUR_OUTPUT_DIRECTORY/CustomizeChangesStylesStream_result.docx";

        try (InputStream sourceFile = new FileInputStream("YOUR_DOCUMENT_DIRECTORY/source_word.docx");
             InputStream targetFile = new FileInputStream("YOUR_DOCUMENT_DIRECTORY/target1_word.docx");
             OutputStream resultStream = new FileOutputStream(outputFileName);
             Comparer comparer = new Comparer(sourceFile)) {

            comparer.add(targetFile);

            // 변경 스타일 사용자 정의
            StyleSettings insertedStyle = new StyleSettings();
            insertedStyle.setHighlightColor(Color.GREEN); // 삽입을 위한 녹색
            StyleSettings deletedStyle = new StyleSettings();
            deletedStyle.setHighlightColor(Color.RED); // 삭제 시 빨간색
            StyleSettings changedStyle = new StyleSettings();
            changedStyle.setHighlightColor(Color.BLUE); // 변경 사항은 파란색으로 표시

            CompareOptions compareOptions = new CompareOptions.Builder()
                    .setInsertedItemStyle(insertedStyle)
                    .setDeletedItemStyle(deletedStyle)
                    .setChangedItemStyle(changedStyle)
                    .build();

            final Path resultPath = comparer.compare(resultStream, compareOptions);
        }
    }
}

설명

  • 사용자 정의 스타일 설정: 사용 StyleSettings 삽입(녹색), 삭제(빨간색), 변경(파란색)에 대한 강조 색상을 정의합니다.
  • CompareOptions.Builder(): 비교 과정에서 이러한 스타일을 적용하세요.

결론

Java용 GroupDocs.Comparison을 활용하면 정밀하게 문서 비교를 자동화할 수 있습니다. 이 튜토리얼에서는 머리글/바닥글 무시, 출력 용지 크기 설정, 감도 조정, 변경 스타일 사용자 지정 방법을 다루었습니다. 이러한 기능을 구현하면 Java 애플리케이션에서 워크플로우가 간소화되고 문서 분석이 향상됩니다.

자주 묻는 질문

1. GroupDocs for Java에서 비교하는 동안 머리글과 바닥글을 무시할 수 있나요?

네, 사용하세요 setHeaderFootersComparison(false) ~에 CompareOptions 비교에서 머리글과 바닥글을 제외합니다.

2. GroupDocs를 사용하여 Java에서 출력 용지 크기를 설정하려면 어떻게 해야 하나요?

적용하다 setPaperSize(PaperSize.A6) 또는 다른 크기 CompareOptions 최종 문서의 용지 크기를 사용자 정의합니다.

3. 비교 민감도를 미세하게 조정할 수 있나요?

네, 사용하세요 setSensitivityOfComparison() ~에 CompareOptions 민감도를 조절하여 사소하거나 큰 변화를 적절히 감지합니다.

4. 비교하는 동안 삽입, 삭제, 변경된 텍스트에 스타일을 적용할 수 있나요?

물론입니다. 스타일을 사용자 정의하세요. StyleSettings 다양한 변경 유형에 대해 적용합니다. CompareOptions.

5. Java에서 GroupDocs Comparison을 시작하기 위한 전제 조건은 무엇입니까?

JDK를 설치하고, Maven을 사용하여 종속성을 관리하고, 라이선스를 취득한 다음, 프로젝트에 GroupDocs.Comparison 라이브러리를 추가합니다.