Interface Registration
- All Known Subinterfaces:
TopicNotifications.NotificationRegistration
Such a handler reference is provided whenever a handler with a server side presence is registered.
- Since:
- 5.1
- Author:
- DiffusionData Limited
-
Method Summary
Modifier and TypeMethodDescriptionclose()
Request that the handler is unregistered from the server.
-
Method Details
-
close
CompletableFuture<?> close()Request that the handler is unregistered from the server.After the handler is unregistered, the handler's
onClose
method will be called.A handler can only be unregistered once. A given instance will return the same CompletableFuture if this method is called more than once.
- Returns:
- a CompletableFuture that completes when a response is received
from the server.
If the task completes successfully, the CompletableFuture result will be null. The result type is any rather than Void to provide forward compatibility with future iterations of this API that may provide a non-null result with a more specific result type.
Otherwise, the CompletableFuture will complete exceptionally with a
CompletionException
. Common reasons for failure, listed by the exception reported as thecause
, include:SessionClosedException
– if the session is closed.
-