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
| Problem | Rozwiązanie |
|---|---|
useCaseSensitiveSearch wydaje się ignorowany | Sprawdź, czy używasz najnowszej wersji GroupDocs.Search oraz czy indeks został przebudowany po zmianie opcji. |
| Brak wyników dla znanego terminu | Upewnij się, że wielkość liter terminu jest dokładnie dopasowana i że dokument został pomyślnie dodany do indeksu. |
| Wyszukiwanie w wielu folderach spowalnia | Dodaj 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
- Dokumentacja: GroupDocs.Search Java Docs
- Referencja API: Java API Reference
- Pobieranie: Latest Releases
- Repozytorium GitHub: GroupDocs.Search for Java
- Forum wsparcia: GroupDocs Free Support
- Tymczasowa licencja: Acquire a Temporary License
Ostatnia aktualizacja: 2026-08-10
Testowano z: GroupDocs.Search 25.4
Autor: GroupDocs