A special type of play.api.mvc.Handler which allows custom logic to be inserted during handling.
A special type of play.api.mvc.Handler which allows custom logic to be inserted
during handling. A Stage
accepts a RequestHeader
then returns a new
RequestHeader
along with the next Handler
to use during request
handling. The next handler could be a terminal Handler
like an
EssentialAction, but it could also be another Stage
. This means
it's possible to chains of Stage
s that should each be executed in turn.
To automatically execute all Stage
s you can call play.api.mvc.Handler.applyStages.
Some handlers are built as a series of stages, with each stage returning a new RequestHeader and another stage, until eventually a terminal handler is returned.
Some handlers are built as a series of stages, with each stage returning
a new RequestHeader and another stage, until eventually a terminal
handler is returned. This method processes all stages in a handler, if any,
returning a terminal handler such as EssentialAction
or WebSocket
.
The current RequestHeader.
The input Handler.
The new RequestHeader and Handler.