This is just a proof-of-concept app to showcase Cramp’s potential.
This should install all the dependencies
This demo uses MySQL, so you will need to create your own database. Read
config/database.sql to create it and edit
config/database.yml with the correct server, username and password.
If you want to test the WebSocket implementation outside of Google Chrome 4+, the app loads web-socket.js. As it uses Flash connection it is required that the server provides a policy file. This app uses Peleus Uhley implementation available in the
extra folder. Start it like this:
cd extra sudo python flashpolicyd.py --port 843 --file crossdomain.xml
It has to be
sudo because 843 is a privileged port. Now you need to start up the application itself:
bundle exec thin --timeout 0 -V -R config.ru start
It will start the server on the port 3000. So you can fire up a webbrowser and use either of these URLs:
The first URL is the WebSocket version. The second is a more usual Ajax Polling version, which may be more compatible with webbrowsers. As the WebSocket version uses Flash it’s less friendly to environments behind proxies and firewalls.
You can also test the server using
curl http://0.0.0.0:3000/websocket curl http://0.0.0.0:3000/retrieve curl -d "from=foo&msg=hello" http://0.0.0.0:3000/receive
The first URL will keep an open HTTP connection, receiving new messages as they are inserted in the database. The second one retrieves the last few messages and you can pass a ‘last_timestamp’ parameter to the URL with the value having the format of
Time.now.to_formatted_s(:db). Finally, the third operation simulates a form post to add new messages. The first URL is the WebSocket version, the last 2 are the polling version.
- In Firefox and Safari, I had the web-socket.js working properly, but for some reason it stopped working. Beware of flash blockers in your browser.
- In the Polling version it is manually setting the last message’s timestamp in the URL. I was still now able to make a version using a Rack::Session
- Just because it is a proof-of-concept, it uses Rack::Static to serve the HTML and JS files, but it’s not certain that this is the best way to do it
- Add CSS to make the demo a little bit more compelling
- Add multiple room and user registration support, but this requires exchanging session information as well. Making Rack::Session work may be a requirement
- Add templating than just static file to allow for some HAML or ERB views, adding Tilt to Cramp would be good as well
- 02/14/2011 – Updated to Cramp 0.14.1 and Active Record + Ruby 1.9 + Fibers.
- 02/14/2011 – Updated to Cramp 0.12 and the new Tramp gem.