Cara melakukan pencarian metadata dengan GroupDocs di Java

Menambahkan dokumen ke indeks dengan cepat dan andal adalah tulang punggung setiap aplikasi modern yang didorong oleh pencarian. Baik Anda membangun repositori hukum, basis pengetahuan dukungan pelanggan, atau portal dokumen internal, metadata search with GroupDocs memungkinkan Anda menemukan file berdasarkan penulis, judul, atau tag khusus apa pun tanpa memindai konten teks penuh. Dalam tutorial ini Anda akan belajar cara mengonfigurasi pengaturan indeks, membuat indeks yang berfokus pada metadata, menambahkan file Anda, dan menjalankan pencarian yang tepat—semua dengan GroupDocs.Search untuk Java.

Jawaban Cepat

  • Apa tujuan utama pengindeksan metadata? Itu memungkinkan pencarian cepat berdasarkan properti dokumen daripada konten teks penuh.
  • Metode mana yang menambahkan file ke indeks? index.add(YOUR_DOCUMENTS_FOLDER);
  • Apakah saya dapat mencari berdasarkan bidang metadata khusus? Ya, setelah bidang tersebut diindeks Anda dapat menanyakan mereka secara langsung.
  • Apakah saya memerlukan lisensi untuk pengembangan? Lisensi percobaan sementara cukup untuk evaluasi; lisensi penuh diperlukan untuk produksi.
  • Versi Java apa yang diperlukan? JDK 8 atau lebih tinggi disarankan.

Apa itu pengindeksan metadata di GroupDocs.Search?

Pengindeksan metadata mengekstrak dan menyimpan atribut dokumen (mis., penulis, tanggal pembuatan, tag khusus) dalam struktur yang dapat dicari. Ketika Anda menambahkan dokumen ke indeks, mesin mencatat atribut-atribut ini, memungkinkan Anda menjalankan kueri yang tepat seperti “temukan semua PDF yang ditulis oleh John Doe” atau “cari PDF berdasarkan penulis”.

Mengapa menggunakan GroupDocs.Search untuk pengindeksan metadata?

Pencarian metadata dengan GroupDocs memberikan waktu respons ringan, kurang dari satu detik bahkan ketika indeks berisi jutaan catatan. Ini mendukung lebih dari 30 format input dan output—termasuk PDF, DOCX, PPTX, HTML, dan file gambar—dan menggunakan kurang dari 200 MB memori heap untuk indeks 100 000 dokumen pada server tipikal.

Prasyarat

  • GroupDocs.Search untuk Java ≥ 25.4.
  • JDK 8 atau yang lebih baru terpasang dan dikonfigurasi.
  • Familiaritas dasar dengan Java dan Maven.

Menyiapkan GroupDocs.Search untuk Java

Instruksi Instalasi

Tambahkan repositori GroupDocs 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>

Anda juga dapat mengunduh binari terbaru langsung dari GroupDocs.Search for Java releases.

Akuisisi Lisensi

Untuk mendapatkan lisensi sementara untuk pengujian:

  1. Kunjungi situs web GroupDocs dan buka bagian Purchase.
  2. Pilih paket temporary license yang sesuai dengan kebutuhan evaluasi Anda.

Cara mengonfigurasi pengaturan indeks untuk metadata?

Mengonfigurasi pengaturan indeks memberi tahu mesin informasi apa yang akan diekstrak dan disimpan. Dengan mengatur tipe indeks ke MetadataIndex, Anda menginstruksikan GroupDocs.Search untuk fokus pada bidang metadata daripada konten teks penuh, yang mengurangi ukuran indeks dan mempercepat kueri. Konfigurasi ini diterapkan melalui objek IndexSettings, di mana Anda juga dapat menentukan bidang metadata khusus yang akan diindeks.

IndexSettings settings = new IndexSettings();
settings.setIndexType(IndexType.MetadataIndex);

Fitur 1: konfigurasi pengaturan indeks

Pemanggilan setIndexType(IndexType.MetadataIndex) memberi tahu mesin untuk fokus pada metadata daripada konten teks penuh. IndexType.MetadataIndex adalah nilai enumerasi yang memilih mode pengindeksan hanya metadata.

import com.groupdocs.search.IndexSettings;
import com.groupdocs.search.IndexType;

// Initialize index settings
IndexSettings settings = new IndexSettings();
settings.setIndexType(IndexType.MetadataIndex);  // Focus on metadata indexing

Fitur 2: membuat indeks di folder yang ditentukan

Buat direktori indeks fisik di mana semua metadata akan disimpan:

import com.groupdocs.search.Index;

String YOUR_INDEX_DIRECTORY = "YOUR_DOCUMENT_DIRECTORY\\\\output\\\\AdvancedUsage\\\\Indexing\\\\IndexingMetadataOfDocuments";

// Create index in specified directory using settings
Index index = new Index(YOUR_INDEX_DIRECTORY, settings);

Ganti YOUR_DOCUMENT_DIRECTORY dengan jalur yang sesuai dengan tata letak proyek Anda.

Fitur 3: Cara menambahkan dokumen ke indeks

Metode index.add menambahkan file dari folder ke indeks dan mengekstrak metadata mereka. index.add memindai setiap dokumen, membaca bidang metadata yang didukung, dan menyimpannya di indeks untuk pengambilan cepat.

String YOUR_DOCUMENTS_FOLDER = "YOUR_DOCUMENT_DIRECTORY";

// Add all documents in directory to the index
index.add(YOUR_DOCUMENTS_FOLDER);

Tips:

  • Pastikan jalur folder benar dan aplikasi memiliki izin baca.
  • GroupDocs.Search secara otomatis mengekstrak metadata yang didukung dari setiap file.

Fitur 4: Mencari dokumen berdasarkan metadata

Jalankan kueri yang menargetkan bidang metadata, misalnya mencari dokumen di mana bahasa adalah English:

import com.groupdocs.search.results.SearchResult;

String query = "English";  // Define search query
SearchResult result = index.search(query);  // Perform the search

// Process results (example)
for (int i = 0; i < result.getDocumentCount(); i++) {
    System.out.println("Found document: " + result.getFoundDocument(i).getFilePath());
}

Metode search(query) mencari melalui metadata yang diindeks dan mengembalikan dokumen yang cocok. Anda juga dapat search pdf by author dengan menggunakan nama penulis sebagai string kueri.

Aplikasi Praktis

  1. Manajemen dokumen perusahaan: Mengambil kontrak berdasarkan tanggal kontrak atau nama penandatangan.
  2. Katalog perpustakaan digital: Membiarkan pengguna menelusuri buku berdasarkan genre, tahun publikasi, atau penulis.
  3. Sistem CRM: Dengan cepat menemukan file klien menggunakan metadata khusus seperti ID pelanggan atau wilayah.

Tips dan praktik terbaik

  • Pembaruan inkremental: Gunakan index.addOrUpdate() untuk file baru atau yang berubah alih-alih membangun ulang seluruh indeks.
  • Pemrosesan batch: Saat menangani ribuan file, tambahkan mereka dalam batch lebih kecil untuk menjaga penggunaan memori tetap rendah.
  • Validasi metadata: Pastikan dokumen sumber benar-benar berisi metadata yang ingin Anda kueri (mis., bidang penulis dalam PDF).

Pertimbangan Kinerja

  • Penyesuaian memori: Sesuaikan ukuran heap JVM (-Xmx) berdasarkan volume metadata yang diindeks.
  • Penyimpanan teroptimasi: Secara periodik panggil index.optimize() untuk memadatkan indeks dan meningkatkan kecepatan kueri.

Masalah umum dan solusi

MasalahSolusi
Tidak ada hasil yang dikembalikanPastikan bahwa bidang metadata yang Anda harapkan memang ada dalam file sumber.
Kesalahan izinPastikan proses Java memiliki akses baca ke folder dokumen dan direktori indeks.
Kesalahan out‑of‑memoryTingkatkan ukuran heap JVM atau lakukan batch pada operasi add untuk memproses file dalam grup yang lebih kecil.

Pertanyaan yang sering diajukan

Q: Apa itu pengindeksan metadata?
A: Pengindeksan metadata menyimpan atribut dokumen (penulis, judul, tag khusus) dalam struktur yang dapat dicari, memungkinkan pencarian cepat tanpa memindai teks penuh.

Q: Bagaimana cara mendapatkan lisensi sementara?
A: Kunjungi halaman pembelian GroupDocs dan ikuti langkah-langkah untuk memperoleh lisensi percobaan.

Q: Bisakah saya mengindeks PDF dengan pengaturan ini?
A: Ya, GroupDocs.Search mendukung PDF, DOCX, PPT, dan banyak format lainnya.

Q: Apa masalah umum saat menambahkan dokumen?
A: Verifikasi jalur file yang benar dan pastikan aplikasi memiliki izin baca untuk direktori.

Q: Bagaimana cara mengoptimalkan kinerja pencarian?
A: Secara teratur perbarui indeks Anda, gunakan penambahan inkremental, dan sesuaikan pengaturan memori JVM.

Sumber Daya


Terakhir Diperbarui: 2026-10-22
Diuji Dengan: GroupDocs.Search Java 25.4
Penulis: GroupDocs

Tutorial Terkait