تكوين البحث الموزع مع شبكة GroupDocs.Search Java

في عالم اليوم القائم على البيانات، configure distributed search أمر أساسي للتعامل مع مجموعات مستندات ضخمة مع الحفاظ على أوقات استجابة منخفضة. يشرح هذا البرنامج التعليمي كيفية إعداد شبكة GroupDocs.Search for Java قوية، موضحًا كيفية نشر البحث عبر عدة عقد، إضافة مستندات إلى الفهرس، وتكوين إعدادات TCP للاتصال الموثوق. في النهاية، ستحصل على حل بحث قابل للتوسع جاهز للإنتاج وفهم واضح لماذا يتفوق هذا الهندسة على إعداد عقدة واحدة.

الإجابات السريعة

  • What is configure distributed search? إنها عملية ربط عدة عقد بحث مستقلة بحيث تقوم بفهرسة والإجابة على الاستعلامات بشكل جماعي، مما يوفر معدل نقل أعلى وتحمل للأخطاء.
  • How many nodes are recommended? عادةً ما توفر 3‑5 عقد توازنًا جيدًا بين الأداء وتحمل الأخطاء لمعظم أحمال العمل المؤسسية.
  • Do I need a license? نعم – يلزم الحصول على ترخيص مؤقت أو كامل لاستخدام GroupDocs.Search في الإنتاج.
  • Which ports should I use? اختر المنافذ التي تكون خالية على خوادمك؛ المثال يستخدم 49136‑49139، لكن أي نطاق مفتوح يعمل.
  • Can I add new documents after deployment? بالتأكيد – يمكنك add documents to index في أي وقت دون إعادة تشغيل الشبكة.

يعني تكوين بنية بحث موزعة ربط عدة عقد بحث مستقلة بحيث تشارك في عمل الفهرسة وتجيب على الاستعلامات بشكل جماعي. هذا يقلل الحمل على أي جهاز واحد، يحسن كل من معدل النقل والموثوقية، ويوفر redundancy مدمجة لتحمل الأخطاء.

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

يقدم GroupDocs.Search for Java high‑performance indexing (حتى 1 GB/s على الأجهزة الحديثة) وscalable architecture التي تدعم مجموعات من أكثر من 10 عقد. يفهم بشكل أصلي 50+ document formats — بما في ذلك PDF و DOCX و XLSX و PPTX وملفات البريد الإلكتروني — بحيث يمكنك فهرسة أي محتوى تجاري تقريبًا دون الحاجة إلى محولات إضافية. تسمح الفئة المدمجة TcpSettings لك بضبط الكمون ومعدل النقل وفترات keep‑alive بدقة، مما يضمن اتصالًا موثوقًا بين العقد حتى عبر حدود مراكز البيانات. TcpSettings يضبط معلمات الاتصال TCP منخفضة المستوى بين العقد.

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

المكتبات والاعتمادات المطلوبة

ستحتاج إلى GroupDocs.Search for Java الإصدار 25.4 أو أحدث. تأكد من أن بيئة التطوير لديك تحتوي على Java مثبتًا.

متطلبات إعداد البيئة

  • مجموعة تطوير جافا (JDK) 11 أو أحدث.
  • بيئة تطوير متكاملة (IDE) مثل IntelliJ IDEA أو Eclipse لإدارة المشروع بسهولة.

المتطلبات المعرفية

ستساعدك مهارات برمجة Java الأساسية وفهم عام لتكوين الشبكة على متابعة الخطوات بسلاسة.

إعداد GroupDocs.Search for Java

للبدء، أضف GroupDocs.Search for Java إلى مشروعك. يمكنك القيام بذلك عبر Maven أو بتحميل المكتبة مباشرة.

إعداد 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.

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

لاستخدام GroupDocs.Search بالكامل، يمكنك الحصول على ترخيص مؤقت أو شراء واحد. زر GroupDocs’s licensing page للحصول على مزيد من المعلومات حول كيفية الحصول على تجربة مجانية أو ترخيص كامل. يمكنك أيضًا استخدام GroupDocs licensing page لنفس الغرض.

التهيئة الأساسية والإعداد

لنقم بتهيئة GroupDocs.Search في تطبيق Java الخاص بك:

import com.groupdocs.search.*;

public class SearchSetup {
    public static void main(String[] args) {
        // Create an index in the specified folder
        Index index = new Index("YOUR_INDEX_DIRECTORY");

        // Add documents to the index
        index.add("YOUR_DOCUMENT_DIRECTORY");
    }
}

دليل التنفيذ

في هذا القسم، سنرشدك خلال تكوين ونشر شبكة بحث باستخدام GroupDocs.Search for Java.

كيف تقوم بتكوين البحث الموزع باستخدام GroupDocs.Search؟

حمّل تكوين الشبكة، عرّف مسارات القاعدة، واضبط معلمات TCP ببضع أسطر من الشيفرة. يوضح هذا النمط المباشر الخطوات الأساسية قبل أي شرح مفصل.

أولاً، أنشئ كائن SearchNetworkConfig، حدد دليل قاعدة مشترك، وعيّن منفذ TCP مميز لكل عقدة. SearchNetworkConfig يحدد إعدادات مجموعة البحث الموزعة، مثل دليل القاعدة ومنافذ العقد. ثم، أنشئ مثيلًا لـ TcpSettings — الفئة التي تتحكم في مهلة المقبس، حجم الذاكرة المؤقتة، وسلوك keep‑alive. أخيرًا، استدعِ NetworkManager.deploy(config) لإطلاق المجموعة. NetworkManager يدير نشر وإدارة عقد البحث داخل المجموعة.

تكوين الشبكة

فئة TcpSettings هي مركز التكوين لجميع اتصالات مستوى TCP بين العقد. تتيح لك ضبط مهلة الاتصال، أحجام الذاكرة المؤقتة للقراءة/الكتابة، وما إذا كان سيتم استخدام خوارزمية Nagle.

Configuration configuration = ConfiguringSearchNetwork.configure("YOUR_DOCUMENT_DIRECTORY", 49136);

نشر العقد

انشر كل عقدة بتوفير معرفها الفريد والتكوين المحدد مسبقًا. تقوم روتين النشر تلقائيًا بتسجيل العقدة مع المجموعة، فتح مقبس الاستماع، وبدء خيوط الفهرسة الخلفية.

public static SearchNetworkNode[] deploy(String basePath, int basePort, Configuration configuration) {
    // Define timeouts for sending and receiving data over the network.
    int sendTimeout = 3000;
    int receiveTimeout = 3000;

    // Create and start three nodes that can run on separate servers or together.
    SearchNetworkNode node1 = new SearchNetworkNode(
        1,
        basePath + "Node1",
        new TcpSettings(basePort + 1, sendTimeout, receiveTimeout)
    );
    node1.start();

    SearchNetworkNode node2 = new SearchNetworkNode(
        2,
        basePath + "Node2",
        new TcpSettings(basePort + 2, sendTimeout, receiveTimeout)
    );
    node2.start();

    SearchNetworkNode node3 = new SearchNetworkNode(
        3,
        basePath + "Node3",
        new TcpSettings(basePort + 3, sendTimeout, receiveTimeout)
    );
    node3.start();

    // Create and configure the main configuration node.
    SearchNetworkNode node0 = new SearchNetworkNode(
        0,
        basePath + "Node0",
        new TcpSettings(basePort, sendTimeout, receiveTimeout),
        new ConsoleLogger(),
        configuration
    );

    // Add an event handler to notify when the configuration is complete.
    node0.getEvents().ConfigurationCompleted.add(new EventHandler() {
        @Override
        public void invoke(Object s, EventArgs e) {
            // Event handling logic here (e.g., logging)
        }
    });

    // Configure all nodes in the network using the main configuration node.
    node0.configureAllNodes();

    // Start the search network by launching all configured nodes.
    node0.start();

    // Return an array of all deployed nodes.
    return new SearchNetworkNode[] {node0, node1, node2, node3};
}

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

  • Directory Access Errors – تأكد من وجود دليل القاعدة لكل عقدة وأن عملية Java لديها أذونات القراءة/الكتابة.
  • Port Conflicts – تحقق من أن المنافذ المختارة (مثلاً 49136‑49139) غير مستخدمة من قبل خدمات أخرى؛ يمكنك تشغيل netstat -an للتحقق.
  • Timeouts on Slow Networks – زد قيمة TcpSettings.setConnectionTimeout() إذا واجهت انقطاعات متكررة في بيئات ذات زمن استجابة عالي.
  • Index Corruption – قم بعمل نسخ احتياطي دوري لمجلد الفهرس وفعل NetworkManager.enableAutoRecovery() لإعادة بناء القطع التالفة تلقائيًا.

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

يمكن أن يكون نشر شبكة بحث موزعة مفيدًا في سيناريوهات متعددة:

  1. Large‑Scale Enterprise Systems – فهرسة ملايين العقود والسياسات والتقارير مع الحفاظ على استجابات استعلام أقل من ثانية.
  2. Content Management Platforms – خدمة آلاف المستخدمين المتزامنين الذين يبحثون عبر الأصول المتعددة الوسائط دون عنق زجاجة.
  3. E‑commerce Websites – تسريع عمليات البحث عن المنتجات والتنقل المتعدد الأوجه في الكتالوجات التي تحتوي على ملايين SKU.

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

للحفاظ على تشغيل بيئة configure distributed search بكفاءة:

  • Index Size Management – يمكن لـ GroupDocs.Search التعامل مع فهارس تتجاوز 100 GB؛ ومع ذلك، راقب I/O للقرص وفكر في تقسيم المجموعات الكبيرة عبر عدة عقد.
  • Resource Tuning – طبق أعلام ضبط الذاكرة في Java (-Xmx8g -Xms4g) بناءً على عبء العمل، واضبط TcpSettings.setReadBufferSize() لشبكات ذات معدل نقل عالي.
  • Health Monitoring – استخدم NetworkHealthMonitor المدمج لتتبع CPU والذاكرة وزمن استجابة الشبكة لكل عقدة، وضع تنبيهات للحدود التي تحددها.

الخلاصة

باتباع هذا البرنامج التعليمي، تعلمت كيفية configure distributed search ونشر شبكة GroupDocs.Search Java قابلة للتوسع. يمكن لهذا الحل تحسين السرعة والموثوقية لميزات البحث في تطبيقك بشكل كبير، خاصة عند التعامل مع مجموعات مستندات كبيرة ومتنوعة.

الخطوات التالية

استكشف القدرات المتقدمة مثل المحللات المخصصة، معالجة المرادفات، والفهرسة في الوقت الحقيقي لتحسين تجربة البحث الخاصة بك. يمكنك أيضًا دمج الشبكة مع طبقة API RESTful لعرض وظائف البحث للعملاء الخارجيين.

دعوة للعمل

ابدأ بتنفيذ هذا الحل القوي في مشاريعك اليوم وشاهد تحسين الأداء مباشرة!

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

س: ما هو GroupDocs.Search for Java؟
ج: GroupDocs.Search for Java هي مكتبة عالية الأداء تقوم بفهرسة والبحث عن النص عبر أكثر من 50 صيغة مستند، وتوفر بحث نص كامل سريع وقابل للتوسع لتطبيقات Java.

س: كيف أحصل على ترخيص مؤقت لـ GroupDocs.Search؟
ج: زر GroupDocs’s licensing page لطلب تجربة مجانية أو شراء ترخيص كامل للاستخدام في الإنتاج.

س: هل يمكنني إضافة مستندات جديدة بعد نشر الشبكة؟
ج: نعم، يمكنك add documents to index في أي وقت باستخدام طريقة IndexManager.addDocument()؛ التغييرات تنتقل تلقائيًا عبر المجموعة. IndexManager.addDocument() يضيف مستندًا جديدًا إلى الفهرس وينقله عبر الشبكة.

س: ما هي المشكلات الشائعة عند تكوين العقد؟
ج: تشمل المشكلات الشائعة مسارات القاعدة غير المتطابقة، تعارضات المنافذ، وعدم كفاية أذونات نظام الملفات. تحقق مرة أخرى من تكوين كل عقدة وتأكد من إمكانية الوصول إلى جميع الدلائل.

س: هل تدعم الشبكة الفهرسة في الوقت الحقيقي؟
ج: بالتأكيد. تقدم GroupDocs.Search واجهات برمجة تطبيقات الفهرسة في الوقت الحقيقي التي تجعل المستندات المضافة حديثًا قابلة للبحث عبر جميع العقد فورًا دون توقف.

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

دروس ذات صلة