Menambahkan Dokumen ke Indeks dan Manajemen Alias di GroupDocs.Search Java: Panduan Komprehensif

Di dunia yang didorong oleh data saat ini, kemampuan untuk add documents to index dengan cepat dan mencarinya secara efisien dapat memberi bisnis Anda keunggulan kompetitif yang nyata. Baik Anda menangani ribuan kontrak, katalog produk, atau makalah penelitian, GroupDocs.Search untuk Java memudahkan pembuatan indeks yang dapat dicari dan penyetelan kueri dengan kamus alias.

Di bawah ini Anda akan menemukan semua yang diperlukan untuk menyiapkan pustaka, add documents to index, mengelola alias, dan menjalankan pencarian yang kuat—semua dijelaskan dalam gaya langkah‑demi‑langkah yang ramah.

Jawaban Cepat

• Apa langkah pertama untuk mulai menggunakan GroupDocs.Search? Tambahkan dependensi Maven dan inisialisasi objek Index.
• Bagaimana cara menambahkan dokumen ke indeks? Panggil index.add("<folder_path>") dengan folder yang berisi file Anda.
• Apakah saya dapat membuat alias untuk kueri kompleks? Ya—gunakan kamus alias untuk memetakan token pendek ke ekspresi kueri lengkap.
• Apakah memungkinkan mengekspor dan mengimpor kamus alias? Tentu saja—gunakan metode exportDictionary dan importDictionary.
• Versi GroupDocs.Search apa yang diperlukan? Versi 25.4 atau yang lebih baru (tutorial ini menggunakan 25.4).

Apa itu “add documents to index”?

Menambahkan dokumen ke indeks berarti memasukkan file mentah (PDF, DOCX, TXT, dll.) ke dalam GroupDocs.Search sehingga pustaka dapat menganalisis kontennya dan membangun struktur data yang dapat dicari. Setelah diindeks, Anda dapat menjalankan kueri teks penuh yang cepat di seluruh dokumen tersebut.

Mengapa Mengelola Alias?

Alias memungkinkan Anda mengganti fragmen kueri yang panjang dan berulang dengan token pendek yang mudah diingat (misalnya, @t → (gravida OR promotion)). Ini tidak hanya mempersingkat string pencarian Anda tetapi juga meningkatkan keterbacaan dan pemeliharaan, terutama ketika kueri menjadi kompleks.

Prasyarat

Sebelum kita melanjutkan, pastikan Anda memiliki:

• GroupDocs.Search untuk Java ≥ 25.4.
• JDK (versi terbaru, misalnya 11+).
• IDE seperti IntelliJ IDEA atau Eclipse.
• Pengetahuan dasar tentang Java dan Maven.

Menyiapkan GroupDocs.Search untuk Java

Menggunakan Maven

Tambahkan repositori dan dependensi ke pom.xml Anda:

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

Unduhan Langsung

Atau, unduh JAR terbaru dari situs resmi:
GroupDocs.Search for Java releases.

Langkah‑Langkah Akuisisi Lisensi

1. Free Trial – jelajahi semua fitur tanpa komitmen.
2. Temporary License – minta kunci jangka pendek untuk evaluasi.
3. Full Purchase – dapatkan lisensi permanen untuk penggunaan produksi.

Inisialisasi dan Pengaturan Dasar

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.");
    }
}

Panduan Implementasi

Berikut adalah walkthrough lengkap untuk setiap fitur. Bacalah penjelasan terlebih dahulu, kemudian salin blok kode yang sesuai.

Membuat atau Membuka Indeks

Cara menambahkan dokumen ke indeks – pertama Anda memerlukan instance Index yang aktif.

Langkah 1: Impor kelas Index

import com.groupdocs.search.Index;

Langkah 2: Tentukan lokasi file indeks

String indexFolder = "YOUR_DOCUMENT_DIRECTORY/Indexes/Index";

Langkah 3: Buat indeks baru atau buka yang sudah ada

Index index = new Index(indexFolder);

Menambahkan Dokumen ke Indeks

Setelah indeks ada, mari add documents to index.

Langkah 1: Arahkan ke folder sumber Anda

String documentsFolder = "YOUR_DOCUMENT_DIRECTORY/Documents";

Langkah 2: Tambahkan setiap file yang didukung dari folder tersebut

index.add(documentsFolder);

Pro tip: Jalankan langkah ini setiap kali file baru tiba. GroupDocs.Search hanya akan mengindeks konten baru, meninggalkan entri yang sudah ada tidak berubah.

Mengelola Kamus Alias

Alias memungkinkan Anda memetakan token pendek ke string kueri yang kompleks. Kami akan membahas menghapus entri lama, menambahkan alias tunggal, dan add multiple aliases secara massal.

Menghapus Alias yang Ada

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

Menambahkan Alias Tunggal

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

Menambahkan Banyak Alias

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

Menanyakan Penggantian Alias

Anda dapat mengambil teks lengkap untuk alias apa pun yang telah Anda definisikan:

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

Mengekspor dan Mengimpor Kamus Alias

Mengekspor berguna untuk pencadangan atau berbagi lintas lingkungan.

Ekspor Alias

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

Impor Alias

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

Mencari Menggunakan Kuery Alias

Dengan alias yang sudah ada, string pencarian Anda menjadi jauh lebih bersih:

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

Simbol @ memberi tahu GroupDocs.Search untuk mengganti token dengan ekspresi lengkapnya sebelum mengeksekusi pencarian.

Aplikasi Praktis

Pertimbangan Kinerja

• Incremental Indexing: Tambahkan hanya file baru atau yang berubah; hindari pengindeksan ulang penuh.
• JVM Tuning: Alokasikan memori heap yang cukup (-Xmx4g untuk korpus besar).
• Batch Alias Updates: Gunakan addRange untuk menyisipkan banyak alias sekaligus, mengurangi beban.

Kesimpulan

Anda kini tahu cara add documents to index, mengelola kamus alias, dan menjalankan pencarian efisien dengan GroupDocs.Search untuk Java. Teknik ini akan membuat aplikasi berbasis pencarian Anda lebih cepat, lebih mudah dipelihara, dan lebih ramah bagi pengguna akhir.

Langkah selanjutnya: Bereksperimen dengan analyzer khusus, jelajahi opsi pencarian fuzzy, dan integrasikan indeks ke layanan web untuk kueri waktu nyata.

Pertanyaan yang Sering Diajukan

T: Apa manfaat utama menggunakan GroupDocs.Search untuk Java?
J: Ia menyediakan kemampuan pengindeksan dan pencarian teks penuh yang kuat, siap pakai, memungkinkan Anda add documents to index dengan cepat dan menanyakan mereka dengan kinerja tinggi.

T: Bisakah saya menggunakan GroupDocs.Search dengan basis data?
J: Ya—ekstrak data dari sumber apa pun (SQL, NoSQL, CSV) dan masukkan ke indeks menggunakan metode add yang sama.

T: Bagaimana alias meningkatkan efisiensi pencarian?
J: Alias memungkinkan Anda menyimpan logika kueri kompleks sekali dan menggunakannya kembali dengan token pendek, mengurangi waktu parsing kueri dan meminimalkan kesalahan manusia.

T: Apakah memungkinkan memperbarui alias yang ada tanpa membangun ulang seluruh kamus?
J: Tentu—cukup panggil add dengan kunci yang sama; pustaka akan menimpa nilai sebelumnya.

T: Apa yang harus saya lakukan jika pencarian menghasilkan hasil yang tidak terduga?
J: Periksa kembali definisi alias, lakukan pengindeksan ulang pada dokumen yang baru ditambahkan, dan tinjau pengaturan analyzer untuk masalah tokenisasi.

Terakhir Diperbarui: 2026-01-03
Diuji Dengan: GroupDocs.Search 25.4 untuk Java
Penulis: GroupDocs