Overview

TODO Akka Http is not a webframework. It's an Akka based implementation of asynchronous requests available since servlet 3.0 Each request will have own actor. Actor will live until async request is processed and completed or time is out. Processing of async request is divided by different unit of work. All these work units will be processed one by one, however Actor may receive one of the javax.servlet.AsyncEvent between. In case of Error, Timeout or Complete events actor will stop processing and shutdown. So all work untis will be droped.

What's new

Scopes

Async context has been divided on different scopes. Each scope is a synchronous unit of work

• Request scope. Expected to be the heaviest scope. All request logic shhould go here

• Response scope. Light scope for putting request result in response

• Callback scope. Simple callback function. Passes TRUE when response succeeded, FALSE otherwise.

Why

We need scope to receive async event messages in between. Thus will allow us to avoid various exceptions For example you may get response time out exception or response already completed, etc. TODO Also you can avoid odd operations when requrest already expired.

Migration Guide

Configuration

From Akka Migration Guide

In v1.3 the default name of the configuration file was akka.conf. In v2.0 the default name is application.conf.

Akka Http properties has been removed from akka-reference.conf (akka.conf). So Akka Mist has own reference.conf. However some of the properties were removed from mist at all, same happened with related functionality.

Changed:

• root-actor-id = "_httproot" to endpoints-path = endpoints - path of the actor to use for receiving and adding endpoints, call 'actorFor(/user/endpoints)'

Added:

• system-name = http - name of the system used in servlet
• endpoint-retrieval-timeout = 500 - HTTP 404 if no endpoint retrieved within defined timeout (ms), should be less then timeout

Removed:

• hostname = "localhost"
• port = 9998
• filters = ["akka.security.AkkaSecurityFilterFactory"]
• resource-packages = []
• authenticator = "N/A"
• connection-close = true
• kerberos.servicePrincipal = "N/A"
• kerberos.keyTabLocation = "N/A"
• kerberos.kerberosDebug = "N/A"
• kerberos.realm = ""