akka / akka-http-quickstart-java.g8 Goto Github PK

View Code? Open in Web Editor NEW

18.0 13.0 21.0 777 KB

Home Page: http://akka.io

Scala 16.73% Java 83.27%

akka akka-http http seed-template example java

akka-http-quickstart-java.g8's Introduction

Akka HTTP quickstart in Java

The Akka family of projects is managed by teams at Lightbend with help from the community.

Please see the quickstart guide for a walk through the code.

You can use Giter8 to create your own project from the quickstart. Or, download and extract the zip file(https://example.lightbend.com/v1/download/akka-quickstart-scala?name=akka-quickstart-scala) to a convenient location.

Prerequisites:

JDK 17
sbt 1.9.6 or higher (download here)

Open a console and run the following command to apply this template:

sbt new akka/akka-http-java-seed.g8

This template will prompt for the following parameters. Press Enter if the default values suit you:

name: Becomes the name of the project.
organisation: Provides an organisation name for the project.
akka-http-version: Specifies which version of Akka HTTP should be used for this project.
akka-version: Specifies which version of Akka should be used for this project.

This template comes with example for an Akka HTTP server on Java QuickstartServer, along with their respective tests.

Once inside the project folder, to run this code, you can issue the following command to run the server:

sbt run

This template also provides build descriptors for maven and gradle. You can use any of the following commands to run the application:

mvn compile
mvn exec:java

gradle run

Both commands run com.lightbend.akka.http.sample.QuickstartServer by default.

Template license

Written in 2017 by Lightbend, Inc.

To the extent possible under law, the author(s) have dedicated all copyright and related and neighboring rights to this template to the public domain worldwide. This template is distributed without any warranty. See http://creativecommons.org/publicdomain/zero/1.0/.

akka-http-quickstart-java.g8's People

Contributors

Stargazers

Watchers

akka-http-quickstart-java.g8's Issues

Change download link

Per this marketing effort: https://docs.google.com/spreadsheets/d/1IJCclFJYD7SuxdIgYJ9wyHu-rDn-z5Rt-BKWgDOGfz0/edit?usp=sharing Project Starter is going to be removed from Techhub. Instead, the guide should point directly to the download:
https://example.lightbend.com/v1/download/akka-http-quickstart-java?name=akka-http-quickstart-java

sbt restart command not found in akka-http-quickstart-java

I'm trying the akka-http quick start guide here: https://developer.lightbend.com/guides/akka-http-quickstart-java/
When executing reStart in sbt, I'm getting an error saying Not a valid command. Any idea why?

Use giter8 maven properties

https://github.com/akka/akka-grpc-quickstart-java.g8/pull/11/files#diff-d5b0299875acd07cbaec00b0114f8a1cR4

http://www.foundweekends.org/giter8/template.html

Port the new quickstart :-)

The new quickstart is here in Scala: https://github.com/akka/akka-http-quickstart-scala.g8
We should port it to Java.

I remember there was community interest in helping us out on that - that would be awesome!

Update to newer version of Akka HTTP when available

In the new version of Akka HTTP the HttpApp changed one signature from route to routes. Please adapt this as well, and add a comment stating that this was called route in previous versions. Just in case somebody wants to use the seed for different Akka HTTP versions.

Remove scalatest dependency once 10.0.8 is out

After akka/akka-http#1147 was completed, Akka HTTP for the Java API doesn't need Scalatest as a dependency anymore.
Once Akka HTTP 10.0.8 is out, remove scalatest dependency.

NoSuchElementException when asking for a non existing user

GET http://localhost:8080/users/user-4

[ERROR] [03/06/2018 17:38:41.501] [helloAkkaHttpServer-akka.actor.default-dispatcher-8] [akka.actor.ActorSystemImpl(helloAkkaHttpServer)] Error during processing of request: 'No value present'. Completing with 500 Internal Server Error response. To change default exception handling behavior, provide a custom ExceptionHandler.
java.util.NoSuchElementException: No value present
at java.base/java.util.Optional.get(Optional.java:151)
at com.lightbend.akka.http.sample.UserRoutes.lambda$getUser$4(UserRoutes.java:75)

simplify the shutdown

The reading from stdin doesn't always work (mvn). Was fixed in scala sample already https://github.com/akka/akka-http-quickstart-scala.g8/pull/35/files

UserRoutes makes use of the deprecated akka.pattern.PatternsCS.ask(...) method

Versions used

Akka version: 2.5.22

Akka Http version: 10.1.8

Expected Behavior

The UserRoutes.java class does not have any compiler warnings due to deprecation.

Actual Behavior

UserRoutes.java makes use of the akka.pattern.PatternsCS.ask(...) method, which is deprecated.

My acutal message to you

Thanks for providing this example, I am new to akka and currently trying to learn it.
I am going to provide a PR, which fixes the described issue.
IMHO learning by contributing is the best way to become an expert. ;-)