com.lightstreamer.ls_proxy
Class PushException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          com.lightstreamer.ls_proxy.PushException

All Implemented Interfaces:

java.io.Serializable

public class PushException
extends java.lang.Exception

Indicates an error condition occurred during communication with Lightstreamer Server. The error condition may affect:

• A connection request. In this case, it is sent as an answer to the connection request.
• A subscription request for one or more Items. In this case, it is sent as an asyncronous notification to the involved listeners.
• The Updates flow for a single Item or all Items. In this case, it is sent as an asyncronous notification to the involved listeners.
• The connection status. In this case, it is sent as an asyncronous notification to the connection state listener.

This error notification is just a facade for different, more specific, error notifications.

See Also:

Serialized Form

Constructor Summary

PushException(ConnectionException e)
Used by Lightstreamer to create a PushException which encapsulates a ConnectionException

PushException(PushConnException e)
Used by Lightstreamer to create a PushException which encapsulates a PushConnException

PushException(PushServerException e)
Used by Lightstreamer to create a PushException which encapsulates a PushServerException

PushException(PushUpdateException e)
Used by Lightstreamer to create a PushException which encapsulates a PushUpdateException

PushException(PushUserException e)
Used by Lightstreamer to create a PushException which encapsulates a PushUserException

Method Summary

void	rethrow() Gets the specific error notification.

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

PushException

public PushException(ConnectionException e)

Used by Lightstreamer to create a PushException which encapsulates a ConnectionException

Parameters:

e - a ConnectionException to be reported.

PushException

public PushException(PushUpdateException e)

Used by Lightstreamer to create a PushException which encapsulates a PushUpdateException

Parameters:

e - a PushUpdateException to be reported.

PushException

public PushException(PushConnException e)

Used by Lightstreamer to create a PushException which encapsulates a PushConnException

Parameters:

e - a PushConnException to be reported.

PushException

public PushException(PushServerException e)

Used by Lightstreamer to create a PushException which encapsulates a PushServerException

Parameters:

e - a PushServerException to be reported.

PushException

public PushException(PushUserException e)

Used by Lightstreamer to create a PushException which encapsulates a PushUserException

Parameters:

e - a PushUserException to be reported.

Method Detail

rethrow

public void rethrow()
             throws ConnectionException,
                    PushUpdateException,
                    PushConnException,
                    PushUserException,
                    PushServerException

Gets the specific error notification. This is done by throwing the appropriate exception.

Throws:

ConnectionException - Signals an internal problem that prevents a connection operation.

PushUpdateException - Signals an unexpected error in update values coming from Lightstreamer Server.

PushConnException - Signals a connection problem in a request to Lightstreamer Server or in the reception of Updates.

PushUserException - Signals a Server refusal to accomplish a request because of the constraints imposed by the Metadata Adapter or by Server configuration.

PushServerException - Signals an unexpected error in the answer received from Lightstreamer Server or a Server refusal to accomplish a request.