java Volltextsuche – Dokumente hinzufügen & mit GroupDocs.Search zusammenführen

In modernen Unternehmensumgebungen ist java full text search das Rückgrat jedes robusten Dokumentenverwaltungssystems in Java. Egal, ob Sie Verträge, Rechnungen oder interne Berichte indexieren müssen, ein gut gestalteter Index ermöglicht es Ihnen, die richtigen Informationen in Millisekunden abzurufen. Dieses Tutorial führt Sie durch das Erstellen eines Index, das Hinzufügen von Dokumenten, das Konfigurieren von Merge-Optionen und das sichere Abbrechen eines Merge-Vorgangs – alles mit GroupDocs.Search für Java.

Schnelle Antworten

  • What does “add documents to index” mean? Es weist GroupDocs.Search an, einen Ordner zu scannen, durchsuchbare Token zu extrahieren und Metadaten für jede Datei zu speichern.
  • Can I stop a long merge? Ja—verwenden Sie das Cancellation‑Objekt, um einen Merge nach einer konfigurierbaren Zeitüberschreitung abzubrechen.
  • Do I need a license? Eine kostenlose Testversion oder temporäre Lizenz reicht für Tests; eine kommerzielle Lizenz schaltet alle Funktionen frei.
  • Which Java version is required? JDK 8 oder neuer.
  • Is this suitable for large datasets? Absolut—GroupDocs.Search kann mehrseitige Dokumente mit inkrementellem Indexieren verarbeiten.

Was bedeutet “add documents to index” in GroupDocs.Search?

Adding documents to an index means feeding a collection of files into GroupDocs.Search so the library can analyze their content, extract tokens, and build a searchable data structure. Der Prozess erstellt eine kompakte Darstellung, die blitzschnelle Volltextabfragen über alle indexierten Dateien ermöglicht.

Warum GroupDocs.Search für die Dokumentenverwaltung in Java verwenden?

GroupDocs.Search bietet skalierbares Indexieren für über 50 Eingabeformate (PDF, DOCX, XLSX, PPTX, HTML, Bilder usw.) und kann Dokumente bis zu 2 GB verarbeiten, ohne die gesamte Datei in den Speicher zu laden. Seine API gibt Ihnen feinkörnige Kontrolle über Indexierung, Zusammenführen und Abbruch, was es zu einer Spitzenwahl für Enterprise‑Java‑Full‑Text‑Search‑Lösungen macht.

Voraussetzungen

  • GroupDocs.Search for Java Version 25.4 oder neuer.
  • Maven (oder manueller JAR‑Download).
  • Grundkenntnisse in Java und eine JDK 8+ Umgebung.

Einrichtung von GroupDocs.Search für Java

Maven-Installation

Wenn Sie Abhängigkeiten mit Maven verwalten, fügen Sie das Repository und die Abhängigkeit zu Ihrer pom.xml hinzu:

<repositories>
    <repository>
        <id>repository.groupdocs.com</id>
        <name>GroupDocs Repository</name>
        <url>https://releases.groupdocs.com/search/java/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-search</artifactId>
        <version>25.4</version>
    </dependency>
</dependencies>

Direkter Download

Alternativ können Sie das neueste JAR von der offiziellen Seite herunterladen: GroupDocs.Search for Java releases.

Lizenzbeschaffung

  • Free Trial: Registrieren Sie sich auf der GroupDocs‑Website für eine Testlizenz.
  • Temporary License: Beantragen Sie einen temporären Schlüssel, wenn Sie eine erweiterte Evaluierung benötigen.
  • Commercial License: Kaufen Sie eine Lizenz für den Produktionseinsatz.

Nachdem Sie die Lizenzdatei erhalten haben, legen Sie sie in Ihrem Projekt ab und initialisieren die Bibliothek wie später gezeigt.

Implementierungs‑Leitfaden

Wie man Dokumente zum Index hinzufügt – Erstellen des ersten Index

Load or create an empty index by instantiating the Index class, which represents a searchable container on disk. Dieser Schritt bereitet einen Speicherort für alle Token vor, die aus Ihren Dokumenten generiert werden.

import com.groupdocs.search.Index;

// Create an instance of the index at the specified path
Index index1 = new Index("YOUR_DOCUMENT_DIRECTORY\\\\Index1");
  • Why: Dieser Schritt richtet einen Speichercontainer ein, in dem die indexierten Token gespeichert werden.

Dokumente zum Index hinzufügen

Call index.add with a folder path; the method scans each file, extracts text, and stores searchable metadata in the index. Der Vorgang läuft in einem Durchlauf und berücksichtigt die konfigurierten IndexSettings.

index1.add("YOUR_DOCUMENT_DIRECTORY"); // Add documents from this directory
  • Why: Die Bibliothek liest jede Datei, extrahiert Text und speichert ihn in index1.

Erstellen eines zweiten Index für flexible Workflows

Instantiate another Index object to hold a separate document set, enabling isolated processing before a merge. Dieses Muster ist nützlich für Multi‑Tenant‑Szenarien oder gestuftes Indexieren.

Index index2 = new Index("YOUR_DOCUMENT_DIRECTORY\\\\Index2");

index2.add("YOUR_DOCUMENT_DIRECTORY");
  • Why: Mehrere Indexe ermöglichen die Verwaltung unterschiedlicher Dokumentensätze und deren spätere Kombination.

Wie man Merge‑Optionen konfiguriert und den Merge‑Vorgang abbricht

Create a MergeOptions instance, set desired parameters, and attach a Cancellation token that aborts the merge after a specified timeout. Das gibt Ihnen volle Kontrolle über die Ressourcennutzung bei großen Merges.

import com.groupdocs.search.options.MergeOptions;
import com.groupdocs.search.options.Cancellation;

MergeOptions options = new MergeOptions();
options.setCancellation(new Cancellation()); // Initialize cancellation object
options.getCancellation().cancelAfter(5000); // Cancel merge operation after 5 seconds
  • Why: Cancellation gibt Ihnen die Kontrolle, den Merge‑Vorgang automatisch abzubrechen und verhindert unkontrollierte Aufgaben.

Zusammenführen der Indexe

Invoke index1.merge(index2, mergeOptions); the primary index absorbs all documents from the secondary index while preserving token integrity. Nach dem Zusammenführen haben Sie ein einheitliches durchsuchbares Repository.

index1.merge(index2, options);
  • Why: Nach diesem Aufruf enthält index1 alle Dokumente beider Quellen und bietet Ihnen ein einheitliches Sucherlebnis.

Praktische Anwendungsfälle für die Dokumentenverwaltung in Java

  • Legal firms: Konsolidieren Sie Akten aus mehreren Niederlassungen zu einem einzigen durchsuchbaren Index.
  • Financial institutions: Führen Sie Quartalsberichte in ein einheitliches Repository zusammen für schnelle Prüfungsabfragen.
  • Enterprises: Kombinieren Sie HR‑Richtlinien, Compliance‑Handbücher und interne Leitfäden für eine unternehmensweite Suche.

Leistungsüberlegungen

  • Incremental indexing: Fügen Sie regelmäßig neue Dateien hinzu, anstatt den gesamten Index neu zu erstellen.
  • Memory monitoring: Große Stapel können RAM verbrauchen; verarbeiten Sie Dateien in kleineren Teilen oder aktivieren Sie den Streaming‑Modus.
  • Garbage collection: Geben Sie ungenutzte Index‑Objekte sofort frei, um Ressourcen zu sparen.
  • SSD storage: Das Speichern von Indexdateien auf SSDs kann die Merge‑Geschwindigkeit um bis zu das Doppelte steigern.

Häufige Probleme & Lösungen

IssueSolution
Falscher OrdnerpfadÜberprüfen Sie den absoluten Pfad und stellen Sie sicher, dass die Anwendung Leseberechtigungen hat.
Unzureichender SpeicherErhöhen Sie den JVM‑Heap (-Xmx) oder indexieren Sie Dateien in Batches.
Abbruch nicht ausgelöstStellen Sie sicher, dass cancelAfter vor dem Aufruf von merge gesetzt ist.
Nicht unterstütztes DateiformatInstallieren Sie bei Bedarf zusätzliche Format‑Plugins von GroupDocs.

Häufig gestellte Fragen

Q: Warum sollte ich mehrere Indexe anstelle eines einzigen erstellen?
A: Separate Indexe ermöglichen es, Datenbereiche zu isolieren, unterschiedliche Sicherheitsrichtlinien anzuwenden und nur bei Bedarf zusammenzuführen, was die Leistung und Organisation verbessert.

Q: Kann ich einen Indexierungsvorgang auf dieselbe Weise abbrechen wie einen Merge?
A: Ja—verwenden Sie das Cancellation‑Objekt mit der add‑Methode, um langlaufende Indexierungsaufgaben zu stoppen.

Q: Wie stelle ich optimale Leistung bei sehr großen Dokumentensammlungen sicher?
A: Führen Sie inkrementelles Indexieren durch, überwachen Sie den JVM‑Speicher und speichern Sie den Index auf SSDs. Erwägen Sie die Verwendung der Einstellung BatchSize, um die Anzahl der im Speicher befindlichen Dokumente zu begrenzen.

Q: Was soll ich tun, wenn ich “Access denied”-Fehler erhalte?
A: Überprüfen Sie die Ordnerberechtigungen für den Benutzer, der den Java‑Prozess ausführt, und stellen Sie sicher, dass die Lizenzdatei lesbar ist.

Q: Ist GroupDocs.Search mit anderen GroupDocs‑Bibliotheken kompatibel?
A: Absolut—Sie können es mit GroupDocs.Viewer, GroupDocs.Conversion und weiteren integrieren, um eine Full‑Stack‑Dokumentlösung zu erstellen.

Fazit

Durch die Befolgung dieses Leitfadens wissen Sie jetzt, wie Sie add documents to index ausführen, das Merge‑Verhalten konfigurieren und bei Bedarf sicher cancel merge operation abbrechen—alles innerhalb eines robusten java full text search‑Workflows. Experimentieren Sie mit größeren Datensätzen, erkunden Sie benutzerdefinierte Tokenizer oder kombinieren Sie GroupDocs.Search mit anderen GroupDocs‑Produkten, um eine Enterprise‑Lösung zu erstellen.

Resources

Zuletzt aktualisiert: 2026-05-12
Getestet mit: GroupDocs.Search 25.4 for Java
Autor: GroupDocs

Verwandte Tutorials