Jak używać wyszukiwania pełnotekstowego w Java z GroupDocs.Search
W tym samouczku dowiesz się, jak wdrożyć wyszukiwanie pełnotekstowe w Java przy użyciu GroupDocs.Search dla Javy. Przejdziemy przez konfigurację folderu indeksu, dodawanie dokumentów do indeksu oraz zastosowanie technik najlepszych praktyk, które optymalizują wydajność wyszukiwania dla tysięcy plików PDF, DOCX, TXT i innych formatów. Po zakończeniu będziesz mieć gotowy do produkcji komponent wyszukiwania, który działa szybko i skalowalnie.
Szybkie odpowiedzi
- Jaki jest pierwszy krok? Dodaj GroupDocs.Search do swojego projektu Maven lub pobierz plik JAR z oficjalnej strony wydań.
- Jak dodać dokumenty do indeksu? Wywołaj
index.add(yourDocumentsFolder)po utworzeniu obiektuIndex. - Który folder powinien przechowywać indeks? Użyj dedykowanego folderu, np.
output, i przekaż go donew Index(indexFolder). - Czy mogę poprawić szybkość wyszukiwania? Tak — regularnie łącz segmenty indeksu, uruchamiaj indeksowanie w tle i dostosowuj rozmiar sterty JVM.
- Czy potrzebna jest licencja? Licencja próbna lub tymczasowa wystarcza do testów; pełna licencja jest wymagana w środowiskach produkcyjnych.
Co to jest indeks dokumentów?
Indeks dokumentów to ustrukturyzowane repozytorium danych, które zawiera tokeny wyszukiwalne wyodrębnione z Twoich plików źródłowych. Tworząc indeks dokumentów, umożliwiasz szybkie, pełnotekstowe zapytania w całej zindeksowanej treści bez skanowania każdego pliku w czasie działania. Przechowuje on częstotliwości wystąpień terminów, pozycje oraz metadane, co pozwala silnikowi wyszukiwania efektywnie rankować wyniki.
Dlaczego używać GroupDocs.Search dla Java?
GroupDocs.Search zapewnia wysokowydajną, łatwą do integracji rozwiązanie wyszukiwania pełnotekstowego w aplikacjach Java. Obsługuje szeroką gamę formatów dokumentów i oferuje wbudowane optymalizacje, które utrzymują niskie opóźnienia nawet przy dużych kolekcjach.
- Wysoka wydajność – wbudowane optymalizacje utrzymują niskie opóźnienia nawet przy milionach plików.
- Łatwa integracja – proste API do tworzenia indeksów, dodawania dokumentów i wykonywania zapytań.
- Skalowalna architektura – działa lokalnie lub w chmurze i może być dostosowana przy użyciu funkcji synonimów lub rankingów.
- Wyszukiwanie pełnotekstowe w Java – obsługuje szeroką gamę formatów od razu, w tym PDF, DOCX, TXT, HTML oraz ponad 50 dodatkowych typów.
Wymagania wstępne
- Java Development Kit (JDK) 8 lub wyższy.
- IDE, np. IntelliJ IDEA lub Eclipse.
- Maven do zarządzania zależnościami.
- Podstawowa znajomość koncepcji programowania w Javie.
Konfigurowanie GroupDocs.Search dla Java
Instalacja Maven
Dodaj następującą zależność do pliku pom.xml:
<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
Alternatywnie pobierz najnowszą wersję bezpośrednio z GroupDocs.Search for Java releases.
Uzyskanie licencji
- Bezpłatna wersja próbna – przetestuj wszystkie funkcje bez zobowiązań.
- Licencja tymczasowa – wydłuż testowanie poza okres próbny.
- Zakup – uzyskaj pełną licencję do użytku produkcyjnego.
Podstawowa inicjalizacja
Klasa Index jest podstawowym obiektem reprezentującym indeks wyszukiwalny przechowywany na dysku. Udostępnia metody do dodawania, aktualizacji i zapytań dokumentów.
import com.groupdocs.search.Index;
public class InitializeGroupDocs {
public static main(String[] args) {
// Create an index in the specified folder
String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output";
Index index = new Index(indexFolder);
System.out.println("GroupDocs.Search initialized successfully.");
}
}
Jak dodać dokumenty do indeksu
Wczytaj dokumenty, skonfiguruj folder indeksu i wywołaj metodę add — wszystko w trzech zwięzłych krokach.
Krok 1: skonfiguruj folder indeksu i folder źródłowy
indexFolder to miejsce, w którym będzie przechowywany indeks wyszukiwalny, natomiast documentsFolder wskazuje pliki, które chcesz dodać do indeksu.
String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Searching\\SynonymSearch";
String documentsFolder = "YOUR_DOCUMENT_DIRECTORY"; // Replace with your actual document path
Krok 2: utwórz indeks (skonfiguruj folder indeksu)
Instancjonowanie obiektu Index ze ścieżką indexFolder tworzy nową instancję indeksu, która zapisuje dane w określonym miejscu.
Index index = new Index(indexFolder);
Krok 3: dodaj dokumenty do indeksowania
Metoda add skanuje określony folder i dodaje każdy obsługiwany dokument do indeksu, udostępniając jego zawartość do wyszukiwania natychmiast po zakończeniu wywołania.
Metoda add skanuje określony folder i dodaje każdy obsługiwany dokument do indeksu.
index.add(documentsFolder);
Porady dotyczące rozwiązywania problemów
- Brakujące zależności – sprawdź podwójnie wpisy Maven w
pom.xml. - Nieprawidłowa ścieżka folderu – upewnij się, że zarówno
indexFolder, jak idocumentsFolderistnieją i są czytelne dla JVM.
Jak skonfigurować folder indeksu
Możesz umieścić folder indeksu na szybkim SSD, udziale sieciowym lub w dowolnym miejscu, do którego Twój proces Java ma dostęp. W środowiskach chmurowych zamapuj trwały wolumen (np. Azure Files lub Amazon EFS) i przekaż jego punkt montowania do konstruktora Index. Takie podejście zapewnia, że indeks przetrwa ponowne uruchomienia aplikacji i będzie skalować się wraz z infrastrukturą.
Obsługa dużych dokumentów
Gdy pracujesz z PDF‑ami o rozmiarze w gigabajtach lub ogromnymi kolekcjami DOCX, rozważ następujące kwestie:
- Przetwarzanie wsadowe – podziel folder źródłowy na mniejsze podfoldery i wywołaj
index.add()dla każdej partii. - Indeksowanie w tle – uruchom kod indeksujący w osobnym wątku, aby główna aplikacja pozostała responsywna.
- Dostosowanie sterty – zwiększ ustawienie JVM
-Xmx, aby zapewnić procesowi wystarczającą pamięć dla dużych plików.
Optymalizacja wydajności wyszukiwania
Aby optymalizować wydajność wyszukiwania i poprawić opóźnienie wyszukiwania, stosuj następujące najlepsze praktyki:
Metoda update stosuje oczekujące zmiany w indeksie bez jego pełnego przebudowywania.
- Regularnie łącz segmenty indeksu – zmniejsza to liczbę odczytów z dysku podczas zapytań.
- Użyj
index.update()po masowych dodaniach zamiast od nowa tworzyć indeks. - Monitoruj zużycie sterty – duże indeksy mogą zużywać znaczną ilość pamięci; odpowiednio dostosuj opcje JVM.
- Włącz buforowanie dla często wykonywanych zapytań, jeśli wzorzec aplikacji na to pozwala.
Praktyczne zastosowania
- Zarządzanie dokumentami w przedsiębiorstwie – pobieraj umowy, polityki lub pliki HR w milisekundach.
- Badania prawne – znajdź akta spraw i precedensy przy minimalnym opóźnieniu.
- Biblioteki akademickie – umożliwiaj naukowcom szybkie przeszukiwanie tysięcy prac badawczych.
Typowe problemy i rozwiązania
| Problem | Rozwiązanie |
|---|---|
| Błędy braku pamięci podczas masowego indeksowania | Podziel folder źródłowy na mniejsze partie i indeksuj każdą partię osobno. |
| Wyszukiwanie zwraca nieaktualne wyniki | Ponownie otwórz obiekt Index po dużych aktualizacjach lub wywołaj index.update(), jeśli jest dostępny. |
| Licencja nie została rozpoznana | Sprawdź, czy ścieżka do pliku licencji jest poprawna i czy wersja licencji odpowiada wersji biblioteki. |
Najczęściej zadawane pytania
Q: Jaka jest minimalna wymagana wersja Java?
A: Java 8 lub wyższa jest zalecana dla pełnej kompatybilności z GroupDocs.Search.
Q: Jak mogę efektywnie obsłużyć bardzo duże zestawy dokumentów?
A: Użyj przetwarzania wsadowego, uruchamiaj indeksowanie w wątkach w tle i dostosuj ustawienia pamięci JVM, jak opisano w sekcji „Obsługa dużych dokumentów”.
Q: Czy GroupDocs.Search może być wdrożony w środowisku chmurowym?
A: Tak, możesz przechowywać folder indeksu w dowolnym dostępnym w chmurze magazynie (np. Azure Files, Amazon EFS), pod warunkiem że wszystkie instancje mają do niego dostęp do odczytu i zapisu.
Q: Jakie korzyści daje wyszukiwanie synonimów?
A: Wyszukiwanie synonimów rozszerza terminy zapytania o powiązane słowa, zwiększając przywołanie bez utraty precyzji, co jest idealne dla przyjaznych użytkownikowi doświadczeń wyszukiwania.
Q: Gdzie mogę znaleźć bardziej zaawansowaną dokumentację?
A: Odwiedź oficjalną referencję API pod adresem GroupDocs.Search API Reference.
Zasoby
- Dokumentacja: GroupDocs Search for Java
- Referencja API: GroupDocs Search API
- Pobierz: Latest Releases
- GitHub: GroupDocs.Search on GitHub
- Bezpłatne wsparcie: GroupDocs Forum
- Licencja tymczasowa: Acquire a License
Postępując zgodnie z tymi krokami, teraz wiesz, jak utworzyć indeks dokumentów, dodać dokumenty do indeksu, skonfigurować folder indeksu oraz optymalizować wydajność wyszukiwania przy użyciu GroupDocs.Search dla Java. Szczęśliwego kodowania!
Last Updated: 2026-10-22
Tested With: GroupDocs.Search 25.4 for Java
Author: GroupDocs