com.nokia.notifications
Class NotificationError

java.lang.Object
  com.nokia.notifications.NotificationError

public class NotificationError
extends java.lang.Object

This class defines all the error codes used by NotificationException and NotificationState.

Field Summary

static int	ERROR_APPLICATION_ID_CONFLICT Conflicting Application ID.
static int	ERROR_APPLICATION_ID_INVALID Returned when trying to register MIDlet with invalid Application ID.
static int	ERROR_AUTHENTICATION_FAILED This error occurs if the device is not able to fetch the authentication details from server.
static int	ERROR_CONNECTION_DISABLED_BY_USER User has disabled all connections like WiFi and Cellular network.
static int	ERROR_DISABLED_BY_USER User has disabled all notifications for this MIDlet.
static int	ERROR_ENABLER_EXITED Deprecated. This is not supported in Nokia Asha OS 1.0.
static int	ERROR_ENABLER_NOT_FOUND Deprecated. This is not supported in Nokia Asha OS 1.0.
static int	ERROR_INVALID_SERVICE_ID Deprecated. This is not supported in Nokia Asha OS 1.0.
static int	ERROR_NO_ACCOUNT Deprecated. This is not supported in Nokia Asha OS 1.0.
static int	ERROR_NO_NETWORK Network connection not available.
static int	ERROR_NONE No error occurred.
static int	ERROR_NOT_ALLOWED NotificationSession is not in correct state.
static int	ERROR_NOT_KNOWN Returned when error is anything other than listed above.
static int	ERROR_NOT_REGISTERED MIDlet is not registered but it called a function that requires registration.
static int	ERROR_NOTIFICATION_ID_INVALIDATED Deprecated. This is not supported in Nokia Asha OS 1.0.
static int	ERROR_OFFLINE Deprecated. This is not supported in Nokia Asha OS 1.0.
static int	ERROR_OPERATION_FAILED Deprecated. This is not supported in Nokia Asha OS 1.0.
static int	ERROR_REGISTER_FAILED Registration failed because there is not enough space available in the device memory to store the settings.
static int	ERROR_SERVICE_ID_CONFLICT Deprecated. This is not supported in Nokia Asha OS 1.0.
static int	ERROR_SERVICE_UNAVAILABLE Notification service is no longer available because service's authentication has expired.
static int	ERROR_SESSION_CLOSED NotificationSession function call failed because session was closed.
static int	ERROR_UNREGISTER_FAILED Deprecated. This is not supported in Nokia Asha OS 1.0.

Constructor Summary

NotificationError()

Method Summary

Methods inherited from class java.lang.Object

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

Field Detail

ERROR_NONE

public static final int ERROR_NONE

No error occurred.

See Also:

Constant Field Values

ERROR_OPERATION_FAILED

public static final int ERROR_OPERATION_FAILED

Deprecated. This is not supported in Nokia Asha OS 1.0.

See Also:

Constant Field Values

ERROR_SESSION_CLOSED

public static final int ERROR_SESSION_CLOSED

NotificationSession function call failed because session was closed.

To fix the error MIDlet should first call NotificationSessionFactory.openSession(MIDlet, java.lang.String, java.lang.String, com.nokia.notifications.NotificationSessionListener).

See Also:

Constant Field Values

ERROR_NOT_ALLOWED

public static final int ERROR_NOT_ALLOWED

NotificationSession is not in correct state. This error occurs when NotificationSession.getNotificationInformation() is called before NotificationSession is in NotificationState.STATE_ONLINE.

To recover MIDlet should wait until it gets NotificationSessionListener.stateChanged(com.nokia.notifications.NotificationState) callback with NotificationState.STATE_ONLINE and then call NotificationSession.getNotificationInformation() again to get Notification ID.

See Also:

Constant Field Values

ERROR_NO_ACCOUNT

public static final int ERROR_NO_ACCOUNT

Deprecated. This is not supported in Nokia Asha OS 1.0.

See Also:

Constant Field Values

ERROR_OFFLINE

public static final int ERROR_OFFLINE

Deprecated. This is not supported in Nokia Asha OS 1.0.

See Also:

Constant Field Values

ERROR_ENABLER_NOT_FOUND

public static final int ERROR_ENABLER_NOT_FOUND

Deprecated. This is not supported in Nokia Asha OS 1.0.

See Also:

Constant Field Values

ERROR_NO_NETWORK

public static final int ERROR_NO_NETWORK

Network connection not available. This error occurs when Notification Enabler has lost connection with Notification server temporarily because of lost n/w (cellular or WiFi), Notification Enabler will recover the connection automatically whenever n/w is found again, MIDlet need not trigger any action from API to recover the connection.

See Also:

Constant Field Values

ERROR_APPLICATION_ID_CONFLICT

public static final int ERROR_APPLICATION_ID_CONFLICT

Conflicting Application ID. The same Application ID has already been registered by another MIDlet. MIDlet should use another Application ID.

See Also:

Constant Field Values

ERROR_SERVICE_ID_CONFLICT

public static final int ERROR_SERVICE_ID_CONFLICT

Deprecated. This is not supported in Nokia Asha OS 1.0.

See Also:

Constant Field Values

ERROR_SERVICE_UNAVAILABLE

public static final int ERROR_SERVICE_UNAVAILABLE

Notification service is no longer available because service's authentication has expired. This error occurs when Notification Server is unavailable due to service break. Notification Enabler will recover connection on its own after sometime. MIDlet need not trigger any action on its behalf to recover lost connection.

See Also:

Constant Field Values

ERROR_REGISTER_FAILED

public static final int ERROR_REGISTER_FAILED

Registration failed because there is not enough space available in the device memory to store the settings. User should be asked to free some memory from the device.

See Also:

Constant Field Values

ERROR_UNREGISTER_FAILED

public static final int ERROR_UNREGISTER_FAILED

Deprecated. This is not supported in Nokia Asha OS 1.0.

See Also:

Constant Field Values

ERROR_INVALID_SERVICE_ID

public static final int ERROR_INVALID_SERVICE_ID

Deprecated. This is not supported in Nokia Asha OS 1.0.

See Also:

Constant Field Values

ERROR_NOTIFICATION_ID_INVALIDATED

public static final int ERROR_NOTIFICATION_ID_INVALIDATED

Deprecated. This is not supported in Nokia Asha OS 1.0.

See Also:

Constant Field Values

ERROR_DISABLED_BY_USER

public static final int ERROR_DISABLED_BY_USER

User has disabled all notifications for this MIDlet. User has turned off the MIDlet switch from the Settings->Notifications view. MIDlet can indicate to the user to turn the switch ON from Settings, if the user would like to use Notification Enabler for this MIDlet.

See Also:

Constant Field Values

ERROR_ENABLER_EXITED

public static final int ERROR_ENABLER_EXITED

Deprecated. This is not supported in Nokia Asha OS 1.0.

See Also:

Constant Field Values

ERROR_NOT_REGISTERED

public static final int ERROR_NOT_REGISTERED

MIDlet is not registered but it called a function that requires registration.

The following function may have been called before calling NotificationSession.registerApplication():

• NotificationSession.unregisterApplication()
• NotificationSession.getReceiveAtLatest()
• NotificationSession.setReceiveAtLatest(int)
• NotificationSession.isAudioAlertEnabled()
• NotificationSession.setAudioAlertEnabled(boolean)

To fix this error MIDlet should first call NotificationSession.registerApplication().

See Also:

Constant Field Values

ERROR_AUTHENTICATION_FAILED

public static final int ERROR_AUTHENTICATION_FAILED

This error occurs if the device is not able to fetch the authentication details from server. NNA will automatically continue trying to fetch the authentication details from server. MIDlet need not do anything on the NNA to recover from this error.

See Also:

Constant Field Values

ERROR_APPLICATION_ID_INVALID

public static final int ERROR_APPLICATION_ID_INVALID

Returned when trying to register MIDlet with invalid Application ID. Application ID is either empty or more than 255 characters long.

See Also:

Constant Field Values

ERROR_CONNECTION_DISABLED_BY_USER

public static final int ERROR_CONNECTION_DISABLED_BY_USER

User has disabled all connections like WiFi and Cellular network. MIDlet can indicate to the user to turn ON the n/w switches or disable the flight mode, if it is enabled.

See Also:

Constant Field Values

ERROR_NOT_KNOWN

public static final int ERROR_NOT_KNOWN

Returned when error is anything other than listed above.

See Also:

Constant Field Values

Constructor Detail

NotificationError

public NotificationError()