Goal of example is to show how create reactive REST services on Typesafe stack with Akka and Slick.

Example contains complete REST service for entity interaction.

• CRUD operations
• Entity partial updates
• CORS support
• Implemented authentication by token directive
• Test coverage with ScalaTest
• Migrations with FlyWay
• Ready for Docker
• Testing with inmemory postgres instance that launch automaticly
• HikaryCP as connection pool

• JDK 8 (e.g. https://www.oracle.com/technetwork/java/javase/downloads/index.html);
• sbt (https://www.scala-sbt.org/release/docs/Getting-Started/Setup.html);

You can get this example through Activator. For more information please use following url that explains how to get this template on your computer step-by-step: https://www.typesafe.com/activator/template/akka-http-rest

• Create database in PostgresSQL
• Set database settings on application config or set environment variables

There are two config files. Application config src/main/resources/application.conf and test config src/test/resources/application.conf.

• PSQL_URL - database url by scheme jdbc:postgresql:https://host:port/database-name
• PSQL_USER - database user
• PSQL_PASSWORD - database password

To run application, call:

sbt run

If you wanna restart your application without reloading of sbt, use:

sbt re-start

For launching application in Docker, you must configure database docker instance and run docker image, generated by sbt.

Generating application docker image and publishing on localhost:

sbt docker:publishLocal

Example of running, generated docker image:

docker run --name restapi -e DB_USER=dbuser -e DB_PASSWORD=dbpass -e DB_NAME=dbname -d --link DATABASE_INSTANCE_NAME:database -p 9090:9000 APPLICATION_IMAGE

• DATABASE_INSTANCE_NAME - name of your Postgresql docker instance
• APPLICATION_IMAGE - id or name of application docker image

To run tests, call:

sbt test

Application deployed on heroku and can be accessed by URL https://akka-http-rest.herokuapp.com/. First request can take some time, because heroku launch up project.

You can see documentation for this example on Apiary.

Great blog article about how it works, thanks @BBartosz!

Copyright (C) 2015 Arthur Kushka.

Distributed under the MIT License.