play-example

An example of Play Framework 2.6.x framework usage for building a REST service with Java 8. The service itself represents simple API for books catalog.

What's implemented

• routing
• asynchronous controllers
• marshaling/unmarshalling using Jackson including Views and Serializers
• validation using JSR 303
• persistence layer using in-memory H2 and Ebean ORM including optimistic locking and soft-delete
• database evolution scripts
• testing with JUnit

Usage by getting the code from github

Running from project directory (if sbt already installed):

sbt
> run

or (Java 8 JDK must be installed)

$ ./sbt
> run

or (for Win)

sbt
> run

Then you'll see something like

--- (Running the application, auto-reloading is enabled) ---
[info] p.c.s.AkkaHttpServer - Listening for HTTP on /0:0:0:0:0:0:0:0:9000
(Server started, use Enter to stop and go back to the console...)

Now you can open browser at localhost:9000 and apply evolution script for database.

Then you can request books by genre id:

curl http://localhost:9000/v1/genres/f022820c-cb84-4981-9184-46b6f9a17de8/books?offset=0

=>

[
{
"id": "0ae2a56c-5dd4-47ed-b230-690c11a786be",
"name": "Alice's Adventures in Wonderland",
"year": 1865,
"edition": 1,
"author": {
"id": "bdd6741d-71b9-493c-9c31-38af19b9e27c",
"lastName": "Dodgson",
"firstName": "Charles"
}
}
]

Or create new book:

curl \
-H "Content-Type: application/json" \
-X POST \
-d '{"name":"The Hunting of the Snark","author":{"id":"bdd6741d-71b9-493c-9c31-38af19b9e27c"},"year":1876,"edition":1,"genreCollection":[{"id":"f022820c-cb84-4981-9184-46b6f9a17de8"}]}' \
http://localhost:9000/v1/books

=>

{
"id": "f5ce84de-6e18-4c88-b160-be749b10ba5d",
"whenCreated": "2017-08-03T01:04:44.254+03:00"
}

or update author:

curl \
-H "Content-Type: application/json" \
-X PUT \
-d '{"lastName":"Carroll","firstName":"Lewis","middleName":"Lutwidge"}' \
http://localhost:9000/v1/authors/bdd6741d-71b9-493c-9c31-38af19b9e27c

=>

{
"id": "bdd6741d-71b9-493c-9c31-38af19b9e27c",
"whenCreated": "2017-08-03T00:59:16.413+03:00",
"whenUpdated": "2017-08-03T01:14:13.127+03:00"
}

Testing

sbt
> test

=>

[info] Test run started
[info] Test RepositoryTest.saveBook started
[info] application - Creating Pool for datasource 'default'
...

Have fun!