توفر هذه المكتبة واجهات برمجة التطبيقات لإرسال/استقبال الرسائل من/إلى عملية تطبيق أخرى (محلية أو بعيدة) للبروتوكولات غير المتصلة.
عندما لا يتم إعطاء عنوان المضيف المحلي أو عنوان IP لحقل localHost
الاختياري، يتم ربط عنوان localhost
افتراضيًا. يتم تحديد رقم المنفذ الخاص بالمنفذ المحلي المستخدم للاتصال بالخادم البعيد بشكل عشوائي (المنفذ المؤقت).
يتم استخدام udp:Client
للتفاعل مع مضيف UDP البعيد ويمكن تعريفه على النحو التالي:
udp : Client socketClient = check new ;
udp : Datagram datagram = {
remoteHost : " localhost " ,
remotePort : 48829 ,
data : " Hello Ballerina " . toBytes ()
};
check socketClient -> sendDatagram ( datagram );
readonly & udp : Datagram result = check socketClient -> receiveDatagram ();
check socketClient -> close ();
يتم تكوين udp:ConnectClient
من خلال توفير remoteHost
و remotePort
بحيث يتلقى البيانات فقط من المضيف البعيد الذي تم تكوينه ويرسلها إليه. بمجرد الاتصال، قد لا يتم استلام البيانات أو إرسالها إلى أي مضيفين آخرين. يظل العميل متصلاً حتى يتم إغلاقه بشكل صريح. إذا كان عدد البايتات المعطاة لأسلوب writeBytes
أكبر من حجم البيانات المسموح به بواسطة مخطط بيانات، فسوف يرسل بشكل متكرر كافة البايتات مع عدة مخططات بيانات.
udp : ConnectClient socketClient = check new ( " localhost " , 48829 );
string msg = " Hello Ballerina " ;
check socketClient -> writeBytes ( msg . toBytes ());
readonly & byte [] result = check socketClient -> readBytes ();
check socketClient -> close ();
يتم استخدام udp:Listener
للاستماع إلى طلب مأخذ التوصيل الوارد.
يمكن أن يكون لـ udp:Listener
الطرق التالية.
onBytes(readonly & byte[] data, udp:Caller caller)
أو onDatagram(readonly & udp:Datagram, udp:Caller)
: يتم استدعاء هذه الأساليب البعيدة بمجرد استلام المحتوى من العميل. يتم تمثيل العميل باستخدام udp:Caller
.
onError(readonly & udp:Error err)
: يتم استدعاء هذه الطريقة عن بعد في حالة حدوث خطأ.
يمكن تعريف udp:Listener
على النحو التالي:
service on new udp:Listener( 48829 ) {
remote function onDatagram( readonly & udp : Datagram datagram )
returns udp : Datagram | udp : Error ? {
// Handle the content received from the client
}
remote function onError( udp : Error err ) {
// Handle the error situation
}
}
تم تعطيل علامات التبويب "المشكلات" و"المشاريع" لهذا المستودع لأنه جزء من مكتبة Ballerina القياسية. للإبلاغ عن الأخطاء، وطلب ميزات جديدة، وبدء مناقشات جديدة، وعرض لوحات المشروع، وما إلى ذلك. يرجى زيارة مستودع الوالدين في مكتبة Ballerina Standard Library.
يحتوي هذا المستودع فقط على الكود المصدري للحزمة.
قم بتنزيل وتثبيت الإصدار 21 من Java SE Development Kit (JDK) (من أحد المواقع التالية).
أوراكل
OpenJDK
ملاحظة: قم بتعيين متغير البيئة JAVA_HOME على اسم مسار الدليل الذي قمت بتثبيت JDK فيه.
قم بتنفيذ الأوامر أدناه للبناء من المصدر.
لبناء الحزمة:
./gradlew clean build
لتشغيل الاختبارات:
./gradlew clean test
لإجراء مجموعة من الاختبارات
./gradlew clean test -Pgroups=<test_group_names>
لبناء دون الاختبارات:
./gradlew clean build -x test
لتصحيح تنفيذ الحزمة:
./gradlew clean build -Pdebug=<port>
لتصحيح الأخطاء باستخدام لغة Ballerina:
./gradlew clean build -PbalJavaDebug=<port>
انشر القطع الأثرية التي تم إنشاؤها إلى مستودع Ballerina المركزي المحلي:
./gradlew clean build -PpublishToLocalCentral=true
انشر القطع الأثرية التي تم إنشاؤها إلى مستودع Ballerina المركزي:
./gradlew clean build -PpublishToCentral=true
كمشروع مفتوح المصدر، ترحب Ballerina بمساهمات المجتمع.
لمزيد من المعلومات، انتقل إلى إرشادات المساهمة.
يتم تشجيع جميع المساهمين على قراءة قواعد سلوك راقصة الباليه.
udp
.