Dodawanie wielu aliasów i dodawanie dokumentów do indeksu w GroupDocs.Search Java: Kompletny przewodnik

W dzisiejszym świecie napędzanym danymi możliwość dodawania wielu aliasów podczas dodawania dokumentów do indeksu daje Twojemu rozwiązaniu wyszukiwania wyraźną przewagę wydajnościową. Niezależnie od tego, czy indeksujesz tysiące umów, katalogi produktów czy publikacje naukowe, GroupDocs.Search dla Javy pozwala tworzyć indeksy przeszukiwalne oraz precyzyjnie dostrajać zapytania przy użyciu słowników aliasów — wszystko przy zachowaniu prostej i szybkiej implementacji.

Szybkie odpowiedzi

• Jaki jest pierwszy krok, aby rozpocząć korzystanie z GroupDocs.Search? Dodaj zależność Maven i zainicjalizuj obiekt Index.
• Jak dodać dokumenty do indeksu? Wywołaj index.add("<folder_path>") podając folder zawierający Twoje pliki.
• Czy mogę tworzyć aliasy dla złożonych zapytań? Tak — użyj słownika aliasów, aby mapować krótkie tokeny na pełne wyrażenia zapytań, a także możesz dodawać wiele aliasów jednorazowo.
• Czy można eksportować i importować słowniki aliasów? Oczywiście — użyj metod exportDictionary i importDictionary.
• Jakiej wersji GroupDocs.Search potrzebuję? Wersja 25.4 lub nowsza (tutorial używa wersji 25.4).

Co oznacza „dodawanie dokumentów do indeksu”?

Dodawanie dokumentów do indeksu oznacza wprowadzanie surowych plików (PDF, DOCX, TXT itp.) do GroupDocs.Search, aby biblioteka mogła analizować ich zawartość i tworzyć indeks przeszukiwalny. Po zaindeksowaniu możesz wykonywać szybkie zapytania pełnotekstowe we wszystkich tych dokumentach.

Dlaczego zarządzać aliasami?

Aliasom pozwala zastąpić długie, powtarzalne fragmenty zapytań krótkimi, łatwymi do zapamiętania tokenami (np. @t → (gravida OR promotion)). Dzięki temu nie tylko skracasz ciągi wyszukiwania, ale także poprawiasz czytelność, utrzymanie i optymalizujesz wydajność wyszukiwania, szczególnie gdy zapytania stają się złożone.

Jak dodać wiele aliasów?

GroupDocs.Search udostępnia wygodną metodę addRange, która pozwala wstawić wiele par alias‑wartość jednocześnie. Ta operacja zbiorcza zmniejsza narzut w porównaniu do dodawania każdego aliasu osobno.

Wymagania wstępne

• GroupDocs.Search for Java ≥ 25.4.
• JDK (dowolna aktualna wersja, np. 11+).
• IDE, takie jak IntelliJ IDEA lub Eclipse.
• Podstawowa znajomość Javy i Maven.

Konfiguracja GroupDocs.Search dla Java

Korzystanie z Maven

Dodaj repozytorium i zależność do swojego pom.xml:

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

Bezpośrednie pobranie

Alternatywnie, pobierz najnowszy plik JAR z oficjalnej strony:
GroupDocs.Search for Java releases.

Kroki uzyskania licencji

1. Free Trial – przetestuj wszystkie funkcje bez zobowiązań.
2. Temporary License – poproś o krótkoterminowy klucz do oceny.
3. Full Purchase – uzyskaj stałą licencję do użytku produkcyjnego.

Podstawowa inicjalizacja i konfiguracja

import com.groupdocs.search.Index;

public class GroupDocsSetup {
    public static void main(String[] args) {
        // Specify the directory to store indices
        String indexFolder = "YOUR_DOCUMENT_DIRECTORY/Indexes/Index";
        
        // Create or open an index
        Index index = new Index(indexFolder);
        
        System.out.println("GroupDocs.Search setup complete.");
    }
}

Przewodnik implementacji

Poniżej znajduje się pełny przewodnik po każdej funkcji. Najpierw przeczytaj wyjaśnienia, a następnie skopiuj odpowiedni blok kodu.

Tworzenie lub otwieranie indeksu

Jak dodać dokumenty do indeksu – najpierw potrzebujesz aktywnej instancji Index.

Krok 1: Importuj klasę Index

import com.groupdocs.search.Index;

Krok 2: Określ, gdzie będą przechowywane pliki indeksu

String indexFolder = "YOUR_DOCUMENT_DIRECTORY/Indexes/Index";

Krok 3: Utwórz nowy indeks lub otwórz istniejący

Index index = new Index(indexFolder);

Dodawanie dokumentów do indeksu

Teraz, gdy indeks istnieje, dodajmy dokumenty do indeksu.

Krok 1: Wskaż folder źródłowy

String documentsFolder = "YOUR_DOCUMENT_DIRECTORY/Documents";

Krok 2: Dodaj wszystkie obsługiwane pliki z tego folderu

index.add(documentsFolder);

Wskazówka: Uruchamiaj ten krok za każdym razem, gdy pojawią się nowe pliki. GroupDocs.Search zaindeksuje tylko nową zawartość, pozostawiając istniejące wpisy niezmienione. To jest istota incremental indexing java.

Zarządzanie słownikiem aliasów

Aliasom pozwala mapować krótkie tokeny na złożone ciągi zapytań. Omówimy czyszczenie istniejących wpisów, dodawanie pojedynczych aliasów oraz dodawanie wielu aliasów jednorazowo.

Czyszczenie istniejących aliasów

if (index.getDictionaries().getAliasDictionary().getCount() > 0) {
    index.getDictionaries().getAliasDictionary().clear();
}

Dodawanie pojedynczych aliasów

index.getDictionaries().getAliasDictionary().add("t", "(gravida OR promotion)");
index.getDictionaries().getAliasDictionary().add("e", "(viverra OR farther)");

Dodawanie wielu aliasów

AliasReplacementPair[] pairs = new AliasReplacementPair[] {
    new AliasReplacementPair("d", "daterange(2017-01-01 ~~ 2019-12-31)"),
    new AliasReplacementPair("n", "(400 ~~ 4000)")
};
index.getDictionaries().getAliasDictionary().addRange(pairs);

Zapytania o zamiany aliasów

Możesz pobrać pełny tekst dla dowolnego zdefiniowanego aliasu:

if (index.getDictionaries().getAliasDictionary().contains("e")) {
    String replacement = index.getDictionaries().getAliasDictionary().getText("e");
}

Eksport i import słownika aliasów

Eksport jest przydatny do tworzenia kopii zapasowych lub udostępniania między środowiskami.

Eksport aliasów

String fileName = "YOUR_OUTPUT_DIRECTORY/Aliases.dat";
index.getDictionaries().getAliasDictionary().exportDictionary(fileName);

Import aliasów

index.getDictionaries().getAliasDictionary().importDictionary(fileName);

Wyszukiwanie przy użyciu zapytań aliasowych

Po wprowadzeniu aliasów Twoje ciągi wyszukiwania stają się znacznie czytelniejsze:

String query = "@t OR @e";
SearchResult result = index.search(query);

Symbol @ informuje GroupDocs.Search, aby przed wykonaniem wyszukiwania zastąpił token jego pełnym wyrażeniem.

Praktyczne zastosowania

Uwagi dotyczące wydajności

• Incremental Indexing: Dodawaj tylko nowe lub zmienione pliki; unikaj pełnego ponownego indeksowania.
• JVM Tuning: Przydziel wystarczającą pamięć heap (-Xmx4g dla dużych korpusów).
• Batch Alias Updates: Użyj addRange, aby wstawić wiele aliasów jednocześnie, zmniejszając narzut.
• Optimize Search Performance: Utrzymuj słownik aliasów w zwięzłej formie i mądrze ponownie używaj tokenów, aby zminimalizować czas parsowania zapytań.

Typowe problemy i rozwiązania

Najczęściej zadawane pytania

Q: Jaka jest główna korzyść z używania GroupDocs.Search dla Java?
A: Dostarcza potężne, gotowe do użycia możliwości indeksowania i wyszukiwania pełnotekstowego, umożliwiając szybkie dodawanie dokumentów do indeksu i zapytania z wysoką wydajnością.

Q: Czy mogę używać GroupDocs.Search z bazami danych?
A: Tak — wyodrębnij dane z dowolnego źródła (SQL, NoSQL, CSV) i wprowadź je do indeksu przy użyciu tych samych metod add.

Q: Jak aliasy poprawiają wydajność wyszukiwania?
A: Aliasom pozwala przechowywać złożoną logikę zapytań raz i ponownie używać jej za pomocą krótkich tokenów, co skraca czas parsowania zapytań i minimalizuje błędy ludzkie podczas wyszukiwania z aliasami.

Q: Czy można zaktualizować istniejący alias bez przebudowywania całego słownika?
A: Oczywiście — po prostu wywołaj add z tym samym kluczem; biblioteka nadpisze poprzednią wartość.

Q: Co zrobić, gdy wyszukiwanie zwraca nieoczekiwane wyniki?
A: Sprawdź, czy definicje aliasów są poprawne, ponownie zaindeksuj nowo dodane dokumenty i zweryfikuj ustawienia analizatora pod kątem problemów z tokenizacją.

Ostatnia aktualizacja: 2026-03-06
Testowano z: GroupDocs.Search 25.4 dla Java
Autor: GroupDocs