Jak utworzyć indeks dokumentów i dodać dokumenty przy użyciu GroupDocs.Search dla Javy

Jeśli potrzebujesz utworzyć indeks dokumentów umożliwiający natychmiastowe przeszukiwanie tysięcy plików PDF, DOCX, TXT i innych formatów, GroupDocs.Search dla Javy zapewnia czyste API, które to umożliwia. W tym samouczku dowiesz się, jak skonfigurować folder indeksu, dodać dokumenty do indeksu oraz zoptymalizować wydajność wyszukiwania w rzeczywistych scenariuszach wyszukiwania pełnotekstowego w Javie.

Szybkie odpowiedzi

Jaki jest pierwszy krok? Zainstaluj GroupDocs.Search za pomocą Maven lub pobierz bibliotekę.
Jak dodać dokumenty do indeksu? Wywołaj index.add(yourDocumentsFolder) po zainicjowaniu indeksu.
Który folder powinien przechowywać indeks? Użyj dedykowanego folderu, takiego jak output, i skonfiguruj go przy pomocy new Index(indexFolder).
Czy mogę przyspieszyć wyszukiwanie? Tak — regularnie utrzymuj indeks i uruchamiaj indeksowanie w wątku w tle.
Czy potrzebna jest licencja? Licencja próbna lub tymczasowa działa w testach; pełna licencja jest wymagana w środowisku produkcyjnym.

Czym jest indeks dokumentów?

Indeks dokumentów to uporządkowane repozytorium danych zawierające tokeny możliwe do przeszukania, wyodrębnione z Twoich plików źródłowych. Dzięki utworzeniu indeksu dokumentów umożliwiasz szybkie zapytania pełnotekstowe we wszystkich zindeksowanych treściach bez skanowania każdego pliku w czasie wykonywania.

Dlaczego warto używać GroupDocs.Search dla Javy?

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 Javie – obsługuje szeroką gamę formatów od razu po instalacji.

Wymagania wstępne

Java Development Kit (JDK) 8 lub wyższy.
IDE takie jak IntelliJ IDEA lub Eclipse.
Maven do zarządzania zależnościami.
Podstawowa znajomość programowania w Javie.

Konfiguracja GroupDocs.Search dla Javy

Instalacja przez Maven

Dodaj poniższy kod 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 wydania GroupDocs.Search dla Javy.

Uzyskanie licencji

Bezpłatna wersja próbna – przetestuj wszystkie funkcje bez zobowiązań.
Licencja tymczasowa – wydłuż testowanie poza okres wersji próbnej.
Zakup – uzyskaj pełną licencję do użytku produkcyjnego.

Podstawowa inicjalizacja

import com.groupdocs.search.Index;

public class InitializeGroupDocs {
    public static void 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

Krok 1: Skonfiguruj folder indeksu i folder źródłowy

String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Searching\\SynonymSearch";
String documentsFolder = "YOUR_DOCUMENT_DIRECTORY"; // Replace with your actual document path

Wyjaśnienie: indexFolder to miejsce, w którym będzie przechowywany indeks wyszukiwalny, natomiast documentsFolder wskazuje na pliki, które chcesz dodać do indeksu.

Krok 2: Utwórz indeks (skonfiguruj folder indeksu)

Index index = new Index(indexFolder);

Wyjaśnienie: Ten wiersz tworzy nową instancję indeksu, która zapisuje dane w skonfigurowanym folderze.

Krok 3: Dodaj dokumenty do indeksowania

index.add(documentsFolder);

Wyjaśnienie: Metoda add skanuje documentsFolder i dodaje dokumenty do indeksu, czyniąc ich zawartość przeszukiwalną.

Wskazówki rozwiązywania problemów

Brakujące zależności – sprawdź ponownie wpisy Maven w pom.xml.
Nieprawidłowa ścieżka folderu – upewnij się, że zarówno indexFolder, jak i documentsFolder istnieją i są dostępne dla JVM.

Obsługa dużych dokumentów

Gdy pracujesz z plikami PDF o rozmiarze gigabajtów lub ogromnymi kolekcjami DOCX, rozważ następujące rozwiązania:

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 zoptymalizować wydajność wyszukiwania i poprawić opóźnienie wyszukiwania, stosuj się do następujących najlepszych praktyk:

Regularnie łącz segmenty indeksu – zmniejsza to liczbę odczytów z dysku podczas zapytań.
Użyj index.update() (jeśli dostępne) 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 Twojej aplikacji na to pozwala.

Praktyczne zastosowania

Zarządzanie dokumentami w przedsiębiorstwie – szybkie odnajdywanie umów, polityk lub plików HR.
Badania prawne – znajdowanie akt spraw i precedensów przy minimalnym opóźnieniu.
Biblioteki akademickie – umożliwienie naukowcom przeszukiwania tysięcy publikacji naukowych.

Typowe problemy i rozwiązania

Problem	Rozwiązanie
Błędy Out‑of‑memory 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ępne.
Licencja nie została rozpoznana	Sprawdź, czy ścieżka do pliku licencji jest poprawna oraz czy wersja licencji odpowiada wersji biblioteki.

Najczęściej zadawane pytania

P: Jaka jest minimalna wymagana wersja Javy?
O: Java 8 lub wyższa jest zalecana dla pełnej kompatybilności.

P: Jak efektywnie obsłużyć bardzo duże zestawy dokumentów?
O: Użyj przetwarzania wsadowego, uruchamiaj indeksowanie w wątkach w tle i dostosuj ustawienia pamięci JVM.

P: Czy GroupDocs.Search może być wdrożony w środowisku chmurowym?
O: Tak, ale upewnij się, że lokalizacja przechowywania folderu indeksu jest dostępna dla wszystkich instancji.

P: Jakie korzyści daje wyszukiwanie synonimów?
O: Rozszerza terminy zapytania o powiązane słowa, zwiększając pokrycie (recall) bez utraty precyzji.

P: Gdzie mogę znaleźć bardziej zaawansowaną dokumentację?
O: Odwiedź oficjalną referencję API pod adresem Referencja API GroupDocs.Search.

Zasoby

Dokumentacja: GroupDocs Search dla Javy
Referencja API: API GroupDocs Search
Pobieranie: Najnowsze wydania
GitHub: GroupDocs.Search na GitHub
Bezpłatne wsparcie: Forum GroupDocs
Licencja tymczasowa: Uzyskaj licencję

Postępując zgodnie z tymi krokami, teraz wiesz, jak utworzyć indeks dokumentów, dodać dokumenty do indeksu, skonfigurować folder indeksu oraz zoptymalizować wydajność wyszukiwania przy użyciu GroupDocs.Search dla Javy. Powodzenia w kodowaniu!

Ostatnia aktualizacja: 2026-03-15
Testowano z: GroupDocs.Search 25.4 for Java
Autor: GroupDocs