James Roper |

Lagom Scala API release candidate 2

We’re happy to announce that Lagom 1.3.0-RC2 has been released!

This release candidate includes the new Lagom Scala API, fully documented and with feature parity with the Java API.

Scala API design philosophy

In Lagom, we want both the Java API and the Scala API to be first class citizens, not one API built on the other, or one API augmented so that it works with the other language. For this reason, we have created two completely separate APIs, these APIs are provided by completely separate libraries, and typically will not be on the classpath at the same time. The namespaces selected for these APIs follow the convention introduced by Akka streams, namely that the Java API has a package name of javadsl, while the Scala API has a package name of scaladsl.

In general, when creating the Scala API, we have typically started with the Java API, and then worked from there to make it more idiomatic for Scala use. Some of the major differences from the Java API include:

  • Compile time dependency injection. Lagom’s Java API builds on Play’s Guice support. Lagom’s Scala API however uses a lightweight form of the cake pattern to wire dependencies together. This API is designed to work well with Macwire, though Macwire is not required to use it.
  • Stronger typed APIs where Scala allows, particularly in the persistent entity API.
  • Use of type classes to provide serializers and path parameter extractors, rather than using reflection.
  • Use of play-json for JSON serialization support.
  • Use of macros to implement service clients, rather than dynamic proxies.

Other features

Other new features in this release include:

  • JPA support, including JPA read side processor support.
  • New test APIs for testing message broker integration.
  • Activator is now deprecated, in favour of the new Giter8 support in sbt 0.13.13.

Sample apps

The Lagom team has been working on an auction system that demonstrates many of the features of Lagom. You can get the Java version here and the Scala version here. Please be aware that these apps are still a work in progress.


There are no major API changes from 1.3.0-RC1, this release primarily just contains bug fixes.