Dear hakkers,

we—the Akka committers—are proud to announce a new minor release of Akka, 2.4.5 that contains some pretty major news for those of you who are using Akka HTTP with Java.

Rise of the “New” Java Routing DSL

This release contains the long-awaited “new” Routing DSL for Java, which is an initiative started a few months ago by Jan Ypma (jypma) in which the Java and Scala DSLs were to be made more similar to each other. This has a number of benefits: simplifying the learning curve of either APIs, actually achieving feature parity between the APIs, and also a more Java8 feel thanks to the intense use of lambda expressions. Also, numerous issues were found and fixed during the transition – be sure to upgrade if you found problems in the old DSL.

Today, we announce that the API has been completed, and except minor changes we do not expect to do any large refactorings like this one – we’re on our road to a stable Routing API. This sadly means that the changes are rather wide-spread, and migrating from old to new may feel like learning an entire new API (which it is). If you run into trouble migrating contact us via the mailing list or gitter chat; customers may of course ask for help via the Lightbend support portal.

You will notice that directives documentation is complete, however lacking code examples in some cases. We would like to ask for your help in finishing the docs by adding code examples – these efforts can be coordinated as part of the #20466 ticket.

Other important fixes and improvements:

• The cluster client and the cluster client receptionist now allow for subscribers to which the changes to the current set of contacts or clients will be announced. (#20446)
• FileIO streams factory methods using java.nio.Path added and the old File (#20390)
• A bug in the Akka scheduler making it stop running scheduled events in a long lived actor system (#20424), thanks to ecartner for finding and reproducing this issue
• Registration of custom MediaTypes for Akka HTTP (#20397)
• Scala Routing DSL’s (experimental) Rest path matcher was changed to be Remaining to be more consistent with other parts of the routing DSL

The full list of changes since the last milestone is available under the 2.4.5 milestone on github for your reference.

Credits

Thanks to the Community! For this release we had the help of 48 committers. Special thanks to Jan Ypma for his involvement in the development of the new Java routing DSL.

Commits added removed
   34   11708    4371 Konrad Malawski
   32    3205    2924 Johan Andrén
   13     429     251 Patrik Nordwall
    7     889      96 Endre Sándor Varga
    7     180     223 2beaucoup
    6      67     114 Bernard Leach
    4     554     125 Robert Budźko
    4      37       5 poojadshende
    3     210     159 Daniel Moran
    3     331     175 Samuel Tardieu
    3      67      33 Nafer Sanabria
    2      29       3 Oleksii
    2      16      12 Tim Harper
    2      14      14 atemerev
    2      86      43 zhxiaog
    2      97      88 andreaTP
    2      14       1 Alexander Temerev
    2    3995    4059 Jan Ypma
    2      83      24 Ganeshwara Herawan Hananda Putra
    2     168       8 David Knapp
    1     169      20 Rémy-Christophe Schermesser
    1    2570       3 Felix Satyaputra
    1       2       3 Anil Gursel
    1      10       7 kerr
    1       1       1 Paweł Jurczenko
    1    1044      30 leonidb
    1      27       6 Stefano Bonetti
    1      61       0 Oleksii Tkachuk
    1       2       0 杨博 (Yang Bo)
    1       2       2 Derek Wickern
    1      18      14 Andrea Peruffo
    1     610      34 Christopher Hunt
    1      20       2 Mark van der Tol
    1     129     134 hepin1989(虎鸣)
    1       5       7 Leonid Bakaleynik
    1      39       3 svezfaz
    1       1       1 Alexey Noskov
    1      11       0 jsuchenia
    1     731      23 Rodolphe BELOUIN
    1      10       4 Björn Antonsson
    1       9       2 mumutu
    1      74       0 Giovanni Caporaletti
    1      51      77 Viktor Klang
    1     285     123 Michał Kiędyś
    1      61      33 Michał Płachta
    1      23      13 Martynas Mickevicius
    1      16       3 Priyanka Chordia
    1       6       9 tpfeifer

Happy hakking!

– The Akka Team