Full text search java – ovládání GroupDocs.Search Java – vytvoření a správa vyhledávacího indexu

V dnešních datově řízených aplikacích je provozování efektivního full text search java nad velkými kolekcemi dokumentů nezbytnou schopností. Ať už budujete interní dokumentový portál, e‑commerce katalog nebo obsahově náročný CMS, dobře strukturovaný vyhledávací index umožňuje rychlé a přesné výsledky. Tento tutoriál vás provede nastavením GroupDocs.Search pro Java, vytvořením vyhledávatelného indexu, adding documents to index a provedením full text search java dotazu – vše vysvětleno přátelským, krok‑za‑krokem stylem.

Rychlé odpovědi

  • Co znamená “full text search java”? Spuštění textového vyhledávání proti indexu vytvořenému pomocí GroupDocs.Search v Java aplikaci.
  • Která knihovna zajišťuje indexování? GroupDocs.Search for Java (nejnovější stabilní verze).
  • Potřebuji licenci k vyzkoušení? Je k dispozici bezplatná zkušební verze; pro produkci je vyžadována dočasná nebo plná licence.
  • Mohu indexovat celý adresář najednou? Ano – použijte index.add("folderPath") k add folder to index v jednom volání.
  • Je vyhledávání necitlivé na velikost písmen? Ve výchozím nastavení provádí GroupDocs.Search necitlivé full‑textové vyhledávání.

Co je full text search java?

Operace full text search java vám umožní najít dokumenty, které obsahují konkrétní textový vzor. Předáte řetězec dotazu metodě search() objektu GroupDocs.Search Index a knihovna dotaz analyzuje, prohledá indexované termíny a okamžitě vrátí odpovídající dokumenty. To umožňuje rychlé získání relevantního obsahu napříč tisíci soubory bez ručního procházení.

Proč používat GroupDocs.Search pro Java?

GroupDocs.Search for Java poskytuje vysoce výkonné, připravené řešení pro indexování a vyhledávání. Dokáže indexovat 30+ formátů dokumentů – včetně PDF, DOCX, XLSX, PPTX, TXT, HTML a mnoha typů obrázků – a zpracovává soubory s několika stovkami stránek, aniž by načítala celý soubor do paměti. Vestavěné algoritmy poskytují millisecond‑level odezvu i při indexu obsahujícím miliony dokumentů, což jej činí vhodným jak pro malé utility, tak pro rozsáhlé podnikově nasazení.

Požadavky

Než se pustíme dál, ujistěte se, že máte:

  1. Java Development Kit (JDK) 8+ – runtime pro kompilaci a spouštění kódu.
  2. Maven – pro správu závislostí (můžete také použít Gradle, ale příklady jsou pro Maven).
  3. Základní znalost Java tříd, metod a příkazové řádky.

Nastavení GroupDocs.Search pro Java

Nastavení Maven

Přidejte repozitář GroupDocs a závislost do vašeho pom.xml. Toto je jediná změna, kterou musíte provést v konfiguraci projektu.

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

Přímé stažení (volitelné)

Pokud raději nepoužíváte Maven, stáhněte si nejnovější JAR z oficiální stránky vydání: GroupDocs.Search for Java releases.

Získání licence

  • Free trial: Ideální pro vyhodnocení funkcí.
  • Temporary license: Použijte pro rozšířené testování bez závazku.
  • Full license: Doporučeno pro produkční nasazení.

Základní inicializace

Níže uvedený úryvek vytvoří prázdný adresář indexu. Je to základ pro každý full text search java, který budete později spouštět.

Index je hlavní třída představující vyhledávatelný index uložený na disku.

import com.groupdocs.search.Index;

public class GroupDocsSearchSetup {
    public static void main(String[] args) {
        String indexFolder = "YOUR_OUTPUT_DIRECTORY/HelloWorld";
        Index index = new Index(indexFolder);
        System.out.println("Index created at: " + indexFolder);
    }
}

Jak vytvořit vyhledávací index

Přímá odpověď

Vytvořte instanci Index, která ukazuje na složku na disku, a poté zavolejte index.add() pro načtení souborů. Tento jediný krok vytvoří vyhledávatelnou strukturu, která pohání všechny následné full‑textové dotazy. Inicializací indexu jednou a hromadným přidáváním dokumentů zajistíte optimální výkon a vyhnete se opakovanému re‑indexování.

Index je centrální třída, která spravuje vyhledávatelnou datovou strukturu.

import com.groupdocs.search.Index;

public class CreateIndexExample {
    public static void main(String[] args) {
        // Define the path for the output index directory
        String indexFolder = "YOUR_OUTPUT_DIRECTORY/HelloWorld";
        
        // Creating an index in the specified folder.
        Index index = new Index(indexFolder);
        System.out.println("Index created at: " + indexFolder);
    }
}

Přidání složky do indexu

Nyní, když index existuje, musíte add documents to index, aby se staly vyhledávatelnými. GroupDocs.Search dokáže načíst celý adresář jedním voláním.

Metoda add rekurzivně prohledá zadaný adresář, extrahuje text z každého podporovaného souboru a uloží termíny do indexu.

import com.groupdocs.search.Index;

public class AddDocumentsToIndexExample {
    public static void main(String[] args) {
        // Define the path for the output index directory and documents folder
        String indexFolder = "YOUR_OUTPUT_DIRECTORY/HelloWorld";
        String documentsFolder = "YOUR_DOCUMENT_DIRECTORY";
        
        // Create an index in the specified folder.
        Index index = new Index(indexFolder);
        
        // Adding documents from the specified folder to the index.
        index.add(documentsFolder);
        System.out.println("Documents added to index.");
    }
}

Provádění full text search java

S vašimi dokumenty indexovanými je provedení full text search java jednoduché.

Metoda search přijímá řetězec dotazu, zpracuje jej pomocí nakonfigurovaného analyzátoru a vrátí SearchResult obsahující odpovídající dokumenty.

import com.groupdocs.search.Index;
import com.groupdocs.search.results.SearchResult;

public class SearchIndexExample {
    public static void main(String[] args) {
        // Define the path for the output index directory
        String indexFolder = "YOUR_OUTPUT_DIRECTORY/HelloWorld";
        
        // Create an index in the specified folder.
        Index index = new Index(indexFolder);
        
        // Performing a search query on the indexed documents.
        SearchResult result = index.search("Lorem");
        
        System.out.println("Search completed. Number of results: " + result.getDocumentCount());
    }
}

Praktické aplikace

GroupDocs.Search for Java vyniká v mnoha reálných scénářích:

  1. Interní systémy správy dokumentů – okamžité získání politik, smluv a manuálů.
  2. E‑commerce platformy – rychlé vyhledávání produktů v katalozích s tisíci položkami.
  3. Content management systems (CMS) – umožňuje editorům i návštěvníkům rychle najít články, média a PDF soubory.

Úvahy o výkonu

Aby vaše full text search java zůstala bleskově rychlá:

  • Optimize indexing: Re‑indexujte pouze změněné soubory a pravidelně odstraňujte zastaralé položky.
  • Manage resources: Sledujte využití haldy JVM; zvažte inkrementální indexování pro masivní datové sady.
  • Follow best practices: Používejte dávkové volání add() místo přidávání souborů po jednom, pokud je to možné.

Časté problémy a řešení

SymptomLikely causeFix
No results returnedIndex not built or documents not addedVerify index.add() executed successfully; check folder path.
Out‑of‑memory errorsVery large files loaded all at onceEnable incremental indexing or increase JVM heap (-Xmx).
Search misses termsAnalyzer not configured for languageUse appropriate IndexSettings to set language‑specific analyzers.

Často kladené otázky

Q: Jaké formáty souborů může GroupDocs.Search indexovat?
A: PDF, DOC/DOCX, XLS/XLSX, PPT/PPTX, TXT, HTML a mnoho dalších běžných kancelářských formátů – celkem 30+ podporovaných typů.

Q: Mohu spustit full text search java na vzdáleném serveru?
A: Ano. Vytvořte index na serveru a vystavte REST endpoint, který předá dotaz Java službě.

Q: Jak aktualizuji index, když se dokument změní?
A: Použijte index.update("path/to/changed/file") k nahrazení starého záznamu bez nutnosti přestavovat celý index.

Q: Existuje způsob, jak omezit výsledky vyhledávání na konkrétní složku?
A: Po získání SearchResult filtrujte result.getDocuments() podle jejich původní cesty.

Q: Podporuje GroupDocs.Search fuzzy nebo wildcard vyhledávání?
A: Knihovna obsahuje vestavěnou podporu pro fuzzy shodu (~) a wildcard (*) operátory v dotazových řetězcích.

Q: Jak mohu zlepšit relevance výsledků pro můj full text search java?
A: Upravit IndexSettings, například vážení termínů, zvýraznění konkrétních polí nebo povolení synonym pro jemné doladění relevance.

Q: Je možné mazat dokumenty z indexu?
A: Ano. Zavolejte index.delete("path/to/file") k odstranění záznamu dokumentu.

Q: Co konkrétně dělá “add folder to index” pod kapotou?
A: GroupDocs.Search rekurzivně prohledá složku, extrahuje text z každého podporovaného souboru, tokenizuje termíny a uloží je do indexové struktury pro rychlé vyhledávání.


Last updated: 2026-10-17
Tested with: GroupDocs.Search 25.4 for Java
Author: GroupDocs

Související tutoriály