Represents an event that occurs on the event bus bridge.
Please consult the documentation for a full explanation.
package |
Default |
---|
__construct()
cause() : \Exception
\Exception
the cause or null if the operation succeeded.
complete( $arg0 = null) : void
complete()
Set the result. Any handler will be called, if there is one, and the future will be marked as completed.
param $result [boolean] the result complete($result)
boolean
completer() : callable
callable
an handler completing this future
compose( $arg0, $arg1 = null) : \io\vertx\jphp\ext\bridge\Future<U>
When this future (the one on which compose
is called) succeeds, the mapper
will be called with
the completed value and this mapper returns another future object. This returned future completion will complete
the future returned by this method call.
If the mapper
throws an exception, the returned future will be failed with this exception.
When this future fails, the failure will be propagated to the returned future and the mapper
will not be called.
param $mapper [callable] the mapper function compose($mapper)
Compose this future with a provided next
future.
When this (the one on which compose
is called) future succeeds, the handler
will be called with
the completed value, this handler should complete the next future.
If the handler
throws an exception, the returned future will be failed with this exception.
When this future fails, the failure will be propagated to the next
future and the handler
will not be called.
param $handler [callable] the handler param $next [Future] the next future compose($handler, $next)
callable
Future
\io\vertx\jphp\ext\bridge\Future
the composed future
fail( $arg0) : void
param $cause [\Exception] the failure cause fail($cause)
Try to set the failure. When it happens, any handler will be called, if there is one, and the future will be marked as completed.
param $failureMessage [string] the failure message fail($failureMessage)
string | \Exception
failed() : boolean
boolean
true if it failed or false otherwise
getRawMessage() : array
array
the raw JSON message for the event
isComplete() : boolean
boolean
true if completed, false if not
map( $arg0) : \io\vertx\jphp\ext\bridge\Future<U>
When this future succeeds, the mapper
will be called with the completed value and this mapper
returns a value. This value will complete the future returned by this method call.
If the mapper
throws an exception, the returned future will be failed with this exception.
When this future fails, the failure will be propagated to the returned future and the mapper
will not be called.
param $mapper [callable] the mapper function map($mapper)
Map the result of a future to a specific value
.
When this future succeeds, this value
will complete the future returned by this method call.
When this future fails, the failure will be propagated to the returned future.
param $value [mixed] the value that eventually completes the mapped future map($value)
callable | mixed
\io\vertx\jphp\ext\bridge\Future
the mapped future
mapEmpty() : \io\vertx\jphp\ext\bridge\Future<V>
This is a conveniency for future.map((T) null)
or future.map((Void) null)
.
When this future succeeds, null
will complete the future returned by this method call.
When this future fails, the failure will be propagated to the returned future.
\io\vertx\jphp\ext\bridge\Future
the mapped future
otherwise( $arg0) : \io\vertx\jphp\ext\bridge\Future<Boolean>
When this future fails, the mapper
will be called with the completed value and this mapper
returns a value. This value will complete the future returned by this method call.
If the mapper
throws an exception, the returned future will be failed with this exception.
When this future succeeds, the result will be propagated to the returned future and the mapper
will not be called.
param $mapper [callable] the mapper function otherwise($mapper)
Map the failure of a future to a specific value
.
When this future fails, this value
will complete the future returned by this method call.
When this future succeeds, the result will be propagated to the returned future.
param $value [boolean] the value that eventually completes the mapped future otherwise($value)
callable | boolean
\io\vertx\jphp\ext\bridge\Future
the mapped future
otherwiseEmpty() : \io\vertx\jphp\ext\bridge\Future<Boolean>
This is a convenience for future.otherwise((T) null)
.
When this future fails, the null
value will complete the future returned by this method call.
When this future succeeds, the result will be propagated to the returned future.
\io\vertx\jphp\ext\bridge\Future
the mapped future
recover( $arg0) : \io\vertx\jphp\ext\bridge\Future<Boolean>
If the mapper fails, then the returned future will be failed with this failure.
callable
\io\vertx\jphp\ext\bridge\Future
A recovered future
result() : boolean
boolean
the result or null if the operation failed.
setHandler( $arg0) : $this
If the future has already been completed it will be called immediately. Otherwise it will be called when the future is completed.
callable
$this
a reference to this, so it can be used fluently
setRawMessage( $arg0) : $this
array
$this
this reference, so it can be used fluently
succeeded() : boolean
boolean
true if it succeded or false otherwise
tryComplete( $arg0 = null) : boolean
tryComplete()
Set the failure. Any handler will be called, if there is one, and the future will be marked as completed.
param $result [boolean] the result tryComplete($result)
boolean
boolean
false when the future is already completed
tryFail( $arg0) : boolean
param $cause [\Exception] the failure cause tryFail($cause)
Try to set the failure. When it happens, any handler will be called, if there is one, and the future will be marked as completed.
param $failureMessage [string] the failure message tryFail($failureMessage)
string | \Exception
boolean
false when the future is already completed
type() : string
string
the type of the event