com.pushtechnology.diffusion.client.callbacks

Interface Callback

All Known Subinterfaces:

AuthenticationControl.ControlAuthenticator, ClientControl.QueueEventStream, ClientControl.SessionPropertiesCallback, ClientControl.SessionPropertiesStream, Messaging.RequestHandler<T,R>, Messaging.RequestStream<T,R>, SecurityControl.ConfigurationCallback, SecurityStoreFeature.UpdateStoreCallback, SessionFactory.OpenCallback, Stream, SubscriptionControl.SubscriptionByFilterCallback, SystemAuthenticationControl.ConfigurationCallback, TopicControl.MissingTopicNotificationStream, TopicControl.RemovalCallback, TopicNotifications.TopicNotificationListener, Topics.SubscriberStream, Topics.ValueStream<V>

All Known Implementing Classes:

Callback.Default, ClientControl.QueueEventStream.Default, ClientControl.SessionPropertiesStream.Default, Messaging.FilteredRequestCallback.Default, Stream.Default, SubscriptionControl.SubscriptionByFilterCallback.Default, TopicControl.MissingTopicNotificationStream.Default, TopicControl.RemovalCallback.Default, TopicNotifications.TopicNotificationListener.Default, Topics.SubscriberStream.Default, Topics.ValueStream.Default

public interface Callback

Callback interface that provides responses from the server. Extensions of this interface have callback methods that provide results for successful calls.

Direct extensions of this interface support a single callback each time the callback is used in a call (the call context). If the call fails to return a result, for example if the session is closed or the operation times out, onError will be called. Each call to the server will result in invocation of either a single callback method or onError.

The Stream extension supports multiple responses for each call.

If the server returns a response for an unknown call context (typically a late response for a call context has timed out), an error will be reported to the session error handler.

Since:

5.1

Author:

DiffusionData Limited

See Also:

Stream, ContextStream, ContextCallback

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	Callback.Default Abstract default callback.

Method Summary

Modifier and Type	Method and Description
void	onError(ErrorReason errorReason) Notification of a contextual error related to this callback.

Method Detail

onError

void onError(ErrorReason errorReason)

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

Parameters:

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