Documentvergelijking in Java onder de knie krijgen met de GroupDocs.Comparison API

Invoering

Bent u het beu om documenten handmatig te vergelijken? Of het nu gaat om het identificeren van wijzigingen in kopteksten, voetteksten of inhoud, documentvergelijking kan een lastige klus zijn. De GroupDocs.Comparison voor Java-bibliotheek automatiseert en verbetert dit proces met precisie en gemak.

Deze uitgebreide tutorial begeleidt je bij het gebruik van GroupDocs.Comparison in Java om documentvergelijkingsstijlen aan te passen, gevoeligheidsinstellingen aan te passen, kop./voettekstvergelijkingen te negeren, het papierformaat voor de uitvoer in te stellen en meer. Aan het einde van deze handleiding kun je je workflow efficiënt stroomlijnen.

Wat je leert:

  • Kop- en voetteksten negeren tijdens documentvergelijkingen.
  • Pas wijzigingen aan met stijlaanpassingen.
  • Pas de vergelijkingsgevoeligheid aan voor een gedetailleerde analyse.
  • Stel uitvoerpapierformaten in Java-toepassingen in.
  • Implementeer deze functies in realistische scenario’s.

Zorg ervoor dat u over de nodige vereisten beschikt voordat u met de praktische aspecten begint.

Vereisten

Om aan de slag te gaan met GroupDocs.Comparison voor Java, moet u het volgende hebben:

  1. Java-ontwikkelingskit (JDK): Zorg ervoor dat de JDK op uw computer is geïnstalleerd. Elke versie hoger dan 8 zou voldoende moeten zijn.
  2. Kenner: In deze zelfstudie gaan we ervan uit dat u Maven gebruikt om projectafhankelijkheden te beheren.
  3. GroupDocs.Comparison-bibliotheek:
    • Voeg de volgende afhankelijkheid toe aan uw 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. Licentie: Ontvang een gratis proefversie, tijdelijke licentie of koop de volledige versie bij GroupDocs.

Nadat u deze instellingen hebt geconfigureerd, kunt u beginnen met het implementeren van functies voor documentvergelijking in uw Java-toepassingen.

GroupDocs.Comparison instellen voor Java

Zorg ervoor dat onze omgeving correct is geconfigureerd:

Installatie via Maven

Voeg het bovenstaande XML-fragment toe aan uw project pom.xmlDeze stap zorgt ervoor dat de benodigde repository en afhankelijkheid door Maven worden herkend.

Licentieverwerving

Nadat u uw licentiebestand hebt verkregen en ingesteld volgens de GroupDocs-documentatie, initialiseert u GroupDocs.Comparison als volgt:

// Basisinitialisatievoorbeeld
com.groupdocs.comparison.License license = new com.groupdocs.comparison.License();
license.setLicense("path/to/your/license/file.lic");

Implementatiegids

Functie 1: Koptekst./voettekstvergelijking negeren

Overzicht: Kopteksten en voetteksten bevatten vaak informatie zoals paginanummers of documenttitels, die mogelijk niet relevant zijn voor vergelijkingen van inhoudswijzigingen.

Opties instellen

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");

            // Stel vergelijkingsopties in om kopteksten en voetteksten te negeren
            CompareOptions compareOptions = new CompareOptions.Builder()
                    .setHeaderFootersComparison(false)
                    .build();

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

Uitleg

  • CompareOptions.Builder().setHeaderFootersComparison(false): Met deze instelling slaat de bibliotheek kop- en voettekstvergelijkingen over.
  • try-with-resources: Zorgt ervoor dat alle stromen na gebruik goed worden afgesloten.

Functie 2: Stel het formaat van het uitvoerpapier in

Overzicht: Het aanpassen van het papierformaat is cruciaal voor het maken van printvriendelijke documenten. Hier leest u hoe u dit kunt aanpassen tijdens het vergelijken van documenten.

Implementatiestappen

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");

            // Stel het papierformaat in op A6
            CompareOptions compareOptions = new CompareOptions.Builder()
                    .setPaperSize(PaperSize.A6)
                    .build();

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

Uitleg

  • CompareOptions.Builder().setPaperSize(PaperSize.A6): Hiermee stelt u het uitvoerpapierformaat in op A6.

Functie 3: Vergelijkingsgevoeligheid aanpassen

Overzicht: Door de vergelijkingsgevoeligheid nauwkeurig af te stellen, kunt u zelfs kleine veranderingen identificeren. Zo kunt u dit aanpassen:

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");

            // Stel de gevoeligheid in op 100
            CompareOptions compareOptions = new CompareOptions.Builder()
                    .setSensitivityOfComparison(100)
                    .build();

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

Uitleg

  • CompareOptions.Builder().setSensitivityOfComparison(100): Past het gevoeligheidsniveau voor het detecteren van wijzigingen aan.

Functie 4: Wijzigingsstijlen aanpassen (met behulp van streams)

Overzicht: Door onderscheid te maken tussen ingevoegde, verwijderde en gewijzigde tekst, worden vergelijkingen intuïtiever. Zo past u stijlen aan met behulp van streams:

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);

            // Wijzigingsstijlen aanpassen
            StyleSettings insertedStyle = new StyleSettings();
            insertedStyle.setHighlightColor(Color.GREEN); // Groen voor invoegingen
            StyleSettings deletedStyle = new StyleSettings();
            deletedStyle.setHighlightColor(Color.RED); // Rood voor verwijderingen
            StyleSettings changedStyle = new StyleSettings();
            changedStyle.setHighlightColor(Color.BLUE); // Blauw voor veranderingen

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

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

Uitleg

  • Aangepaste stijlinstellingen: Gebruik StyleSettings om markeringskleuren te definiëren voor invoegingen (groen), verwijderingen (rood) en wijzigingen (blauw).
  • CompareOptions.Builder(): Pas deze stijlen toe tijdens het vergelijkingsproces.

Conclusie

Met GroupDocs.Comparison voor Java kunt u documentvergelijking nauwkeurig automatiseren. In deze tutorial leert u hoe u kop- en voetteksten kunt negeren, papierformaten kunt instellen, de gevoeligheid kunt aanpassen en wijzigingsstijlen kunt aanpassen. De implementatie van deze functies stroomlijnt uw workflow en verbetert de documentanalyse in Java-applicaties.

Veelgestelde vragen

1. Kan ik kop- en voetteksten negeren tijdens de vergelijking in GroupDocs voor Java?

Ja, gebruik setHeaderFootersComparison(false) in CompareOptions om kop- en voetteksten uit de vergelijking uit te sluiten.

2. Hoe stel ik het papierformaat voor de uitvoer in Java in met behulp van GroupDocs?

Toepassen setPaperSize(PaperSize.A6) of andere maten in CompareOptions om het papierformaat van het uiteindelijke document aan te passen.

3. Is het mogelijk om de vergelijkingsgevoeligheid nauwkeurig af te stellen?

Ja, gebruik setSensitivityOfComparison() in CompareOptions om de gevoeligheid aan te passen en zo kleine of grote veranderingen te detecteren.

4. Kan ik ingevoegde, verwijderde en gewijzigde tekst opmaken tijdens de vergelijking?

Absoluut, pas stijlen aan via StyleSettings voor verschillende soorten wijzigingen en pas ze toe in CompareOptions.

5. Wat zijn de vereisten om aan de slag te gaan met GroupDocs Comparison in Java?

Installeer JDK, beheer afhankelijkheden met Maven, schaf een licentie aan en voeg de GroupDocs.Comparison-bibliotheek toe aan uw project.