WatsonWebsocket

Watson WebSocket

WatsonWebsocket เป็นวิธีที่ง่ายที่สุดและเร็วที่สุดในการสร้างแอปพลิเคชันไคลเอนต์และเซิร์ฟเวอร์ที่ต้องอาศัยการส่งข้อความโดยใช้ WebSockets ของมัน. จริงหรือ. ง่าย.

ขอบคุณและขอบคุณ

ขอบคุณมากและขอบคุณมากสำหรับผู้ที่ใช้เวลาในการทำให้ห้องสมุดนี้ดีขึ้น!

@bryancrotaz @foddermk @caozero @danatobob @data33 @ak5nowman @jjxtra @martyix @rajeshdua123 @tersers @mackey-255 @krookoo1 @joreg @ilsnk @xbarra @mawkish.00 @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!" ) ; 

การเข้าถึงจากนอกบ้านท้องถิ่น

เมื่อคุณกำหนดค่า WatsonWebSocket เพื่อฟังใน 127.0.0.1 หรือ localhost มันจะตอบสนองต่อคำขอที่ได้รับจากภายในเครื่องเท่านั้น

ในการกำหนดค่าการเข้าถึงจากโหนดอื่น ๆ นอก localhost ให้ใช้สิ่งต่อไปนี้:

• ระบุชื่อโฮสต์ DNS ที่แน่นอนซึ่ง Watsonwebsocket ควรฟังในตัวสร้างเซิร์ฟเวอร์ ส่วนหัวโฮสต์สำหรับคำขอ HTTP ที่เข้ามาจะต้องตรงกับค่านี้ (นี่คือข้อ จำกัด ของระบบปฏิบัติการ)
• หากคุณต้องการฟังมากกว่าหนึ่งชื่อโฮสต์หรือที่อยู่ IP ให้ใช้ * หรือ + คุณต้อง:
  • เรียกใช้ Watsonwebsocket ในฐานะผู้ดูแลระบบเพื่อให้ทำงาน (นี่คือข้อ จำกัด ของระบบปฏิบัติการ)
  • ใช้ตัวสร้างเซิร์ฟเวอร์ที่ใช้ชื่อโฮสต์และค่าพอร์ตที่แตกต่างกัน (ไม่ใช่ตัวสร้าง URI ที่ใช้)
• หากคุณต้องการใช้หมายเลขพอร์ตน้อยกว่า 1024 คุณต้องเรียกใช้ WatsonWebSocket เป็นผู้ดูแลระบบ (นี่คือข้อ จำกัด ของระบบปฏิบัติการ)
• หากคุณฟังที่อยู่ IP อินเทอร์เฟซนอกเหนือจาก 127.0.0.1 คุณอาจต้องทำงานเป็นผู้ดูแลระบบ (ขึ้นอยู่กับระบบปฏิบัติการ)
• เปิดพอร์ตบนไฟร์วอลล์ของคุณเพื่ออนุญาตการจราจรบนพอร์ต TCP ที่ Watsonwebsocket กำลังฟังอยู่
• คุณอาจต้องเพิ่ม URL ACLs เช่นการผูก URL ภายในระบบปฏิบัติการโดยใช้คำสั่ง netsh :
  • ตรวจสอบการผูกที่มีอยู่โดยใช้ netsh http show urlacl
  • เพิ่มการเชื่อมโยงโดยใช้ netsh http add urlacl url=http://[hostname]:[port]/ user=everyone listen=yes
  • ที่ hostname และ port เป็นค่าที่คุณใช้ในตัวสร้าง
• หากคุณใช้ SSL คุณจะต้องติดตั้งใบรับรองในร้านประกาศนียบัตรและเรียกคืน thumbprint
  • อ้างถึง https://github.com/jchristn/watsonwebserver/wiki/using-ssl-on-windows สำหรับข้อมูลเพิ่มเติมหรือถ้าคุณใช้ SSL
• หากคุณยังคงมีปัญหาโปรดอย่าลังเลที่จะยื่นปัญหาที่นี่และฉันจะพยายามอย่างเต็มที่เพื่อช่วยเหลือและอัปเดตเอกสาร

ประวัติเวอร์ชัน

โปรดดูรายละเอียด Changelog.md