README.adoc

Chatty

A chat demo that evaluates several technologies (and hopefully shows best practices)

Used Technologies

• Java >= 8

• Spring Boot (+ Spring Data REST & REST Docs)

• HAL (Hypertext Application Language)

• Atmosphere (Async Pub/Sub)

• TypeScript for web client

• Angular for web client

• Protractor for functional web client UI tests

• JUnit for Java unit and integration testing

• Mockito for Mocking

• Gradle as build system

• Docker to create containers for the running apps

Requirements

• Java 8 JDK (or later) installed

• JavaScript tooling like Node.js, Grunt CLI, Bower and TSD (TypeScript Definition Manager) doesn’t have to be installed manually, it will be installed automatically (and project local) during the Gradle build.

Getting Started

• ./gradlew build (builds all, both Java and TypeScript)

• ./gradlew bootrun (starts a server using port 8080)

• Open http://localhost:8080 in a web browser

• Open http://localhost:8080 in another web browser

• Play around with Chatty!

Screenshot

Hypermedia API

Here is an example what you get at http://localhost:8080/api/users. I am using HAL (Hypertext Application Language). The returned mime type is application/hal+json. To get a pretty print in Chrome, please install the Chrome extensions JSONView and application/…+json|+xml as inline.

{
  "_embedded" : {
    "chatty:users" : [ {
      "fullName" : "Jane Doe",
      "email" : "[email protected]",
      "_links" : {
        "self" : {
          "href" : "http://localhost:8080/api/users/doe_ja"
        },
        "chatty:user" : {
          "href" : "http://localhost:8080/api/users/doe_ja{?projection}",
          "templated" : true
        },
        "chatty:messages" : {
          "href" : "http://localhost:8080/api/users/doe_ja/messages"
        }
      }
    } ]
  }
}

Spring Boot

To run the Spring-Boot based server, invoke gradlew bootrun

Then you can use http://localhost:8080/api as entry point for exploring the HAL based API.

{
  "_links": {
    "chatty:users": {
      "href": "http://localhost:8080/api/users{?page,size,sort,projection}",
      "templated": true
    },
    "chatty:messages": {
      "href": "http://localhost:8080/api/messages{?page,size,sort,projection}",
      "templated": true
    },
    "chatty:buildinfo": {
      "href": "http://localhost:8080/api/buildinfo"
    },
    "profile": {
      "href": "http://localhost:8080/api/profile"
    },
    "curies": [
      {
        "href": "http://localhost:8080/api/../docs/{rel}.html",
        "name": "chatty",
        "templated": true
      }
    ]
  }
}

HAL Explorer Integration

You can build and integrate the HAL Explorer. Then you have to invoke

• ./gradlew build cloneHalBrowser

• ./gradlew -p subprojects/hal-browser build

Live Demo

Currently, the Spring Boot based server is deployed to Heroku. You can try out a live demo of chatty at

• https://chatty42.herokuapp.com/

The demos include a HAL browser for browsing Chatty’s RESTful hypermedia API, as well as documentation of the REST API created with Spring Restdocs. But please be aware that this is only a test installment and will be reset periodically.

Docker Integration

You find installation instructions at Docker. When you use Windows or MAC, install Docker Toolbox. To prepare the docker image creation you have to run 'gradlew build createDockerfile distTar'. Under Windows and MAC you want to create a VM with docker-machine and connect to it. Then you can create the images and start up a container for the Spring Boot based service (running on port 8080) by invoking: docker-compose up

Pebble Client

• For a Pebble client, see https://github.com/toedter/pebble-chatty

License

MIT, see http://toedter.mit-license.org