com.lightstreamer.ls_client.mpn

Interface MpnRegistrationListener

public interface MpnRegistrationListener

Receives notifications about device registration activity and errors.

Method Summary

Modifier and Type	Method and Description
void	registrationFailed(java.lang.Exception cause) Notification that the device registration on GCM sercice has failed.
void	registrationIdChangeFailed(java.lang.Exception cause) Notification that the registration ID change has been tried on the Server and failed.
void	registrationIdChangeSucceeded(MpnRegistrationIdChangeInfo info) Notification that the registration ID has been successully changed on the Server.
void	registrationSucceeded(java.lang.String registrationId, MpnRegistrationIdStatus status) Notification that the device has been successully registered on GCM service and a registration ID has been obtained.

Method Detail

registrationSucceeded

void registrationSucceeded(java.lang.String registrationId,
                           MpnRegistrationIdStatus status)

Notification that the device has been successully registered on GCM service and a registration ID has been obtained. After this notification it is possible to invoke any of the MPN related operations on LSClient.

Parameters:

registrationId - the obtained registration ID

status - the MpnRegistrationIdStatus associated with the registration ID, i.e. if it is new, changed or unchanged.

registrationFailed

void registrationFailed(java.lang.Exception cause)

Notification that the device registration on GCM sercice has failed. If this notification is received, none of the MPN related operations on LSClient may be successfully invoked.

Parameters:

cause - The specific error that caused the registration to fail.

registrationIdChangeSucceeded

void registrationIdChangeSucceeded(MpnRegistrationIdChangeInfo info)

Notification that the registration ID has been successully changed on the Server. The change attempt is the consequence of a previous invocation of LSClient.registerForMpn(android.content.Context, String, MpnRegistrationListener). If the device token had been invalidated by the GCM service, it is now valid again and all associated MPN subscriptions have been automatically reactivated from suspended state.

Parameters:

info - Additional information about the registration ID change (such as the number of reactivated MPN subscriptions).

registrationIdChangeFailed

void registrationIdChangeFailed(java.lang.Exception cause)

Notification that the registration ID change has been tried on the Server and failed. The change attempt is the consequence of a previous invocation of LSClient.registerForMpn(android.content.Context, String, MpnRegistrationListener). Note that the token change may fail in two situations that not necessarily denote an error condition:

• if there were no active MPN subscriptions related to this device and application;
• if too much time has passed since the old registration ID was invalidated by GCM service.

In both cases, the error reported is an PushUserException with error code 45 (device unknown).

Parameters:

cause - The specific error that caused the registration ID change to fail.