دليل البحث حسب السمة Java باستخدام GroupDocs.Search

هل تتطلع إلى تحسين نظام إدارة المستندات الخاص بك عن طريق تعديل سمات المستندات وفهرستها ديناميكيًا باستخدام Java؟ أنت في المكان الصحيح! يغوص هذا الدليل بعمق في الاستفادة من مكتبة GroupDocs.Search for Java القوية للـ search by attribute java، وتغيير سمات المستند المفهرسة، وإضافتها أثناء عملية الفهرسة. سواء كنت تبني بوابة قابلة للبحث، أو أرشيف امتثال، أو تطبيقًا ذكيًا يعتمد على المحتوى، فإن إتقان هذه التقنيات سيوفر لك الوقت ويحسن الأداء.

إجابات سريعة

ما هو “search by attribute java”? إنها القدرة على تصفية نتائج البحث باستخدام بيانات تعريف مخصصة مرفقة بكل مستند.
هل يمكنني تعديل السمات بعد الفهرسة؟ نعم—استخدم AttributeChangeBatch لتحديث سمات المستند دفعةً.
كيف يمكنني إضافة سمات أثناء الفهرسة؟ اشترك في حدث FileIndexing وقم بتعيين السمات برمجيًا.
هل أحتاج إلى ترخيص؟ تجربة مجانية تعمل للتقييم؛ يلزم ترخيص دائم للإنتاج.
ما نسخة Java المطلوبة؟ يوصى بـ Java 8 أو أحدث.

ما هو “search by attribute java”؟

Search by attribute java يتيح لك الاستعلام عن المستندات بناءً على بياناتها الوصفية (السمات) بدلاً من محتواها فقط. من خلال إرفاق أزواج مفتاح‑قيمة مثل public، main، أو key لكل ملف، يمكنك تضييق النتائج بسرعة إلى المجموعة الأكثر صلة.

لماذا نستخدم وضع العلامات الوصفية الديناميكية؟

التصنيف الديناميكي – الحفاظ على تزامن البيانات الوصفية مع قواعد الأعمال المتطورة.
تصفية أسرع – يتم تقييم مرشحات السمات قبل البحث النصي الكامل، مما يسرّع أوقات الاستجابة.
تتبع الامتثال – وضع علامات على المستندات لسياسات الاحتفاظ أو متطلبات التدقيق.
تحديث السمات دفعةً – تغيير العديد من المستندات في عملية واحدة دون إعادة فهرسة كل شيء.

المتطلبات المسبقة

Java 8+ (JDK 8 أو أحدث)
مكتبة GroupDocs.Search for Java (انظر إعداد Maven أدناه)
فهم أساسي لـ Java ومفاهيم الفهرسة

إعداد GroupDocs.Search لـ Java

إعداد Maven

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

التحميل المباشر

بدلاً من ذلك، قم بتحميل أحدث نسخة من GroupDocs.Search for Java releases.
إذا كنت تفضل عدم استخدام أداة بناء مثل Maven، حمّل ملف JAR من موقع GroupDocs.

الحصول على الترخيص

ابدأ بتجربة مجانية لاستكشاف الإمكانات.
للاستخدام الموسع، احصل على ترخيص مؤقت أو كامل عبر صفحة الترخيص.

التهيئة الأساسية

import com.groupdocs.search.Index;

// Initialize an index in a specified directory
Index index = new Index("YOUR_OUTPUT_DIRECTORY/ChangeAttributes");

كيفية تعديل سمات المستند (تحديث دفعي)

Search by Attribute Java – تعديل سمات المستند

يمكنك إضافة أو إزالة أو استبدال السمات على المستندات المفهرسة بالفعل، مما يتيح batch update document attributes دون إعادة فهرسة المجموعة بالكامل.

خطوة بخطوة

الخطوة 1: إضافة المستندات إلى الفهرس

index.add("YOUR_DOCUMENT_DIRECTORY");

الخطوة 2: استرجاع معلومات المستند المفهرس

import com.groupdocs.search.results.DocumentInfo;

DocumentInfo[] documents = index.getIndexedDocuments();

الخطوة 3: تحديث سمات المستند دفعةً

import com.groupdocs.search.common.AttributeChangeBatch;
import com.groupdocs.search.SearchOptions;

AttributeChangeBatch batch = new AttributeChangeBatch();
batch.addToAll("public"); // Add 'public' to all documents
batch.remove(documents[0].getFilePath(), "public"); // Remove 'public' from a specific document
batch.add(documents[0].getFilePath(), "main", "key"); // Add 'main' and 'key' attributes

// Apply changes
index.changeAttributes(batch);

الخطوة 4: البحث باستخدام مرشحات السمات

import com.groupdocs.search.results.SearchResult;

SearchOptions options = new SearchOptions();
options.setSearchDocumentFilter(SearchDocumentFilter.createAttribute("main"));
String query = "length";
SearchResult result = index.search(query, options); // Perform the search

تحديث سمات المستند دفعةً باستخدام AttributeChangeBatch

فئة AttributeChangeBatch هي الأداة الأساسية لـ batch update document attributes. من خلال تجميع التغييرات في دفعة واحدة، تقلل من عبء I/O وتحافظ على تماسك الفهرس.

كيفية إضافة سمات أثناء الفهرسة

Search by Attribute Java – إضافة سمات أثناء الفهرسة

اربط بحدث FileIndexing لتعيين سمات مخصصة كلما تم إضافة ملف إلى الفهرس.

خطوة بخطوة

الخطوة 1: الاشتراك في حدث FileIndexing

import com.groupdocs.search.events.EventHandler;
import com.groupdocs.search.events.FileIndexingEventArgs;

index.getEvents().FileIndexing.add(new EventHandler<FileIndexingEventArgs>() {
    @Override
    public void invoke(Object sender, FileIndexingEventArgs args) {
        if (args.getDocumentFullPath().endsWith("Lorem ipsum.pdf")) {
            args.setAttributes(new String[] { "main", "key" });
        }
    }
});

الخطوة 2: فهرسة المستندات

index.add("YOUR_DOCUMENT_DIRECTORY");

التطبيقات العملية

أنظمة إدارة المستندات – أتمتة التصنيف بإضافة البيانات الوصفية أثناء الاستيعاب.
أرشيفات المحتوى الكبيرة – استخدم مرشحات السمات لتضييق عمليات البحث، مما يقلل أوقات الاستجابة بشكل كبير.
الامتثال والتقارير – وضع علامات ديناميكية على المستندات لجدولة الاحتفاظ أو سجلات التدقيق.

اعتبارات الأداء

إدارة الذاكرة – راقب كومة JVM واضبط -Xmx حسب الحاجة.
المعالجة الدفعة – اجمع تغييرات السمات باستخدام AttributeChangeBatch لتقليل عمليات كتابة الفهرس.
تحديثات المكتبة – حافظ على تحديث GroupDocs.Search للاستفادة من تصحيحات الأداء.

المشكلات الشائعة والحلول

المشكلة	السبب	طريقة الحل
السمات لم تُطبق	معالج الحدث غير مسجل قبل الفهرسة	تأكد من أن `index.getEvents().FileIndexing.add(...)` يتم تشغيله قبل `index.add(...)`.
البحث لا يُرجع أي نتائج	عدم تطابق اسم السمة (حسّاس لحالة الأحرف)	استخدم أسماء السمات الدقيقة عند إنشاء المرشحات (`createAttribute("main")`).
أخطاء نفاد الذاكرة في الدفعات الكبيرة	عدد كبير جدًا من التغييرات في دفعة واحدة	قسّم التحديثات الكبيرة إلى مثيلات `AttributeChangeBatch` أصغر.
الترخيص غير معترف به	استخدام JAR تجريبي دون تطبيق ملف الترخيص	استدعِ `License license = new License(); license.setLicense("path/to/license.file");` قبل أي عملية فهرسة.

الأسئلة المتكررة

س: ما هي المتطلبات المسبقة لاستخدام GroupDocs.Search في Java؟
ج: تحتاج إلى Java 8+، مكتبة GroupDocs.Search، ومعرفة أساسية بمفاهيم الفهرسة.

س: كيف يمكنني تثبيت GroupDocs.Search عبر Maven؟
ج: أضف المستودع والاعتماد الموضحين في قسم إعداد Maven إلى ملف pom.xml الخاص بك.

س: هل يمكنني تعديل السمات بعد فهرسة المستندات؟
ج: نعم، استخدم AttributeChangeBatch لتحديث سمات المستند دفعةً دون إعادة فهرسة.

س: ماذا أفعل إذا كانت عملية الفهرسة بطيئة؟
ج: حسّن إعدادات ذاكرة JVM، استخدم التحديثات الدفعة، وتأكد من أنك تستخدم أحدث نسخة من المكتبة.

س: أين يمكنني العثور على مزيد من الموارد حول GroupDocs.Search for Java؟
ج: زر الوثائق الرسمية أو استكشف منتديات المجتمع.

الموارد

الوثائق: GroupDocs.Search for Java Docs
مرجع API: API Reference
التنزيل: Latest Releases
GitHub: GitHub GroupDocs.Search
منتدى الدعم المجاني: GroupDocs Forums
ترخيص مؤقت: License Page

آخر تحديث: 2026-02-24
تم الاختبار مع: GroupDocs.Search 25.4 for Java
المؤلف: GroupDocs