كيفية إنشاء فهرس باستخدام GroupDocs.Search للغة Java

إذا كنت بحاجة إلى كيفية إنشاء فهرس لآلاف الملفات القانونية أو الأكاديمية أو التجارية، فإن GroupDocs.Search للغة Java يزودك بمحرك جاهز يُستخرج النص، يبني بنية قابلة للبحث ومُدمجة، ويسمح لك بتنفيذ استعلامات regex أو fuzzy أو wildcard في غضون مللي ثانية. في هذا الدرس ستتعرف على كيفية إعداد SDK، إنشاء فهرس، إضافة مستندات إليه، وتنفيذ عمليات بحث قوية تعتمد على الأنماط.

إجابات سريعة

  • ما هو الهدف الأساسي من GroupDocs.Search؟ لإنشاء فهارس قابلة للبحث لمجموعة واسعة من صيغ المستندات.
  • هل يمكنني إضافة مستندات إلى الفهرس بعد إنشائه؟ نعم—استخدم طريقة index.add() لتضمين ملفات جديدة.
  • هل يدعم GroupDocs.Search البحث الضبابي (fuzzy) في Java؟ بالتأكيد؛ فعّله عبر SearchOptions.
  • كيف يمكنني تشغيل استعلام wildcard في Java؟ أنشئه باستخدام SearchQuery.createWildcardQuery().
  • هل يلزم وجود ترخيص للاستخدام في الإنتاج؟ يتطلب ترخيص صالح لـ GroupDocs.Search للنشر التجاري.

SearchOptions يُكوّن SearchOptions سلوك البحث مثل المطابقة الضبابية.
SearchQuery.createWildcardQuery() يبني كائن استعلام wildcard.

ما معنى “كيفية إنشاء فهرس” في سياق GroupDocs.Search؟

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

لماذا نستخدم GroupDocs.Search للغة Java؟

يوفر GroupDocs.Search حلاً موثوقًا على مستوى المؤسسات يدعم أكثر من 30 صيغة إدخال وإخراج—بما في ذلك PDF وDOCX وXLSX وPPTX وHTML والملفات النصية العادية—مع تحقيق أوقات استجابة للاستعلامات بأقل من ثانية للفهارس التي تحتوي على ملايين الصفحات. تمكنك قدراته المدمجة للبحث الضبابي (fuzzy)، wildcard، وبحث regex java من التعامل مع الأخطاء الإملائية، مطابقة الأنماط، وسيناريوهات البحث المعقدة دون الحاجة لكتابة محللات مخصصة.

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

  • نسخة GroupDocs.Search للغة Java الإصدار 25.4 أو أحدث.
  • بيئة تطوير متكاملة (IDE) مثل IntelliJ IDEA أو Eclipse مع دعم Maven.
  • JDK 11 أو أحدث مثبت على جهاز التطوير الخاص بك.
  • معرفة أساسية بصياغة Java ومفاهيم البحث.

إعداد GroupDocs.Search للغة Java

يمكنك إضافة المكتبة عبر Maven أو تحميلها يدويًا.

إعداد 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 للغة Java.

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

  • إصدار تجريبي مجاني: استكشف جميع الميزات دون تكلفة.
  • ترخيص مؤقت: تمديد فترة التجربة للمشاريع التقييمية.
  • ترخيص كامل: مطلوب للنشر في بيئات الإنتاج ولإلغاء حدود الفهرسة غير المحدودة.

بمجرد توفر المكتبة، قم بتهيئتها في شفرة Java الخاصة بك:

import com.groupdocs.search.*;

public class InitializeSearch {
    public static void main(String[] args) {
        // Create an index instance
        Index index = new Index("YOUR_DOCUMENT_DIRECTORY\\output");
        
        System.out.println("GroupDocs.Search initialized successfully.");
    }
}

كيفية إنشاء فهرس باستخدام GroupDocs.Search

حمّل ملفات المصدر الخاصة بك، وجه SDK إلى مجلد، ودعه يبني بنية البحث في استدعاء واحد. هذه الطريقة تُنشئ الفهرس في أقل من دقيقة لمجموعة مستندات بحجم 10 GB تقريبًا على خادم قياسي.

تعريف المسارات

String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\CreateAndIndexDocuments";
String documentsFolder = "YOUR_DOCUMENT_DIRECTORY";

إنشاء الفهرس

Index index = new Index(indexFolder);
System.out.println("Index created at: " + indexFolder);

إضافة مستندات إلى الفهرس

index.add(documentsFolder);
System.out.println("Documents added to the index.");

نصيحة احترافية: تأكد من وجود الأدلة وأنها تحتوي فقط على الملفات التي تريد أن تكون قابلة للبحث؛ الملفات غير ذات الصلة قد تُثقل الفهرس.

استعلام كلمة بسيطة مع خيارات البحث الضبابي (fuzzy search java)

يساعد البحث الضبابي عندما يخطئ المستخدمون في كتابة كلمة أو عندما تُدخل تقنية OCR أخطاءً. يقوم SDK تلقائيًا بتوسيع الاستعلام ليشمل مصطلحات مشابهة بناءً على مسافة التحرير.

SearchQuery subquery = SearchQuery.createWordQuery("future");
subquery.setSearchOptions(new SearchOptions());
subquery.getSearchOptions().getFuzzySearch().setEnabled(true);
subquery.getSearchOptions().getFuzzySearch()
        .setFuzzyAlgorithm(new TableDiscreteFunction(3));
System.out.println("Fuzzy search enabled with a tolerance of 3.");

استعلام Wildcard في Java

تسمح استعلامات wildcard بمطابقة أنماط مثل أي كلمة تبدأ ببادئة معينة، باستخدام عناصر نائبة * أو ?.

SearchQuery.createWildcardQuery() ينشئ كائن استعلام wildcard.

SearchQuery subquery = SearchQuery.createWildcardQuery(1);
System.out.println("Wildcard query created.");

بحث Regex في Java

توفر التعبيرات النمطية (regex) تحكمًا دقيقًا في مطابقة الأنماط، وهو مثالي للعثور على الأحرف المتكررة أو هياكل الرموز المعقدة.

SearchQuery.createRegexQuery() ينشئ كائن استعلام regex لمطابقة الأنماط.

SearchQuery subquery = SearchQuery.createRegexQuery("(.)\\1");
System.out.println("Regex query created to find repeated characters.");

دمج الاستعلامات الفرعية في استعلام بحث عبارة

يمكنك دمج استعلامات كلمة، wildcard، وregex الفرعية لإنشاء عمليات بحث عبارات متقدمة تحترم الترتيب والقرب.

SearchQuery subquery1 = SearchQuery.createWordQuery("future");
SearchQuery subquery2 = SearchQuery.createWildcardQuery(1);
SearchQuery subquery3 = SearchQuery.createRegexQuery("(.)\\1");
SearchQuery combinedQuery = SearchQuery.createPhraseSearchQuery(subquery1, subquery2, subquery3);
System.out.println("Combined phrase search query created.");

تكوين وتنفيذ بحث مع خيارات مخصصة

يسمح تعديل خيارات البحث بالتحكم في عدد النتائج التي تُرجع، وهو مفيد للمجموعات الكبيرة. يمكنك أيضًا ضبط التقييم، تمييز التطابقات، وتحديد عدد النتائج لكل مستند.

SearchOptions options = new SearchOptions();
options.setMaxOccurrenceCountPerTerm(1000000);
options.setMaxTotalOccurrenceCount(10000000);
System.out.println("Custom search options configured.");
Index index = new Index("YOUR_DOCUMENT_DIRECTORY\\output\\ConfigureAndPerformSearch");
SearchQuery query = SearchQuery.createWordQuery("future");

SearchResult result = index.search(query, options);
System.out.println("Search performed with custom options.");

بحث Regex java – حالات الاستخدام الشائعة

  • البحث القانوني: العثور على بنود تتبع نمطًا محددًا، مثل التواريخ بصيغة DD/MM/YYYY.
  • تحقق من البيانات: اكتشاف المعرفات غير الصالحة أو الأحرف المتكررة في السجلات.
  • مراقبة المحتوى: العثور على الألفاظ النابية أو الأنماط المحظورة باستخدام regex.
  • التحليل المالي: استخراج رموز المعاملات التي تطابق قالب regex معروف.

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

  • تحسين الفهرسة: أعد فهرسة بشكل دوري وأزل الملفات القديمة للحفاظ على خفة الفهرس؛ فهرس مُصان جيدًا يحتوي على مليون صفحة يشغل أقل من 2 GB على القرص.
  • استخدام الموارد: راقب حجم ذاكرة heap في JVM؛ قد تتطلب الفهارس الكبيرة ما يصل إلى 8 GB من الheap أو تخزين خارج الـ heap لتحقيق أقصى معدل نقل.
  • جمع القمامة: ضبط إعدادات GC (مثل G1GC) لخدمات البحث طويلة الأمد لتجنب ارتفاعات زمن التوقف.

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

س: هل يمكنني تحديث فهرس موجود دون إعادة بنائه من الصفر؟
ج: نعم—استخدم index.add() لإضافة ملفات جديدة أو index.update() لتحديث المستندات المتغيرة.

س: كيف يتعامل البحث الضبابي مع اللغات المختلفة؟
ج: الخوارزمية الضبابية المدمجة تعمل على أحرف Unicode، لذا تدعم معظم اللغات مباشرة.

س: هل هناك حد لعدد المستندات التي يمكن فهرستها؟
ج: عمليًا، الحد يتحدد بمساحة القرص المتاحة وذاكرة JVM؛ تم تصميم المكتبة لتعامل مع ملايين المستندات.

س: هل أحتاج إلى إعادة تشغيل التطبيق بعد تغيير خيارات البحث؟
ج: لا—تُطبق خيارات البحث على كل استعلام، لذا يمكنك تعديلها أثناء التشغيل.

س: أين يمكنني العثور على أمثلة استعلامات متقدمة؟
ج: توثيق GroupDocs.Search الرسمي ومرجع API يوفران أمثلة واسعة للسيناريوهات المعقدة.


آخر تحديث: 2026-10-12
تم الاختبار مع: GroupDocs.Search للغة Java 25.4
المؤلف: GroupDocs

دروس ذات صلة