Pełnotekstowe wyszukiwanie java – opanowanie GroupDocs.Search Java – tworzenie i zarządzanie indeksem wyszukiwania
W dzisiejszych aplikacjach opartych na danych, uruchamianie wydajnego full text search java na dużych zbiorach dokumentów jest niezbędną funkcją. Niezależnie od tego, czy budujesz wewnętrzny portal dokumentów, katalog e‑commerce, czy system CMS z dużą ilością treści, dobrze skonstruowany indeks wyszukiwania zapewnia szybkie i dokładne wyniki. Ten samouczek przeprowadzi Cię przez konfigurację GroupDocs.Search dla Javy, tworzenie indeksu przeszukiwalnego, adding documents to index, oraz wykonywanie zapytania full text search java – wszystko wyjaśnione w przyjaznym, krok‑po‑kroku stylu.
Szybkie odpowiedzi
- What does “full text search java” mean? Uruchamianie wyszukiwania opartego na tekście w indeksie zbudowanym przy użyciu GroupDocs.Search w aplikacji Java.
- Which library handles the indexing? GroupDocs.Search for Java (najnowsze stabilne wydanie).
- Do I need a license to try it? Dostępna jest bezpłatna wersja próbna; do produkcji wymagana jest licencja tymczasowa lub pełna.
- Can I index an entire folder at once? Tak – użyj
index.add("folderPath"), aby add folder to index w jednym wywołaniu. - Is the search case‑insensitive? Domyślnie GroupDocs.Search wykonuje wyszukiwania pełnotekstowe bez rozróżniania wielkości liter.
Czym jest full text search java?
Operacja full text search java pozwala zlokalizować dokumenty zawierające określony wzorzec tekstowy. Przekazujesz ciąg zapytania do metody search() obiektu Index z GroupDocs.Search, a biblioteka analizuje zapytanie, przeszukuje terminy w indeksie i natychmiast zwraca pasujące dokumenty. Dzięki temu możliwe jest szybkie odnajdywanie istotnych treści w tysiącach plików bez ręcznego przeglądania.
Dlaczego warto używać GroupDocs.Search for Java?
GroupDocs.Search for Java oferuje wysokowydajne, gotowe rozwiązanie do indeksowania i wyszukiwania. Może indeksować 30+ formatów dokumentów – w tym PDF, DOCX, XLSX, PPTX, TXT, HTML oraz wiele typów obrazów – i przetwarza pliki wielostronicowe bez ładowania całego pliku do pamięci. Wbudowane algorytmy zapewniają czas reakcji na poziomie milisekund, nawet gdy indeks zawiera miliony dokumentów, co czyni je odpowiednimi zarówno dla małych narzędzi, jak i dużych wdrożeń korporacyjnych.
Wymagania wstępne
Zanim przejdziesz dalej, upewnij się, że masz:
- Java Development Kit (JDK) 8+ – środowisko uruchomieniowe do kompilacji i uruchamiania kodu.
- Maven – do zarządzania zależnościami (możesz także używać Gradle, ale przykłady podane są dla Maven).
- Podstawową znajomość klas Java, metod oraz wiersza poleceń.
Konfigurowanie GroupDocs.Search for Java
Konfiguracja Maven
Dodaj repozytorium GroupDocs i zależność do swojego pom.xml. To jedyna zmiana, jaką musisz wprowadzić w konfiguracji 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>
Bezpośrednie pobranie (opcjonalnie)
Jeśli wolisz nie używać Maven, pobierz najnowszy plik JAR ze strony wydania: GroupDocs.Search for Java releases.
Pozyskanie licencji
- Free trial: Idealny do oceny funkcji.
- Temporary license: Do użycia w rozszerzonych testach bez zobowiązań.
- Full license: Zalecany do wdrożeń produkcyjnych.
Podstawowa inicjalizacja
Poniższy fragment tworzy pusty folder indeksu. To podstawa dla każdego full text search java, które uruchomisz później.
Index jest klasą rdzeniową reprezentującą indeks przeszukiwalny przechowywany na dysku.
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 utworzyć indeks wyszukiwania
Bezpośrednia odpowiedź
Utwórz instancję Index wskazującą na folder na dysku, a następnie wywołaj index.add(), aby wczytać pliki. To pojedyncze działanie buduje strukturę przeszukiwalną, która napędza wszystkie kolejne zapytania pełnotekstowe. Inicjalizując indeks raz i dodając dokumenty hurtowo, zapewniasz optymalną wydajność i unikasz wielokrotnego ponownego indeksowania.
Index jest centralną klasą zarządzającą strukturą danych przeszukiwalnych.
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);
}
}
Dodawanie folderu do indeksu
Teraz, gdy indeks istnieje, musisz add documents to index, aby stały się przeszukiwalne. GroupDocs.Search może wczytać cały folder jednym wywołaniem.
Metoda add skanuje podany katalog rekurencyjnie, wyodrębnia tekst z każdego obsługiwanego pliku i zapisuje terminy w indeksie.
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.");
}
}
Wykonywanie full text search java
Po zaindeksowaniu dokumentów, wykonanie full text search java jest proste.
Metoda search przyjmuje ciąg zapytania, przetwarza go przy użyciu skonfigurowanego analizatora i zwraca SearchResult zawierający pasujące 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());
}
}
Praktyczne zastosowania
GroupDocs.Search for Java sprawdza się w wielu rzeczywistych scenariuszach:
- Systemy zarządzania dokumentami wewnętrznymi – natychmiastowe odnajdywanie polityk, umów i podręczników.
- Platformy e‑commerce – szybkie wyszukiwanie produktów w katalogach z tysiącami pozycji.
- Systemy zarządzania treścią (CMS) – umożliwienie redaktorom i odwiedzającym szybkiego znajdowania artykułów, mediów i plików PDF.
Rozważania dotyczące wydajności
Aby full text search java działało błyskawicznie:
- Optymalizuj indeksowanie: Reindeksuj tylko zmienione pliki i regularnie usuwaj przestarzałe wpisy.
- Zarządzaj zasobami: Monitoruj zużycie pamięci JVM; rozważ indeksowanie przyrostowe przy bardzo dużych zestawach danych.
- Stosuj najlepsze praktyki: Używaj wywołań
add()w partiach zamiast dodawania plików pojedynczo, gdy to możliwe.
Częste problemy i rozwiązania
| Symptom | Likely cause | Fix |
|---|---|---|
| Brak zwróconych wyników | Indeks nie został zbudowany lub dokumenty nie zostały dodane | Zweryfikuj, czy index.add() zostało pomyślnie wykonane; sprawdź ścieżkę folderu. |
| Błędy out‑of‑memory | Bardzo duże pliki ładowane jednocześnie | Włącz indeksowanie przyrostowe lub zwiększ pamięć heap JVM (-Xmx). |
| Wyszukiwanie pomija terminy | Analizator nie skonfigurowany dla języka | Użyj odpowiednich IndexSettings, aby ustawić analizatory specyficzne dla języka. |
Najczęściej zadawane pytania
Q: Jakie formaty plików może indeksować GroupDocs.Search?
A: PDF, DOC/DOCX, XLS/XLSX, PPT/PPTX, TXT, HTML oraz wiele innych popularnych formatów biurowych – łącznie 30+ obsługiwanych typów.
Q: Czy mogę uruchomić full text search java na zdalnym serwerze?
A: Tak. Zbuduj indeks na serwerze i udostępnij endpoint REST, który przekazuje zapytanie do usługi Java.
Q: Jak zaktualizować indeks, gdy dokument ulegnie zmianie?
A: Użyj index.update("path/to/changed/file"), aby zastąpić starą pozycję bez przebudowy całego indeksu.
Q: Czy istnieje sposób, aby ograniczyć wyniki wyszukiwania do konkretnego folderu?
A: Po otrzymaniu SearchResult przefiltruj result.getDocuments() według ich pierwotnej ścieżki.
Q: Czy GroupDocs.Search obsługuje wyszukiwania fuzzy lub z użyciem znaków wieloznacznych?
A: Biblioteka zawiera wbudowaną obsługę dopasowań fuzzy (~) oraz operatorów wieloznacznych (*) w ciągach zapytań.
Q: Jak mogę poprawić ranking trafności dla mojego full text search java?
A: Dostosuj IndexSettings, takie jak ważenie terminów, zwiększ priorytet konkretnych pól lub włącz synonimy, aby precyzyjnie dopasować trafność.
Q: Czy można usuwać dokumenty z indeksu?
A: Tak. Wywołaj index.delete("path/to/file"), aby usunąć wpis dokumentu.
Q: Co dokładnie robi „add folder to index” w tle?
A: GroupDocs.Search skanuje folder rekurencyjnie, wyodrębnia tekst z każdego obsługiwanego pliku, tokenizuje terminy i zapisuje je w strukturze indeksu dla szybkiego wyszukiwania.
Ostatnia aktualizacja: 2026-10-17
Testowano z: GroupDocs.Search 25.4 for Java
Autor: GroupDocs