HTML5 Web Socket server/client implementation in Ruby.
For server, em-websocket ( https://github.com/igrigorik/em-websocket ) may be a better choice, especially if you want to use EventMachine.
* How to run sample
- Run sample Web Socket server (echo server) with:
$ ruby samples/echo_server.rb localhost 10081
- Run sample Web Socket client and type something:
$ ruby samples/stdio_client.rb ws://localhost:10081
Ready
hoge
Sent: "hoge"
Received: "hoge"
* Usage example
Server:
# Runs the server at port 10081. It allows connections whose origin is example.com.
server = WebSocketServer.new(:port => 10081, :accepted_domains => ["example.com"])
server.run() do |ws|
# The block is called for each connection.
# Checks requested path.
if ws.path == "/"
# Call ws.handshake() without argument first.
ws.handshake()
# Receives one message from the client as String.
while data = ws.receive()
puts(data)
# Sends the message to the client.
ws.send(data)
end
else
# You can call ws.handshake() with argument to return error status.
ws.handshake("404 Not Found")
end
end
Client:
# Connects to Web Socket server at host example.com port 10081.
client = WebSocket.new("ws://example.com:10081/")
# Sends a message to the server.
client.send("Hello")
# Receives a message from the server.
data = client.receive()
puts(data)
* Supported WebSocket protocol versions
WebSocketServer class (server) accepts version hixie-75, hixie-76, hybi-07, hybi-10.
WebSocket class (client) speaks version hixie-76.
* Tips: JavaScript client implementation
Google Chrome Dev Channel natively supports Web Socket. For other browsers, you can use an implementation using Flash:
http://github.com/gimite/web-socket-js/tree/master
* WebSocket protocol versions
The server supports the protocol defined in RFC 6455, draft versions hixie-75 and hixie-76.
The client speaks draft version hixie-76.
* License
New BSD License.
