WatsonWebsocket

Watson Websocket

تعد WatsonWebsocket أسهل وأسرع طريقة لبناء تطبيقات العميل والخادم التي تعتمد على الرسائل باستخدام WebSockets. إنه. حقًا. سهل.

شكرا وتقدير

شكرا جزيلا وتقدير كبير لأولئك الذين يستغرقون الوقت لجعل هذه المكتبة أفضل!

bryancrotazfoddermk @caozerodanatobob @data33 @ak5nowman @jjjxtramartyix @rajeshdua123 @mackey-255 @krookoo1joregiizefroftafroftafrofet @ exergist @ebarale99 warstekhun @rubidium37 codengine

اختبار التطبيق

يتم تضمين مشروع اختبار لكل من العميل ( TestClient ) والخادم ( TestServer ) والذي سيساعدك على فهم وممارسة مكتبة الفصل.

يمكن الاطلاع على مشروع اختبار يولد خادم وعميل وتبادل الرسائل هنا: https://github.com/jchristn/watsonwebsockettest

أنظمة التشغيل المدعومة

يعتمد WatsonWebsocket حاليًا على دعم WebSocket الموجود في نظام التشغيل الأساسي. Windows 7 لا يدعم WebSockets.

SSL

يتم دعم SSL في Watsonwebsocket. يقبل منشئو WatsonWsServer و WatsonWsClient bool يشير إلى ما إذا كان ينبغي تمكين SSL أم لا. نظرًا لأن WebSockets ، وكنتائج ثانوية WatsonWebsocket ، تستخدم HTTPS ، فإنها تعتمد على الشهادات داخل متجر الشهادة لنظام التشغيل الخاص بك. يتم توفير شهادة اختبار في كل من مشاريع TestClient و TestServer التي يمكن استخدامها لأغراض الاختبار. لا ينبغي استخدام هذه في الإنتاج.

لمزيد من المعلومات حول استخدام شهادات SSL ، يرجى الرجوع إلى الويكي.

جديد في v4.0.x

• كسر التغييرات
• العملاء الذين تم تحديدهم الآن بواسطة Guid في ClientMetadata
• ListClients الآن يعيد ClientMetadata الكامل
• Send* أساليب الآن تأخذ guid بدلاً من IpPort
• أضف الاستهداف لـ .NET 7.0 و .NET Framework 4.8
• Fix for Blazor Wasm ، شكرًا لك @ebarale99
• إصلاح لأحرف التحكم غير صالحة ، شكرًا لك warstekhun

مثال الخادم

 using WatsonWebsocket ;

WatsonWsServer server = new WatsonWsServer ( "[ip]" , port , true | false ) ;
server . ClientConnected += ClientConnected ;
server . ClientDisconnected += ClientDisconnected ;
server . MessageReceived += MessageReceived ; 
server . Start ( ) ;

static void ClientConnected ( object sender , ConnectionEventArgs args ) 
{
    Console . WriteLine ( "Client connected: " + args . Client . ToString ( ) ) ;
}

static void ClientDisconnected ( object sender , DisconnectionEventArgs args ) 
{
    Console . WriteLine ( "Client disconnected: " + args . Client . ToString ( ) ) ;
}

static void MessageReceived ( object sender , MessageReceivedEventArgs args ) 
{ 
    Console . WriteLine ( "Message received from " + args . Client . ToString ( ) + ": " + Encoding . UTF8 . GetString ( args . Data ) ) ;
} 

مثال العميل

 using WatsonWebsocket ;

WatsonWsClient client = new WatsonWsClient ( "[server ip]" , [ server port ] , true | false ) ;
client . ServerConnected += ServerConnected ;
client . ServerDisconnected += ServerDisconnected ;
client . MessageReceived += MessageReceived ; 
client . Start ( ) ; 

static void MessageReceived ( object sender , MessageReceivedEventArgs args ) 
{
    Console . WriteLine ( "Message from server: " + Encoding . UTF8 . GetString ( args . Data ) ) ;
}

static void ServerConnected ( object sender , EventArgs args ) 
{
    Console . WriteLine ( "Server connected" ) ;
}

static void ServerDisconnected ( object sender , EventArgs args ) 
{
    Console . WriteLine ( "Server disconnected" ) ;
} 

مثال العميل باستخدام المتصفح

 server = new WatsonWsServer ( "http://localhost:9000/" ) ;
server . Start ( ) ; 

 let socket = new WebSocket ( "ws://localhost:9000/test/" ) ;
socket . onopen = function ( ) { console . log ( "success" ) ; } ;
socket . onmessage = function ( msg ) { console . log ( msg . data ) ; } ;
socket . onclose = function ( ) { console . log ( "closed" ) ; } ;
// wait a moment
socket . send ( "Hello, world!" ) ; 

الوصول من خارج LocalHost

عند تكوين WatsonWebsocket للاستماع على 127.0.0.1 أو localhost ، فإنه لن يستجيب فقط للطلبات التي تم استلامها من داخل الجهاز المحلي.

لتكوين الوصول من العقد الأخرى خارج localhost ، استخدم ما يلي:

• حدد اسم مضيف DNS الدقيق الذي يجب على WatsonWebsocket الاستماع إليه في مُنشئ الخادم. يجب أن يتطابق رأس المضيف على طلبات HTTP الواردة مع هذه القيمة (هذا هو قيود نظام التشغيل)
• إذا كنت ترغب في الاستماع إلى أكثر من اسم مضيف أو عنوان IP ، فاستخدم * أو + . يجب عليك أن:
  • قم بتشغيل Watsonwebsocket كمسؤول لهذا العمل (هذا هو الحد من نظام التشغيل)
  • استخدم مُنشئ الخادم الذي يأخذ قيم مضيف وموانئ مميزة (وليس مُنشئ URI)
• إذا كنت ترغب في استخدام رقم منفذ أقل من 1024 ، فيجب عليك تشغيل Watsonwebsocket كمسؤول (هذا هو قيود نظام التشغيل)
• إذا استمعت على عنوان IP للواجهة بخلاف 127.0.0.1 ، فقد تحتاج إلى تشغيل كمسؤول (يعتمد هذا على نظام التشغيل)
• افتح منفذًا على جدار الحماية الخاص بك للسماح بحركة المرور على منفذ TCP الذي يستمع إليه WatsonWebsocket
• قد تضطر إلى إضافة ACLS URL ، أي روابط URL ، داخل نظام التشغيل باستخدام أمر netsh :
  • تحقق من وجود روابط موجودة باستخدام netsh http show urlacl
  • أضف ملزمة باستخدام netsh http add urlacl url=http://[hostname]:[port]/ user=everyone listen=yes
  • حيث يكون hostname port القيمان اللتين تستخدمهما في المُنشئ
• إذا كنت تستخدم SSL ، فستحتاج إلى تثبيت الشهادة في متجر الشهادة واسترداد الإبهام
  • ارجع إلى https://github.com/jchristn/watsonwebserver/wiki/using-ssl-on-windows لمزيد من المعلومات ، أو إذا كنت تستخدم SSL
• إذا كنت لا تزال تواجه مشاكل ، فالرجاء عدم التردد في تقديم مشكلة هنا ، وسأبذل قصارى جهدي لمساعدة الوثائق وتحديثها.

تاريخ الإصدار

يرجى الرجوع إلى changelog.md للحصول على التفاصيل.