Java full text search: vytvořte index pomocí GroupDocs.Search

V moderních aplikacích řízených daty je java full text search motor, který vám umožní okamžitě najít informace napříč tisíci soubory. Tento tutoriál vás provede každým krokem – od přidání závislosti GroupDocs.Search po jemné ladění abecedního slovníku – abyste mohli poskytovat rychlé a přesné výsledky vyhledávání v jakémkoli Java projektu.

Rychlé odpovědi

  • Co je “java full text search”? Je to proces vytváření indexu, který umožňuje rychlé textové dotazy napříč mnoha soubory v Java aplikaci.
  • Která knihovna to poskytuje bez nutnosti další konfigurace? GroupDocs.Search for Java poskytuje připravené indexování, správu slovníku a provádění dotazů.
  • Potřebuji licenci? Bezplatná zkušební verze je ideální pro hodnocení; pro nasazení do produkce je vyžadována plná licence.
  • Mohu přizpůsobit zpracování znaků? Rozhodně – použijte abecední slovník k definování vlastních typů znaků.
  • Je Maven povinný? Maven usnadňuje správu závislostí, ale můžete také stáhnout JAR přímo.

Co je java full text search a proč spravovat abecední slovník?

Index java full text search ukládá tokenizované reprezentace vašich dokumentů, což umožňuje okamžité vyhledávání slov nebo frází. Abecední slovník říká motoru, jak zacházet s každým znakem (písmeno, číslice, symbol), což přímo ovlivňuje tokenizaci a relevanci vyhledávání – zejména pro speciální symboly nebo jazykově specifická pravidla.

GroupDocs.Search zpracuje až 10 000 dokumentů bez nutnosti načítání celých souborů do paměti, což poskytuje dotazy v podsekundovém čase. Nabízí plnou kontrolu nad typy znaků, podporuje více než 50 vstupních a výstupních formátů a horizontálně škáluje napříč více servery, což z něj činí nejrobustnější volbu pro podnikové vyhledávání.

Předpoklady

  • GroupDocs.Search for Java (nejnovější verze).
  • Java 17 nebo vyšší nainstalovaný na vašem vývojovém počítači.
  • Maven 3.6+ (nebo možnost přidat JAR ručně).

Požadované knihovny, verze a závislosti

  • GroupDocs.Search for Java – nejnovější stabilní verze.
  • Žádné další knihovny třetích stran nejsou vyžadovány pro základní indexování.

Požadavky na nastavení prostředí

Ujistěte se, že máte prostředí kompatibilní s Mavenem. Pokud Maven ještě není nainstalován, stáhněte jej z oficiální stránky: Apache Maven.

Předpoklady znalostí

Znalost syntaxe Javy a práce se soubory vám pomůže, ale níže uvedený krok‑za‑krokem průvodce pokrývá vše, co potřebujete.

Nastavení GroupDocs.Search pro Java

Maven konfigurace

Add the repository and dependency to your pom.xml file:

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

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

Kroky získání licence

  1. Free trial – Začněte s trial verzí a prozkoumejte všechny funkce.
  2. Temporary license – Požádejte o dočasný klíč pro rozšířené testování.
  3. Full license – Zakupte si produkční licenci pro neomezené používání.

Základní inicializace a nastavení

Create an Index instance that points to the folder where the search index will be stored:

import com.groupdocs.search.*;

public class SearchIndexSetup {
    public static void main(String[] args) {
        String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\Index";
        Index index = new Index(indexFolder);
    }
}

Průvodce implementací

Níže je kompletní průvodce nejčastějšími operacemi, které provedete při vytváření řešení java full text search.

Vytvoření nebo otevření indexu

The Index class is the core object that represents a searchable collection stored on disk.

import com.groupdocs.search.*;

String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\Index";
Index index = new Index(indexFolder);
  • Parameters: indexFolder – cesta, kde jsou uloženy soubory indexu.
  • Purpose: Nastavuje vyhledávací prostředí pro následné indexování a dotazování.

Export abecedního slovníku do souboru

The AlphabetDictionary object holds character‑type mappings. Exporting it lets you reuse or analyse the configuration later.

import com.groupdocs.search.dictionaries.*;

String fileName = "YOUR_OUTPUT_DIRECTORY\\Alphabet.dat";
index.getDictionaries().getAlphabet().exportDictionary(fileName);
  • Parameters: fileName – cílový soubor pro exportovaný slovník.

Vymazání abecedního slovníku

Reset the dictionary to its default state before applying custom rules:

import com.groupdocs.search.dictionaries.*;

if (index.getDictionaries().getAlphabet().getCount() > 0) {
    index.getDictionaries().getAlphabet().clear();
}
  • Purpose: Odstraňuje všechny dříve definované typy znaků a zajišťuje čistý stav.

Import abecedního slovníku ze souboru

Restore a previously saved dictionary configuration:

import com.groupdocs.search.dictionaries.*;

index.getDictionaries().getAlphabet().importDictionary(fileName);
  • Parameters: fileName – cesta k souboru .dat obsahujícímu slovník.

Nastavení typu znaku v abecedním slovníku

The CharacterType enum specifies how characters are interpreted during tokenization. Customize how specific characters are treated during tokenization. The CharacterType.Blended value tells the engine to treat the hyphen as part of a word rather than a separator.

import com.groupdocs.search.dictionaries.*;

if (index.getDictionaries().getAlphabet().getCharacterType('-') != CharacterType.Blended) {
    index.getDictionaries().getAlphabet().setRange(new char[] { '-' }, CharacterType.Blended);
}
  • Parameters: Znak ('-') a jeho nový CharacterType.
  • Why it matters: Úprava typů znaků zlepšuje relevanci vyhledávání pro hyphenované výrazy, ID nebo vlastní symboly.

Indexování dokumentů ze složky

Add all files in a directory to the search index in one operation:

import com.groupdocs.search.*;

String documentsFolder = "YOUR_DOCUMENT_DIRECTORY";
index.add(documentsFolder);
  • Parameters: documentsFolder – složka obsahující dokumenty, které chcete indexovat.

Vyhledávání v indexu

The SearchResult class contains the list of matched documents and snippets returned by a query. Execute a query and retrieve matching results:

import com.groupdocs.search.results.*;

String query = "Elliot-Murray-Kynynmound";
SearchResult result = index.search(query);
  • Parameters: query – text, který hledáte.
  • Result: Objekt SearchResult obsahující nalezené dokumenty a úryvky.
  • Content management systems (CMS): Zrychlete získávání článků a aktiv.
  • Legal document repositories: Okamžitě najděte klauzule nebo odkazy na případy.
  • Research libraries: Indexujte tisíce prací pro okamžité vyhledávání klíčových slov.
  • E‑commerce catalogs: Vylepšete vyhledávání produktů pomocí vlastní tokenizace.
  • Customer support portals: Umožněte agentům rychle najít relevantní tikety nebo články z databáze znalostí.

Úvahy o výkonu

  • Incremental updates: Re‑indexujte pouze nové nebo změněné soubory, aby byl index aktuální bez úplného přestavování.
  • Query optimization: Udržujte dotazy stručné; vyhněte se příliš širokým vyhledáváním pomocí zástupných znaků.
  • Resource monitoring: Sledujte využití paměti během velkého dávkového indexování – upravte velikost haldy JVM podle potřeby.
  • Dictionary size: Exportujte/importujte abecední slovník pouze při jeho úpravě; zbytečné I/O může zpomalit start.

Často kladené otázky

Q: Jaké jsou předpoklady pro používání GroupDocs.Search?
A: Nainstalujte Java 17+, Maven 3.6+ (nebo stáhněte JAR) a přidejte závislost GroupDocs.Search.

Q: Jak získám licenci pro produkční použití?
A: Začněte s bezplatnou zkušební verzí, požádejte o dočasný klíč pro rozšířené testování a poté zakupte plnou licenci na portálu GroupDocs.

Q: Mohu přizpůsobit typy znaků v abecedním slovníku?
A: Ano – použijte metody setRange nebo set k přiřazení vlastních hodnot CharacterType libovolnému znaku nebo rozsahu.

Q: Je možné exportovat a importovat abecední slovník?
A: Rozhodně – použijte metody exportDictionary a importDictionary k uložení nebo sdílení konfigurací slovníku.

Q: S jakou verzí byl tento průvodce testován?
A: Příklady byly ověřeny s GroupDocs.Search for Java verze 25.4.


Poslední aktualizace: 2026-09-06
Testováno s: GroupDocs.Search for Java 25.4
Autor: GroupDocs

Související tutoriály