كيفية إضافة مجلد إلى الفهرس باستخدام GroupDocs.Search في Java
إذا كنت بحاجة إلى java full text search يمكنه التعامل مع ملايين المستندات، فأنت في المكان الصحيح. في هذا الدرس ستتعلم كيفية add folder to index باستخدام GroupDocs.Search، وتكوين تخزين عالي الضغط، وتشغيل استعلامات سريعة كالبرق. في النهاية ستحصل على حل جاهز للإنتاج يمكنك دمجه في أي مشروع Java.
إجابات سريعة
- ما هي المكتبة الأساسية؟ GroupDocs.Search for Java
- كيف يمكن إضافة مجلد إلى الفهرس؟ Use
index.add(folderPath) - هل يمكنني تكوين ضغط النص؟ Yes, via
TextStorageSettings(Compression.High) - ما نسخة Java المطلوبة؟ JDK 8 or higher
- أين يمكن الحصول على ترخيص تجريبي؟ From the GroupDocs website or the repository page
ما هو java full text search ولماذا هو مهم؟
يقوم Java full text search بتحويل المستندات الخام إلى فهرس عكسي، مما يتيح استرجاع أي مصطلح في أقل من ثانية عبر آلاف الملفات. هذه القدرة أساسية لمستودعات الوثائق القانونية، ومكتبات البحث الأكاديمية، وقواعد معرفة المؤسسات حيث يتوقع المستخدمون نتائج فورية. كما أنها تحسن الإنتاجية في التطبيقات الحديثة.
لماذا تستخدم groupdocs.search للبحث النصي الكامل في Java؟
يوفر GroupDocs.Search فهرسة عالية السرعة وتنفيذ استعلامات سريع مع توفير ضغط مدمج عالي. يدعم 50+ input and output formats — بما في ذلك PDF و DOCX و EML و HTML — ويمكنه معالجة مستندات مئات الصفحات دون تحميل الملف بالكامل إلى الذاكرة، مع الحفاظ على استهلاك الذاكرة أقل من 200 ميغابايت للأحمال النموذجية.
المتطلبات المسبقة
- GroupDocs.Search for Java (version 25.4 or later) – المكتبة الأساسية التي تدعم الفهرسة والبحث.
- JDK 8+ مثبت ومُكوَّن – الحد الأدنى من بيئة التشغيل المطلوبة لـ SDK.
- Maven لإدارة التبعيات – يبسط إضافة المكتبة إلى مشروعك.
- بيئة تطوير متكاملة مثل IntelliJ IDEA أو Eclipse – لكتابة وتصحيح كود Java.
إعداد GroupDocs.Search للـ Java
إعداد Maven
أضف المستودع والتبعيات إلى ملف pom.xml الخاص بك:
<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.
الحصول على الترخيص
- Free trial – استكشف جميع الميزات دون التزام.
- Temporary license – فترة اختبار ممتدة.
- Purchase – فتح جميع إمكانيات الإنتاج.
التهيئة الأساسية والإعداد
Index هو الفئة الأساسية المستخدمة لإنشاء وفتح وإدارة فهرس البحث.
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!");
}
}
فهرسة النص مع ضغط مخصص
الخطوة 1: تحديد مجلد الفهرس
اختر دليلًا حيث ستقع ملفات الفهرس:
String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Indexing\\StoringTextOfIndexedDocuments";
الخطوة 2: تكوين إعدادات الفهرس
TextStorageSettings يحدد كيفية تخزين النص في الفهرس، بما في ذلك مستوى الضغط. Compression هو تعداد يحدد خوارزمية الضغط المطلوبة.
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));
الخطوة 3: إنشاء الفهرس بالإعدادات المخصصة
أنشئ الفهرس باستخدام التكوين المحدد أعلاه:
Index index = new Index(indexFolder, settings);
System.out.println("Index created with high compression.");
كيفية إضافة مجلد إلى الفهرس
Index هو الفئة الرئيسية التي تمثل الفهرس القابل للبحث.
حمّل الفهرس الموجود (أو أنشئ فهرسًا جديدًا) ثم استدعِ طريقة add على كائن Index. تقوم عملية add بمسح الدليل المقدم، استخراج النص من كل ملف مدعوم، وتخزينه في الفهرس المضغوط، جاهزًا للبحث الفوري.
String documentsFolder = "YOUR_DOCUMENT_DIRECTORY"; // Replace with actual document path.
Index index = new Index(indexFolder);
كيفية البحث في المستندات المفهرسة
SearchResult يمثل نتيجة واحدة مع مسار المستند والملاءمة.
حدد سلسلة استعلام البحث التي تمثل المصطلح أو العبارة التي تريد العثور عليها، ثم استدعِ طريقة search على كائن Index. تُعيد الطريقة مجموعة من كائنات SearchResult، كل منها يحتوي على مسار المستند، درجة الملاءمة، ومقتطف يبرز التطابق.
index.add(documentsFolder);
System.out.println("Documents added successfully.");
التطبيقات العملية
سيناريوهات واقعية حيث يبرز java full text search:
- Legal document management – استرجاع فوري لملفات القضايا.
- Academic research libraries – بحث سريع عن الأوراق والرسائل.
- Enterprise knowledge bases – وصول سريع إلى الأدلة والأسئلة الشائعة.
- Content management systems – اكتشاف محتوى فعال للمواقع الكبيرة.
- Customer service archives – بحث سريع في تذاكر ودردشات الدعم السابقة.
اعتبارات الأداء
- Compression vs. speed: الضغط العالي يوفر حتى 70 % من مساحة القرص لكنه يضيف عبء فهرسة بسيط؛ قم بإجراء اختبارات معيارية لحجم بياناتك.
- Memory management: خصص على الأقل 2 GB من الذاكرة المؤقتة للفهارس التي تتجاوز 10 GB لتجنب
OutOfMemoryError. - Index updates: أضف المستندات الجديدة تدريجيًا باستخدام
index.add()وتدعُّـindex.optimize()بشكل دوري للحفاظ على فهرس مضغوط. - Query optimization: استخدم صياغة الاستعلام المتقدمة (wildcards, proximity, fuzzy search) لتضييق النتائج وتقليل زمن الاستجابة.
المخاطر الشائعة والنصائح الاحترافية
Pitfall: نسيان استدعاء
index.optimize()بعد الإضافات الجماعية.
Pro tip: شغّلindex.optimize()كل ليلة للحفاظ على الفهرس مضغوطًا.Pitfall: استخدام الضغط الافتراضي (المنخفض) على مجموعات بيانات ضخمة.
Pro tip: التحول إلىCompression.Highفي بيئات الإنتاج لتقليل تكاليف التخزين.Pitfall: عدم معالجة
IOExceptionعند إضافة ملفات من مشاركة شبكة.
Pro tip: ضعindex.add()داخل كتلة try‑catch وسجّل أي فشل للمراجعة لاحقًا.
الأسئلة المتكررة
س: ما هو GroupDocs.Search؟
ج: هي مكتبة Java قوية توفر إمكانيات بحث نصي كامل متقدمة، بما في ذلك الفهرسة، الضغط، ودعم الاستعلامات المعقدة.
س: كيف يمكنني التعامل مع مجموعات بيانات كبيرة باستخدام GroupDocs.Search؟
ج: فعّل الضغط العالي (Compression.High) وارتكِب التغييرات بشكل دوري للحفاظ على خفة الفهرس. كما يجب تخصيص ذاكرة مؤقتة كافية (مثلاً 4 GB للفهارس التي تتجاوز 20 GB).
س: هل يمكنني دمج GroupDocs.Search مع الأنظمة المؤسسية الحالية؟
ج: نعم، يمكن تضمين المكتبة في أي خلفية مبنية على Java، أو خدمات REST، أو بنية مايكرو‑خدمات.
س: ماذا لو أصبح فهرسي قديمًا؟
ج: استخدم طريقة index.add() لإضافة ملفات جديدة وindex.delete() لإزالة الملفات القديمة، ثم أعد تشغيل index.optimize() إذا لزم الأمر.
س: أين يمكنني الحصول على المساعدة أو الدعم؟
ج: زر منتدى المجتمع على GroupDocs forums للحصول على حلول المشكلات ونصائح أفضل الممارسات.
موارد إضافية
- دليل الاستخدام التفصيلي: GroupDocs Search Documentation
- مرجع API الكامل: API Reference Guide
- ابقَ محدثًا بأحدث الميزات: Latest Releases
آخر تحديث: 2026-11-02
تم الاختبار مع: GroupDocs.Search 25.4
المؤلف: GroupDocs
String query = "sample";
import com.groupdocs.search.results.SearchResult;
SearchResult result = index.search(query);
System.out.println("Search completed. Results found: " + result.getDocumentCount());