دليل البحث حسب السمة 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 for 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. من خلال تجميع التغييرات في دفعة واحدة، تقلل من حمل الإدخال/الإخراج وتحافظ على تماسك الفهرس.

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

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

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

اعت الأداء

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

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

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

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

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

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

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

موارد

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