RequesterImplicits
Related Doc:
package requester
Hook to add the request() methods to a third-party Actor.
The actual Requester that is going to send the requests and process the responses.
The actual Requester that is going to send the requests and process the responses. If you mix RequesterImplicits into a non-Requester, this must point to that Actor, which does all the real work. (If you are using this from within Requester, it's already set.)
This is a wrapper, intended to surround a request clause whose value you want to return as a Future.
This is a wrapper, intended to surround a request clause whose value you want to return as a Future. There is no magic here -- it is simply syntactic sugar to make this pattern easier. You should use it along these lines:
requestFuture[TargetType] { implicit promise =>
for {
v1 <- someActor.request(MyMessage)
v2 <- anotherActor.request(AnotherMessage(v1))
}
promise.success(v2)
}That is, requestFuture expects a block that takes a Promise of the type you want to return. This block should declare that Promise as implicit -- that implicit Promise gets sucked into the requests, and is used if an exception is thrown.
An arbitrarily-complex request clause, which eventually calls promise.success() when it gets the desired answer.
Implicit that hooks into *other* Actors, to provide the nice request() syntax to send messages to them. These implicits are available to any Actor that mixes in Requester, but RequesterImplicits should also be mixed into any other class that wants access to this capability. Those other classes must have access to a Requester -- usually, they should be functional classes owned *by* a Requester.
This trait gives you the functions that you actually call directly -- request(), requestFor() and requestFuture(). But those calls mostly create RequestM objects, and the actual work gets done by the associated Requester.