Hogyan adjon hozzá mappát az indexhez a GroupDocs.Search Java-ban
Ha java full text search‑re van szüksége, amely millió dokumentumra is skálázható, jó helyen jár. Ebben az útmutatóban megtanulja, hogyan adjon hozzá mappát az indexhez a GroupDocs.Search segítségével, hogyan konfiguráljon nagy tömörítésű tárolást, és hogyan futtasson villámgyors lekérdezéseket. A végére egy termelésre kész megoldást kap, amelyet bármely Java projektbe be lehet illeszteni.
Gyors válaszok
- Mi a fő könyvtár? GroupDocs.Search for Java
- Hogyan adjon hozzá egy mappát az indexhez? Használja az
index.add(folderPath)metódust - Be tudom-e állítani a szövegtömörítést? Igen, a
TextStorageSettings(Compression.High)segítségével - Melyik Java verzió szükséges? JDK 8 vagy újabb
- Hol szerezhetek próbaverziós licencet? A GroupDocs weboldaláról vagy a tároló oldaláról
Mi az a java full text search és miért fontos?
A Java full text search nyers dokumentumokat fordít visszafelé mutató indexbe, lehetővé téve almásodperces lekérdezést bármely kifejezésre több ezer fájl között. Ez a képesség elengedhetetlen jogi adattárak, kutatási könyvtárak és vállalati tudásbázisok számára, ahol a felhasználók azonnali eredményeket várnak. Emellett növeli a modern alkalmazások termelékenységét.
Miért használjuk a groupdocs.search‑t java full text search‑hez?
A GroupDocs.Search magas áteresztőképességű indexelést és lekérdezés-végrehajtást biztosít beépített nagy tömörítéssel. 50+ bemeneti és kimeneti formátumot támogat – köztük PDF, DOCX, EML és HTML – és képes több száz oldalas dokumentumokat feldolgozni anélkül, hogy az egész fájlt a memóriába töltené, így a tipikus munkaterhelés esetén a memóriahasználat 200 MB alatt marad.
Előfeltételek
- GroupDocs.Search for Java (25.4 vagy újabb verzió) – a magkönyvtár, amely az indexelést és keresést biztosítja.
- JDK 8+ telepítve és beállítva – a SDK minimális futtatási környezete.
- Maven a függőségkezeléshez – egyszerűsíti a könyvtár projektbe való felvételét.
- Egy IDE, például IntelliJ IDEA vagy Eclipse – a Java kód írásához és hibakereséséhez.
A GroupDocs.Search beállítása java-hoz
Maven beállítás
Adja hozzá a tárolót és a függőséget a pom.xml fájlhoz:
<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>
Közvetlen letöltés
Alternatívaként töltse le a legújabb verziót a GroupDocs.Search for Java releases oldalról.
Licencbeszerzés
- Ingyenes próba – minden funkció kipróbálása kötelezettség nélkül.
- Ideiglenes licenc – meghosszabbított tesztidőszak.
- Vásárlás – a teljes termelési funkciók feloldása.
Alapvető inicializálás és beállítás
Az Index az a fő osztály, amelyet index létrehozására, megnyitására és kezelésére használunk.
import com.groupdocs.search.Index;
public class InitializeSearch {
public static void main(String[] args) {
// Path to store index data
String indexPath = "path/to/index";
// Creating an index at specified location
Index index = new Index(indexPath);
System.out.println("GroupDocs.Search initialized successfully!");
}
}
Szöveg indexelése egyedi tömörítéssel
1. lépés: az index mappájának meghatározása
Válasszon egy könyvtárat, ahol az indexfájlok tárolódni fognak:
String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Indexing\\StoringTextOfIndexedDocuments";
2. lépés: index beállításainak konfigurálása
A TextStorageSettings határozza meg, hogyan tárolódik a szöveg az indexben, beleértve a tömörítési szintet is. A Compression egy enum, amely a kívánt tömörítési algoritmust jelöli.
import com.groupdocs.search.Index;
import com.groupdocs.search.IndexSettings;
import com.groupdocs.search.options.TextStorageSettings;
import com.groupdocs.search.compression.Compression;
IndexSettings settings = new IndexSettings();
settings.setTextStorageSettings(new TextStorageSettings(Compression.High));
3. lépés: index létrehozása egyedi beállításokkal
Hozza létre az indexet a fent definiált konfigurációval:
Index index = new Index(indexFolder, settings);
System.out.println("Index created with high compression.");
Hogyan adjon hozzá egy mappát az indexhez
Az Index a kereshető indexet képviselő fő osztály.
Töltse be a meglévő indexet (vagy hozza létre újat), majd hívja meg az add metódust az Index objektumon. Az add művelet beolvassa a megadott könyvtárat, kinyeri a szöveget minden támogatott fájlból, és a tömörített indexbe helyezi, készen az azonnali keresésre.
String documentsFolder = "YOUR_DOCUMENT_DIRECTORY"; // Replace with actual document path.
Index index = new Index(indexFolder);
Hogyan keressen az indexelt dokumentumokban
A SearchResult egyetlen találatot reprezentál a dokumentum útvonalával és relevanciájával.
Határozzon meg egy keresési lekérdezés‑sztringet, amely a keresett kifejezést vagy szókapcsolatot tartalmazza, majd hívja meg a search metódust az Index példányon. A metódus egy SearchResult objektumok gyűjteményét adja vissza, mindegyik tartalmazza a dokumentum útvonalát, a relevancia‑pontszámot és egy szövegrészletet, amely kiemeli a találatot.
index.add(documentsFolder);
System.out.println("Documents added successfully.");
Gyakorlati alkalmazások
Valós példák, ahol a java full text search ragyog:
- Jogi dokumentumkezelés – az ügyiratok azonnali visszakeresése.
- Akademiai kutatási könyvtárak – gyors keresés dolgozatok és értekezések között.
- Vállalati tudásbázisok – gyors hozzáférés kézikönyvekhez és GYIK‑hez.
- Tartalomkezelő rendszerek – hatékony tartalomfelfedezés nagy webhelyek esetén.
- Ügyfélszolgálati archívumok – gyors keresés a múltbeli jegyek és csevegések között.
Teljesítménybeli megfontolások
- Tömörítés vs. sebesség: A magas tömörítés akár 70 % lemezhelyet takaríthat meg, de mérsékelt indexelési többletterhet okoz; futtasson benchmark teszteket az adatmennyiségre vonatkozóan.
- Memória kezelés: Legalább 2 GB heapet biztosítson 10 GB‑nál nagyobb indexekhez, hogy elkerülje a
OutOfMemoryErrorhibát. - Index frissítések: Új dokumentumok hozzáadásához használja az
index.add()‑t, és időnként hívja meg azindex.optimize()‑t az index kompakt tartásához. - Lekérdezés optimalizálás: Használja a fejlett lekérdezés‑szintaxist (helyettesítő karakterek, közelség, fuzzy keresés) a találatok szűkítéséhez és a válaszidő csökkentéséhez.
Gyakori hibák és profi tippek
Hiba: Elfelejti meghívni az
index.optimize()‑t a tömeges hozzáadások után.
Profi tipp: Futtassa azindex.optimize()‑t éjszakánként, hogy az index kompakt maradjon.Hiba: Alapértelmezett (alacsony) tömörítés használata hatalmas adatkészleteken.
Profi tipp: ÁllítsaCompression.High‑ra a termelési környezetben a tárolási költségek csökkentése érdekében.Hiba: Nem kezeli az
IOException‑t hálózati megosztásról történő fájlhozzáadáskor.
Profi tipp: Tegye azindex.add()‑t try‑catch blokkba, és naplózza a hibákat későbbi felülvizsgálatra.
Gyakran feltett kérdések
K: Mi a GroupDocs.Search?
V: Egy robusztus Java könyvtár, amely fejlett full‑text keresési képességeket biztosít, beleértve az indexelést, tömörítést és összetett lekérdezéstámogatást.
K: Hogyan kezeljem a nagy adatállományokat a GroupDocs.Search‑szal?
V: Engedélyezze a magas tömörítést (Compression.High) és időszakosan commit‑olja a változásokat, hogy az index karcsú maradjon. Emellett biztosítson elegendő heap memóriát (például 4 GB 20 GB‑nál nagyobb indexekhez).
K: Integrálhatom a GroupDocs.Search‑t meglévő vállalati rendszerekkel?
V: Igen, a könyvtár beágyazható bármely Java‑alapú háttérrendszerbe, REST szolgáltatásba vagy mikro‑szolgáltatás‑architektúrába.
K: Mi a teendő, ha az index elavul?
V: Használja az index.add() metódust új fájlok hozzáadásához és az index.delete()‑t elavultak eltávolításához, majd szükség esetén futtassa újra az index.optimize()‑t.
K: Hol kaphatok segítséget vagy támogatást?
V: Látogassa meg a közösségi fórumot a GroupDocs forums oldalon a hibakereséshez és legjobb gyakorlatokhoz.
További források
- Részletes használati útmutató: GroupDocs Search Documentation
- Teljes API referencia: API Reference Guide
- Legújabb funkciók nyomon követése: Latest Releases
Utoljára frissítve: 2026-11-02
Tesztelve a következővel: GroupDocs.Search 25.4
Szerző: GroupDocs
String query = "sample";
import com.groupdocs.search.results.SearchResult;
SearchResult result = index.search(query);
System.out.println("Search completed. Results found: " + result.getDocumentCount());