Cara menambahkan folder ke indeks dengan GroupDocs.Search di Java
Jika Anda membutuhkan java full text search yang dapat diskalakan hingga jutaan dokumen, Anda berada di tempat yang tepat. Dalam tutorial ini Anda akan belajar cara menambahkan folder ke indeks menggunakan GroupDocs.Search, mengonfigurasi penyimpanan kompresi tinggi, dan menjalankan kueri super cepat. Pada akhir tutorial Anda akan memiliki solusi siap produksi yang dapat Anda masukkan ke proyek Java mana pun.
Jawaban Cepat
- Apa perpustakaan utama? GroupDocs.Search for Java
- Bagaimana cara menambahkan folder ke indeks? Use
index.add(folderPath) - Apakah saya dapat mengonfigurasi kompresi teks? Yes, via
TextStorageSettings(Compression.High) - Versi Java apa yang diperlukan? JDK 8 or higher
- Di mana mendapatkan lisensi percobaan? From the GroupDocs website or the repository page
Apa itu java full text search dan mengapa penting?
Java full text search mengubah dokumen mentah menjadi indeks terbalik, memungkinkan pengambilan istilah dalam hitungan sub‑detik di antara ribuan file. Kemampuan ini penting untuk repositori hukum, perpustakaan riset, dan basis pengetahuan perusahaan di mana pengguna mengharapkan hasil instan. Ini juga meningkatkan produktivitas dalam aplikasi modern.
Mengapa menggunakan groupdocs.search untuk java full text search?
GroupDocs.Search menyediakan pengindeksan dan eksekusi kueri dengan throughput tinggi sambil menawarkan kompresi tinggi bawaan. Ia mendukung lebih dari 50 format input dan output—termasuk PDF, DOCX, EML, dan HTML—dan dapat memproses dokumen berukuran ratusan halaman tanpa memuat seluruh file ke memori, menjaga jejak memori di bawah 200 MB untuk beban kerja tipikal.
Prasyarat
- GroupDocs.Search for Java (version 25.4 atau lebih baru) – perpustakaan inti yang menggerakkan pengindeksan dan pencarian.
- JDK 8+ terpasang dan dikonfigurasi – runtime minimum yang diperlukan untuk SDK.
- Maven untuk manajemen dependensi – mempermudah menambahkan perpustakaan ke proyek Anda.
- IDE seperti IntelliJ IDEA atau Eclipse – untuk menulis dan men-debug kode Java.
Menyiapkan GroupDocs.Search untuk java
Pengaturan Maven
Tambahkan repositori dan dependensi ke file 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
Sebagai alternatif, unduh versi terbaru dari GroupDocs.Search for Java releases.
Akuisisi Lisensi
- Free trial – jelajahi semua fitur tanpa komitmen.
- Temporary license – periode pengujian yang diperpanjang.
- Purchase – membuka semua kemampuan produksi.
Inisialisasi dan Pengaturan Dasar
Index adalah kelas inti yang digunakan untuk membuat, membuka, dan mengelola indeks pencarian.
import com.groupdocs.search.Index;
public class InitializeSearch {
public static void main(String[] args) {
// Path to store index data
String indexPath = "path/to/index";
// Creating an index at specified location
Index index = new Index(indexPath);
System.out.println("GroupDocs.Search initialized successfully!");
}
}
Mengindeks teks dengan kompresi khusus
Langkah 1: definisikan folder indeks
Pilih direktori tempat file indeks akan disimpan:
String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Indexing\\StoringTextOfIndexedDocuments";
Langkah 2: konfigurasikan pengaturan indeks
TextStorageSettings mengonfigurasi cara teks disimpan dalam indeks, termasuk tingkat kompresi. Compression adalah enum yang menentukan algoritma kompresi yang diinginkan.
import com.groupdocs.search.Index;
import com.groupdocs.search.IndexSettings;
import com.groupdocs.search.options.TextStorageSettings;
import com.groupdocs.search.compression.Compression;
IndexSettings settings = new IndexSettings();
settings.setTextStorageSettings(new TextStorageSettings(Compression.High));
Langkah 3: buat indeks dengan pengaturan khusus
Instansiasi indeks menggunakan konfigurasi yang didefinisikan di atas:
Index index = new Index(indexFolder, settings);
System.out.println("Index created with high compression.");
Cara menambahkan folder ke indeks
Index adalah kelas utama yang mewakili indeks yang dapat dicari.
Muat indeks yang ada (atau buat yang baru) lalu panggil metode add pada objek Index. Operasi add memindai direktori yang diberikan, mengekstrak teks dari setiap file yang didukung, dan menyimpannya dalam indeks terkompresi, siap untuk pencarian instan.
String documentsFolder = "YOUR_DOCUMENT_DIRECTORY"; // Replace with actual document path.
Index index = new Index(indexFolder);
Cara mencari dokumen yang diindeks
SearchResult mewakili satu kecocokan dengan jalur dokumen dan relevansi.
Definisikan string kueri pencarian yang mewakili istilah atau frasa yang ingin Anda temukan, lalu panggil metode search pada instance Index. Metode ini mengembalikan koleksi objek SearchResult, masing-masing berisi jalur dokumen, skor relevansi, dan potongan teks yang menyoroti kecocokan.
index.add(documentsFolder);
System.out.println("Documents added successfully.");
Aplikasi Praktis
Skenario dunia nyata di mana java full text search bersinar:
- Manajemen dokumen hukum – pengambilan berkas kasus secara instan.
- Perpustakaan riset akademik – pencarian cepat makalah dan tesis.
- Basis pengetahuan perusahaan – akses cepat ke manual dan FAQ.
- Sistem manajemen konten – penemuan konten yang efisien untuk situs besar.
- Arsip layanan pelanggan – pencarian cepat tiket dan percakapan sebelumnya.
Pertimbangan Kinerja
- Kompresi vs. kecepatan: Kompresi tinggi menghemat hingga 70 % ruang disk tetapi menambah overhead pengindeksan yang sedang; jalankan tes benchmark untuk volume data Anda.
- Manajemen memori: Alokasikan setidaknya 2 GB heap untuk indeks yang lebih besar dari 10 GB guna menghindari
OutOfMemoryError. - Pembaruan indeks: Tambahkan dokumen baru secara inkremental dengan
index.add()dan secara berkala panggilindex.optimize()untuk menjaga indeks tetap kompak. - Optimasi kueri: Gunakan sintaks kueri lanjutan (wildcard, proximity, fuzzy search) untuk mempersempit hasil dan mengurangi waktu respons.
Kesalahan Umum & Tips Pro
Kesalahan: Lupa memanggil
index.optimize()setelah penambahan massal.
Tips pro: Jalankanindex.optimize()setiap malam untuk menjaga indeks tetap kompak.Kesalahan: Menggunakan kompresi default (rendah) pada dataset besar.
Tips pro: Beralih keCompression.Highuntuk lingkungan produksi guna mengurangi biaya penyimpanan.Kesalahan: Tidak menangani
IOExceptionsaat menambahkan file dari jaringan bersama.
Tips pro: Bungkusindex.add()dalam blok try‑catch dan log setiap kegagalan untuk ditinjau nanti.
Pertanyaan yang Sering Diajukan
Q: Apa itu GroupDocs.Search?
A: Ini adalah perpustakaan Java yang kuat yang menyediakan kemampuan pencarian teks penuh lanjutan, termasuk pengindeksan, kompresi, dan dukungan kueri kompleks.
Q: Bagaimana cara menangani dataset besar dengan GroupDocs.Search?
A: Aktifkan kompresi tinggi (Compression.High) dan secara berkala commit perubahan untuk menjaga indeks tetap ramping. Juga, alokasikan memori heap yang cukup (mis., 4 GB untuk indeks di atas 20 GB).
Q: Bisakah saya mengintegrasikan GroupDocs.Search dengan sistem perusahaan yang ada?
A: Ya, perpustakaan ini dapat disematkan dalam backend berbasis Java apa pun, layanan REST, atau arsitektur mikro‑service.
Q: Bagaimana jika indeks saya menjadi usang?
A: Gunakan metode index.add() untuk menambahkan file baru dan index.delete() untuk menghapus yang usang, lalu jalankan kembali index.optimize() jika diperlukan.
Q: Di mana saya dapat mendapatkan bantuan atau dukungan?
A: Kunjungi forum komunitas di GroupDocs forums untuk pemecahan masalah dan tips praktik terbaik.
Sumber Daya Tambahan
- Panduan penggunaan detail: GroupDocs Search Documentation
- Referensi API lengkap: API Reference Guide
- Tetap up‑to‑date dengan fitur baru: Latest Releases
Terakhir Diperbarui: 2026-11-02
Diuji Dengan: GroupDocs.Search 25.4
Penulis: GroupDocs
String query = "sample";
import com.groupdocs.search.results.SearchResult;
SearchResult result = index.search(query);
System.out.println("Search completed. Results found: " + result.getDocumentCount());