net.rim.pushsdk.acknowledgement
Interface AcknowledgementService

All Known Implementing Classes:
AcknowledgementServiceImpl

public interface AcknowledgementService

Business logic relating to the handling of acknowledgements.

Author:
dstrelbytsky

Method Summary
 List<String> requestNotification(List<String> pushIds)
          Requests notification for the given push ids.
 void setNotificationProcessorService(NotificationProcessorService notificationProcessorService)
          Support for dependency injection.
 void setPapService(PapService papService)
          Support for dependency injection.
 void setPushApplicationService(PushApplicationService pushApplicationService)
          Support for dependency injection.
 void setPushCountService(PushCountService pushCountService)
          Support for dependency injection.
 void setPushRequestDetailService(PushRequestDetailService pushRequestDetailService)
          Support for dependency injection.
 void setPushSDKProperties(PushSDKProperties pushSDKProperties)
          Support for dependency injection.
 

Method Detail

requestNotification

List<String> requestNotification(List<String> pushIds)
                                 throws PushSDKException
Requests notification for the given push ids. Used in the case where result notifications may have been lost.

Note: The push requests corresponding to the ids must have previously been persisted by the SDK (i.e. for applications with the 'storePushRequests' property set to true).

Parameters:
pushIds - a list of push ids to request notifications for
Returns:
list of invalid pushIds for which there are no pending requests
Throws:
PushSDKException - if any errors occur

setPapService

void setPapService(PapService papService)
Support for dependency injection. Inject an implementation of a PapService collaborating object - this is used to send the PAP messages to the PPG.

Parameters:
papService - an instance of a PapService implementation (must be thread safe)

setPushSDKProperties

void setPushSDKProperties(PushSDKProperties pushSDKProperties)
Support for dependency injection. Inject an implementation of a PushSDKProperties collaborating object - this is used to read global configuration properties.

Parameters:
pushSDKProperties - an instance of a PushSDKProperties implementation (must be thread safe)

setPushApplicationService

void setPushApplicationService(PushApplicationService pushApplicationService)
Support for dependency injection. Inject an implementation of a PushApplicationService collaborating object - this is used to interface with the business service that manages push applications.

Parameters:
pushApplicationService - an instance of a PushApplicationService implementation (must be thread safe)

setPushCountService

void setPushCountService(PushCountService pushCountService)
Support for dependency injection. Inject an implementation of a PushCountService collaborating object - this is used to interface with the business service that manages tracking pushes that are complete.

Parameters:
pushCountService - an instance of a PushCountService implementation (must be thread safe)

setPushRequestDetailService

void setPushRequestDetailService(PushRequestDetailService pushRequestDetailService)
Support for dependency injection. Inject an implementation of a PushRequestDetailService collaborating object - this is used to interface with the business service that manages push request details.

Parameters:
pushRequestDetailService - an instance of a PushRequestDetailService implementation (must be thread safe)

setNotificationProcessorService

void setNotificationProcessorService(NotificationProcessorService notificationProcessorService)
Support for dependency injection. Inject an implementation of a NotificationProcessorService collaborating object - this is used to interface with the business service that processes result notifications.

Parameters:
notificationProcessorService - an instance of a NotificationProcessorService implementation (must be thread safe)


Copyright © 2011 Research In Motion. All Rights Reserved.