com.lightstreamer.ls_client

Class PushUserException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.lightstreamer.ls_client.PushUserException

All Implemented Interfaces:

java.io.Serializable

public class PushUserException
extends java.lang.Exception

Thrown in case the Server refuses to satisfy a request because of the constraints imposed by the Metadata Adapter or by Server configuration. A detailed error code is supplied. Both the error code and the message are received from the Server. In particular:

• A positive error code is issued by the Server after checking the request against the constraints imposed by the Metadata Adapter or by its own configuration. See the text protocol documentation for a reference of the error codes that can be issued in response to the operation performed (i.e. stream/poll, subscription, or synchronous sendMessage request).
• A zero or negative error code is issued directly by the Metadata Adapter because of capability restrictions that may be applied to the specific user.

See Also:

Serialized Form

Note:

When using MPN operations, a few more response codes are possible that are not documented in the text protocol:

• 40: mobile push notifications (MPN) are not supported by this Server instance
• 41: mobile push notification (MPN) request timed out
• 42: mobile push notification (MPN) request specified an invalid platform
• 43: mobile push notification (MPN) request specified an invalid application ID
• 44: mobile push notification (MPN) request specified an invalid format or syntax in trigger expression
• 45: mobile push notification (MPN) request specified an unknown device token
• 46: mobile push notification (MPN) request specified an unknown or invalid subscription ID
• 47: mobile push notification (MPN) request specified an invalid argument name in format or trigger expression
• 48: mobile push notification (MPN) request specified a device token that has been invalidated by APNS Feedback Service
• 49: mobile push notification (MPN) request specified a subscription parameter that exceeded maximum length
• 50: mobile push notification (MPN) request specified a subscription with no fields or no items

Constructor Summary

Constructors

Constructor and Description
PushUserException(int serverCode, java.lang.String serverMsg) Used by Lightstreamer to create a PushUserException.

Method Summary

Modifier and Type	Method and Description
int	getErrorCode() Returns the detailed error code, as received by the Server.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, 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

PushUserException

public PushUserException(int serverCode,
                         java.lang.String serverMsg)

Used by Lightstreamer to create a PushUserException.

Parameters:

serverCode - the error code received from the Server.

serverMsg - the error message received from the Server.

Method Detail

getErrorCode

public int getErrorCode()

Returns the detailed error code, as received by the Server.

Returns:

Integer code, whose meaning depends on Lightstreamer Server or the Metadata Adapter.