java full-text zoeken – documenten toevoegen & samenvoegen met GroupDocs.Search

Snelle antwoorden

  • Wat betekent “add documents to index”? Het vertelt GroupDocs.Search om een map te scannen, doorzoekbare tokens te extraheren en metadata voor elk bestand op te slaan.
  • Kan ik een lange samenvoeging stoppen? Ja—gebruik het Cancellation‑object om een samenvoeging af te breken na een configureerbare time‑out.
  • Heb ik een licentie nodig? Een gratis proefversie of tijdelijke licentie werkt voor testen; een commerciële licentie ontgrendelt alle functies.
  • Welke Java‑versie is vereist? JDK 8 of nieuwer.
  • Is dit geschikt voor grote datasets? Absoluut—GroupDocs.Search kan documenten van honderden pagina’s aan met incrementeel indexeren.

Wat betekent “add documents to index” in GroupDocs.Search?

Documenten toevoegen aan een index betekent een verzameling bestanden aan GroupDocs.Search leveren zodat de bibliotheek hun inhoud kan analyseren, tokens kan extraheren en een doorzoekbare datastructuur kan bouwen. Het proces creëert een compacte representatie die bliksemsnelle full‑text zoekopdrachten over alle geïndexeerde bestanden mogelijk maakt.

Waarom GroupDocs.Search gebruiken voor documentbeheer in java?

GroupDocs.Search levert schaalbare indexering voor meer dan 50 invoerformaten (PDF, DOCX, XLSX, PPTX, HTML, afbeeldingen, enz.) en kan documenten tot 2 GB verwerken zonder het volledige bestand in het geheugen te laden. De API geeft je fijnmazige controle over indexeren, samenvoegen en annuleren, waardoor het een topkeuze is voor enterprise‑grade java full text search‑oplossingen.

Voorvereisten

  • GroupDocs.Search for Java versie 25.4 of later.
  • Maven (of handmatige JAR‑download).
  • Basiskennis van Java en een JDK 8+ omgeving.

GroupDocs.Search voor Java instellen

Maven‑installatie

Als je afhankelijkheden beheert met Maven, voeg dan de repository en afhankelijkheid toe aan je pom.xml:

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

Directe download

Download anders de nieuwste JAR van de officiële site: GroupDocs.Search for Java releases.

Licentie‑acquisitie

  • Gratis proefversie: Meld je aan op de GroupDocs‑website voor een proeflicentie.
  • Tijdelijke licentie: Vraag een tijdelijke sleutel aan als je een verlengde evaluatie nodig hebt.
  • Commerciële licentie: Aanschaffen voor productiegebruik.

Nadat je het licentiebestand hebt, plaats je het in je project en initialiseert je de bibliotheek zoals later getoond.

Implementatie‑gids

Hoe documenten toe te voegen aan index – De eerste index maken

Laad of maak een lege index door een instantie van de Index‑klasse te maken, die een doorzoekbare container op schijf vertegenwoordigt. Deze stap bereidt een opslaglocatie voor alle tokens die uit je documenten worden gegenereerd.

import com.groupdocs.search.Index;

// Create an instance of the index at the specified path
Index index1 = new Index("YOUR_DOCUMENT_DIRECTORY\\\\Index1");
  • Waarom: Deze stap zet een opslagcontainer op waar de geïndexeerde tokens worden opgeslagen.

Documenten toevoegen aan de index

Roep index.add aan met een mappad; de methode scant elk bestand, extraheert tekst en slaat doorzoekbare metadata op in de index. De operatie wordt in één enkele doorgang uitgevoerd en houdt rekening met de geconfigureerde IndexSettings.

index1.add("YOUR_DOCUMENT_DIRECTORY"); // Add documents from this directory
  • Waarom: De bibliotheek leest elk bestand, extraheert tekst en slaat het op in index1.

Een tweede index maken voor flexibele workflows

Instantieer een ander Index‑object om een aparte documentenset te bevatten, waardoor geïsoleerde verwerking vóór een samenvoeging mogelijk is. Dit patroon is nuttig voor multi‑tenant scenario’s of gefaseerde indexering.

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

index2.add("YOUR_DOCUMENT_DIRECTORY");
  • Waarom: Meerdere indexen laten je verschillende documentensets beheren en later combineren.

Hoe merge‑opties te configureren en merge‑operatie te annuleren

Maak een MergeOptions‑instantie, stel de gewenste parameters in en koppel een Cancellation‑token dat de samenvoeging afbreekt na een opgegeven time‑out. Dit geeft je volledige controle over het resourcegebruik tijdens grote samenvoegingen.

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
  • Waarom: Cancellation geeft je controle om de merge‑operatie automatisch te annuleren, waardoor uit de hand lopende taken worden voorkomen.

De indexen samenvoegen

Roep index1.merge(index2, mergeOptions) aan; de primaire index absorbeert alle documenten van de secundaire index terwijl de tokenintegriteit behouden blijft. Na het samenvoegen heb je een eenduidige doorzoekbare repository.

index1.merge(index2, options);
  • Waarom: Na deze oproep bevat index1 alle documenten van beide bronnen, waardoor je een eenduidige zoekervaring krijgt.

Praktische toepassingen voor Document Management Java

  • Advocatenkantoren: Consolidatie van dossiers uit meerdere kantoren in één doorzoekbare index.
  • Financiële instellingen: Samengevoegde kwartaalrapporten in een eenduidige repository voor snelle audit‑query’s.
  • Ondernemingen: Combineer HR‑beleid, compliance‑handleidingen en interne gidsen voor organisatiebrede zoekopdrachten.

Prestatie‑overwegingen

  • Incrementele indexering: Voeg periodiek nieuwe bestanden toe in plaats van de volledige index opnieuw op te bouwen.
  • Geheugenmonitoring: Grote batches kunnen RAM verbruiken; verwerk bestanden in kleinere delen of schakel streaming‑modus in.
  • Garbage collection: Maak ongebruikte Index‑objecten snel vrij om resources vrij te maken.
  • SSD‑opslag: Het opslaan van indexbestanden op SSD’s kan de samenvoegsnelheid tot 2× verbeteren.

Veelvoorkomende problemen & oplossingen

ProbleemOplossing
Onjuist mappadControleer het absolute pad en zorg ervoor dat de applicatie leesrechten heeft.
Onvoldoende geheugenVerhoog de JVM‑heap (-Xmx) of indexeer bestanden in batches.
Annulering niet geactiveerdZorg ervoor dat cancelAfter is ingesteld vóór het aanroepen van merge.
Niet‑ondersteund bestandsformaatInstalleer extra formaat‑plugins van GroupDocs indien nodig.

Veelgestelde vragen

V: Waarom zou ik meerdere indexen maken in plaats van één?
A: Gescheiden indexen laten je datadomeinen isoleren, verschillende beveiligingsbeleid toepassen en alleen samenvoegen wanneer nodig, wat de prestaties en organisatie verbetert.

V: Kan ik een indexeer‑operatie op dezelfde manier annuleren als een merge?
A: Ja—gebruik het Cancellation‑object met de add‑methode om langdurige indexeringstaken te stoppen.

V: Hoe zorg ik voor optimale prestaties met zeer grote documentcollecties?
A: Voer incrementele indexering uit, monitor JVM‑geheugen en sla de index op SSD’s op. Overweeg de BatchSize‑instelling te gebruiken om in‑memory documenten te beperken.

V: Wat moet ik doen als ik “Access denied”‑fouten krijg?
A: Controleer de maprechten voor de gebruiker die het Java‑proces uitvoert en zorg ervoor dat het licentiebestand leesbaar is.

V: Is GroupDocs.Search compatibel met andere GroupDocs‑bibliotheken?
A: Absoluut—je kunt het integreren met GroupDocs.Viewer, GroupDocs.Conversion en meer om een full‑stack documentoplossing te bouwen.

Conclusie

Door deze gids te volgen weet je nu hoe je documenten toevoegt aan een index, merge‑gedrag configureert en veilig merge‑operatie annuleert wanneer nodig—alles binnen een robuuste java full text search‑workflow. Experimenteer met grotere datasets, verken aangepaste tokenizers, of combineer GroupDocs.Search met andere GroupDocs‑producten om een enterprise‑grade oplossing te bouwen.

Bronnen

Laatst bijgewerkt: 2026-05-12
Getest met: GroupDocs.Search 25.4 for Java
Auteur: GroupDocs

Gerelateerde tutorials