Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Websockets service for Wildcloud
Ruby
branch: master
Failed to load latest commit information.
bin Reimplement using sockjs-netty
ext
lib/wildcloud Reimplement using sockjs-netty
samples Reimplement using sockjs-netty
.gitignore Add Jackson; Modify README;
.rbenv-version
CHANGELOG.md Initial commit
Gemfile
Gemfile.lock
LICENSE
README.md
wildcloud-websockets.gemspec Reimplement using sockjs-netty

README.md

Wildcloud - Websockets

Service providing websockets to applications deployed in Wildcloud platform

Status

Proof of concept implementation.

The service does not yet implement the interface as described below.

Client interface

  • SockJS

Interface

Application authorizes client with secret application id and custom client id. The service returns socket_id, that should be used for identifying that specific client (e.g. session of a user of a web application).

POST /authorize/application_id/client_id

with parameters in it's body, encoded as JSON.

{"callback":"http://www.yourapplication.com/ws/callback"}

To the callback url, a message published by client to the service, will be forwarded

POST http://www.yourapplication.com/ws/callback

with content of the message as the request body with other parameters encoded as JSON

{"message": "some message", "session": "session_id", "client": "client_id"}

where session id represent single connection between the client and this service (e.g. one window or tab in a browser).

To publish a message, the application posts a request to the service with socket_id

POST /publish/socket_id

with JSON encoded body containing the message and optional parameters.

{"message": "some message"}

The service then forwards the message to the client (all sessions or just a specific one).

On the client-side the user connects using SockJS to the server and specifies the already authorized socket_id

var socket = new SockJS('http://ws.your_server.com/socket_id');

Support

  • Transports
    • Websockets
    • XHR-Streaming
    • Iframe-EventSource
    • Iframe-Htmlfile
    • XHR-Polling
    • Iframe-XHR-Polling
  • Browsers
    • MacOSX
      • Chromium - OK
      • Firefox - broken on XHR polling
      • Opera - broken
      • Safari - not tested
      • Camino
    • Linux - not tested
      • Chromium
      • Firefox
      • Opera
      • Epiphany
      • Konqueror
    • Windows - not tested
      • Chromium
      • Firefox
      • Opera
      • Safari
      • Internet explorer
    • Solaris - not tested
    • BSDs - not tested
    • Android - not tested
      • Android browser
      • Firefox
      • Opera
    • iOS - not tested
      • Safari
    • WP7 - not tested
      • Internet explorer mobile

Implementation

License

Project is licensed under the terms of the Apache 2 License.

Something went wrong with that request. Please try again.