com.pushtechnology.diffusion.client.callbacks

Interface ServerHandler

All Known Subinterfaces:

ClientControl.SessionPropertiesListener

All Known Implementing Classes:

ClientControl.SessionPropertiesListener.Default, ServerHandler.Default

Deprecated.

since 6.7

This interface is only used by deprecated methods and will be removed in a future release.

@Deprecated
public interface ServerHandler

Common interface for callback handlers that establish a server side control presence for the client session.

Since:

5.1

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	ServerHandler.Default Deprecated. Skeleton server handler implementation.

Method Summary

Modifier and Type	Method and Description
void	onClose() Deprecated. Called if the handler is closed.
void	onError(ErrorReason errorReason) Deprecated. Notification of a contextual error related to this handler.
void	onRegistered(Registration registration) Deprecated. Called when the handler has been successfully registered with the server.

Method Detail

onRegistered

void onRegistered(Registration registration)

Deprecated.

Called when the handler has been successfully registered with the server.

A session can register at most one a single handler of each type. If there is already a handler registered the operation will fail, registeredHandler will be closed, and the session error handler will be notified. To change the handler, first close the previous handler.

Parameters:

registration - a reference that allows the handler to be closed

onClose

void onClose()

Deprecated.

Called if the handler is closed. The handler will be closed if the session is closed after the handler has been registered, or if the handler is unregistered using close.

No further calls will be made for the handler.

onError

void onError(ErrorReason errorReason)

Deprecated.

Notification of a contextual error related to this handler. This is analogous to an unchecked exception being raised. Situations in which onError is called include the session being closed before the handler is registered, a communication timeout, or a problem with the provided parameters. No further calls will be made to this handler.

Parameters:

errorReason - a value representing the error; this can be one of constants defined in ErrorReason, or a feature-specific reason