Jak zaktualizować indeks i dodać dokumenty przy użyciu GroupDocs.Search Java

Efektywne zarządzanie indeksem wyszukiwania jest niezbędne dla każdej aplikacji opartej na Javie, która wymaga szybkiego i dokładnego wyszukiwania informacji. W tym samouczku dowiesz się jak zaktualizować indeks, a także jak dodawać i usuwać dokumenty, korzystając z GroupDocs.Search dla Javy. Zobaczysz najlepsze praktyki, wskazówki dotyczące wydajności oraz przykłady zastosowań w rzeczywistych scenariuszach, które utrzymują indeks lekki, a zapytania błyskawiczne.

Szybkie odpowiedzi

  • Jaki jest pierwszy krok, aby dodać dokumenty do indeksu? Create or open an Index instance and call addDocument(...).
  • Czy mogę usuwać dokumenty z indeksu? Yes, invoke deleteDocument(...) with the document’s identifier.
  • Czy potrzebna jest specjalna licencja? A valid GroupDocs.Search for Java license is required for production use.
  • Która wersja Javy jest obsługiwana? Java 8 and higher are fully supported.
  • Gdzie mogę znaleźć więcej przykładów? See the official GroupDocs.Search for Java documentation and API reference.

Co oznacza „add documents to index” w GroupDocs.Search?

Operacja addDocument wstawia przeszukiwalną zawartość pliku (PDF, DOCX, TXT itp.) do struktury danych indeksu. Dzięki temu dokument jest natychmiast dostępny do zapytań i zapewnia, że późniejsze aktualizacje lub usunięcia pozostają zsynchronizowane z plikami źródłowymi. Dodatkowo rejestruje metadane, takie jak nazwa pliku i rozmiar, które mogą być użyte do filtrowania wyników wyszukiwania.

Dlaczego warto używać GroupDocs.Search w projektach zarządzania dokumentami w Javie?

GroupDocs.Search przetwarza do 10 million documents z opóźnieniem poniżej sekundy, obsługuje ponad 100 formatów plików i oferuje wbudowane dostrajanie trafności. API jest lekkie, wymaga tylko kilku linii kodu i integruje się płynnie z każdą aplikacją Java — niezależnie od tego, czy działa na komputerze stacjonarnym, serwerze czy w środowisku chmurowym.

Wymagania wstępne

  • Środowisko programistyczne Java 8 + (IDE, JDK, Maven/Gradle).
  • Biblioteka GroupDocs.Search for Java (pobierz z oficjalnej strony).
  • Ważna licencja GroupDocs.Search (licencje tymczasowe są dostępne do testów).

Jak dodać dokumenty do indeksu w GroupDocs.Search dla Javy?

Załaduj docelowy plik i wywołaj addDocument na instancji Index — to pojedyncze wywołanie wyodrębnia tekst, wykrywa język i przechowuje przeszukiwalne tokeny. Metoda zwraca również identyfikator dokumentu, który powinieneś przechowywać do przyszłych operacji aktualizacji lub usunięcia.

Klasa Index jest podstawowym obiektem reprezentującym przeszukiwalną kolekcję przechowywaną na dysku. Po jej utworzeniu wszystkie kolejne operacje — dodawanie, aktualizacja, usuwanie i optymalizacja — są wykonywane za pośrednictwem tej instancji.

Krok 1: otwórz lub utwórz indeks

Index index = new Index("path/to/index"); tworzy folder, jeśli nie istnieje, i przygotowuje wewnętrzne struktury do szybkiego wyszukiwania.

Krok 2: dodaj pojedynczy dokument

index.addDocument(new File("contracts/contract1.pdf")); wstawia PDF, automatycznie wykrywając jego format i wyodrębniając tekst.

Krok 3: dodaj wiele dokumentów w partii

Iteruj po katalogu i wywołuj addDocument dla każdego pliku. Przetwarzanie wsadowe zmniejsza obciążenie I/O i zwiększa ogólną przepustowość.

Jak zaktualizować indeks, gdy zmieni się plik źródłowy?

updateDocument aktualizuje istniejący dokument w indeksie przy użyciu jego identyfikatora. Zastąp starą zawartość najnowszą wersją, wywołując tę metodę i przekazując ten sam identyfikator dokumentu, który otrzymałeś przy pierwszym dodaniu pliku. Ta operacja przepisuje tylko zmienione tokeny, pozostawiając resztę indeksu nienaruszoną dla maksymalnej wydajności.

Aktualizacja krok po kroku

  1. Pobierz identyfikator dokumentu (przechowaj go, gdy po raz pierwszy dodajesz plik).
  2. Wywołaj index.updateDocument(documentId, new File("contracts/contract1_v2.pdf")); aby odświeżyć wpis.
  3. Opcjonalnie uruchom ponownie index.optimize() po dużej partii aktualizacji, aby utrzymać indeks w kompaktowej formie.

Jak bezpiecznie usuwać wpisy indeksu?

deleteDocument usuwa dokument z indeksu przy użyciu jego identyfikatora. Usunięcie dokumentu zwalnia miejsce w pamięci i zapobiega, aby przestarzałe dane wpływały na wyniki trafności. Wywołaj deleteDocument z identyfikatorem; indeks natychmiast wyklucza plik z przyszłych wyszukiwań i aktualizuje wewnętrzne listy postingów, aby utrzymać wydajność zapytań.

Jak zoptymalizować indeks pod kątem maksymalnej wydajności?

optimize() kompresuje indeks, łącząc segmenty i usuwając usunięte wpisy. Po masowych dodaniach, aktualizacjach lub usunięciach wywołaj tę metodę, aby skompresować listy postingów i zreorganizować struktury przechowywania. Ten krok może poprawić opóźnienie zapytań nawet o 30 % dla dużych indeksów i pomaga utrzymać rozmiar indeksu w rozsądnych granicach.

Typowe przypadki użycia

  • Legal document repositories: Dodawaj, aktualizuj i usuwaj pliki spraw, zachowując wysoką trafność wyszukiwania słów kluczowych.
  • Enterprise knowledge bases: Utrzymuj wewnętrzne podręczniki, polityki i FAQ przeszukiwalne w miarę ich rozwoju.
  • E‑commerce catalogs: Indeksuj specyfikacje produktów i usuwaj wycofane pozycje bez przestojów.

Rozwiązywanie problemów i wskazówki

  • Pro tip: Dodawaj dokumenty w partiach w godzinach poza szczytem, aby uniknąć skoków wydajności.
  • Pitfall: Pominięcie optimize() po masowych usunięciach może prowadzić do fragmentacji indeksów i wolniejszych zapytań.
  • Error handling: Otaczaj wszystkie operacje indeksu blokami try‑catch, aby elegancko obsługiwać IndexException.
  • Performance tip: Użyj IndexSettings, aby dostroić zużycie pamięci przy pracy z bardzo dużymi zestawami danych (np. ustaw maxMemoryUsage na wyższą wartość na serwerach z dużą ilością RAM).
  • Memory safety: Dla plików większych niż 500 MB rozważ strumieniowanie wejścia do addDocument, aby utrzymać niski zużycie pamięci sterty JVM.

Najczęściej zadawane pytania

Q: Jak usunąć dokumenty z indeksu?
A: Wywołaj deleteDocument(documentId) z unikalnym identyfikatorem; wpis zostaje natychmiast usunięty, a miejsce w pamięci odzyskane.

Q: Czy mogę modyfikować atrybuty dokumentu, aby zwiększyć dokładność wyszukiwania?
A: Tak, możesz ustawić niestandardowe metadane (np. kategorię, autora) za pomocą API atrybutów obiektu Document przed dodaniem go do indeksu.

Q: Czy istnieje samouczek „search index” dla początkujących?
A: Oficjalna dokumentacja GroupDocs.Search zawiera samouczek krok po kroku, który obejmuje tworzenie indeksu, dodawanie dokumentów i wykonywanie zapytań.

Q: Czy GroupDocs.Search obsługuje rozpoznawanie homofonów?
A: Biblioteka zawiera funkcje językowe, które poprawiają dokładność w przypadku homofonów i podobnie brzmiących słów.

Q: Jaka wersja Javy jest wymagana dla najnowszego GroupDocs.Search?
A: Wymagana jest Java 8 lub nowsza; biblioteka jest w pełni kompatybilna z Java 11 i nowszymi wersjami LTS.

Dostępne samouczki

Jak aktualizować i zarządzać wersjami indeksu w GroupDocs.Search for Java: Kompletny przewodnik

Dowiedz się, jak efektywnie aktualizować i zarządzać wersjami indeksu przy użyciu GroupDocs.Search dla Javy. Ten przewodnik obejmuje indeksowanie dokumentów, aktualizacje wersji i optymalizację wydajności.

Zarządzanie dokumentami z GroupDocs.Search for Java: Rozpoznawanie homofonów i przewodnik po indeksowaniu

Dowiedz się, jak zarządzać dokumentami przy użyciu GroupDocs.Search dla Javy, koncentrując się na rozpoznawaniu homofonów i efektywnym indeksowaniu. Popraw dokładność i wydajność wyszukiwania.

Opanowanie atrybutów dokumentów w GroupDocs.Search w Javie dla ulepszonego indeksowania i zarządzania

Dowiedz się, jak dynamicznie modyfikować i dodawać atrybuty dokumentów przy użyciu GroupDocs.Search dla Javy. Ulepsz system zarządzania dokumentami, opanowując techniki indeksowania.

Opanowanie GroupDocs.Search w Javie: Kompletny przewodnik po zarządzaniu indeksem i wyszukiwaniu dokumentów

Dowiedz się, jak skutecznie zarządzać indeksami dokumentów przy użyciu GroupDocs.Search dla Javy. Rozszerz możliwości wyszukiwania w różnych dokumentach, od dokumentów prawnych po raporty biznesowe.

Dodatkowe zasoby


Ostatnia aktualizacja: 2026-10-12
Testowano z: GroupDocs.Search for Java 23.11
Autor: GroupDocs

Powiązane samouczki