com.pushtechnology.diffusion.client.callbacks

Interface ContextCallback<C>

Type Parameters:

C - context object type

All Known Subinterfaces:

ClientControl.SessionPropertiesContextCallback<C>, ContextStream<C>, SecurityControl.ConfigurationContextCallback<C>, SecurityStoreFeature.UpdateStoreContextCallback<C>, SessionFactory.OpenContextCallback<C>, SubscriptionControl.SubscriptionByFilterContextCallback<C>, SystemAuthenticationControl.ConfigurationContextCallback<C>, TopicControl.RemovalContextCallback<C>

All Known Implementing Classes:

ContextCallback.Default, ContextStream.Default, SubscriptionControl.SubscriptionByFilterContextCallback.Default, TopicControl.RemovalContextCallback.Default

Deprecated.

since 6.7

Methods that use contextual callbacks are deprecated and will be removed in a future release. Use CompletableFuture variant instead.

@Deprecated
public interface ContextCallback<C>

Callback interface that provides responses from the server, together with an application supplied context object.

This interface and its extensions are alternatives to the Callback interface hierarchy that allow the application to associate an arbitrary context object with each call. Any suitable application object can be provided as the context. It will be passed on to the corresponding callback methods, allowing requests and responses to be correlated. The context object is optional (it may be null).

In all other respects Callback and ContextCallback behave identically.

Since:

5.1

See Also:

Callback, ContextStream

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	ContextCallback.Default<C> Deprecated. Abstract default callback.

Method Summary

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

Method Detail

onError

void onError(C context,
             ErrorReason errorReason)

Deprecated.

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:

context - the context object supplied when making the call. May be null.

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