Jak podświetlić wyniki wyszukiwania w Javie przy użyciu GroupDocs.Search

Jeśli potrzebujesz podświetlić wyniki wyszukiwania w Javie w swoich aplikacjach, trafiłeś we właściwe miejsce. Ten przewodnik przeprowadzi Cię przez proces wizualnego podkreślania dopasowanych terminów w oryginalnych dokumentach i podglądach HTML przy użyciu GroupDocs.Search dla Javy. Niezależnie od tego, czy tworzysz portal wyszukiwania dokumentów, korporacyjną bazę wiedzy, czy prosty eksplorator plików, techniki opisane tutaj pomogą Ci zapewnić jaśniejsze i bardziej intuicyjne doświadczenie użytkownika.

Szybkie odpowiedzi

  • Co robi „highlight search results java”?
    Wizualnie oznacza każde wystąpienie terminu zapytania w dokumencie lub podglądzie, ułatwiając zauważenie dopasowań.
  • Jakie typy plików są obsługiwane?
    Word, PDF, Excel, PowerPoint, zwykły tekst i wiele innych za pośrednictwem GroupDocs.Search.
  • Czy potrzebna jest licencja?
    Licencja tymczasowa wystarcza do rozwoju; pełna licencja jest wymagana w środowisku produkcyjnym.
  • Czy mogę dostosować styl podświetlenia?
    Tak — kolory, czcionki i przezroczystość można ustawić programowo.
  • Czy wymagana jest dodatkowa konfiguracja?
    Wystarczy dodać bibliotekę GroupDocs.Search for Java do projektu i odwołać się do API.

Czym jest podświetlanie wyników wyszukiwania w Javie?

Podświetlanie wyników wyszukiwania w Javie to technika programowego stosowania wizualnych znaczników (zazwyczaj kolorów tła) do każdego wystąpienia terminu wyszukiwania znalezionego przez GroupDocs.Search w dokumencie. Dzięki temu użytkownikom końcowym łatwiej jest znaleźć istotne informacje bez ręcznego przeglądania całego pliku.

Dlaczego warto używać podświetlania w GroupDocs.Search for Java?

GroupDocs.Search obsługuje podświetlanie w ponad 30 formatach plików, w tym DOCX, PDF, XLSX, PPTX, TXT, HTML i innych. Może indeksować do 10 milionów dokumentów, zachowując opóźnienie zapytań poniżej sekundy na standardowym sprzęcie serwerowym. API pozwala dostosować kolory, przezroczystość i nawet zastosować różne style dla poszczególnych terminów, dzięki czemu możesz idealnie dopasować się do wytycznych UI swojej marki.

Wymagania wstępne

  • Zainstalowany Java 8 lub nowsza.
  • Biblioteka GroupDocs.Search for Java dodana do projektu (zależność Maven/Gradle).
  • Plik licencji GroupDocs.Search – tymczasowy lub pełny.

Przewodnik krok po kroku

Krok 1: zainicjalizuj silnik wyszukiwania

SearchEngine jest klasą podstawową, która indeksuje i przeszukuje Twoją kolekcję dokumentów. Utwórz instancję SearchEngine i załaduj indeks zawierający dokumenty, które chcesz przeszukać.

Uwaga: Kod dla tego kroku jest dostępny w powiązanym kompleksowym przewodniku poniżej.

Krok 2: wykonaj zapytanie wyszukiwania

SearchResult reprezentuje pojedynczy dokument zawierający dopasowania do zapytania użytkownika. Wywołaj metodę search z ciągiem zapytania; zwraca ona kolekcję obiektów SearchResult.

Krok 3: podświetl dopasowania w oryginalnym dokumencie

HighlightOptions pozwala określić styl wizualny — kolor, przezroczystość oraz czy podświetlać cały fragment czy tylko dokładny termin. Dla każdego SearchResult wywołaj API podświetlania, aby osadzić wizualne znaczniki bezpośrednio w pliku źródłowym.

Krok 4: wygeneruj podgląd HTML (opcjonalnie)

Jeśli wolisz wyświetlać podgląd w przeglądarce zamiast oryginalnego pliku, użyj klasy HighlightResult, aby wygenerować fragment HTML z podświetlonymi terminami. Jest to przydatne w przeglądarkowych podglądaczach lub lekkich aplikacjach mobilnych.

Krok 5: zapisz lub strumieniuj podświetlony wynik

Po podświetleniu możesz nadpisać oryginalny dokument, zapisać nową podświetloną kopię lub strumieniować wynik bezpośrednio do przeglądarki klienta.

Jak podświetlić terminy w PDF

Załaduj swój PDF przy użyciu SearchEngine i zastosuj HighlightOptions używające jasnego żółtego koloru z 30 % przezroczystością — ta kombinacja jest sprawdzona jako wyraźnie widoczna na typowych tłach PDF, zachowując pierwotny układ. API automatycznie oblicza prawidłowe współrzędne dla każdego dopasowania, zachowując przepływ tekstu i obrazy. Po podświetleniu możesz zapisać zmodyfikowany PDF na dysku lub strumieniować go bezpośrednio do klienta. To podejście działa zarówno dla jednopostaciowych, jak i wielostronicowych PDF‑ów bez zmiany pierwotnej struktury pliku.

Podświetl dopasowania w dokumentach Word

HighlightResult działa z plikami Word w ten sam sposób, ale należy wybrać HighlightColor, który respektuje natywne style Worda (np. jasny odcień teal, który nie zostaje usunięty po otwarciu dokumentu w Microsoft Word). Dzięki temu podświetlenie utrzymuje się w różnych wersjach Worda.

Typowe problemy i rozwiązania

  • Brak podświetleń: Upewnij się, że format dokumentu jest obsługiwany i że zapytanie rzeczywiście znajduje treść w pliku.
  • Spowolnienie wydajności przy dużych plikach: Włącz asynchroniczne indeksowanie lub przetwarzaj dokumenty w partiach.
  • Nieprawidłowe kolory: Sprawdź, czy używasz właściwych wartości wyliczenia HighlightColor i czy styl nie jest nadpisany przez CSS w Twoim interfejsie.

Dostępne samouczki

GroupDocs.Search for Java: Podświetlanie terminów wyszukiwania w dokumentach | Kompletny przewodnik

Dowiedz się, jak używać GroupDocs.Search for Java do podświetlania terminów wyszukiwania w dokumentach. Odkryj techniki podświetlania w całych dokumentach oraz w określonych fragmentach.

Dodatkowe zasoby

Najczęściej zadawane pytania

Q: Czy mogę podświetlić wyniki wyszukiwania w chronionych hasłem plikach PDF?
A: Tak. Podaj hasło podczas ładowania dokumentu, a następnie zastosuj te same metody podświetlania.

Q: Czy podświetlenie modyfikuje oryginalny plik na stałe?
A: Domyślnie tworzy nową kopię, ale możesz wybrać nadpisanie źródła, jeśli tego potrzebujesz.

Q: Czy można podświetlić wiele terminów zapytania jednocześnie?
A: Oczywiście. Przekaż listę terminów do silnika wyszukiwania; każdy termin zostanie podświetlony przy użyciu skonfigurowanego stylu.

Q: Jak zmienić kolor podświetlenia dla różnych terminów?
A: Użyj klasy HighlightOptions, aby przypisać różne wartości HighlightColor dla każdego terminu przed wywołaniem metody podświetlania.

Q: Co zrobić, jeśli dokument zawiera miliony stron?
A: Przetwarzaj dokument w fragmentach i używaj API strumieniowego, aby uniknąć ładowania całego pliku do pamięci.

Ostatnia aktualizacja: 2026-09-27
Testowano z: GroupDocs.Search for Java 23.11
Autor: GroupDocs

Powiązane samouczki