Skip to content

lymr/fun-chat

Repository files navigation

Fun-Chat

Build Status

Fun-Chat is a showcase project for an online chat (Instant Messaging). It implements some concepts taken from well known IM protocols, however its main goal is to demonstrate a fully asynchronous client -> server -> client architecture utilizing Scala, Akka, Akka-HTTP and PostgreSQL with ScalikeJDBC.

Technical Features

  • Asynchronous message based architecture for server as well as client using Akka.
  • REST API with Akka-HTTP.
  • Non-blocking I/O with Akka actors.
  • Secure resources access using OAuth2 Bearer token with underlying Auth0 implementation of Json Web Token (JWT).
  • Persistence with PostgreSQL and ScalikeJDBC.
  • Utilization of Domain Specific Language (DSL) for sending messages.
  • Usage of Functional Programing paradigm.

User Features

  • Send / Receive messages from a friends.
  • Easy message sending with a simple DSL.

Message Grammar

    /**
    *   Message grammar
    *
    *   Note: single-quoted strings are tokens.
    *
    *   Example: "
    *       send to "Alice" , "Bob" message "Hey!"
    *                                              "
    */

    operation   :   recipients | text(s) | attachment(s)

    operation   :   'send'
    recipients  :   'to' recipient
    text        :   'message' "content" ~ delimiter text
    attachment  :   'attachment' "attachment-id" ~ delimiter attachment
    recipient   :   "user-name" ~ delimiter recipient
    delimiter   :   ',' |   ';'

Copyright

  • Copyright (C) 2016 Mor Levy.