/sse-chat

Chat example app using Server Sent Events plus REST calls. Scala, Play Framework 2.3, AngularJS or React (alternatively).

Primary LanguageScalaOtherNOASSERTION

sse-chat

This is a simple chat application using Play Framework together with AngularJS. It makes use of a Concurrent.Broadcast object as an Enumerator, a filtering Enumeratee and EventSource as the Iteratee. Together these building blocks facilitate the chat message data flow within the application.

Check out the live demo.

Architecture

The application uses Server Sent Events to deliver messages to the client and REST calls to send messages to the server. The messages flow from the POST to the Server Sent Events (SSE) stream through Concurrent.broadcast as the central information hub into the chatFeed controller which attaches an Enumeratee / Iteratee chain to the Enumerator provided by Concurrent.broadcast. Filtering for the correct chat room is done with a filtering Enumeratee.

Architecture

The client is designed as a single page application using AngularJS. The file organization is inspired by the angular-seed project.

Alternatively, there is another client based on Facebook's React instead of AngularJS. This alternative version can be accessed under localhost:9000/react. Blog post about the React version will follow.

There are Romeo and Juliet hanging out in Room 1 in order to make looking at the app a little less boring. They are having their balcony scene conversation, but they are confused, uttering the lines at random.

How to run this:

  1. if Typesafe Activator is installed on your machine: activator run from inside the project folder
  2. if Activator is not installed, you can run: ./activator run in the project folder (or double click on activator script in OS X)

This application will work in Firefox, Safari, Chrome and Opera. It will not work in Internet Explorer, simply because Microsoft for whatever reason does not support Server Sent Events.

More information at matthiasnehlsen.com.

Edit January 2014: there also is a client version running Scala.js; please check the README in the scala-js folder for more information how to build this. The Closure Compiler optimized JavaScript of the application has been included in this project, whereas the other resulting files from the build process have been excluded for reasons of space.

Licence

This software is licensed under the Apache 2 license, quoted below.

Copyright © 2013 Matthias Nehlsen.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this project except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.