/sse-chat

Chat example app using Server Sent Events plus REST calls. Scala, Play Framework 2.1, AngularJS.

Primary LanguageShellOtherNOASSERTION

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.

Architecture

The application uses Server Sent Events for delivering messages to the client and REST calls for sending 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.

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. with Play installed on your machine: play run in the project folder

  2. without Play installed you can make use of the Typesafe Activator feature: ./activator ui 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 on matthiasnehlsen.com.

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.