Autor:** GroupDocs
Make sure markdown formatting preserved.
Now produce final content.# full text search java – Ovládání GroupDocs.Search Java – Vytvoření a správa vyhledávacího indexu
V dnešních aplikacích řízených daty je provozování efektivního full text search java proti velkým kolekcím dokumentů nezbytnou schopností. Ať už vytváříte interní dokumentový portál, e‑commerce katalog nebo obsahově náročný CMS, dobře strukturovaný vyhledávací index zajišť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 dotazu full text search java – vše vysvětleno přátelským, krok‑za‑krokem stylem.
Rychlé odpovědi
- Co znamená “full text search java”? Provedení 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 pro vyzkoušení? Je k dispozici bezplatná zkušební verze; pro produkci je vyžadována dočasná nebo plná licence.
- Mohu indexovat celou složku najednou? Ano – použijte
index.add("folderPath")k add folder to index v jednom volání. - Je vyhledávání case‑insensitive? Ve výchozím nastavení GroupDocs.Search provádí case‑insensitive full‑text vyhledávání.
Co je full text search java?
Operace full text search java je jednoduše textový řetězec, který předáte metodě search() objektu Index v GroupDocs.Search. Knihovna analyzuje dotaz, prohledá indexované termíny a okamžitě vrátí odpovídající dokumenty.
Proč používat GroupDocs.Search pro Java?
- Rychlost: Vestavěné algoritmy poskytují odezvu na úrovni milisekund i při milionech dokumentů.
- Podpora formátů: Indexuje PDF, Word soubory, Excel tabulky, prostý text a mnoho dalších formátů ihned po instalaci.
- Škálovatelnost: Funguje stejně dobře pro malé utility i velká podniková řešení.
Předpoklady
Než se pustíme dál, ujistěte se, že máte:
- Java Development Kit (JDK) 8+ – runtime pro kompilaci a spuštění kódu.
- Maven – pro správu závislostí (můžete také použít Gradle, ale příklady jsou pro Maven).
- Základní znalost Java tříd, metod a příkazové řádky.
Nastavení GroupDocs.Search pro Java
Maven nastavení
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 nasazení do produkce.
Základní inicializace
Níže uvedený úryvek vytvoří prázdnou složku indexu. Je to základ pro každé full text search java, které budete později spouštět.
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
Vytvoření indexu
Vytvoření vyhledávacího indexu je první krok k umožnění efektivního získávání dokumentů.
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 dokumenty staly prohledávatelnými. GroupDocs.Search může načíst celou složku jedním voláním.
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.");
}
}
Provedení full text search java
S vašimi dokumenty v indexu je provedení full text search java jednoduché.
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 pro Java vyniká v mnoha reálných scénářích:
- Interní systémy správy dokumentů – okamžité vyhledání politik, smluv a manuálů.
- E‑commerce platformy – rychlé vyhledávání produktů v katalozích s tisíci položkami.
- Content Management Systems (CMS) – umožňuje editorům a návštěvníkům rychle najít články, média a PDF.
Úvahy o výkonu
Aby vaše full text search java zůstalo bleskově rychlé:
- Optimalizace indexování: Re‑indexujte pouze změněné soubory a pravidelně odstraňujte zastaralé položky.
- Správa zdrojů: Sledujte využití heapu JVM; zvažte inkrementální indexování pro masivní datové sady.
- Dodržujte osvědčené postupy: Používejte dávkové volání
add()místo přidávání souborů jeden po druhém, pokud je to možné.
Časté problémy a řešení
| Příznak | Pravděpodobná příčina | Oprava |
|---|---|---|
| Žádné výsledky | Index nebyl vytvořen nebo dokumenty nebyly přidány | Ověřte, že index.add() byl úspěšně proveden; zkontrolujte cestu ke složce. |
| Chyby nedostatku paměti | Velmi velké soubory načtené najednou | Povolte inkrementální indexování nebo zvýšte heap JVM (-Xmx). |
| Vyhledávání nevyhledá termíny | Analyzátor není nastaven pro jazyk | Použijte vhodné IndexSettings k nastavení jazykově specifických analyzátorů. |
Často kladené otázky
Q: Jaké souborové formáty 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ů.
Q: Mohu spustit full text search java na vzdáleném serveru?
A: Ano. Vytvořte index na serveru a zpřístupněte REST endpoint, který předá dotaz Java službě.
Q: Jak aktualizovat 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.
Další časté otázky
Q: Jak mohu zlepšit hodnocení relevance pro můj full text search java?
A: Upravit IndexSettings, např. vážení termínů, zvýšit konkrétní pole nebo povolit synonyma pro jemné ladě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 prohledá složku rekurzivně, extrahuje text z každého podporovaného souboru, tokenizuje termíny a uloží je do struktury indexu pro rychlé vyhledávání.
Poslední aktualizace: 2026-03-09
Testováno s: GroupDocs.Search 25.4 pro Java
Autor: GroupDocs