الصفحة الرئيسية>المتعلقة بالبرمجة>جافا كود المصدر
تنزيل

ملاحظات الإصدار

ملاحظات الإصدار متاحة هنا.

التوثيق

تتوفر الوثائق المرجعية وواجهة برمجة التطبيقات (API) لبرنامج تشغيل Java هنا.

المرجع ووثائق واجهة برمجة التطبيقات (API) لبرنامج تشغيل Kotlin متاحة هنا.

تتوفر الوثائق المرجعية وواجهة برمجة التطبيقات (API) لبرنامج تشغيل Scala هنا.

دروس / تدريب

للحصول على دروس حول كيفية استخدام برامج تشغيل MongoDB JVM، يرجى الرجوع إلى جامعة MongoDB. يمكن أيضًا العثور على برامج تعليمية ومقاطع فيديو وأمثلة تعليمات برمجية إضافية باستخدام كل من Java Driver وKotlin Driver في مركز مطوري MongoDB.

الدعم / ردود الفعل

بالنسبة للمشكلات المتعلقة ببرامج تشغيل MongoDB Java وKotlin وScala أو الأسئلة المتعلقة بها أو التعليقات عليها، يرجى الاطلاع على قنوات الدعم الخاصة بنا. يرجى عدم إرسال بريد إلكتروني مباشرة إلى أي من مطوري برامج التشغيل لطرح مشكلات أو أسئلة - فمن المرجح أن تحصل على إجابة في منتديات مجتمع MongoDB أو StackOverflow.

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

البق / طلبات الميزة

هل تعتقد أنك وجدت خطأً في برامج تشغيل Java أو Kotlin أو Scala؟ هل تريد رؤية ميزة جديدة في برامج التشغيل؟ يُرجى فتح حالة في أداة إدارة المشكلات الخاصة بنا، JIRA:

  • إنشاء حساب وتسجيل الدخول.
  • انتقل إلى مشروع جافا.
  • انقر فوق إنشاء مشكلة - يرجى تقديم أكبر قدر ممكن من المعلومات حول نوع المشكلة وبرنامج التشغيل الذي تستخدمه وكيفية إعادة إنتاج مشكلتك.

تقارير الأخطاء في JIRA لبرنامج التشغيل ومشروع Core Server (أي SERVER) عامة .

إذا حددت ثغرة أمنية في برنامج التشغيل أو أي مشروع آخر في MongoDB، فيرجى الإبلاغ عنها وفقًا للتعليمات الواردة هنا.

الإصدار

ستحدث زيادات كبيرة (مثل 4.x -> 5.x) عند إجراء تغييرات جذرية على واجهة برمجة التطبيقات العامة. جميع الأساليب والفئات التي تمت إزالتها في إصدار رئيسي سيتم إهمالها في إصدار سابق لفرع الإصدار الرئيسي السابق، و/أو تم استدعاؤها في ملاحظات الإصدار.

ستحدث زيادات طفيفة 5.x (مثل 5.1، 5.2، وما إلى ذلك) عند إضافة وظائف جديدة غير تافهة أو حدوث تحسينات مهمة أو إصلاحات للأخطاء قد يكون لها تغييرات سلوكية قد تؤثر على بعض حالات الحافة (مثل الاعتماد على السلوك الناتج عن علة). مثال على التحسين هو الطريقة أو الفئة المضافة لدعم الوظائف الجديدة المضافة إلى خادم MongoDB. ستكون الإصدارات الثانوية دائمًا متوافقة ثنائيًا مع الإصدارات الثانوية السابقة من نفس فرع الإصدار الرئيسي، باستثناء ما هو مذكور أدناه.

زيادات التصحيح 5.xy (مثل 5.0.0 -> 5.0.1، 5.1.1 -> 5.1.2، إلخ) ستحدث لإصلاحات الأخطاء فقط وستكون دائمًا متوافقة ثنائيًا مع إصدارات التصحيح السابقة لنفس فرع الإصدار الثانوي .

@ألفا

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

من غير المستحسن للتطبيقات استخدام Alpha APIs في بيئات الإنتاج أو للمكتبات (التي يتم تضمينها في CLASSPATHs الخاصة بالمستخدمين، خارج سيطرة مطوري المكتبة) للاعتماد على واجهات برمجة التطبيقات هذه. Alpha APIs مخصصة للأغراض التجريبية فقط.

@بيتا

تخضع واجهات برمجة التطبيقات (APIs) المميزة بالتعليق التوضيحي @Beta على مستوى الفئة أو الطريقة للتغيير. ويمكن تعديلها بأي شكل من الأشكال، أو حتى إزالتها، في أي وقت. إذا كانت التعليمات البرمجية الخاصة بك عبارة عن مكتبة بحد ذاتها (أي يتم استخدامها على CLASSPATH للمستخدمين خارج نطاق سيطرتك)، فيجب ألا تستخدم واجهات برمجة التطبيقات التجريبية، إلا إذا قمت بإعادة تجميعها (على سبيل المثال باستخدام التظليل، وما إلى ذلك).

@مهمل

ستظل واجهات برمجة التطبيقات المميزة بالتعليق التوضيحي @Deprecated على مستوى الفئة أو الطريقة مدعومة حتى الإصدار الرئيسي التالي ولكن يوصى بالتوقف عن استخدامها.

com.mongodb.internal.*

جميع التعليمات البرمجية الموجودة داخل حزم com.mongodb.internal.* تعتبر واجهة برمجة تطبيقات خاصة ولا ينبغي الاعتماد عليها على الإطلاق. يمكن أن تتغير في أي وقت.

الثنائيات

يمكن العثور على الثنائيات ومعلومات التبعية لـ Maven وGradle وIvy وغيرها على http://search.maven.org.

مثال لميفن: 

< dependency >
    < groupId >org.mongodb</ groupId >
    < artifactId >mongodb-driver-sync</ artifactId >
    < version >x.y.z</ version >
</ dependency >

يتم أيضًا نشر إصدارات اللقطات بشكل منتظم عبر Sonatype.

مثال لميفن: 

    < repositories >
        < repository >
            < id >sonatype-snapshot</ id >
            < url >https://oss.sonatype.org/content/repositories/snapshots/</ url >
        </ repository >
    </ repositories >

يبني

مطلوب Java 17+ وgit لإنشاء المصدر وتجميعه. لبناء واختبار برنامج التشغيل: 

 $ git clone https://github.com/mongodb/mongo-java-driver.git
$ cd mongo-java-driver
$ ./gradlew check

تتطلب مجموعة الاختبار تشغيل mongod باستخدام enableTestCommands ، والذي يمكن ضبطه باستخدام --setParameter enableTestCommands=1 معلمة سطر الأوامر: 

 $ mkdir -p data/db
$ mongod --dbpath ./data/db --logpath ./data/mongod.log --port 27017 --logappend --fork --setParameter enableTestCommands=1

إذا واجهت أخطاء "Too many open files" عند تشغيل الاختبارات، فستحتاج إلى زيادة عدد واصفات الملفات المتاحة قبل بدء تشغيل mongod كما هو موضح في https://www.mongodb.com/docs/manual/reference/ulimit /

فكرة إنتيليج

يلزم وجود خطوتين للتكوين اليدوي لتشغيل التعليمات البرمجية في IntelliJ:

  • مطلوب Java 17+ لإنشاء المصدر وتجميعه.

  • خطأ: java: cannot find symbol: class SNIHostName location: package javax.net.ssl
    إصلاح: الإعدادات/التفضيلات > البناء والتنفيذ والنشر > المحول البرمجي > مترجم Java - قم بإلغاء تحديد خيار "استخدام '--الإصدار' للتجميع المشترك (Java 9 والإصدارات الأحدث)"

  • خطأ: java: package com.mongodb.internal.build does not exist
    الإصلاحات: أي مما يلي:

    • قم بتشغيل مهمة generateBuildConfig : على سبيل المثال: ./gradlew generateBuildConfig أو عبر Gradle > driver-core > Tasks > buildconfig > generatorBuildConfig
    • قم بتعيين generateBuildConfig للتنفيذ قبل الإنشاء. عبر Gradle > المهام > buildconfig > انقر بزر الماوس الأيمن على createBuildConfig - انقر على "التنفيذ قبل الإنشاء"
    • تفويض جميع إجراءات البناء إلى Gradle: الإعدادات/التفضيلات > البناء والتنفيذ والنشر > أدوات البناء > Gradle > البناء والتشغيل باستخدام/تشغيل الاختبارات باستخدام - حدد "Gradle"
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل