-
Notifications
You must be signed in to change notification settings - Fork 594
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Consider introducing HttpApp for Java/Scala to lessen boilerplate #156
Comments
Comment by 2beaucoup The high level APIs mentioned in #16856 seems to be done. I can imagine that additional shortcuts like |
Comment by ktoso Let's take the discussion on client api to the client ticket :) |
Comment by johanandren While I definitely agree on that we could improve the getting started experience with the docs (which are more styled like a technical manual than the tutorial style of the python-requests docs referenced) I think that would be falling for something like a hello world fallacy, not actually useful because so few will be writing an application using akka-http that just makes one or two http calls (BTW in that case bash with curl or wget would be less boilerplate than Python). I also think that we have chosen explicit self contained samples over minimal, so that users can just copy and paste and run. Maybe we could create some kind of toggle for "full" vs "minimal without boilerplate" for the code samples in akka docs? |
I completely agree with this. Currently for any Hello World example, there is too much code I need to copy/paste from the previous one. |
Would you like to contribute such base class? Help would be definitely welcome on this front :) |
I'd like to :). I don't know when I could invest some time on this, but sure! |
Just to clarify, this issue is about creating a "bootstrap" class to create easily servers that use the High Level API, right? |
Experimental API to help on starting an http server. Add documentation on how to use it Add tests for it
Experimental API to help on starting an http server. Add documentation on how to use it Add tests for it
Issue by ktoso
Tuesday Apr 12, 2016 at 21:36 GMT
Originally opened as akka/akka#20299
We could provide (for java we once did), an
HttpApp
trait that'd work like App that's setting up akka etc and require overridingdef routes: Route
, it would simplify the "hello world" examples for the server side.Idea comes back after https://twitter.com/li_haoyi/status/719914887309176832
The other points from the discussion are tracked already:
The text was updated successfully, but these errors were encountered: