Utwórz indeks wyszukiwania java przy użyciu GroupDocs.Search dla Java

W tym obszernej przewodniku dowiesz się, jak create search index java aplikacje przy użyciu GroupDocs.Search dla Java, a także zobaczysz, jak highlight search results java, aby użytkownicy mogli natychmiast zauważyć dopasowania w plikach PDF, Office, stronach HTML i nie tylko. Niezależnie od tego, czy tworzysz lekkie narzędzie desktopowe, czy wydajną usługę wyszukiwania w przedsiębiorstwie, poniższe kroki obejmują wszystko, od indeksowania różnych formatów po dopasowywanie wydajności i uruchamianie przykładu zapytania boolean w Javie.

Szybki przegląd

GroupDocs.Search for Java provides a rich, ready‑to‑use toolbox that lets you:

  • Index diverse document types – PDF‑y, DOCX, PPTX, XLSX, HTML i ponad 150 innych formatów.
  • Run advanced queries – Boolean, fuzzy, wildcard, phrase, regex i faceted searches.
  • Leverage language processing – Synonyms, spell checking, homophone detection i custom dictionaries.
  • Integrate OCR – Extract text from scanned images and add it to the searchable index.
  • Optimize performance – Control memory usage, index size, and query response times for indexes that reach multi‑gigabyte scale.
  • Highlight results – Show matches directly in the original document or in an HTML preview with customizable colors and CSS classes.

Poniżej znajduje się wyselekcjonowana lista dedykowanych samouczków, które prowadzą Cię krok po kroku przez każdą funkcję.

Szybkie odpowiedzi

  • What does “highlight search results java” do? Wizualnie oznacza pasujące terminy w oryginalnym dokumencie lub wygenerowanym podglądzie HTML, umożliwiając użytkownikom natychmiastowe odnalezienie odpowiednich fragmentów.
  • Which library provides faceted search java? GroupDocs.Search for Java zawiera wbudowane wsparcie faceted search, które grupuje wyniki według pól metadanych.
  • Can I implement OCR java with the same API? Tak — włącz silnik OCR za pomocą pojedynczego ustawienia OcrOptions, a ten sam przepływ indeksowania wyodrębni tekst z obrazów.
  • Do I need a license for production use? Licencja komercyjna jest wymagana po wygaśnięciu okresu próbnego.
  • Is the API compatible with Java 17 and later? W pełni obsługuje Java 8+, jest testowane na Java 17 i działa na każdej platformie zgodnej z JVM.

Czym jest „highlight search results java”?

Podświetlanie wyników wyszukiwania w Javie oznacza programowe stosowanie wizualnych wskazówek — takich jak kolory tła lub pogrubienie — do dokładnych słów lub fraz, które pasowały do zapytania użytkownika. Ta technika skraca czas, jaki użytkownicy spędzają na przeglądaniu długich dokumentów i poprawia ogólną użyteczność wyszukiwania.

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

GroupDocs.Search for Java indeksuje i przeszukuje tysiące dokumentów w czasie krótszym niż dwie sekundy na standardowym serwerze 8‑rdzeniowym. Obsługuje ponad 150 formatów plików, przetwarza indeksy wielogigabajtowe bez ładowania całej kolekcji do pamięci oraz oferuje gotowe OCR, faceted search i obsługę synonimów — wszystko poprzez płynne, dobrze udokumentowane API.

Wymagania wstępne

  • Java 8 lub nowsza (zalecana Java 17)
  • Maven lub Gradle do zarządzania zależnościami
  • Ważna licencja GroupDocs.Search for Java (dostępna wersja próbna)

Przewodnik krok po kroku

Krok 1: skonfiguruj projekt

Utwórz projekt Maven lub Gradle i dodaj zależność GroupDocs.Search. Umieść plik licencji (GroupDocs.Search.lic) w folderze src/main/resources, aby SDK mogło go automatycznie załadować.

Krok 2: utwórz indeks

Index jest klasą podstawową, która reprezentuje repozytorium przeszukiwalne na dysku.

Index index = new Index("path/to/index/folder");

Po utworzeniu instancji Index wywołaj add dla każdego dokumentu, który ma być przeszukiwany. SDK automatycznie wykrywa typ pliku i wyodrębnia tekst.

Krok 3: włącz OCR (implement OCR java)

OcrOptions konfiguruje wbudowany silnik OCR.

OcrOptions ocr = new OcrOptions();
ocr.setLanguage("eng");
ocr.setDpi(300);

Dołącz instancję OcrOptions do wywołania indeksowania, aby zeskanowane obrazy zostały przekształcone w tekst przeszukiwalny.

Krok 4: wykonaj zapytanie wyszukiwania

SearchOptions buduje zapytanie, które wysyłasz do indeksu.

SearchOptions options = new SearchOptions()
    .setQuery("invoice")
    .setBooleanOperator(BooleanOperator.AND)
    .setFuzzy(true);

Możesz połączyć Java boolean query example z filtrami faceted, wildcardami lub wzorcami regex, aby dodatkowo zawęzić wyniki.

Krok 5: podświetl wyniki wyszukiwania java

Highlight jest klasą pomocniczą, która generuje podświetloną wersję dopasowanego dokumentu.

HighlightOptions highlight = new HighlightOptions()
    .setColor(Color.YELLOW)
    .setCssClass("search-highlight");
HighlightResult result = Highlight.apply(searchResult, highlight);

API zwraca albo zmodyfikowany plik PDF, albo fragment HTML, w którym każdy pasujący termin jest otoczony wybranym stylem.

Krok 6: przegląd i optymalizacja

Użyj wbudowanego API statystyk, aby monitorować rozmiar indeksu, zużycie pamięci i opóźnienie zapytań. Dostosuj maxMemoryUsage lub włącz kompresję (setCompression(true)), aby utrzymać indeks w lekkiej formie przy obsłudze milionów rekordów.

Typowe problemy i rozwiązania

  • No highlights appear: Zweryfikuj, czy przekazałeś obiekt HighlightOptions z obsługiwanym formatem wyjściowym (HTML lub PDF).
  • OCR misses text: Upewnij się, że pakiety językowe są zainstalowane, a obrazy źródłowe spełniają minimalną rekomendację 300 dpi.
  • Faceted search returns empty buckets: Potwierdź, że pola, które mają być faceted, zostały zindeksowane jako typ Facet w kroku 2.

Najczęściej zadawane pytania

Q: Czy mogę używać faceted search java razem z dopasowaniem fuzzy?
A: Tak — możesz łączyć filtry facet i zapytania fuzzy w tym samym builderze SearchOptions, co pozwala zawęzić wyniki przy tolerowaniu literówek.

Q: Czy podświetlanie działa na zaszyfrowanych plikach PDF?
A: Działa tylko wtedy, gdy podasz prawidłowe hasło podczas dodawania dokumentu do indeksu; SDK następnie odszyfruje, podświetli i ponownie zaszyfruje wynik.

Q: Jak duży może być indeks, zanim wydajność spadnie?
A: Biblioteka niezawodnie obsługuje indeksy wielogigabajtowe; włączenie kompresji i dostosowanie maxMemoryUsage pozwala utrzymać czasy zapytań poniżej 200 ms nawet przy 10 milionach dokumentów.

Q: Czy istnieje sposób na dostosowanie koloru podświetlenia?
A: Oczywiście. Użyj HighlightOptions.setColor(Color.YELLOW) lub podaj własną klasę CSS dla wyjścia HTML poprzez setCssClass.

Q: Jaką wersję GroupDocs.Search przetestowano w tym przewodniku?
A: Przykłady zostały zweryfikowane z GroupDocs.Search for Java 23.9.

Powiązane tematy, które możesz zbadać

Przegląd funkcji wyszukiwania dokumentów w Javie

GroupDocs.Search for Java offers a comprehensive set of capabilities for building powerful search applications:

  • Multi‑format support – ponad 150 formatów wejścia i wyjścia, w tym PDF, DOCX, PPT, XLS, HTML i pliki graficzne.
  • Advanced search types – Boolean, fuzzy, wildcard, phrase, regex i faceted search java options.
  • Intelligent indexing – Szybkie, konfigurowalne indeksowanie dokumentów z opcjonalną kompresją.
  • Language processing – Wykrywanie synonimów, sprawdzanie pisowni i rozpoznawanie homofonów.
  • OCR support – Ekstrahowanie i wyszukiwanie tekstu z obrazów oraz zeskanowanych dokumentów (implement OCR java).
  • Performance optimization – Regulowane użycie pamięci i szybkość zapytań dla indeksów wielogigabajtowych.
  • Result highlighting – Wizualne podświetlanie dopasowań wyszukiwania w oryginalnych dokumentach (highlight search results java).
  • Dictionary support – Niestandardowe słowniki dla specjalistycznej terminologii i dziedzin.
  • Distributed search – Tworzenie skalowalnych, partycjonowanych rozwiązań wyszukiwania z funkcjami sieciowymi.
  • Blazing speed – Przetwarzanie i wyszukiwanie 10 000 dokumentów w czasie krótszym niż 2 sekundy na typowym serwerze.

Zasoby edukacyjne

Ostatnia aktualizacja: 2026-08-26
Testowano z: GroupDocs.Search for Java 23.9
Autor: GroupDocs