Utwórz indeks przeszukiwalny Java: dodawanie dokumentów i wyszukiwanie rozróżniające wielkość liter

W nowoczesnych aplikacjach Java, tworzenie indeksu przeszukiwalnego Java jest podstawą szybkiego i dokładnego wyszukiwania informacji w dużych zbiorach dokumentów. Ten samouczek pokazuje, jak dodać dokumenty do indeksu, włączyć wyszukiwanie rozróżniające wielkość liter oraz dopracować proces przy użyciu GroupDocs.Search. Niezależnie od tego, czy tworzysz repozytorium prawne, katalog e‑commerce, czy system zarządzania treścią, te kroki pomogą Ci dostarczyć precyzyjne wyniki, które zadowolą użytkowników.

Szybkie odpowiedzi

  • Jaki jest podstawowy krok, aby rozpocząć wyszukiwanie? Dodaj dokumenty do indeksu za pomocą index.add(...).
  • Jak włączyć wyszukiwanie rozróżniające wielkość liter? Ustaw options.setUseCaseSensitiveSearch(true).
  • Czy można wyszukiwać w wielu katalogach? Tak – wywołaj index.add() dla każdego folderu, który chcesz uwzględnić.
  • Która metoda pozwala na wyszukiwanie przy użyciu obiektów? Użyj SearchQuery.createWordQuery(...).
  • Czy potrzebna jest licencja do testów? Tymczasowa licencja jest dostępna do celów próbnych.

Co oznacza „dodawanie dokumentów do indeksu”?

Dodawanie dokumentów do indeksu oznacza wprowadzenie Twoich plików źródłowych (PDF, dokumenty Word, zwykły tekst itp.) do GroupDocs.Search, aby mógł on zbudować przeszukiwalną strukturę danych. Indeks przechowuje tokenizowane terminy, pozycje i metadane, co pozwala silnikowi wykonywać szybkie zapytania, w tym rozróżniające wielkość liter, oraz efektywnie klasyfikować wyniki.

Dlaczego włączyć wyszukiwanie rozróżniające wielkość liter w Java?

Włączenie wyszukiwania rozróżniającego wielkość liter zapewnia, że silnik odróżnia terminy różniące się jedynie wielkością liter, co jest kluczowe w dziedzinach, w których kapitalizacja ma znaczenie. Umożliwia dokładne dopasowanie terminu, wspiera wymogi zgodności regulacyjnej oraz poprawia trafność, zwracając wyniki, które precyzyjnie odpowiadają wielkości liter w zapytaniu użytkownika.

  • Dokładne dopasowanie terminu – np. „Apple” (firma) vs. „apple” (owoc).
  • Zgodność regulacyjna – wiele branż wymaga precyzyjnego dopasowania fraz.
  • Poprawiona trafność – użytkownicy techniczni i prawniczy często oczekują wyników zależnych od wielkości liter.

Wymagania wstępne

  • JDK 17 lub nowszy (zalecane)
  • Maven do zarządzania zależnościami
  • IDE, takie jak IntelliJ IDEA lub Eclipse
  • Podstawowa znajomość programowania w Java

Konfiguracja GroupDocs.Search dla Java

Poniższy fragment Maven dodaje repozytorium GroupDocs.Search oraz wymaganą zależność do Twojego projektu.

<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>

Alternatywnie możesz pobrać najnowszą wersję bezpośrednio z GroupDocs.Search for Java releases.

Licencjonowanie

Aby rozpocząć próbę, odwiedź stronę GroupDocs i zdobądź tymczasową licencję. Pozwoli to przetestować wszystkie funkcje bez ograniczeń.

Jak utworzyć indeks przeszukiwalny Java – wyszukiwanie zapytaniem tekstowym

Krok 1: utwórz indeks i dodaj swoje dokumenty

Klasa Index reprezentuje przeszukiwalny obszar przechowywania na dysku, w którym dokumenty są indeksowane.

String indexFolder = YOUR_OUTPUT_DIRECTORY + "/CaseSensitiveSearch/QueryInTextForm";
Index index = new Index(indexFolder);
index.add(YOUR_DOCUMENT_DIRECTORY); // Add documents to the index

Wskazówka: Możesz wywołać index.add() wielokrotnie, aby wyszukiwać w wielu katalogach w jednym indeksie.

Krok 2: włącz wyszukiwanie rozróżniające wielkość liter

SearchOptions konfiguruje sposób przetwarzania zapytań, w tym rozróżnianie wielkości liter oraz inne zachowania wyszukiwania.

SearchOptions options = new SearchOptions();
options.setUseCaseSensitiveSearch(true);

Krok 3: wykonaj zapytanie tekstowe rozróżniające wielkość liter

SearchQuery buduje obiekt zapytania, który silnik ocenia względem indeksu.

String query = "Advantages";
SearchResult result = index.search(query, options);

// Output results
for (FoundDocument doc : result.getDocuments()) {
    System.out.println("Document: " + doc.getDocumentInfo().getFilePath());
}

Pętla wypisuje pełną ścieżkę każdego dokumentu, który zawiera dokładnie dopasowany pod względem wielkości liter termin.

Jak utworzyć indeks przeszukiwalny Java – wyszukiwanie zapytaniem obiektowym

Krok 1: zainicjuj drugi indeks (opcjonalnie)

Druga instancja Index może zostać utworzona, aby odizolować wyszukiwania oparte na obiektach od wyszukiwań zwykłego tekstu.

String indexFolder = YOUR_OUTPUT_DIRECTORY + "/CaseSensitiveSearch/QueryInObjectForm";
Index index = new Index(indexFolder);
index.add(YOUR_DOCUMENT_DIRECTORY); // Add documents to the index

Krok 2: ponownie użyj opcji rozróżniania wielkości liter

SearchOptions może być ponownie użyty w różnych typach zapytań, aby zachować spójne traktowanie wielkości liter.

SearchOptions options = new SearchOptions();
options.setUseCaseSensitiveSearch(true);

Krok 3: zbuduj i uruchom zapytanie obiektowe

WordQuery reprezentuje wyszukiwanie na poziomie słowa, które może być łączone z innymi typami zapytań w celu przeprowadzania złożonych wyszukiwań.

SearchQuery query = SearchQuery.createWordQuery("Advantages");
SearchResult result = index.search(query, options);

// Output results
for (FoundDocument doc : result.getDocuments()) {
    System.out.println("Document: " + doc.getDocumentInfo().getFilePath());
}

Użycie createWordQuery pozwala później łączyć je z zapytaniami frazowymi, wieloznacznymi lub logicznymi w bardziej złożonych scenariuszach.

Praktyczne zastosowania

  • Zarządzanie dokumentami prawnymi: Pobieraj przepisy specyficzne dla sprawy, gdzie kapitalizacja ma znaczenie.
  • Platformy e‑commerce: Rozróżniaj SKU produktów, np. „PRO‑X” vs. „pro‑x”.
  • Systemy zarządzania treścią (CMS): Zapewnij autorom znajdowanie dokładnych nagłówków lub tagów.

Wskazówki dotyczące wydajności

  • Utrzymuj indeks aktualny – przeprowadzaj ponowne indeksowanie, gdy dodawane są nowe pliki lub istniejące się zmieniają.
  • Monitoruj zużycie pamięci – duże korpusy korzystają z indeksowania przyrostowego i odpowiedniego przydziału pamięci JVM.
  • Wykorzystaj garbage collector Javy – zwalniaj obiekty Index, gdy nie są już potrzebne.

Typowe problemy i rozwiązania

ProblemRozwiązanie
useCaseSensitiveSearch wydaje się ignorowanySprawdź, czy używasz najnowszej wersji GroupDocs.Search oraz czy indeks został przebudowany po zmianie opcji.
Brak wyników dla znanego terminuUpewnij się, że wielkość liter terminu jest dokładnie dopasowana i że dokument został pomyślnie dodany do indeksu.
Wyszukiwanie w wielu folderach spowalniaDodaj każdy folder osobno przy użyciu index.add() i rozważ podzielenie indeksu na fragmenty przy bardzo dużych zestawach danych.

Najczęściej zadawane pytania

Q: Jak radzić sobie z dużymi zestawami danych w GroupDocs.Search?
A: Wykorzystaj partycjonowanie indeksu, dostosuj ustawienia pamięci JVM i okresowo kompaktuj indeks, aby utrzymać optymalną wydajność.

Q: Czy mogę wyszukiwać jednocześnie w wielu katalogach?
A: Tak – wywołaj index.add() dla każdego katalogu, który chcesz uwzględnić, a następnie uruchom jedno zapytanie przeciwko połączonemu indeksowi.

Q: Jakie są typowe pułapki przy konfigurowaniu wyszukiwania rozróżniającego wielkość liter?
A: Zapominanie o przebudowie indeksu po włączeniu useCaseSensitiveSearch lub używanie niewłaściwej wielkości liter w ciągu zapytania.

Q: Jak mogę rozwiązywać problemy z błędami wyszukiwania?
A: Sprawdź pliki logów generowane przez GroupDocs.Search pod kątem śladów stosu i potwierdź, że wszystkie zależności Maven zostały poprawnie rozwiązane.

Q: Czy GroupDocs.Search jest odpowiedni dla aplikacji w czasie rzeczywistym?
A: Przy odpowiednich strategiach indeksowania (przyrostowe aktualizacje i buforowanie w pamięci) może dostarczać wyniki wyszukiwania bliskie czasie rzeczywistym.

Zasoby


Ostatnia aktualizacja: 2026-08-10
Testowano z: GroupDocs.Search 25.4
Autor: GroupDocs

Powiązane samouczki